@dsh-workbench/shared 1.1.7 → 1.1.9

package/dist/host/local-declaration.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { localDirOf } from './spec.js';
+export { localDirOf };
+import { declarationProblemsOf } from '../contract/unit-declaration.js';
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+export function packageManifestOf(dir) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+        return asRecord(parsed);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function dshRecordOf(dir) {
+    return packageManifestOf(dir)?.dsh;
+}
+export function packageNameOf(dir) {
+    const name = packageManifestOf(dir)?.name;
+    return typeof name === 'string' && name.trim() !== '' ? name.trim() : undefined;
+}
+export function pathDeclarationOf(spec) {
+    const dir = localDirOf(spec);
+    return dir === undefined ? undefined : asRecord(dshRecordOf(dir))?.workbench;
+}
+export function declarationRefusalOf(name, raw) {
+    if (raw === undefined)
+        return [];
+    return declarationProblemsOf(name, raw);
+}

package/dist/host/market-index-claim.d.ts

@@ -15,6 +15,5 @@ export interface MarketClaimInput {
 }
 export declare function marketArtifactPath(name: string): string;
 export declare function marketArtifactRoot(name: string): string;
-export declare function marketArtifactPathFor(name: string, version: string): string;
 export declare function entryUnitOf(entry: MarketIndexEntry): string | undefined;
 export declare function claimOf(index: MarketIndex, input: MarketClaimInput): MarketClaim;

package/dist/host/market-index-claim.js

