@dsh-workbench/shared 0.3.11 → 1.0.0-beta.0

package/dist/host/market-index.js

@@ -0,0 +1,420 @@
+import { createHash } from 'node:crypto';
+import { MARKET_INDEX_FORMAT } from '../contract/protocol/market-index.js';
+import { marketText } from '../lib/market-index.js';
+export { marketBranchOk, marketInstallTarget, marketText } from '../lib/market-index.js';
+export const MARKET_INDEX_SEED = '{\n  "format": 1,\n  "plugins": []\n}\n';
+export const MARKET_INDEX_README_LINES = [
+    '# 模块市场索引',
+    '',
+    '这个仓库给 DeepSeek Harness 工作台当模块市场索引：`market.json`（format 1）列出可安装的模块与版本。',
+    '',
+    '## 发布模块',
+    '',
+    '在模块包里运行：',
+    '',
+    '```bash',
+    'dsh-wb-module release --index <本仓库地址> --index-policy artifacts-in-repo',
+    '```',
+    '',
+    '产物会提交到 `packages/<unit>/`，并更新 `market.json`。',
+    '',
+    '## 使用这个索引',
+    '',
+    '在工作台的「模块市场 → 发现」里添加本仓库地址，即可浏览与安装。',
+    '',
+];
+const SEMVER = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+([0-9A-Za-z.-]+))?$/;
+const NPM_NAME = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+const GIT_COMMIT = /^[0-9a-f]{40}$/;
+const MAX_ICON_CHARS = 32 * 1024;
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function asText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function asTextArray(value) {
+    return Array.isArray(value)
+        ? value.flatMap((item) => (typeof item === 'string' && item.trim() !== '' ? [item.trim()] : []))
+        : [];
+}
+function asLocalized(value) {
+    const record = asRecord(value);
+    if (record === undefined)
+        return undefined;
+    const zh = asText(record['zh']);
+    const en = asText(record['en']);
+    return zh === '' && en === '' ? undefined : { ...(zh === '' ? {} : { zh }), ...(en === '' ? {} : { en }) };
+}
+function problem(kind, detail, at) {
+    return { kind, detail, ...(at === undefined ? {} : { at }) };
+}
+export function compareSemver(left, right) {
+    const a = SEMVER.exec(left);
+    const b = SEMVER.exec(right);
+    if (a === null || b === null)
+        return undefined;
+    for (let index = 1; index <= 3; index += 1) {
+        const diff = Number(a[index]) - Number(b[index]);
+        if (diff !== 0)
+            return diff > 0 ? 1 : -1;
+    }
+    const preA = a[4];
+    const preB = b[4];
+    if (preA === undefined && preB === undefined)
+        return 0;
+    if (preA === undefined)
+        return 1;
+    if (preB === undefined)
+        return -1;
+    const leftParts = preA.split('.');
+    const rightParts = preB.split('.');
+    for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+        const one = leftParts[index];
+        const other = rightParts[index];
+        if (one === undefined)
+            return -1;
+        if (other === undefined)
+            return 1;
+        const oneNumber = /^\d+$/.test(one);
+        const otherNumber = /^\d+$/.test(other);
+        if (oneNumber && otherNumber) {
+            const diff = Number(one) - Number(other);
+            if (diff !== 0)
+                return diff > 0 ? 1 : -1;
+            continue;
+        }
+        if (oneNumber)
+            return -1;
+        if (otherNumber)
+            return 1;
+        if (one !== other)
+            return one > other ? 1 : -1;
+    }
+    return 0;
+}
+function sourceOf(raw, at) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return problem('source', 'source 必须是一个对象', at);
+    if (record['type'] === 'npm') {
+        const registry = record['registry'];
+        if (registry !== undefined && asText(registry) === '') {
+            return problem('source', 'npm source 的 registry 必须是非空字符串', at);
+        }
+        return { type: 'npm', ...(registry === undefined ? {} : { registry: asText(registry) }) };
+    }
+    if (record['type'] === 'git') {
+        const url = asText(record['url']);
+        const commit = asText(record['commit']);
+        if (url === '')
+            return problem('source', 'git source 缺 url', at);
+        if (!GIT_COMMIT.test(commit)) {
+            return problem('git-commit', `git source 的 commit 必须是 40 位小写 SHA（现在是 ${JSON.stringify(commit)}）`, at);
+        }
+        const path = record['path'];
+        return {
+            type: 'git',
+            url,
+            commit,
+            ...(path === undefined || asText(path) === '' ? {} : { path: asText(path) }),
+        };
+    }
+    return problem('source', 'source.type 只能是 npm 或 git', at);
+}
+function versionOf(raw, at) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return problem('version', '版本必须是一个对象', at);
+    const version = asText(record['version']);
+    if (!SEMVER.test(version))
+        return problem('version', `版本号不是合法 SemVer：${JSON.stringify(version)}`, at);
+    const source = sourceOf(record['source'], `${at}.source`);
+    if ('kind' in source)
+        return source;
+    const timestamp = record['publishTimestamp'];
+    if (timestamp !== undefined && (!Number.isInteger(timestamp) || timestamp < 0)) {
+        return problem('timestamp', 'publishTimestamp 必须是 Unix 秒整数', at);
+    }
+    const engines = asRecord(record['engines']);
+    const dsh = engines === undefined ? '' : asText(engines['dsh']);
+    return {
+        version,
+        source,
+        ...(timestamp === undefined ? {} : { publishTimestamp: timestamp }),
+        ...(dsh === '' ? {} : { engines: { dsh } }),
+    };
+}
+function versionsOf(raw, at) {
+    if (!Array.isArray(raw) || raw.length === 0)
+        return problem('versions', 'versions 必须是非空数组', at);
+    const versions = [];
+    const seen = new Set();
+    for (const [index, item] of raw.entries()) {
+        const parsed = versionOf(item, `${at}[${String(index)}]`);
+        if ('kind' in parsed)
+            return parsed;
+        if (seen.has(parsed.version))
+            return problem('versions', `版本重复：${parsed.version}`, at);
+        seen.add(parsed.version);
+        versions.push(parsed);
+    }
+    for (let index = 1; index < versions.length; index += 1) {
+        const order = compareSemver(versions[index - 1]?.version ?? '', versions[index]?.version ?? '');
+        if (order === undefined || order < 0) {
+            return problem('version-order', 'versions 必须按 SemVer 降序', at);
+        }
+    }
+    return versions;
+}
+function iconProblem(icon) {
+    if (icon.length > MAX_ICON_CHARS)
+        return problem('icon', 'icon 超过 32 KiB');
+    if (icon.startsWith('data:image/'))
+        return icon.includes(';base64,') ? undefined : problem('icon', 'data URL 必须是 base64');
+    if (/^https?:\/\//i.test(icon))
+        return undefined;
+    return problem('icon', 'icon 只能是 base64 data URL 或 http(s) URL');
+}
+function metadataOf(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return undefined;
+    const category = asText(record['category']);
+    const labels = asTextArray(record['labels']);
+    const keywords = asTextArray(record['keywords']);
+    const sortKeysRecord = asRecord(record['sortKeys']);
+    const sortKeys = sortKeysRecord === undefined
+        ? undefined
+        : Object.fromEntries(Object.entries(sortKeysRecord).flatMap(([key, value]) => typeof value === 'string' || typeof value === 'number' ? [[key, value]] : []));
+    return {
+        ...(category === '' ? {} : { category }),
+        ...(labels.length === 0 ? {} : { labels }),
+        ...(keywords.length === 0 ? {} : { keywords }),
+        ...(sortKeys === undefined || Object.keys(sortKeys).length === 0 ? {} : { sortKeys }),
+    };
+}
+function entryOf(raw, at) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return problem('plugin', '插件条目必须是对象', at);
+    const name = asText(record['name']);
+    if (name === '' || name.length > 214 || !NPM_NAME.test(name)) {
+        return problem('name', `不是合法 npm 包名：${JSON.stringify(name)}`, at);
+    }
+    const versions = versionsOf(record['versions'], `${at}.versions`);
+    if ('kind' in versions)
+        return versions;
+    const icon = asText(record['icon']);
+    if (icon !== '') {
+        const badIcon = iconProblem(icon);
+        if (badIcon !== undefined)
+            return badIcon;
+    }
+    const title = asLocalized(record['title']);
+    const description = asLocalized(record['description']);
+    const author = asText(record['author']);
+    const homepage = asText(record['homepage']);
+    const metadata = metadataOf(record['metadata']);
+    return {
+        name,
+        versions,
+        ...(title === undefined ? {} : { title }),
+        ...(description === undefined ? {} : { description }),
+        ...(author === '' ? {} : { author }),
+        ...(homepage === '' ? {} : { homepage }),
+        ...(icon === '' ? {} : { icon }),
+        ...(metadata === undefined ? {} : { metadata }),
+    };
+}
+export function parseMarketIndex(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return { ok: false, problems: [problem('not-object', '索引必须是一个 JSON 对象')] };
+    if (record['format'] !== MARKET_INDEX_FORMAT) {
+        return {
+            ok: false,
+            problems: [problem('format', `format 必须是 ${String(MARKET_INDEX_FORMAT)}（现在是 ${JSON.stringify(record['format'])}）`)],
+        };
+    }
+    const plugins = record['plugins'];
+    if (!Array.isArray(plugins))
+        return { ok: false, problems: [problem('plugins', 'plugins 必须是数组')] };
+    const entries = [];
+    const problems = [];
+    const seen = new Set();
+    for (const [index, item] of plugins.entries()) {
+        const parsed = entryOf(item, `plugins[${String(index)}]`);
+        if ('kind' in parsed) {
+            problems.push(parsed);
+            continue;
+        }
+        if (seen.has(parsed.name)) {
+            problems.push(problem('duplicate-name', `插件名重复：${parsed.name}`, `plugins[${String(index)}]`));
+            continue;
+        }
+        seen.add(parsed.name);
+        entries.push(parsed);
+    }
+    if (problems.length > 0)
+        return { ok: false, problems };
+    const title = asLocalized(record['title']);
+    const description = asLocalized(record['description']);
+    const metadata = asRecord(record['metadata']);
+    return {
+        ok: true,
+        index: {
+            format: MARKET_INDEX_FORMAT,
+            plugins: entries,
+            ...(title === undefined ? {} : { title }),
+            ...(description === undefined ? {} : { description }),
+            ...(metadata === undefined ? {} : { metadata: metadata }),
+        },
+    };
+}
+export function parseMarketIndexJson(text) {
+    try {
+        return parseMarketIndex(JSON.parse(text));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            problems: [problem('not-json', `JSON 解析失败：${error instanceof Error ? error.message : String(error)}`)],
+        };
+    }
+}
+export function sortMarketVersions(versions) {
+    return [...versions].sort((left, right) => (compareSemver(right.version, left.version) ?? 0));
+}
+export function upsertMarketEntry(index, entry) {
+    const found = index.plugins.findIndex((item) => item.name === entry.name);
+    if (found === -1)
+        return { ...index, plugins: [...index.plugins, entry] };
+    const current = index.plugins[found];
+    if (current === undefined)
+        return { ...index, plugins: [...index.plugins, entry] };
+    const merged = new Map();
+    for (const one of current.versions)
+        merged.set(one.version, one);
+    for (const one of entry.versions)
+        merged.set(one.version, one);
+    const plugins = [...index.plugins];
+    plugins[found] = { ...current, ...entry, versions: sortMarketVersions([...merged.values()]) };
+    return { ...index, plugins };
+}
+export function marketEntryLabels(entry) {
+    return entry.metadata?.labels ?? [];
+}
+export function filterMarketIndex(index, filter) {
+    const query = (filter.query ?? '').trim().toLowerCase();
+    const category = (filter.category ?? '').trim();
+    const label = (filter.label ?? '').trim();
+    return index.plugins.filter((entry) => {
+        if (category !== '' && entry.metadata?.category !== category)
+            return false;
+        if (label !== '' && !marketEntryLabels(entry).includes(label))
+            return false;
+        if (query === '')
+            return true;
+        const haystack = [
+            entry.name,
+            marketText(entry.title, 'zh'),
+            marketText(entry.title, 'en'),
+            marketText(entry.description, 'zh'),
+            marketText(entry.description, 'en'),
+            entry.author ?? '',
+            ...(entry.metadata?.keywords ?? []),
+        ]
+            .join(' ')
+            .toLowerCase();
+        return haystack.includes(query);
+    });
+}
+export function marketSourceKey(source) {
+    const canonical = JSON.stringify([source.kind, source.url.trim(), source.ref ?? '', source.path ?? '']);
+    return createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+}
+export function parseSourceConfig(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return { ok: false, problem: problem('source', '索引源必须是对象') };
+    const id = asText(record['id']);
+    const label = asText(record['label']);
+    const kind = record['kind'];
+    const url = asText(record['url']);
+    if (id === '')
+        return { ok: false, problem: problem('source', '索引源缺 id') };
+    if (label === '')
+        return { ok: false, problem: problem('source', '索引源缺 label') };
+    if (kind !== 'http' && kind !== 'git')
+        return { ok: false, problem: problem('source', 'kind 只能是 http 或 git') };
+    if (kind === 'http') {
+        const bad = httpUrlProblem(url);
+        if (bad !== undefined)
+            return { ok: false, problem: problem('source', bad) };
+        return { ok: true, source: { id, label, kind, url } };
+    }
+    if (!gitUrlOk(url)) {
+        return { ok: false, problem: problem('source', 'git 地址不合格（只收 https / ssh / scp 形式，且不能带凭据）') };
+    }
+    const ref = asText(record['ref']);
+    const path = asText(record['path']);
+    const localPath = asText(record['localPath']);
+    const policy = record['policy'];
+    if (policy !== undefined && policy !== 'artifacts-in-repo' && policy !== 'catalog-only') {
+        return { ok: false, problem: problem('source', 'policy 只能是 artifacts-in-repo 或 catalog-only') };
+    }
+    return {
+        ok: true,
+        source: {
+            id,
+            label,
+            kind,
+            url,
+            ...(ref === '' ? {} : { ref }),
+            ...(path === '' ? {} : { path }),
+            ...(localPath === '' ? {} : { localPath }),
+            ...(policy === undefined ? {} : { policy: policy }),
+        },
+    };
+}
+export function httpUrlProblem(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return '不是合法 URL';
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        return '只收 http / https';
+    if (parsed.username !== '' || parsed.password !== '')
+        return 'URL 不能带凭据';
+    if (parsed.search !== '' || parsed.hash !== '')
+        return 'URL 不能带 query / fragment';
+    return undefined;
+}
+export function gitUrlOk(url) {
+    if (url === '')
+        return false;
+    if (/^[^@\s]+@[^@\s:]+:[^@\s]+$/.test(url))
+        return true;
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'ssh:' && parsed.protocol !== 'http:')
+        return false;
+    if (parsed.password !== '')
+        return false;
+    if (parsed.username !== '' && parsed.protocol !== 'ssh:')
+        return false;
+    if (parsed.search !== '' || parsed.hash !== '')
+        return false;
+    return true;
+}

