@dsh-workbench/shared 1.1.8 → 1.1.10

package/dist/host/bundle-manager.js

@@ -0,0 +1,181 @@
+import { RESTART_REASONS } from '../contract/protocol/bundle-install.js';
+const MANAGER_SERVICE = 'pluginManager';
+const APPLICATIONS = ['applied', 'restart-required', 'overridden', 'failed', 'cancelled'];
+const STAGES = ['install', 'enable', 'remove'];
+const PROBLEMS = [
+    'invalid-spec',
+    'already-installed',
+    'not-found',
+    'not-a-package',
+    'not-a-bundle',
+    'not-a-workbench-module',
+    'network',
+    'unknown',
+];
+const SPEC_KINDS = ['registry', 'path', 'git', 'tarball'];
+const FAILURE_KINDS = [
+    'pnpm-missing',
+    'timeout',
+    'not-found',
+    'no-matching-version',
+    'network',
+    'disk-full',
+    'permission',
+    'build-blocked',
+    'integrity',
+    'unknown',
+];
+const CANCELLATIONS = ['cancelled', 'too-late', 'not-running'];
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+function asText(value) {
+    return typeof value === 'string' ? value : '';
+}
+function pick(allowed, value) {
+    return typeof value === 'string' && allowed.includes(value) ? value : undefined;
+}
+function asRegistry(value) {
+    if (value === null)
+        return null;
+    return typeof value === 'string' ? value : undefined;
+}
+function asTextArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+}
+function asRegistries(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return null;
+    const registry = asRegistry(record.registry);
+    if (registry === undefined)
+        return null;
+    return {
+        registry,
+        fallbackRegistries: asTextArray(record.fallbackRegistries),
+        resolved: typeof record.resolved === 'string' ? record.resolved : null,
+    };
+}
+function asPackageResult(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return undefined;
+    const kind = pick(FAILURE_KINDS, record.kind);
+    return {
+        exitCode: typeof record.exitCode === 'number' ? record.exitCode : -1,
+        output: asText(record.output),
+        truncated: record.truncated === true,
+        logPath: asText(record.logPath),
+        ...(kind === undefined ? {} : { kind }),
+    };
+}
+function asChange(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return null;
+    const application = pick(APPLICATIONS, record.application);
+    const stage = pick(STAGES, record.stage);
+    if (application === undefined || stage === undefined)
+        return null;
+    const error = asRecord(record.error);
+    const packageResult = asPackageResult(record.packageResult);
+    const pendingBuilds = asTextArray(record.pendingBuilds);
+    const restartReason = pick(RESTART_REASONS, record.restartReason);
+    const failedAt = pick(['registry', 'spec-host'], record.failedAt);
+    const bundle = asText(record.bundle);
+    const version = asText(record.version);
+    const errorCode = error === undefined ? '' : asText(error.code);
+    const errorDetail = error === undefined ? '' : asText(error.diagnostic);
+    return {
+        application,
+        stage,
+        changed: record.changed === true,
+        target: asText(record.target),
+        ...(bundle === '' ? {} : { bundle }),
+        ...(version === '' ? {} : { version }),
+        ...(errorCode === '' ? {} : { errorCode }),
+        ...(errorDetail === '' ? {} : { errorDetail }),
+        ...(packageResult === undefined ? {} : { packageResult }),
+        ...(pendingBuilds.length === 0 ? {} : { pendingBuilds }),
+        ...(restartReason === undefined ? {} : { restartReason }),
+        ...(failedAt === undefined ? {} : { failedAt }),
+    };
+}
+function asInspection(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return null;
+    const status = asText(record.status);
+    if (status === 'refused') {
+        const problem = pick(PROBLEMS, record.problem) ?? 'unknown';
+        const registries = Array.isArray(record.registries)
+            ? record.registries.map(asRegistry).filter((item) => item !== undefined)
+            : [];
+        return {
+            status: 'refused',
+            problem,
+            reason: asText(record.reason),
+            ...(registries.length === 0 ? {} : { registries }),
+        };
+    }
+    if (status !== 'accepted')
+        return null;
+    const kind = pick(SPEC_KINDS, record.kind);
+    const registry = asRegistry(record.registry);
+    if (kind === undefined || registry === undefined)
+        return null;
+    const name = asText(record.name);
+    const version = asText(record.version);
+    const description = asText(record.description);
+    const host = asText(record.host);
+    return {
+        status: 'accepted',
+        kind,
+        bundle: typeof record.bundle === 'boolean' ? record.bundle : null,
+        registry,
+        ...(name === '' ? {} : { name }),
+        ...(version === '' ? {} : { version }),
+        ...(description === '' ? {} : { description }),
+        ...(host === '' ? {} : { host }),
+    };
+}
+export function readBundleManager(ctx) {
+    const face = ctx.get(MANAGER_SERVICE);
+    if (face === undefined)
+        return undefined;
+    if (typeof face.installBundle !== 'function' || typeof face.removeBundle !== 'function')
+        return undefined;
+    return {
+        async registries() {
+            if (typeof face.registries !== 'function')
+                return null;
+            return asRegistries(await face.registries());
+        },
+        async inspect(spec, registry) {
+            if (typeof face.inspect !== 'function')
+                return null;
+            return asInspection(await face.inspect(spec, registry === undefined ? undefined : { registry }));
+        },
+        async install(request) {
+            const options = {
+                ...(request.registry === undefined ? {} : { registry: request.registry }),
+                ...(request.requestId === undefined ? {} : { requestId: request.requestId }),
+                ...(request.approvedBuilds === undefined ? {} : { approvedBuilds: request.approvedBuilds }),
+            };
+            return asChange(await face.installBundle?.(request.spec, options));
+        },
+        async remove(name) {
+            return asChange(await face.removeBundle?.(name));
+        },
+        async setEnabled(name, enabled) {
+            if (typeof face.setBundleEnabled !== 'function')
+                return null;
+            return asChange(await face.setBundleEnabled(name, enabled));
+        },
+        async cancel(requestId) {
+            if (typeof face.cancelInstall !== 'function')
+                return null;
+            return pick(CANCELLATIONS, (asRecord(await face.cancelInstall(requestId)) ?? {}).status) ?? null;
+        },
+    };
+}