@@ -45,9 +45,6 @@ export function marketArtifactPath(name) {
 export function marketArtifactRoot(name) {
     return `${MARKET_ARTIFACTS_DIR}/${name}`;
 }
-export function marketArtifactPathFor(name, version) {
-    return `${MARKET_ARTIFACTS_DIR}/${name}/${version}`;
-}
 export function entryUnitOf(entry) {
     const unit = entry.metadata?.unit?.trim();
     if (unit !== undefined && unit !== '')

package/dist/host/market-index-doc.d.ts

@@ -1,38 +1,4 @@
-import type { MarketIndex, MarketIndexEngines, MarketIndexEntryMetadata, MarketIndexProblem, MarketIndexSource, MarketLocalizedText } from '../contract/protocol/market-index.js';
-export interface MarketVersionDoc {
-    readonly name: string;
-    readonly version: string;
-    readonly source: MarketIndexSource;
-    readonly publishTimestamp?: number;
-    readonly engines?: MarketIndexEngines;
-    readonly title?: MarketLocalizedText;
-    readonly description?: MarketLocalizedText;
-    readonly author?: string;
-    readonly owner?: string;
-    readonly homepage?: string;
-    readonly icon?: string;
-    readonly metadata?: MarketIndexEntryMetadata;
-}
-export interface MarketMetaDoc {
-    readonly name: string;
-    readonly epoch?: number;
-    readonly publishTimestamp: number;
-    readonly title?: MarketLocalizedText;
-    readonly description?: MarketLocalizedText;
-    readonly author?: string;
-    readonly owner?: string;
-    readonly homepage?: string;
-    readonly icon?: string;
-    readonly metadata?: MarketIndexEntryMetadata;
-}
-export type MarketEntryDoc = MarketVersionDoc | MarketMetaDoc;
-export type MarketEntryDocParse = {
-    readonly ok: true;
-    readonly doc: MarketEntryDoc;
-} | {
-    readonly ok: false;
-    readonly problems: readonly MarketIndexProblem[];
-};
+import type { MarketIndex, MarketIndexProblem } from '../contract/protocol/market-index.js';
 export interface MarketEntryFile {
     readonly path: string;
     readonly text: string;
@@ -44,13 +10,3 @@ export type MarketIndexAssemble = {
     readonly ok: false;
     readonly problems: readonly MarketIndexProblem[];
 };
-export interface MarketDocFields {
-    readonly name: string;
-    readonly title?: MarketLocalizedText;
-    readonly description?: MarketLocalizedText;
-    readonly author?: string;
-    readonly owner?: string;
-    readonly homepage?: string;
-    readonly icon?: string;
-    readonly metadata?: MarketIndexEntryMetadata;
-}

package/dist/host/market-index-parse.d.ts

@@ -1,5 +1,4 @@
 import type { DiscoverFilter, IndexSourceSpec, MarketIndex, MarketIndexEntry, MarketIndexParse, MarketIndexProblem, MarketIndexVersion, MarketSourceConfig } from '../contract/protocol/market-index.js';
-import type { MarketEntryDocParse } from './market-index-doc.js';
 export declare function compareSemver(left: string, right: string): number | undefined;
 export declare function httpUrlProblem(url: string): string | undefined;
 export declare function gitUrlOk(url: string): boolean;
@@ -18,6 +17,12 @@ export type SourceConfigParse = {
     readonly problem: MarketIndexProblem;
 };
 export declare function parseSourceConfig(raw: unknown): SourceConfigParse;
-export declare function parseMarketEntryDoc(raw: unknown): MarketEntryDocParse;
-export declare function marketEntryPath(dir: string, name: string, version: string): string;
-export declare function marketMetaPath(dir: string, name: string, epoch: number, suffix: string): string;
+export declare function marketEntryPath(dir: string, name: string): string;
+export type MarketEntryParse = {
+    readonly ok: true;
+    readonly entry: MarketIndexEntry;
+} | {
+    readonly ok: false;
+    readonly problems: readonly MarketIndexProblem[];
+};
+export declare function parseMarketEntryJson(text: string): MarketEntryParse;

package/dist/host/market-index-parse.js

@@ -384,102 +384,27 @@ export function parseSourceConfig(raw) {
         },
     };
 }
-function docFieldsOf(record, at) {
-    const name = asText(record['name']);
-    if (name === '' || name.length > 214 || !NPM_NAME.test(name)) {
-        return problem('name', `不是合法 npm 包名：${JSON.stringify(name)}`, at);
-    }
-    const icon = asText(record['icon']);
-    if (icon !== '') {
-        const badIcon = iconProblem(icon);
-        if (badIcon !== undefined)
-            return badIcon;
-    }
-    const owner = asText(record['owner']);
-    if (owner !== '') {
-        const badOwner = ownerProblem(owner);
-        if (badOwner !== undefined)
-            return badOwner;
-    }
-    const metadata = metadataOf(record['metadata']);
-    if (metadata?.unit !== undefined && !UNIT_ID.test(metadata.unit)) {
-        return problem('unit', `metadata.unit 只能是小写字母开头的 a-z0-9-（现在是 ${JSON.stringify(metadata.unit)}）`, at);
-    }
-    const title = asLocalized(record['title']);
-    const description = asLocalized(record['description']);
-    const author = asText(record['author']);
-    const homepage = asText(record['homepage']);
-    return {
-        name,
-        ...(title === undefined ? {} : { title }),
-        ...(description === undefined ? {} : { description }),
-        ...(author === '' ? {} : { author }),
-        ...(owner === '' ? {} : { owner }),
-        ...(homepage === '' ? {} : { homepage }),
-        ...(icon === '' ? {} : { icon }),
-        ...(metadata === undefined ? {} : { metadata }),
-    };
-}
-export function parseMarketEntryDoc(raw) {
-    const record = asRecord(raw);
-    if (record === undefined)
-        return { ok: false, problems: [problem('entry', '条目文件必须是一个 JSON 对象')] };
-    const fields = docFieldsOf(record, 'entry');
-    if ('kind' in fields)
-        return { ok: false, problems: [fields] };
-    const version = asText(record['version']);
-    const timestamp = record['publishTimestamp'];
-    if (timestamp !== undefined && (!Number.isInteger(timestamp) || timestamp < 0)) {
-        return { ok: false, problems: [problem('timestamp', 'publishTimestamp 必须是 Unix 秒整数', 'entry')] };
-    }
-    if (version === '') {
-        if (timestamp === undefined) {
-            return { ok: false, problems: [problem('timestamp', '元数据文件要有 publishTimestamp', 'entry')] };
-        }
-        const epoch = record['epoch'];
-        if (epoch !== undefined && (!Number.isInteger(epoch) || epoch < 0)) {
-            return { ok: false, problems: [problem('timestamp', 'epoch 必须是非负整数', 'entry')] };
-        }
-        return {
-            ok: true,
-            doc: { ...fields, publishTimestamp: timestamp, ...(epoch === undefined ? {} : { epoch: epoch }) },
-        };
-    }
-    if (!isValidVersion(version)) {
-        return { ok: false, problems: [problem('version', `版本号不是合法 SemVer：${JSON.stringify(version)}`, 'entry')] };
-    }
-    const source = sourceOf(record['source'], 'entry.source');
-    if ('kind' in source)
-        return { ok: false, problems: [source] };
-    const engines = asRecord(record['engines']);
-    const dsh = engines === undefined ? '' : asText(engines['dsh']);
-    return {
-        ok: true,
-        doc: {
-            ...fields,
-            version,
-            source,
-            ...(timestamp === undefined ? {} : { publishTimestamp: timestamp }),
-            ...(dsh === '' ? {} : { engines: { dsh } }),
-        },
-    };
-}
 function indexPathBase(dir) {
     return dir.replace(/^\/+|\/+$/g, '') || MARKET_INDEX_DIR;
 }
-export function marketEntryPath(dir, name, version) {
+export function marketEntryPath(dir, name) {
     if (!NPM_NAME.test(name))
         throw new Error(`不是合法包名：${JSON.stringify(name)}`);
-    if (!isValidVersion(version))
-        throw new Error(`不是合法版本号：${JSON.stringify(version)}`);
-    return `${indexPathBase(dir)}/${name}/${version}.json`;
+    return `${indexPathBase(dir)}/${name}.json`;
 }
-export function marketMetaPath(dir, name, epoch, suffix) {
-    if (!NPM_NAME.test(name))
-        throw new Error(`不是合法包名：${JSON.stringify(name)}`);
-    if (!Number.isInteger(epoch) || epoch < 0)
-        throw new Error(`epoch 不合法：${String(epoch)}`);
-    if (!/^[a-z0-9]{4,16}$/u.test(suffix))
-        throw new Error(`后缀不合法：${suffix}`);
-    return `${indexPathBase(dir)}/${name}/meta-${String(epoch)}-${suffix}.json`;
+export function parseMarketEntryJson(text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            problems: [problem('not-json', `JSON 解析失败：${error instanceof Error ? error.message : String(error)}`, 'entry')],
+        };
+    }
+    const parsed = entryOf(raw, 'entry');
+    if ('kind' in parsed)
+        return { ok: false, problems: [parsed] };
+    return { ok: true, entry: parsed };
 }

package/dist/host/market-index.d.ts

@@ -1,14 +1,13 @@
-import type { MarketIndex, MarketIndexEntry, MarketIndexVersion } from '../contract/protocol/market-index.js';
-import type { MarketEntryFile, MarketIndexAssemble, MarketMetaDoc, MarketVersionDoc } from './market-index-doc.js';
+import type { MarketIndex, MarketIndexEntry } from '../contract/protocol/market-index.js';
+import type { MarketEntryFile, MarketIndexAssemble } from './market-index-doc.js';
 export declare const MARKET_ENTRIES_README_LINES: readonly string[];
 export declare const MARKET_INDEX_README_LINES: readonly string[];
 export { marketBranchOk, marketInstallTarget, marketText } from '../lib/market-index.js';
-export type { MarketEntryDoc, MarketEntryDocParse, MarketEntryFile, MarketIndexAssemble, MarketMetaDoc, MarketVersionDoc, } from './market-index-doc.js';
-export { compareSemver, filterMarketIndex, gitUrlOk, httpUrlProblem, marketEntryLabels, marketEntryPath, marketMetaPath, marketSourceKey, parseMarketEntryDoc, parseMarketIndex, parseMarketIndexJson, parseSourceConfig, sortMarketVersions, upsertMarketEntry, } from './market-index-parse.js';
+export type { MarketEntryFile, MarketIndexAssemble } from './market-index-doc.js';
+export { compareSemver, filterMarketIndex, gitUrlOk, httpUrlProblem, marketEntryLabels, marketEntryPath, marketSourceKey, parseMarketEntryJson, parseMarketIndex, parseMarketIndexJson, parseSourceConfig, sortMarketVersions, upsertMarketEntry, } from './market-index-parse.js';
 export type { SourceConfigParse } from './market-index-parse.js';
-export declare function marketVersionDocOf(entry: MarketIndexEntry, version: MarketIndexVersion): MarketVersionDoc;
-export declare function marketMetaDocOf(entry: MarketIndexEntry, epoch: number, at: number): MarketMetaDoc;
 export declare function assembleMarketIndex(files: readonly MarketEntryFile[]): MarketIndexAssemble;
+export declare function marketEntryFileOf(entry: MarketIndexEntry, dir?: string): MarketEntryFile;
 export declare function marketEntryFilesOf(index: MarketIndex, dir?: string): readonly MarketEntryFile[];
 export declare function collectMarketEntryFiles(dir: string): readonly MarketEntryFile[];
 export declare function marketEntryFilesOfLegacy(text: string, dir?: string): readonly MarketEntryFile[] | undefined;

package/dist/host/market-index.js

@@ -1,18 +1,22 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join, relative, sep } from 'node:path';
 import { MARKET_INDEX_DIR, MARKET_INDEX_FORMAT } from '../contract/protocol/market-index.js';