package/dist/host/needs.d.ts

@@ -0,0 +1,4 @@
+export type { NeedKindSpec as NeedKindSpecOf } from '../contract/needs.js';
+export type NeedProbe = 'bin' | 'extension' | 'package' | 'env';
+export { NEED_KIND_SPECS } from '../contract/needs.js';
+export declare const NEED_PROBES: readonly NeedProbe[];

package/dist/host/needs.js

@@ -0,0 +1,2 @@
+export { NEED_KIND_SPECS } from '../contract/needs.js';
+export const NEED_PROBES = ['bin', 'extension', 'package', 'env'];

package/dist/host/patch.d.ts

@@ -0,0 +1,9 @@
+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 writePatchFile(path: string, text: string): void;

package/dist/host/patch.js

@@ -0,0 +1,78 @@
+import { renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+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#]+)/;
+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);
+}
+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;
+    }
+}

package/dist/host/paths.d.ts

@@ -0,0 +1,12 @@
+export declare function isolatedRoot(): string;
+export declare function isolatedHome(): string;
+export declare function vendorPrefix(): string;
+export declare function vendorPluginsDir(): string;
+export declare function libsPrefix(): string;
+export declare const OPENCLI_NPM_PACKAGE = "@jackwener/opencli";
+export declare function toolchainOpencliDir(): string;
+export declare function vendorPeerLink(): {
+    readonly dir: string;
+    readonly parent: string;
+};
+export declare function npmCacheDir(): string;

