@dsh-workbench/shared 1.1.4 → 1.1.6

package/dist/api/host-write.d.ts

@@ -1,9 +1,11 @@
+import type { InstallFailure } from '../contract/command.js';
 /**
  * 宿主写口的五条通道（偏好、动作、供给、工坊调试、工坊录制），是写路由的第一段。
  */
 export type WriteChannel = 'prefs' | 'actions' | 'provision' | 'diy-debug' | 'diy-record';
 /**
- * 写通道统一的结果：成了带值，没成带一句能给人看的话（可选明细与帮助链接）。
+ * 写通道统一的结果：成了带值，没成带一句能给人看的话（可选明细与帮助链接）；
+ * 安装类的失败多带一份结构化现场，界面据此给修法。
  */
 export type WriteOutcome<T> = {
     readonly ok: true;
@@ -13,4 +15,5 @@ export type WriteOutcome<T> = {
     readonly message: string;
     readonly detail?: string;
     readonly helpUrl?: string;
+    readonly failure?: InstallFailure;
 };

package/dist/api/workbench-client.d.ts

@@ -1,3 +1,4 @@
+import type { InstallFailure } from '../contract/command.js';
 /**
  * 宿主读口 / 写口回的错误：code 给判据分档，message 给人看，helpUrl 有就去点。
  */
@@ -7,6 +8,7 @@ export interface ApiError {
     readonly detail?: string;
     readonly hint?: string;
     readonly helpUrl?: string;
+    readonly failure?: InstallFailure;
 }
 /**
  * 读口的统一响应：成了把载荷摊平在顶层，没成只有一条 ApiError。

package/dist/components/ApprovalPlan.css

@@ -10,22 +10,21 @@
   color: var(--dsw-alias-label-secondary);
 }
 .wb-approvalRows {
-  display: flex;
-  flex-direction: column;
-  gap: var(--wb-len-2);
+  display: grid;
+  grid-template-columns: minmax(var(--wb-len-56), auto) minmax(0, 1fr);
+  column-gap: var(--wb-len-8);
+  row-gap: var(--wb-len-2);
+  align-items: baseline;
   margin: 0;
 }
 .wb-approvalRow {
-  display: flex;
-  align-items: baseline;
-  gap: var(--wb-len-8);
+  display: contents;
 }
 .wb-approvalLabel {
-  flex: none;
-  width: var(--wb-len-56);
   font-size: var(--dsw-font-xxs-12-font-size);
   line-height: var(--wb-line-18);
   color: var(--dsw-alias-label-tertiary);
+  overflow-wrap: anywhere;
 }
 .wb-approvalValue {
   margin: 0;

package/dist/config/constants.d.ts

@@ -74,6 +74,10 @@ export declare const STORAGE_KEY_RIGHTBAR = "dsh-workbench.rightbar.expanded";
 export declare const STORAGE_KEY_RIGHTBAR_COLUMN = "dsh-workbench.rightbar.column";
 /** 记住右栏宽度（像素数字的字符串）的 localStorage 键。 */
 export declare const STORAGE_KEY_RIGHTBAR_WIDTH = "dsh-workbench.rightbar.width";
+/** 记住「添加模块」浮层选过的安装源的 localStorage 键。 */
+export declare const STORAGE_KEY_MARKET_REGISTRY = "dsh-workbench.market.registry";
+/** 记住「添加模块」浮层上次填过的自定义源地址的 localStorage 键。 */
+export declare const STORAGE_KEY_MARKET_REGISTRY_CUSTOM = "dsh-workbench.market.registry.custom";
 /** 右栏宽度达到或超过多少像素就按全屏对待（阈值，像素）。 */
 export declare const RIGHTBAR_FULLSCREEN_WIDTH = 768;
 /** dsh i18n 的命名空间：词表都注册在它下面，`ctx.locale.register` / `bind` 按它取。 */

package/dist/config/constants.js

@@ -74,6 +74,10 @@ export const STORAGE_KEY_RIGHTBAR = "dsh-workbench.rightbar.expanded";
 export const STORAGE_KEY_RIGHTBAR_COLUMN = "dsh-workbench.rightbar.column";
 /** 记住右栏宽度（像素数字的字符串）的 localStorage 键。 */
 export const STORAGE_KEY_RIGHTBAR_WIDTH = "dsh-workbench.rightbar.width";
+/** 记住「添加模块」浮层选过的安装源的 localStorage 键。 */
+export const STORAGE_KEY_MARKET_REGISTRY = "dsh-workbench.market.registry";
+/** 记住「添加模块」浮层上次填过的自定义源地址的 localStorage 键。 */
+export const STORAGE_KEY_MARKET_REGISTRY_CUSTOM = "dsh-workbench.market.registry.custom";
 /** 右栏宽度达到或超过多少像素就按全屏对待（阈值，像素）。 */
 export const RIGHTBAR_FULLSCREEN_WIDTH = 768;
 /** dsh i18n 的命名空间：词表都注册在它下面，`ctx.locale.register` / `bind` 按它取。 */

package/dist/contract/approval.d.ts

@@ -0,0 +1,4 @@
+/**
+ * agent 自己那句"这次想干什么"的参数名：插件命令族必填，审批屏把它画在详情座里，不进标题。
+ */
+export declare const APPROVAL_NOTE_ARG = "approval_note";

package/dist/contract/approval.js

@@ -0,0 +1,4 @@
+/**
+ * agent 自己那句"这次想干什么"的参数名：插件命令族必填，审批屏把它画在详情座里，不进标题。
+ */
+export const APPROVAL_NOTE_ARG = 'approval_note';

package/dist/contract/command.d.ts

@@ -20,3 +20,36 @@ export interface CommandResult {
 export interface CommandReader {
     run(request: CommandRequest): Promise<CommandResult>;
 }
+export declare const INSTALL_FAILURE_KINDS: readonly ["permission", "disk-full", "sandbox", "unknown"];
+export type InstallFailureKind = (typeof INSTALL_FAILURE_KINDS)[number];
+export type InstallFix = {
+    readonly kind: 'chown';
+    readonly path: string;
+    readonly uid: number;
+    readonly gid: number;
+} | {
+    readonly kind: 'chmod';
+    readonly path: string;
+} | {
+    readonly kind: 'space';
+    readonly path: string;
+} | {
+    readonly kind: 'handoff';
+};
+export interface InstallFailure {
+    readonly kind: InstallFailureKind;
+    readonly command: string;
+    readonly exitCode: number | null;
+    readonly output: string;
+    readonly path?: string | undefined;
+    readonly mode?: string | undefined;
+    readonly owner?: {
+        readonly uid: number;
+        readonly gid: number;
+    } | undefined;
+    readonly current: {
+        readonly uid: number;
+        readonly gid: number;
+    };
+    readonly fix: InstallFix;
+}

package/dist/contract/command.js

@@ -1 +1 @@
-export {};
+export const INSTALL_FAILURE_KINDS = ['permission', 'disk-full', 'sandbox', 'unknown'];

package/dist/contract/needs.d.ts

@@ -40,12 +40,28 @@ export interface NeedCommon {
     readonly required?: boolean;
     readonly id?: string;
 }
+/**
+ * 一条装这个可执行文件的命令；模块作者写，工作台照抄执行。
+ */
+export type BinInstall = {
+    readonly kind: 'command';
+    readonly line: string;
+    readonly platforms?: readonly string[] | undefined;
+} | {
+    readonly kind: 'npm';
+    readonly package: string;
+    readonly registryEnv?: string | undefined;
+    readonly registryDefault?: string | undefined;
+    readonly platforms?: readonly string[] | undefined;
+};
 /**
  * 机器上要有一个可执行文件；探法是 `command -v` / `where`。
  */
 export interface BinNeed extends NeedCommon {
     readonly kind: 'bin';
     readonly name: string;
+    readonly install?: BinInstall | undefined;
+    readonly docs?: string | undefined;
 }
 /**
  * 某个运行时上要有一个扩展（opencli 的插件就是这种），并且要提供这些命令。
@@ -111,6 +127,7 @@ export declare function isKnownNeedKind(value: unknown): value is NeedKind;
  * @returns 标识串。
  */
 export declare function needIdOf(need: Need): string;
+export declare function binInstallProblemsOf(raw: unknown, at: string): readonly string[];
 /**
  * 一张表说了算：每种 kind 的探法、可用来源与校验。
  */

package/dist/contract/needs.js

@@ -20,6 +20,8 @@ export const NEED_KEYS = [
     'version',
     'sources',
     'secret',
+    'install',
+    'docs',
 ];
 const SOURCE_KEYS = ['kind', 'package', 'registryEnv', 'registryDefault', 'url', 'ref', 'path', 'env'];
 const REGISTRY_PATTERN = /^(?:https?|file):\/\//;
@@ -87,7 +89,7 @@ function sourcesProblemsOf(raw, at, allowed) {
     if (raw.length === 0)
         return [`${at}.sources 是空数组 —— 不代装就整条删掉`];
     if (allowed.length === 0) {
-        return [`${at} 这种需要不支持 sources —— 它没有「从哪装」这回事`];
+        return [`${at} 这种需要不支持 sources —— 要代装就写 install（一条命令）`];
     }
     const errors = [];
     raw.forEach((source, index) => {
@@ -113,12 +115,50 @@ function commonProblemsOf(raw, at) {
         errors.push(`${at}.id 是空串`);
     return errors;
 }
+export function binInstallProblemsOf(raw, at) {
+    if (raw === undefined)
+        return [];
+    if (!isRecord(raw))
+        return [`${at}.install 要是对象`];
+    const errors = [];
+    for (const key of Object.keys(raw)) {
+        if (!['kind', 'line', 'platforms', 'package', 'registryEnv', 'registryDefault'].includes(key)) {
+            errors.push(`${at}.install 有不认识的字段 ${key}`);
+        }
+    }
+    const kind = text(raw['kind']);
+    if (kind !== 'command' && kind !== 'npm') {
+        errors.push(`${at}.install.kind 只认 command（一条命令）或 npm（一个包，装进隔离运行时）`);
+    }
+    if (kind === 'command' && text(raw['line']) === '') {
+        errors.push(`${at}.install.line 没写 —— 要一条能直接粘进终端的命令`);
+    }
+    if (kind === 'npm' && text(raw['package']) === '') {
+        errors.push(`${at}.install.package 没写 —— 这个命令由哪个 npm 包提供`);
+    }
+    if (raw['registryDefault'] !== undefined && !REGISTRY_PATTERN.test(text(raw['registryDefault']))) {
+        errors.push(`${at}.install.registryDefault 要是 http(s):// 或 file:// 的源地址`);
+    }
+    if (raw['platforms'] !== undefined) {
+        if (!Array.isArray(raw['platforms']) || raw['platforms'].length === 0) {
+            errors.push(`${at}.install.platforms 要是非空数组`);
+        }
+        else if (raw['platforms'].some((one) => !['darwin', 'linux', 'win32'].includes(text(one)))) {
+            errors.push(`${at}.install.platforms 只认 darwin / linux / win32`);
+        }
+    }
+    return errors;
+}
 function perKindProblemsOf(kind, raw, at) {
     const errors = [];
     if (kind === 'bin' || kind === 'lib' || kind === 'env') {
         if (text(raw['name']) === '')
             errors.push(`${at}.name 没写`);
     }
+    if (kind === 'bin')
+        errors.push(...binInstallProblemsOf(raw['install'], at));
+    if (raw['docs'] !== undefined && text(raw['docs']) === '')
+        errors.push(`${at}.docs 是空串`);
     if (kind === 'extension') {
         if (text(raw['runtime']) === '')
             errors.push(`${at}.runtime 没写 —— 扩展属于哪个运行时（如 opencli）`);

package/dist/contract/protocol/bundle-install.d.ts

@@ -117,6 +117,7 @@ export interface BundleCancellationPayload {
     readonly cancellation: BundleCancellation | null;
 }
 export type ModuleUpdateBlock = 'needs-workbench' | 'incompatible';
+export type LatestUnavailable = 'local' | 'no-registry' | 'not-registry' | 'probe-failed';
 export interface ModuleVersion {
     readonly unit: string;
     readonly pkg: string;
@@ -124,6 +125,7 @@ export interface ModuleVersion {
     readonly title?: UnitTitle;
     readonly latest?: string;
     readonly latestBlocked?: ModuleUpdateBlock;
+    readonly latestUnavailable?: LatestUnavailable;
     readonly local?: boolean;
     readonly refused?: readonly string[];
     readonly market?: MarketInstalledModule;

package/dist/contract/protocol/market-index.d.ts

@@ -1,4 +1,6 @@
 export declare const MARKET_INDEX_FORMAT = 1;
+export declare const MARKET_INDEX_DIR = "market";
+export declare const MARKET_ARTIFACTS_DIR = "artifacts";
 export declare const MARKET_INDEX_PATH = "market.json";
 export declare const MARKET_DISCOVER_ROUTE = "panels/market-discover";
 export declare const MARKET_DOC_ROUTE = "panels/market-doc";
@@ -111,7 +113,7 @@ export interface MarketIndex {
     readonly metadata?: MarketIndexMetadata;
     readonly plugins: readonly MarketIndexEntry[];
 }
-export type MarketIndexProblemKind = 'not-json' | 'not-object' | 'format' | 'plugins' | 'plugin' | 'name' | 'duplicate-name' | 'versions' | 'version' | 'version-order' | 'source' | 'git-commit' | 'timestamp' | 'icon' | 'owner' | 'unit';
+export type MarketIndexProblemKind = 'not-json' | 'not-object' | 'format' | 'plugins' | 'plugin' | 'entry' | 'name' | 'duplicate-name' | 'versions' | 'version' | 'version-order' | 'duplicate-version' | 'source' | 'git-commit' | 'timestamp' | 'icon' | 'owner' | 'unit';
 export interface MarketIndexProblem {
     readonly kind: MarketIndexProblemKind;
     readonly detail: string;

package/dist/contract/protocol/market-index.js

@@ -1,4 +1,6 @@
 export const MARKET_INDEX_FORMAT = 1;
+export const MARKET_INDEX_DIR = 'market';
+export const MARKET_ARTIFACTS_DIR = 'artifacts';
 export const MARKET_INDEX_PATH = 'market.json';
 export const MARKET_DISCOVER_ROUTE = 'panels/market-discover';
 export const MARKET_DOC_ROUTE = 'panels/market-doc';

package/dist/contract/unit.d.ts

@@ -18,12 +18,22 @@ export declare function unitTitleKey(unit: string): string;
 export interface UnitCard {
     readonly order: number;
 }
+/**
+ * 合成工具背后那条 opencli 命令：插件名与命令名都是 opencli 那边的原名，`args` 是命令自己声明的参数名（按声明顺序）。
+ */
+export interface UnitToolOpencli {
+    readonly plugin: string;
+    readonly command: string;
+    readonly args: readonly string[];
+}
 /**
  * 一条工具在清单里的样子：全名加会不会写；审批按 writes 认领。
+ * `opencli` 只有「按已装插件合成」的单元写，手写模块的工具没有这一格。
  */
 export interface UnitTool {
     readonly name: string;
     readonly writes: boolean;
+    readonly opencli?: UnitToolOpencli;
 }
 /**
  * 模块要外壳的哪些服务：inject 缺一个就挂不上，optional 缺了照挂。

package/dist/host/adapter-types.d.ts

@@ -19,6 +19,7 @@ export interface ProfileModule {
     readonly version: string;
     readonly registry?: string;
     readonly local?: boolean;
+    readonly fromRegistry?: boolean;
 }
 export interface ProfilePackage {
     readonly pkg: string;
@@ -41,6 +42,7 @@ export interface RegistryEntry {
 export interface RegistryNotebook {
     sources(): readonly RegistryEntry[];
     remember(entries: readonly RegistryEntry[]): readonly string[];
+    swapScope?(scope: string, registry: string): () => void;
 }
 export interface SelfUpdatePaths {
     readonly dir: string;

package/dist/host/data-error.d.ts

@@ -4,10 +4,12 @@ export declare class WorkbenchDataError extends Error {
     readonly hint?: string;
     readonly project?: unknown;
     readonly helpUrl?: string;
+    readonly failure?: unknown;
     constructor(code: string, message: string, extra?: {
         detail?: string;
         hint?: string;
         project?: unknown;
         helpUrl?: string;
+        failure?: unknown;
     });
 }

package/dist/host/data-error.js

@@ -4,6 +4,7 @@ export class WorkbenchDataError extends Error {
     hint;
     project;
     helpUrl;
+    failure;
     constructor(code, message, extra = {}) {
         super(message);
         this.name = 'WorkbenchDataError';
@@ -16,5 +17,7 @@ export class WorkbenchDataError extends Error {
             this.project = extra.project;
         if (extra.helpUrl !== undefined)
             this.helpUrl = extra.helpUrl;
+        if (extra.failure !== undefined)
+            this.failure = extra.failure;
     }
 }

package/dist/host/http.js

@@ -33,6 +33,7 @@ function toErrorPayload(error) {
             ...(data.hint === undefined ? {} : { hint: data.hint }),
             ...(data.helpUrl === undefined ? {} : { helpUrl: data.helpUrl }),
             ...(data.project === undefined ? {} : { project: data.project }),
+            ...(data.failure === undefined ? {} : { failure: data.failure }),
         };
     }
     return { code: 'internal', message: error instanceof Error ? error.message : String(error) };

package/dist/host/install-failure.d.ts

@@ -0,0 +1,49 @@
+import type { InstallFailure, InstallFailureKind } from '../contract/command.js';
+export interface DirFacts {
+    readonly mode: string;
+    readonly owner: {
+        readonly uid: number;
+        readonly gid: number;
+    };
+    readonly writable: boolean;
+}
+export declare function commandTokens(command: string): string[];
+export declare function installTargets(command: string): string[];
+export declare function failurePathIn(output: string): string | undefined;
+export declare function nearestDir(path: string): string | undefined;
+export type WriteState = 'ok' | 'denied' | 'unknown';
+export declare function writeStateOf(dir: string): WriteState;
+export declare function dirFacts(dir: string): DirFacts | undefined;
+export declare function currentUser(): {
+    readonly uid: number;
+    readonly gid: number;
+};
+export declare function classifyInstallFailure(output: string): InstallFailureKind;
+export interface InstallFailureFacts {
+    readonly command: string;
+    readonly exitCode: number | null;
+    readonly output: string;
+    readonly kind?: InstallFailureKind | undefined;
+    readonly path?: string | undefined;
+    readonly mode?: string | undefined;
+    readonly owner?: {
+        readonly uid: number;
+        readonly gid: number;
+    } | undefined;
+    readonly writable?: boolean | undefined;
+    readonly current: {
+        readonly uid: number;
+        readonly gid: number;
+    };
+}
+export declare function installFailureOf(facts: InstallFailureFacts): InstallFailure;
+export declare function diagnoseInstallFailure(input: {
+    readonly command: string;
+    readonly exitCode: number | null;
+    readonly output: string;
+    readonly fallback?: string | undefined;
+}): InstallFailure;
+export declare function installWriteProblem(input: {
+    readonly command: string;
+    readonly fallback?: string | undefined;
+}): InstallFailure | undefined;

package/dist/host/install-failure.js

@@ -0,0 +1,167 @@
+import { accessSync, constants, statSync } from 'node:fs';
+import { dirname } from 'node:path';
+const TARGET_FLAGS = ['--prefix', '--cache', '--dir', '--store-dir'];
+const INSTALL_VERBS = /^\s*npm\s+(i|install|add)\b/;
+const NPM_PATH = /^npm (?:error|ERR!) path (.+)$/m;
+export function commandTokens(command) {
+    const tokens = [];
+    const token = /'([^']*)'|"([^"]*)"|(\S+)/g;
+    for (let match = token.exec(command); match !== null; match = token.exec(command)) {
+        tokens.push(match[1] ?? match[2] ?? match[3] ?? '');
+    }
+    return tokens;
+}
+export function installTargets(command) {
+    const tokens = commandTokens(command);
+    const targets = [];
+    for (let index = 0; index < tokens.length - 1; index += 1) {
+        if (TARGET_FLAGS.includes(tokens[index] ?? ''))
+            targets.push(tokens[index + 1] ?? '');
+    }
+    return targets.filter((target) => target !== '');
+}
+export function failurePathIn(output) {
+    const path = NPM_PATH.exec(output)?.[1]?.trim();
+    return path === undefined || path === '' ? undefined : path;
+}
+export function nearestDir(path) {
+    let at = path;
+    for (;;) {
+        const here = () => {
+            try {
+                return statSync(at).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        };
+        if (here())
+            return at;
+        const up = dirname(at);
+        if (up === at)
+            return undefined;
+        at = up;
+    }
+}
+export function writeStateOf(dir) {
+    try {
+        accessSync(dir, constants.W_OK);
+        return 'ok';
+    }
+    catch (error) {
+        return error.code === 'EACCES' ? 'denied' : 'unknown';
+    }
+}
+export function dirFacts(dir) {
+    try {
+        const stats = statSync(dir);
+        return {
+            mode: (stats.mode & 0o777).toString(8),
+            owner: { uid: stats.uid, gid: stats.gid },
+            writable: writeStateOf(dir) === 'ok',
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function currentUser() {
+    return { uid: process.getuid?.() ?? -1, gid: process.getgid?.() ?? -1 };
+}
+export function classifyInstallFailure(output) {
+    const text = output.toLowerCase();
+    if (/enospc|no space left/.test(text))
+        return 'disk-full';
+    if (/eacces|eperm|permission denied|operation not permitted|access is denied/.test(text))
+        return 'permission';
+    return 'unknown';
+}
+export function installFailureOf(facts) {
+    const kind = facts.kind ?? classifyInstallFailure(facts.output);
+    const path = facts.path;
+    const base = {
+        command: facts.command,
+        exitCode: facts.exitCode,
+        output: facts.output,
+        ...(path === undefined ? {} : { path }),
+        ...(facts.mode === undefined ? {} : { mode: facts.mode }),
+        ...(facts.owner === undefined ? {} : { owner: facts.owner }),
+        current: facts.current,
+    };
+    if (kind === 'disk-full') {
+        return { ...base, kind, fix: path === undefined ? { kind: 'handoff' } : { kind: 'space', path } };
+    }
+    if (kind === 'permission' && path !== undefined) {
+        const owner = facts.owner;
+        if (owner !== undefined && owner.uid !== facts.current.uid && facts.current.uid >= 0) {
+            return { ...base, kind, fix: { kind: 'chown', path, uid: facts.current.uid, gid: facts.current.gid } };
+        }
+        if (facts.writable === false) {
+            return { ...base, kind, fix: { kind: 'chmod', path } };
+        }
+        if (facts.writable === true) {
+            return { ...base, kind: 'sandbox', fix: { kind: 'handoff' } };
+        }
+    }
+    return { ...base, kind, fix: { kind: 'handoff' } };
+}
+export function diagnoseInstallFailure(input) {
+    const current = currentUser();
+    const candidates = [
+        failurePathIn(input.output),
+        ...installTargets(input.command),
+        input.fallback,
+    ].filter((path) => path !== undefined && path !== '');
+    for (const candidate of candidates) {
+        const dir = nearestDir(candidate);
+        if (dir === undefined)
+            continue;
+        const facts = dirFacts(dir);
+        if (facts === undefined)
+            continue;
+        return installFailureOf({
+            command: input.command,
+            exitCode: input.exitCode,
+            output: input.output,
+            path: dir,
+            mode: facts.mode,
+            owner: facts.owner,
+            writable: facts.writable,
+            current,
+        });
+    }
+    return installFailureOf({
+        command: input.command,
+        exitCode: input.exitCode,
+        output: input.output,
+        current,
+    });
+}
+export function installWriteProblem(input) {
+    if (!INSTALL_VERBS.test(input.command))
+        return undefined;
+    const current = currentUser();
+    const candidates = [...installTargets(input.command), input.fallback].filter((path) => path !== undefined && path !== '');
+    for (const candidate of candidates) {
+        const dir = nearestDir(candidate);
+        if (dir === undefined)
+            continue;
+        if (writeStateOf(dir) !== 'denied')
+            continue;
+        const facts = dirFacts(dir);
+        if (facts === undefined)
+            continue;
+        return installFailureOf({
+            command: input.command,
+            exitCode: null,
+            output: '',
+            kind: 'permission',
+            path: dir,
+            mode: facts.mode,
+            owner: facts.owner,
+            writable: facts.writable,
+            current,
+        });
+    }
+    return undefined;
+}

package/dist/host/installed-sources.d.ts

@@ -0,0 +1,10 @@
+export interface InstalledSource {
+    readonly version: string;
+    readonly registry: string;
+}
+export type InstalledSourceMap = Readonly<Record<string, InstalledSource>>;
+export declare function installedSourcesFile(profileDir: string): string;
+export declare function readInstalledSources(profileDir: string | null): InstalledSourceMap;
+export declare function packageSourceOf(profileDir: string | null, pkg: string): InstalledSource | undefined;
+export declare function rememberPackageSource(profileDir: string, pkg: string, source: InstalledSource): void;
+export declare function forgetPackageSource(profileDir: string, pkg: string): void;

package/dist/host/installed-sources.js

@@ -0,0 +1,64 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const FILE_NAME = '.dsh-workbench-sources.json';
+const FILE_VERSION = 1;
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+function asText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+export function installedSourcesFile(profileDir) {
+    return path.join(profileDir, FILE_NAME);
+}
+export function readInstalledSources(profileDir) {
+    if (profileDir === null)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(installedSourcesFile(profileDir), 'utf8'));
+    }
+    catch {
+        return {};
+    }
+    const packages = asRecord(asRecord(parsed)?.packages);
+    if (packages === undefined)
+        return {};
+    const found = {};
+    for (const [pkg, value] of Object.entries(packages)) {
+        const record = asRecord(value);
+        if (record === undefined)
+            continue;
+        const version = asText(record.version);
+        const registry = asText(record.registry);
+        if (pkg === '' || version === '' || registry === '')
+            continue;
+        found[pkg] = { version, registry };
+    }
+    return found;
+}
+export function packageSourceOf(profileDir, pkg) {
+    return readInstalledSources(profileDir)[pkg];
+}
+function writeInstalledSources(profileDir, sources) {
+    const file = installedSourcesFile(profileDir);
+    const temp = `${file}.tmp`;
+    const text = `${JSON.stringify({ version: FILE_VERSION, packages: sources }, null, 2)}\n`;
+    fs.writeFileSync(temp, text, { mode: 0o600 });
+    fs.renameSync(temp, file);
+}
+export function rememberPackageSource(profileDir, pkg, source) {
+    const trimmed = pkg.trim();
+    if (trimmed === '' || source.version.trim() === '' || source.registry.trim() === '')
+        return;
+    const all = { ...readInstalledSources(profileDir) };
+    all[trimmed] = { version: source.version.trim(), registry: source.registry.trim() };
+    writeInstalledSources(profileDir, all);
+}
+export function forgetPackageSource(profileDir, pkg) {
+    const all = { ...readInstalledSources(profileDir) };
+    if (all[pkg] === undefined)
+        return;
+    delete all[pkg];
+    writeInstalledSources(profileDir, all);
+}