package/dist/host/cli.js

@@ -1,6 +1,8 @@
 import { adaptersOf } from './adapters.js';
 export function cliPortOf(ctx) {
-    return { command: adaptersOf(ctx).runtime.opencliCommand(ctx).command };
+    const commands = adaptersOf(ctx).runtime.commands(ctx);
+    const first = Object.values(commands)[0];
+    return { command: first ?? '' };
 }
 export function cliCommandOf(ctx) {
     return cliPortOf(ctx).command;

package/dist/host/config-sync.d.ts

@@ -0,0 +1,48 @@
+import type { PostResource, RouteHandler } from './http.js';
+import type { ConfigSyncRow, ConfigSyncSnapshot } from '../contract/protocol/config-sync.js';
+export interface PatchBlock {
+    readonly key: string;
+    readonly id: string;
+    readonly insert: boolean;
+    readonly body: string;
+    readonly names: readonly string[];
+}
+export declare function patchBlocks(text: string): PatchBlock[];
+export declare function normalizeBlock(body: string): string;
+export declare function syncRows(source: readonly PatchBlock[], own: readonly PatchBlock[], missing: (block: PatchBlock) => readonly string[]): ConfigSyncRow[];
+export declare function mergeBlocks(ownText: string, incoming: readonly PatchBlock[], overwrite: ReadonlySet<string>): {
+    ok: true;
+    text: string;
+    written: string[];
+    skipped: string[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function readPatchBlocks(path: string): {
+    ok: true;
+    text: string;
+    blocks: PatchBlock[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function writePatchFile(path: string, text: string): void;
+export interface ConfigSyncDeps {
+    readonly home: string;
+    readonly self: string;
+    readonly profileDir: string | null;
+    readonly reconcile?: (() => Promise<boolean | void>) | undefined;
+}
+export declare function configSyncHandler(deps: ConfigSyncDeps): RouteHandler;
+export declare function configSyncSnapshot(deps: ConfigSyncDeps, asked?: string): ConfigSyncSnapshot;
+export declare function configSyncApply(deps: ConfigSyncDeps, payload: unknown): Promise<{
+    ok: true;
+    written: string[];
+    skipped: string[];
+    verified: boolean;
+} | {
+    ok: false;
+    text: string;
+}>;
+export declare function configSyncAction(deps: ConfigSyncDeps): PostResource;

package/dist/host/config-sync.js

@@ -0,0 +1,342 @@
+import { existsSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CONFIG_SYNC_RESOURCE } from '../contract/protocol/config-sync.js';
+const ID_LINE = /^- id:[ \t]*"?([^"\s#]+)/;
+const INSERT_LINE = /^- insert:[ \t]*$/;
+const NESTED_ID = /^[ \t]+-[ \t]*id:[ \t]*"?([^"\s#]+)/;
+const NAME_LINE = /^[ \t]*-?[ \t]*name:[ \t]*['"]?([^'"\s#]+)/;
+const COMMENT_LINE = /^[ \t]*#/;
+const ISOLATION_IDS = new Set([
+    'session-persistence-jsonl',
+    'storage-json',
+    'attachment-local',
+    'sandbox-policy',
+]);
+function trimmedTail(lines) {
+    let end = lines.length;
+    while (end > 0 && (lines[end - 1] ?? '').trim() === '')
+        end -= 1;
+    return lines.slice(0, end);
+}
+function matched(text, pattern) {
+    const found = pattern.exec(text);
+    return found === null ? undefined : found[1];
+}
+function blockOf(body, index) {
+    const lines = body.split('\n');
+    const first = lines[0] ?? '';
+    const id = matched(first, ID_LINE);
+    const nested = lines.flatMap((line) => {
+        const one = matched(line, NESTED_ID);
+        return one === undefined ? [] : [one];
+    });
+    const insert = id === undefined && INSERT_LINE.test(first);
+    const label = id ?? nested.join(', ');
+    const key = id !== undefined ? `id:${id}` : insert ? `insert:${nested.join(', ')}` : `block:${String(index)}`;
+    const names = lines.flatMap((line) => {
+        const one = matched(line, NAME_LINE);
+        return one === undefined ? [] : [one];
+    });
+    return { key, id: label === '' ? key : label, insert, body, names };
+}
+function spannedBlocks(text) {
+    const lines = text.split('\n');
+    const starts = [];
+    lines.forEach((line, index) => {
+        if (/^- /.test(line) || line === '-')
+            starts.push(index);
+    });
+    const blocks = [];
+    for (let i = 0; i < starts.length; i += 1) {
+        const from = starts[i] ?? 0;
+        const to = i + 1 < starts.length ? (starts[i + 1] ?? lines.length) : lines.length;
+        const body = trimmedTail(lines.slice(from, to)).join('\n');
+        if (body.trim() === '')
+            continue;
+        blocks.push({ ...blockOf(body, blocks.length), from, to });
+    }
+    return blocks;
+}
+export function patchBlocks(text) {
+    return spannedBlocks(text).map(({ from: _from, to: _to, ...block }) => block);
+}
+export function normalizeBlock(body) {
+    return body
+        .split('\n')
+        .map((line) => line.replace(/\s+$/, ''))
+        .filter((line) => line.trim() !== '' && !COMMENT_LINE.test(line))
+        .join('\n');
+}
+function rewriteForTarget(body, self) {
+    if (self === '' || self === 'workbench')
+        return body;
+    return body.replace(/(dshHomePath\(\s*['"])workbench(?=[/'"])/g, `$1${self}`);
+}
+function syncable(block) {
+    return !block.insert && !ISOLATION_IDS.has(block.id);
+}
+export function syncRows(source, own, missing) {
+    const mine = new Map(own.map((block) => [block.key, block]));
+    const rows = [];
+    for (const block of source) {
+        if (!syncable(block))
+            continue;
+        const here = mine.get(block.key);
+        if (here !== undefined && normalizeBlock(here.body) === normalizeBlock(block.body))
+            continue;
+        rows.push({
+            key: block.key,
+            id: block.id,
+            state: here === undefined ? 'new' : 'differs',
+            body: block.body,
+            ownBody: here === undefined ? null : here.body,
+            missing: missing(block),
+        });
+    }
+    return rows;
+}
+function replaceBlocks(text, blocks) {
+    const wanted = new Map(blocks.map((block) => [block.key, block]));
+    const spans = spannedBlocks(text).filter((span) => wanted.has(span.key));
+    const lines = text.split('\n');
+    for (const span of [...spans].reverse()) {
+        const replacement = (wanted.get(span.key)?.body ?? '').split('\n');
+        lines.splice(span.from, span.to - span.from, ...replacement);
+    }
+    return lines.join('\n');
+}
+function appendBlocks(text, blocks) {
+    const kept = text
+        .split('\n')
+        .filter((line) => line.trim() !== '[]')
+        .join('\n')
+        .replace(/\s+$/, '');
+    let out = kept === '' ? '' : `${kept}\n`;
+    for (const block of blocks)
+        out += `\n${block.body}\n`;
+    return out;
+}
+export function mergeBlocks(ownText, incoming, overwrite) {
+    const own = patchBlocks(ownText);
+    const mine = new Set(own.map((block) => block.key));
+    const written = [];
+    const skipped = [];
+    const take = [];
+    for (const block of incoming) {
+        if (!mine.has(block.key) || overwrite.has(block.key)) {
+            take.push(block);
+            written.push(block.id);
+            continue;
+        }
+        skipped.push(block.id);
+    }
+    if (take.length === 0)
+        return { ok: true, text: ownText, written, skipped };
+    const replaced = replaceBlocks(ownText, take.filter((block) => mine.has(block.key)));
+    const text = appendBlocks(replaced, take.filter((block) => !mine.has(block.key)));
+    const check = patchBlocks(text);
+    const expected = new Set([...mine, ...take.map((block) => block.key)]);
+    if (check.length !== expected.size || new Set(check.map((block) => block.key)).size !== expected.size) {
+        return { ok: false, reason: '写入前的自检没过：行的 id 会重复或丢行' };
+    }
+    return { ok: true, text, written, skipped };
+}
+export function readPatchBlocks(path) {
+    try {
+        const text = readFileSync(path, 'utf8');
+        return { ok: true, text, blocks: patchBlocks(text) };
+    }
+    catch (error) {
+        return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+function patchMode(path) {
+    try {
+        return statSync(path).mode & 0o777;
+    }
+    catch {
+        return 0o644;
+    }
+}
+export function writePatchFile(path, text) {
+    const mode = patchMode(path);
+    const tmp = `${path}.wb-sync-${String(process.pid)}`;
+    writeFileSync(tmp, text, { mode });
+    try {
+        renameSync(tmp, path);
+    }
+    catch (error) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+            throw error;
+        }
+        throw error;
+    }
+}
+export function configSyncHandler(deps) {
+    return (search) => ({ ok: true, ...configSyncSnapshot(deps, search.get('source') ?? undefined) });
+}
+function textOf(value) {
+    return typeof value === 'string' ? value : '';
+}
+function profileDependencies(dir) {
+    try {
+        const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        return new Set(Object.keys(manifest.dependencies ?? {}));
+    }
+    catch {
+        return new Set();
+    }
+}
+function profileNames(profilesDir) {
+    try {
+        return readdirSync(profilesDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+            .map((entry) => entry.name)
+            .filter((name) => existsSync(join(profilesDir, name, 'package.json')))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+export function configSyncSnapshot(deps, asked) {
+    const profilesDir = join(deps.home, 'profiles');
+    const names = profileNames(profilesDir);
+    const others = names.filter((name) => name !== deps.self);
+    const base = {
+        self: deps.self,
+        home: deps.home,
+    };
+    if (deps.profileDir === null) {
+        return {
+            ...base,
+            source: '',
+            profiles: [],
+            rows: [],
+            emptyProviders: false,
+            reason: '拿不到当前 profile 目录',
+        };
+    }
+    const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+    const emptyProviders = own.ok && !own.blocks.some((block) => block.key.startsWith('id:llm-'));
+    const ownBlocks = own.ok ? own.blocks : [];
+    const profiles = others.map((name) => {
+        const read = readPatchBlocks(join(profilesDir, name, 'cordis.patch.yml'));
+        const blocks = read.ok
+            ? read.blocks
+                .filter(syncable)
+                .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }))
+            : [];
+        return {
+            name,
+            readable: read.ok,
+            candidates: read.ok ? syncRows(blocks, ownBlocks, () => []).length : 0,
+        };
+    });
+    if (others.length === 0) {
+        return {
+            ...base,
+            source: '',
+            profiles,
+            rows: [],
+            emptyProviders,
+            reason: '这台机器上只有当前这个 profile，没有可同步的来源',
+        };
+    }
+    const source = others.includes(asked ?? '') ? (asked ?? '') : others.includes('web') ? 'web' : (others[0] ?? '');
+    const sourceDir = join(profilesDir, source);
+    const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+    if (!read.ok) {
+        return { ...base, source, profiles, rows: [], emptyProviders, reason: read.reason };
+    }
+    if (!own.ok) {
+        return { ...base, source, profiles, rows: [], emptyProviders, reason: own.reason };
+    }
+    const declared = profileDependencies(sourceDir);
+    const modulesDir = join(deps.profileDir, 'node_modules');
+    const sourceBlocks = read.blocks
+        .filter(syncable)
+        .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+    const rows = syncRows(sourceBlocks, own.blocks, (block) => block.names.filter((name) => declared.has(name) && !existsSync(join(modulesDir, name))));
+    return { ...base, source, profiles, rows, emptyProviders };
+}
+export async function configSyncApply(deps, payload) {
+    if (deps.profileDir === null)
+        return { ok: false, text: '拿不到当前 profile 目录，这次没写任何东西' };
+    const body = typeof payload === 'object' && payload !== null ? payload : {};
+    const source = textOf(body['source']);
+    const keys = new Set((Array.isArray(body['keys']) ? body['keys'] : []).map((item) => textOf(item)).filter((item) => item !== ''));
+    const overwrite = new Set((Array.isArray(body['overwrite']) ? body['overwrite'] : []).map((item) => textOf(item)));
+    if (source === '' || keys.size === 0) {
+        return { ok: false, text: '没说清从哪个 profile 同步哪几行' };
+    }
+    const profilesDir = join(deps.home, 'profiles');
+    if (!profileNames(profilesDir).includes(source))
+        return { ok: false, text: `没有这个 profile：${source}` };
+    if (source === deps.self)
+        return { ok: false, text: '来源不能是工作台自己' };
+    const sourceDir = join(profilesDir, source);
+    const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+    if (!read.ok)
+        return { ok: false, text: `读不到 ${source} 的配置：${read.reason}` };
+    const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+    if (!own.ok)
+        return { ok: false, text: `读不到工作台自己的配置：${own.reason}` };
+    if (read.blocks.some((block) => block.insert && keys.has(block.key))) {
+        return { ok: false, text: '插件行不同步：先把插件装到工作台这边，再同步它的设置' };
+    }
+    const picked = read.blocks
+        .filter((block) => keys.has(block.key) && syncable(block))
+        .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+    if (picked.length === 0) {
+        return { ok: false, text: '选中的行在来源里已经找不到了，重新读一遍再试' };
+    }
+    const merged = mergeBlocks(own.text, picked, overwrite);
+    if (!merged.ok)
+        return { ok: false, text: merged.reason };
+    const patchPath = join(deps.profileDir, 'cordis.patch.yml');
+    const patchChanged = merged.text !== own.text;
+    try {
+        if (patchChanged)
+            writePatchFile(patchPath, merged.text);
+    }
+    catch (error) {
+        return { ok: false, text: `写不进去：${error instanceof Error ? error.message : String(error)}` };
+    }
+    if (deps.reconcile === undefined) {
+        return { ok: true, written: merged.written, skipped: merged.skipped, verified: false };
+    }
+    try {
+        const verified = await deps.reconcile();
+        if (verified === false) {
+            return { ok: true, written: merged.written, skipped: merged.skipped, verified: false };
+        }
+    }
+    catch (error) {
+        if (patchChanged) {
+            try {
+                writePatchFile(patchPath, own.text);
+            }
+            catch {
+                return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。原来的设置没能恢复，手动检查一下` };
+            }
+        }
+        try {
+            await deps.reconcile();
+        }
+        catch {
+            return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+        }
+        return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+    }
+    return { ok: true, written: merged.written, skipped: merged.skipped, verified: true };
+}
+export function configSyncAction(deps) {
+    return {
+        resource: CONFIG_SYNC_RESOURCE,
+        handle: (payload) => configSyncApply(deps, payload),
+    };
+}

package/dist/host/dsh-plugins.d.ts

@@ -0,0 +1,5 @@
+import type { DshHostContext } from '../api/dsh.js';
+import type { RouteHandler } from './http.js';
+import type { DshPluginsSnapshot } from '../contract/protocol/dsh-plugins.js';
+export declare function readDshPlugins(ctx: DshHostContext): Promise<DshPluginsSnapshot>;
+export declare function dshPluginsHandler(ctx: DshHostContext): RouteHandler;

package/dist/host/dsh-plugins.js

@@ -0,0 +1,51 @@
+const MANAGER_SERVICE = 'pluginManager';
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+function asArray(value) {
+    if (Array.isArray(value))
+        return value;
+    const record = asRecord(value);
+    if (record === undefined)
+        return [];
+    for (const key of ['rows', 'items', 'list', 'bundles', 'plugins']) {
+        const inner = record[key];
+        if (Array.isArray(inner))
+            return inner;
+    }
+    return [];
+}
+function asText(value) {
+    return typeof value === 'string' ? value : '';
+}
+function rowOf(value) {
+    const record = asRecord(value);
+    if (record === undefined)
+        return undefined;
+    const name = asText(record.name) || asText(record.id);
+    if (name === '')
+        return undefined;
+    return { name, version: asText(record.version), enabled: record.disabled !== true && record.enabled !== false };
+}
+function rowsOf(value) {
+    const rows = [];
+    for (const item of asArray(value)) {
+        const row = rowOf(item);
+        if (row !== undefined)
+            rows.push(row);
+    }
+    return rows;
+}
+export async function readDshPlugins(ctx) {
+    const manager = ctx.get(MANAGER_SERVICE);
+    if (manager === undefined)
+        return { available: false, bundles: [], plugins: [] };
+    const [bundles, plugins] = await Promise.all([
+        manager.listBundles === undefined ? undefined : manager.listBundles(),
+        manager.listPlugins === undefined ? undefined : manager.listPlugins(),
+    ]);
+    return { available: true, bundles: rowsOf(bundles), plugins: rowsOf(plugins) };
+}
+export function dshPluginsHandler(ctx) {
+    return () => readDshPlugins(ctx);
+}

package/dist/host/extension.js

@@ -22,7 +22,7 @@ export function extensionCallerOf(data, need, callerOptions = {}) {
             const code = result.error.pageCode ?? cliCodeOf(result.error.code);
             const command = [need.name, ...args].join(' ');
             const advice = code === 'cli-unclassified'
-                ? `这条命令（${command}）在这份 ${need.name} 插件里可能不存在（插件版本旧就会缺）：用 workbench_modules_update（id=${callerOptions.suiteId ?? need.name}）升级，或在面板的模块状态里点更新，再重试。终端确认：opencli ${need.name} ${args[0] ?? ''} --help`
+                ? `这条命令（${command}）在这份 ${need.name} 插件里可能不存在（插件版本旧就会缺）：用 workbench_modules_update（id=${callerOptions.suiteId ?? need.name}）升级，或在面板的模块状态里点更新，再重试。终端确认：${need.name} ${args[0] ?? ''} --help`
                 : undefined;
             const hint = advice === undefined
                 ? result.error.hint

package/dist/host/flow/check.d.ts

@@ -0,0 +1,9 @@
+import type { FlowActionRegistry, FlowCheck, FlowDefinition } from './types.js';
+/**
+ * 校验一条流程：id / 步骤、动作存在、引用只指前面、重试与轮询在边界内、子流程也照查。
+ * 只做静态检查，不碰平台、不跑动作。
+ * @param flow 流程定义。
+ * @param actions 动作表（只问 `has`）。
+ * @returns 逐条问题；`ok` 为真表示没有。
+ */
+export declare function checkFlow(flow: FlowDefinition, actions: Pick<FlowActionRegistry, 'has'>): FlowCheck;