package/dist/host/paths.js

@@ -0,0 +1,28 @@
+import { workbenchRoot } from './data-root.js';
+export function isolatedRoot() {
+    return `${workbenchRoot()}/opencli`;
+}
+export function isolatedHome() {
+    return `${isolatedRoot()}/home`;
+}
+export function vendorPrefix() {
+    return `${isolatedRoot()}/plugins-npm`;
+}
+export function vendorPluginsDir() {
+    return `${vendorPrefix()}/node_modules`;
+}
+export function libsPrefix() {
+    return `${isolatedRoot()}/libs`;
+}
+export const OPENCLI_NPM_PACKAGE = '@jackwener/opencli';
+export function toolchainOpencliDir() {
+    return `${isolatedRoot()}/toolchain/node_modules/${OPENCLI_NPM_PACKAGE}`;
+}
+export function vendorPeerLink() {
+    const base = `${vendorPrefix()}/node_modules`;
+    const [scope] = OPENCLI_NPM_PACKAGE.split('/');
+    return { dir: `${base}/${OPENCLI_NPM_PACKAGE}`, parent: `${base}/${scope}` };
+}
+export function npmCacheDir() {
+    return `${isolatedRoot()}/npm-cache`;
+}

package/dist/host/platform.d.ts

@@ -0,0 +1,14 @@
+import type { HostOs, HostSurface, ProfileName } from '../contract/protocol/platform.js';
+export interface HostSurfaceInput {
+    readonly proc?: {
+        readonly versions: {
+            readonly electron?: string | undefined;
+            readonly node?: string | undefined;
+        };
+    };
+    readonly profile?: string | undefined;
+    readonly platform?: NodeJS.Platform | undefined;
+}
+export declare function profileNameOf(raw: string | undefined): ProfileName;
+export declare function hostOsOf(platform: NodeJS.Platform): HostOs;
+export declare function hostSurface(input?: HostSurfaceInput): HostSurface;