-import { marketEntryPath, parseMarketEntryDoc, parseMarketIndexJson, sortMarketVersions, } from './market-index-parse.js';
+import { entryUnitOf } from './market-index-claim.js';
+import { marketEntryPath, parseMarketEntryJson, parseMarketIndexJson, sortMarketVersions } from './market-index-parse.js';
 export const MARKET_ENTRIES_README_LINES = [
     '# 索引目录',
     '',
-    '一个包一个目录，一个版本一个文件：`market/<包名>/<版本>.json`；产物在 `artifacts/<包名>/<版本>/`。',
+    '一个包一个文件：`market/<包名>.json`，里面是这一个包的元数据与所有版本；',
     '',
-    '`meta-<epoch>-<随机后缀>.json` 是只改标题 / 署名 / 说明时追加的元数据快照，读取时按 epoch 取最新的一份。',
+    '产物在 `artifacts/<包名>/`（只放最新一版，老版本按条目里的 commit 取历史）。',
+    '',
+    '发布时只改自己包的文件；包与包之间不共享文件。',
 ];
 export const MARKET_INDEX_README_LINES = [
     '# 模块市场索引',
     '',
-    '这个仓库给 DeepSeek Harness 工作台当模块市场索引：条目在 `market/<包名>/<版本>.json`，产物在 `artifacts/<包名>/<版本>/`。',
+    '这个仓库给 DeepSeek Harness 工作台当模块市场索引：一个包一个文件 `market/<包名>.json`，',
+    '产物在 `artifacts/<包名>/`；老仓库的 `market.json` 会在第一次发布时自动拆开。',
     '',
     '## 发布模块',
     '',
@@ -22,8 +26,7 @@ export const MARKET_INDEX_README_LINES = [
     'dsh-wb-module release --index <本仓库地址> --index-policy artifacts-in-repo',
     '```',
     '',
-    '产物会提交到 `artifacts/<包名>/<版本>/`，条目提交到 `market/<包名>/<版本>.json`。',
-    '发布只新增文件、不改已有文件，两台机器同时发也不会冲突；老条目的 `packages/<包名>/` 路径继续可用。',
+    '发布只会改自己包的那一个文件；包与包之间不会碰同一个文件。',
     '',
     '一个包名归第一次发布的人（条目文件里的 `owner`）。换一个署名发同名会被拒；要换人，先把这一条的 `owner` 改成新的人。',
     '同一个市场里，一个模块 id（`metadata.unit`）只能被一个条目使用；另一个包名想用同一个 id / 产物目录也会被拒。',
@@ -34,107 +37,46 @@ export const MARKET_INDEX_README_LINES = [
     '',
 ];
 export { marketBranchOk, marketInstallTarget, marketText } from '../lib/market-index.js';
-export { compareSemver, filterMarketIndex, gitUrlOk, httpUrlProblem, marketEntryLabels, marketEntryPath, marketMetaPath, marketSourceKey, parseMarketEntryDoc, parseMarketIndex, parseMarketIndexJson, parseSourceConfig, sortMarketVersions, upsertMarketEntry, } from './market-index-parse.js';
+export { compareSemver, filterMarketIndex, gitUrlOk, httpUrlProblem, marketEntryLabels, marketEntryPath, marketSourceKey, parseMarketEntryJson, parseMarketIndex, parseMarketIndexJson, parseSourceConfig, sortMarketVersions, upsertMarketEntry, } from './market-index-parse.js';
 function problem(kind, detail, at) {
     return { kind, detail, ...(at === undefined ? {} : { at }) };
 }
-function docFieldsFromEntry(entry) {
-    return {
-        name: entry.name,
-        ...(entry.title === undefined ? {} : { title: entry.title }),
-        ...(entry.description === undefined ? {} : { description: entry.description }),
-        ...(entry.author === undefined ? {} : { author: entry.author }),
-        ...(entry.owner === undefined ? {} : { owner: entry.owner }),
-        ...(entry.homepage === undefined ? {} : { homepage: entry.homepage }),
-        ...(entry.icon === undefined ? {} : { icon: entry.icon }),
-        ...(entry.metadata === undefined ? {} : { metadata: entry.metadata }),
-    };
-}
-export function marketVersionDocOf(entry, version) {
-    return { ...docFieldsFromEntry(entry), ...version };
-}
-export function marketMetaDocOf(entry, epoch, at) {
-    return { ...docFieldsFromEntry(entry), epoch, publishTimestamp: at };
-}
 export function assembleMarketIndex(files) {
     const problems = [];
-    const groups = new Map();
+    const entries = new Map();
     const ordered = [...files].sort((left, right) => (left.path < right.path ? -1 : left.path > right.path ? 1 : 0));
     for (const file of ordered) {
-        let raw;
-        try {
-            raw = JSON.parse(file.text);
-        }
-        catch (error) {
-            problems.push(problem('not-json', `JSON 解析失败：${error instanceof Error ? error.message : String(error)}`, file.path));
+        if (!file.path.endsWith('.json'))
             continue;
-        }
-        const parsed = parseMarketEntryDoc(raw);
+        const parsed = parseMarketEntryJson(file.text);
         if (!parsed.ok) {
             for (const one of parsed.problems)
                 problems.push({ ...one, at: file.path });
             continue;
         }
-        const doc = parsed.doc;
-        const group = groups.get(doc.name) ?? { versions: new Map(), meta: undefined, fallback: undefined };
-        const at = doc.publishTimestamp ?? 0;
-        if ('version' in doc) {
-            if (group.versions.has(doc.version)) {
-                problems.push(problem('duplicate-version', `版本重复：${doc.version}`, file.path));
-            }
-            group.versions.set(doc.version, {
-                version: doc.version,
-                source: doc.source,
-                ...(doc.publishTimestamp === undefined ? {} : { publishTimestamp: doc.publishTimestamp }),
-                ...(doc.engines === undefined ? {} : { engines: doc.engines }),
-            });
-            const newerFallback = group.fallback === undefined ||
-                at > group.fallback.at ||
-                (at === group.fallback.at && file.path > group.fallback.path);
-            if (newerFallback)
-                group.fallback = { at, path: file.path, doc };
-        }
-        else {
-            const epoch = doc.epoch ?? 0;
-            const newer = group.meta === undefined ||
-                epoch > group.meta.epoch ||
-                (epoch === group.meta.epoch && at > group.meta.at) ||
-                (epoch === group.meta.epoch && at === group.meta.at && file.path > group.meta.path);
-            if (newer)
-                group.meta = { epoch, at, path: file.path, doc };
+        const entry = parsed.entry;
+        if (entries.has(entry.name)) {
+            problems.push(problem('duplicate-name', `插件名重复：${entry.name}`, file.path));
+            continue;
         }
-        groups.set(doc.name, group);
+        entries.set(entry.name, { ...entry, versions: sortMarketVersions(entry.versions) });
     }
     if (problems.length > 0)
         return { ok: false, problems };
-    const plugins = [...groups.entries()].map(([name, group]) => {
-        const meta = group.meta?.doc ?? group.fallback?.doc;
-        return {
-            name,
-            versions: sortMarketVersions([...group.versions.values()]),
-            ...(meta?.title === undefined ? {} : { title: meta.title }),
-            ...(meta?.description === undefined ? {} : { description: meta.description }),
-            ...(meta?.author === undefined ? {} : { author: meta.author }),
-            ...(meta?.owner === undefined ? {} : { owner: meta.owner }),
-            ...(meta?.homepage === undefined ? {} : { homepage: meta.homepage }),
-            ...(meta?.icon === undefined ? {} : { icon: meta.icon }),
-            ...(meta?.metadata === undefined ? {} : { metadata: meta.metadata }),
-        };
-    });
-    plugins.sort((left, right) => (left.name < right.name ? -1 : left.name > right.name ? 1 : 0));
+    const plugins = [...entries.values()].sort((left, right) => (left.name < right.name ? -1 : left.name > right.name ? 1 : 0));
     return { ok: true, index: { format: MARKET_INDEX_FORMAT, plugins } };
 }
+export function marketEntryFileOf(entry, dir = MARKET_INDEX_DIR) {
+    return { path: marketEntryPath(dir, entry.name), text: `${JSON.stringify(entry, null, 2)}\n` };
+}
 export function marketEntryFilesOf(index, dir = MARKET_INDEX_DIR) {
-    const files = [];
-    for (const entry of index.plugins) {
-        for (const version of entry.versions) {
-            files.push({
-                path: marketEntryPath(dir, entry.name, version.version),
-                text: `${JSON.stringify(marketVersionDocOf(entry, version), null, 2)}\n`,
-            });
-        }
-    }
-    return files;
+    return index.plugins.map((entry) => marketEntryFileOf(healedUnit(entry), dir));
+}
+function healedUnit(entry) {
+    if (entry.metadata?.unit !== undefined)
+        return entry;
+    const unit = entryUnitOf(entry);
+    return unit === undefined ? entry : { ...entry, metadata: { ...entry.metadata, unit } };
 }
 export function collectMarketEntryFiles(dir) {
     if (!existsSync(dir))

package/dist/host/module-root.d.ts

@@ -0,0 +1 @@
+export declare function packageRootOf(moduleUrl: string): string;

package/dist/host/module-root.js

@@ -0,0 +1,5 @@
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function packageRootOf(moduleUrl) {
+    return dirname(dirname(dirname(fileURLToPath(moduleUrl))));
+}

package/dist/host/npm-registry.d.ts

@@ -0,0 +1,10 @@
+export declare function npmRegistryOf(source: {
+    readonly registryEnv?: string;
+    readonly registryDefault?: string;
+}, env: Readonly<Record<string, string | undefined>>): {
+    readonly ok: true;
+    readonly value: string;
+} | {
+    readonly ok: false;
+    readonly env: string;
+};

package/dist/host/npm-registry.js

@@ -0,0 +1,16 @@
+function envValue(env, name) {
+    const value = env[name]?.trim();
+    return value === undefined || value === '' ? { ok: false } : { ok: true, value };
+}
+export function npmRegistryOf(source, env) {
+    const name = source.registryEnv ?? '';
+    if (name !== '') {
+        const fromEnv = envValue(env, name);
+        if (fromEnv.ok)
+            return fromEnv;
+    }
+    const fallback = source.registryDefault?.trim();
+    if (fallback === undefined || fallback === '')
+        return { ok: false, env: name };
+    return { ok: true, value: fallback };
+}

package/dist/host/opencli-runner.d.ts

@@ -2,9 +2,10 @@ import type { DataRequest, DataResult } from '../contract/data.js';
 /**
  * 一条 opencli 命令的执行器：同一形状的 `execFile('opencli', args)`，结果只留 stdout。
  */
-export type OpencliRunner = (args: readonly string[]) => Promise<{
+export type LibRunner = (args: readonly string[]) => Promise<{
     readonly stdout: string;
 }>;
+export type OpencliRunner = LibRunner;
 /**
  * 读缝（`DataReader.read`）的形状；模块直接把自己的 `data.read` 传进来即可。
  */

package/dist/host/package-content.d.ts

@@ -0,0 +1,7 @@
+import type { DshShell } from '../api/dsh.js';
+export declare function withPackageDir<T>(options: {
+    readonly shell?: DshShell | undefined;
+    readonly spec: string;
+    readonly registry?: string | undefined;
+    readonly cacheDir?: string | undefined;
+}, visit: (dir: string) => T): Promise<T | undefined>;

package/dist/host/package-content.js

@@ -0,0 +1,69 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { INSTALL_TIMEOUT_MS } from '../config/constants.js';
+import { parseJsonLoose } from '../lib/text.js';
+import { quoteShellArg } from './shell-text.js';
+import { runShell } from './shell.js';
+import { splitNpmSpec } from './package-kind.js';
+import { localDirOf } from './local-declaration.js';
+function cacheFlag(cacheDir) {
+    return cacheDir === undefined ? '' : ` --cache ${quoteShellArg(cacheDir)}`;
+}
+function packedFileFrom(stdout, root) {
+    const parsed = parseJsonLoose(stdout);
+    if (Array.isArray(parsed)) {
+        const first = parsed[0];
+        const filename = typeof first === 'object' && first !== null ? first.filename : undefined;
+        if (typeof filename === 'string' && filename.trim() !== '') {
+            const at = path.join(root, path.basename(filename.trim()));
+            if (fs.existsSync(at))
+                return at;
+        }
+    }
+    try {
+        const found = fs.readdirSync(root).filter((name) => name.endsWith('.tgz'));
+        return found.length === 1 ? path.join(root, found[0] ?? '') : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function withPackageDir(options, visit) {
+    const local = localDirOf(options.spec);
+    if (local !== undefined)
+        return visit(local);
+    if (splitNpmSpec(options.spec) === undefined)
+        return undefined;
+    const shell = options.shell;
+    if (shell === undefined)
+        return undefined;
+    let root;
+    try {
+        root = fs.mkdtempSync(path.join(os.tmpdir(), 'wb-package-'));
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const at = options.registry === undefined ? '' : ` --registry ${quoteShellArg(options.registry)}`;
+        const packed = await runShell(shell, `npm pack ${quoteShellArg(options.spec)} --ignore-scripts --json --pack-destination ${quoteShellArg(root)}${cacheFlag(options.cacheDir)}${at}`, { timeoutMs: INSTALL_TIMEOUT_MS }).catch(() => undefined);
+        if (packed === undefined || packed.exitCode !== 0)
+            return undefined;
+        const file = packedFileFrom(packed.stdout, root);
+        if (file === undefined)
+            return undefined;
+        const unpacked = await runShell(shell, `tar -xzf ${quoteShellArg(file)} -C ${quoteShellArg(root)}`, {
+            timeoutMs: INSTALL_TIMEOUT_MS,
+        }).catch(() => undefined);
+        if (unpacked === undefined || unpacked.exitCode !== 0)
+            return undefined;
+        const dir = path.join(root, 'package');
+        if (!fs.existsSync(dir))
+            return undefined;
+        return visit(dir);
+    }
+    finally {
+        fs.rmSync(root, { recursive: true, force: true });
+    }
+}

package/dist/host/package-kind.d.ts

@@ -0,0 +1,13 @@
+export { splitNpmSpec } from './spec.js';
+export type { NpmRef } from './spec.js';
+export type PackageKind = 'runtime-plugin' | 'dsh-bundle' | 'both' | 'neither';
+export interface PackageVerdict {
+    readonly kind: PackageKind;
+    readonly pkg?: string;
+    readonly pluginName?: string;
+}
+export declare function isCommandFile(name: string): boolean;
+export declare function pluginManifestOf(dir: string, manifestFile: string): Readonly<Record<string, unknown>> | undefined;
+export declare function hasCommandFile(dir: string): boolean;
+export declare function dshMarkersOf(raw: unknown): boolean;
+export declare function verdictOf(dir: string, manifestFile: string): PackageVerdict | undefined;

package/dist/host/package-kind.js

@@ -0,0 +1,51 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export { splitNpmSpec } from './spec.js';
+import { dshRecordOf, packageManifestOf, packageNameOf } from './local-declaration.js';
+import { pluginAt } from './plugin.js';
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+export function isCommandFile(name) {
+    if (name.endsWith('.d.ts') || name.endsWith('.test.ts'))
+        return false;
+    if (name.endsWith('.d.js'))
+        return false;
+    return name.endsWith('.ts') || name.endsWith('.js');
+}
+export function pluginManifestOf(dir, manifestFile) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(dir, manifestFile), 'utf8'));
+        if (Array.isArray(parsed))
+            return undefined;
+        return asRecord(parsed);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function hasCommandFile(dir) {
+    try {
+        return fs.readdirSync(dir).some(isCommandFile);
+    }
+    catch {
+        return false;
+    }
+}
+export function dshMarkersOf(raw) {
+    const record = asRecord(raw);
+    return record !== undefined && ('bundle' in record || 'workbench' in record);
+}
+export function verdictOf(dir, manifestFile) {
+    const plugin = pluginAt(dir, manifestFile);
+    if (packageManifestOf(dir) === undefined && plugin === undefined)
+        return undefined;
+    const dsh = dshMarkersOf(dshRecordOf(dir));
+    const kind = plugin !== undefined && dsh ? 'both' : plugin !== undefined ? 'runtime-plugin' : dsh ? 'dsh-bundle' : 'neither';
+    const pkg = packageNameOf(dir);
+    return {
+        kind,
+        ...(pkg === undefined ? {} : { pkg }),
+        ...(plugin?.name === undefined ? {} : { pluginName: plugin.name }),
+    };
+}