package/dist/host/platform.js

@@ -0,0 +1,40 @@
+export function profileNameOf(raw) {
+    const name = (raw ?? '').split(/[\\/]/).pop()?.toLowerCase() ?? '';
+    if (name === 'desktop' || name === 'web' || name === 'workbench' || name === 'headless')
+        return name;
+    return 'other';
+}
+export function hostOsOf(platform) {
+    if (platform === 'darwin' || platform === 'win32' || platform === 'linux')
+        return platform;
+    return 'other';
+}
+export function hostSurface(input = {}) {
+    const proc = input.proc ?? process;
+    const runtime = proc.versions.electron === undefined ? 'node' : 'electron';
+    const deployment = runtime === 'electron' ? 'desktop' : 'web';
+    const profile = profileNameOf(input.profile);
+    const hostOs = hostOsOf(input.platform ?? process.platform);
+    const pageDebug = deployment !== 'desktop';
+    const selfUpdateCli = profile === 'desktop' ? 'desktop-cli' : 'path-dsh';
+    return {
+        deployment,
+        hostOs,
+        runtime,
+        profile,
+        capabilities: {
+            pageDebug,
+            siteExplore: true,
+            recording: true,
+            browserWake: deployment === 'desktop',
+            selfUpdateCli,
+            safeMode: deployment === 'desktop',
+        },
+        restartHint: deployment === 'desktop' ? '退出并重开 Desktop' : '重启一次 dsh',
+        toolchain: {
+            node: { source: deployment === 'desktop' ? 'desktop-shim' : 'path' },
+            npm: { neededFor: 'opencli-install' },
+            pnpm: { neededFor: 'workshop', expectedMajor: 10 },
+        },
+    };
+}

package/dist/host/plugin-source.d.ts

@@ -1,5 +1,6 @@
-import type { PluginSource } from '../api/unit.js';
-export type PluginSourceProblem = "not-declared" | "env-missing" | "malformed";
+import type { SupplySource } from '../contract/needs.js';
+import type { ProvisionProblem } from '../contract/plugin-source.js';
+export type { ProvisionProblem } from '../contract/plugin-source.js';
 export interface PluginSourceCommand {
     readonly line: string;
     readonly optional?: true;
@@ -10,22 +11,23 @@ export type ResolvedPluginSource = {
     readonly line: string;
 } | {
     readonly ok: false;
-    readonly problem: PluginSourceProblem;
+    readonly problem: ProvisionProblem;
     readonly env?: string;
 };
 export interface PluginSourceOptions {
     readonly command?: string;
     readonly plugin?: string;
     readonly version?: string;
-    readonly mode?: "install" | "update";
+    readonly mode?: 'install' | 'update';
 }
 export declare function npmRegistryOf(source: {
-    readonly registryEnv: string;
+    readonly registryEnv?: string;
     readonly registryDefault?: string;
 }, env: Readonly<Record<string, string | undefined>>): {
     readonly ok: true;
     readonly value: string;
 } | {
     readonly ok: false;
+    readonly env: string;
 };
-export declare function resolvePluginSource(source: PluginSource | undefined, env: Readonly<Record<string, string | undefined>>, options?: PluginSourceOptions): ResolvedPluginSource;
+export declare function resolvePluginSource(source: SupplySource | undefined, env: Readonly<Record<string, string | undefined>>, options?: PluginSourceOptions): ResolvedPluginSource;