@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/plugin/models-service.js

@@ -0,0 +1,317 @@
+/*
+ * 宿主模型服务：给 sandbox 插件提供自定义供应商与模型切换。
+ *
+ * 配置写在 app-setting.json 的 models 节（每次调用实时读写，改完下一轮对话生效），
+ * 每个供应商的 Key 写在 credentials.json；状态只返回掩码。
+ */
+import { CONFIG_CODES } from "../config/codes.js";
+import { clearProviderApiKey, credentialsFile, normalizeApiKey, providerKeyStatusSync, saveProviderApiKey, } from "../config/credentials.js";
+import { DEFAULT_SETTINGS } from "../config/defaults.js";
+import { REASONING_LEVELS } from "../config/types.js";
+import { loadSettings, saveSettings, SETTING_FILE_NAME } from "../config/loader.js";
+import { BUILTIN_PROVIDER_ID, listModelProviders, modelsSetting, providerApiKey, } from "../config/providers.js";
+import { OpenAIClient } from "../network/openai.js";
+import { createProxyFetch } from "../network/proxy.js";
+const PROVIDER_ID = /^[a-z0-9][a-z0-9._-]{0,31}$/;
+const MAX_MODEL_CHARS = 120;
+function normalizeModels(value) {
+    const models = [];
+    for (const item of value ?? []) {
+        if (typeof item !== "string") {
+            continue;
+        }
+        const model = item.trim();
+        if (model === "" || model.length > MAX_MODEL_CHARS || models.includes(model)) {
+            continue;
+        }
+        models.push(model);
+    }
+    return models;
+}
+function slugOf(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 32);
+    return PROVIDER_ID.test(slug) ? slug : "provider";
+}
+function uniqueId(base, taken) {
+    if (!taken.has(base) && base !== BUILTIN_PROVIDER_ID) {
+        return base;
+    }
+    for (let index = 2; index < 100; index += 1) {
+        const candidate = `${base}-${index}`;
+        if (!taken.has(candidate) &&
+            candidate !== BUILTIN_PROVIDER_ID &&
+            PROVIDER_ID.test(candidate)) {
+            return candidate;
+        }
+    }
+    return `provider-${Date.now().toString(36)}`;
+}
+export function createHostModelsService(options) {
+    const logger = options.logger.child({ module: "models" });
+    const settingsFile = options.settingsFile;
+    const credentialsPath = credentialsFile(options.configDir);
+    const currentSettings = async () => {
+        const loaded = await loadSettings(settingsFile);
+        return loaded.getData() ?? options.settings ?? DEFAULT_SETTINGS;
+    };
+    const stateOf = (settings) => {
+        const models = modelsSetting(settings);
+        const providers = listModelProviders(settings).map((provider) => {
+            const key = providerKeyStatusSync({ id: provider.id, apiKeyEnv: provider.apiKeyEnv }, credentialsPath);
+            return {
+                id: provider.id,
+                name: provider.name,
+                baseUrl: provider.baseUrl,
+                models: provider.models,
+                defaultModel: provider.defaultModel,
+                apiKeyEnv: provider.apiKeyEnv,
+                builtin: provider.builtin,
+                keyConfigured: key.configured,
+                keySource: key.source,
+                keyMasked: key.masked,
+                envVar: key.envVar,
+                keyStored: key.stored,
+            };
+        });
+        const activeProvider = providers.some((provider) => provider.id === models.activeProvider)
+            ? models.activeProvider
+            : BUILTIN_PROVIDER_ID;
+        return {
+            providers,
+            activeProvider,
+            activeModel: models.activeModel,
+            activeReasoning: models.activeReasoning,
+            reasoningLevels: REASONING_LEVELS,
+        };
+    };
+    const saveProviderConfig = async (settings, provider) => {
+        const models = modelsSetting(settings);
+        const providers = [...models.providers];
+        const index = providers.findIndex((item) => item.id === provider.id);
+        if (index === -1) {
+            if (providers.length >= 20) {
+                return { ok: false, code: "models.too-many-providers", state: stateOf(settings) };
+            }
+            providers.push(provider);
+        }
+        else {
+            providers[index] = provider;
+        }
+        const next = {
+            ...settings,
+            models: { ...models, providers },
+        };
+        const saved = await saveSettings(next, settingsFile);
+        if (!saved.isSuccess()) {
+            return {
+                ok: false,
+                code: saved.getCode() ?? CONFIG_CODES.invalid,
+                state: stateOf(settings),
+            };
+        }
+        return { ok: true, state: stateOf(next) };
+    };
+    const fail = async (code) => ({
+        ok: false,
+        code,
+        state: stateOf(await currentSettings()),
+    });
+    return {
+        async state() {
+            return stateOf(await currentSettings());
+        },
+        async setActive(providerId, model, reasoning) {
+            const settings = await currentSettings();
+            const models = modelsSetting(settings);
+            const id = providerId.trim();
+            const exists = listModelProviders(settings).some((provider) => provider.id === id);
+            if (!exists) {
+                throw new Error("models.provider-not-found");
+            }
+            const nextModel = typeof model === "string" && model.trim() !== "" ? model.trim() : null;
+            if (nextModel !== null && nextModel.length > MAX_MODEL_CHARS) {
+                throw new Error("models.invalid-model");
+            }
+            const nextReasoning = typeof reasoning === "string" && reasoning.trim() !== ""
+                ? reasoning.trim()
+                : models.activeReasoning;
+            if (!REASONING_LEVELS.includes(nextReasoning)) {
+                throw new Error("models.invalid-reasoning");
+            }
+            const next = {
+                ...settings,
+                models: {
+                    ...models,
+                    activeProvider: id,
+                    activeModel: nextModel,
+                    activeReasoning: nextReasoning,
+                },
+            };
+            const saved = await saveSettings(next, settingsFile);
+            if (!saved.isSuccess()) {
+                throw new Error(saved.getCode() ?? CONFIG_CODES.invalid);
+            }
+            logger.info({ provider: id, model: nextModel, reasoning: nextReasoning }, "切换模型");
+            return stateOf(next);
+        },
+        async saveProvider(input) {
+            const settings = await currentSettings();
+            const models = modelsSetting(settings);
+            const name = typeof input.name === "string" ? input.name.trim() : "";
+            if (name === "" || name.length > 60) {
+                return await fail(CONFIG_CODES.invalid);
+            }
+            const explicitId = typeof input.id === "string" && input.id.trim() !== "" ? input.id.trim() : "";
+            const taken = new Set(models.providers.map((provider) => provider.id));
+            let id = explicitId;
+            if (id === "") {
+                id = uniqueId(slugOf(name), taken);
+            }
+            else if (!PROVIDER_ID.test(id) || id === BUILTIN_PROVIDER_ID) {
+                return await fail(CONFIG_CODES.invalid);
+            }
+            const apiKey = typeof input.apiKey === "string" && input.apiKey.trim() !== ""
+                ? normalizeApiKey(input.apiKey)
+                : null;
+            if (typeof input.apiKey === "string" && input.apiKey.trim() !== "" && apiKey === null) {
+                return { ok: false, code: CONFIG_CODES.invalidApiKey, state: stateOf(settings) };
+            }
+            const rawBaseUrl = input.baseUrl;
+            const baseUrl = typeof rawBaseUrl === "string" && rawBaseUrl.trim() !== ""
+                ? rawBaseUrl.trim()
+                : null;
+            const provider = {
+                id,
+                name,
+                baseUrl,
+                models: normalizeModels(input.models),
+                defaultModel: typeof input.defaultModel === "string" && input.defaultModel.trim() !== ""
+                    ? input.defaultModel.trim()
+                    : null,
+                apiKeyEnv: typeof input.apiKeyEnv === "string" && input.apiKeyEnv.trim() !== ""
+                    ? input.apiKeyEnv.trim()
+                    : null,
+            };
+            const result = await saveProviderConfig(settings, provider);
+            if (!result.ok) {
+                return result;
+            }
+            if (apiKey !== null) {
+                const keyed = await saveProviderApiKey(id, apiKey, credentialsPath);
+                if (!keyed.isSuccess()) {
+                    return await fail(keyed.getCode() ?? CONFIG_CODES.credentialsWriteFailed);
+                }
+            }
+            return { ok: true, state: stateOf(await currentSettings()) };
+        },
+        async removeProvider(id) {
+            const settings = await currentSettings();
+            const models = modelsSetting(settings);
+            if (id === BUILTIN_PROVIDER_ID) {
+                return await fail("models.builtin-provider");
+            }
+            const providers = models.providers.filter((provider) => provider.id !== id);
+            if (providers.length === models.providers.length) {
+                return await fail("models.provider-not-found");
+            }
+            const next = {
+                ...settings,
+                models: {
+                    ...models,
+                    providers,
+                    activeProvider: models.activeProvider === id ? BUILTIN_PROVIDER_ID : models.activeProvider,
+                    activeModel: models.activeProvider === id ? null : models.activeModel,
+                },
+            };
+            const saved = await saveSettings(next, settingsFile);
+            if (!saved.isSuccess()) {
+                return await fail(saved.getCode() ?? CONFIG_CODES.invalid);
+            }
+            await clearProviderApiKey(id, credentialsPath);
+            logger.info({ provider: id }, "删除自定义供应商");
+            return { ok: true, state: stateOf(next) };
+        },
+        async fetchModels(id, candidate) {
+            const settings = await currentSettings();
+            const provider = listModelProviders(settings).find((item) => item.id === id);
+            if (provider === undefined) {
+                return { ok: false, code: "models.provider-not-found" };
+            }
+            let apiKey;
+            if (typeof candidate === "string" && candidate.trim() !== "") {
+                const normalized = normalizeApiKey(candidate);
+                if (normalized === null) {
+                    return { ok: false, code: CONFIG_CODES.invalidApiKey };
+                }
+                apiKey = normalized;
+            }
+            else {
+                apiKey = providerApiKey(provider, options.configDir) ?? undefined;
+            }
+            if (apiKey === undefined) {
+                return { ok: false, code: "openai.missing-api-key" };
+            }
+            let proxyFetch;
+            try {
+                proxyFetch = createProxyFetch(settings.network.proxy);
+            }
+            catch {
+                proxyFetch = undefined;
+            }
+            const created = OpenAIClient.create({
+                settings: {
+                    ...settings.openai,
+                    baseUrl: provider.baseUrl,
+                    model: provider.defaultModel ?? provider.models[0] ?? settings.openai.model,
+                },
+                apiKey,
+                credentialsFile: credentialsPath,
+                logger,
+                fetch: proxyFetch,
+            });
+            const client = created.getData();
+            if (!created.isSuccess() || client === null) {
+                return { ok: false, code: created.getCode() ?? "openai.missing-api-key" };
+            }
+            const listed = await client.listModels();
+            const data = listed.getData();
+            if (!listed.isSuccess() || data === null) {
+                return { ok: false, code: listed.getCode() ?? "openai.request-failed" };
+            }
+            return { ok: true, models: data };
+        },
+        async saveKey(id, apiKey) {
+            const settings = await currentSettings();
+            const exists = listModelProviders(settings).some((provider) => provider.id === id);
+            if (!exists) {
+                return await fail("models.provider-not-found");
+            }
+            const saved = await saveProviderApiKey(id, apiKey, credentialsPath);
+            if (!saved.isSuccess()) {
+                return {
+                    ok: false,
+                    code: saved.getCode() ?? CONFIG_CODES.invalidApiKey,
+                    state: stateOf(settings),
+                };
+            }
+            return { ok: true, state: stateOf(settings) };
+        },
+        async clearKey(id) {
+            const settings = await currentSettings();
+            const exists = listModelProviders(settings).some((provider) => provider.id === id);
+            if (!exists) {
+                throw new Error("models.provider-not-found");
+            }
+            const cleared = await clearProviderApiKey(id, credentialsPath);
+            if (!cleared.isSuccess()) {
+                throw new Error(cleared.getCode() ?? CONFIG_CODES.credentialsWriteFailed);
+            }
+            return stateOf(settings);
+        },
+    };
+}
+//# sourceMappingURL=models-service.js.map

package/dist/plugin/models-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-service.js","sourceRoot":"","sources":["../../src/plugin/models-service.ts"],"names":[],"mappings":"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"}

package/dist/plugin/network-service.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from "pino";
+import type { HostNetworkApi } from "../api/host/network.js";
+import type { AppSetting } from "../config/types.js";
+export interface HostNetworkServiceOptions {
+    /** 启动时的配置；配置文件不存在或读取失败时回退到它 */
+    readonly settings: AppSetting;
+    readonly settingsFile: string;
+    readonly logger?: Logger;
+}
+export declare function createHostNetworkService(options: HostNetworkServiceOptions): HostNetworkApi;

package/dist/plugin/network-service.js

@@ -0,0 +1,87 @@
+/*
+ * 宿主网络配置服务：读写 app-setting.json 的 network.proxy。
+ *
+ * 只写这一个字段，其余配置原样保留；写入前经过 validateSettings，
+ * 非法 URL / noProxy 不会落盘。模型调用、拉模型、网页搜索每轮都会重新读配置，
+ * 所以保存后不需要重启服务，下一轮请求生效。
+ */
+import { CONFIG_CODES, invalidCode } from "../config/codes.js";
+import { loadSettings, saveSettings } from "../config/loader.js";
+const MAX_NO_PROXY = 100;
+const MAX_NO_PROXY_LENGTH = 256;
+function isHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/** 去空、去重、限长，避免把超大/空白的 noProxy 写进配置 */
+function normalizeNoProxy(values) {
+    const result = [];
+    for (const raw of values ?? []) {
+        if (typeof raw !== "string")
+            continue;
+        const value = raw.trim();
+        if (value === "" || value.length > MAX_NO_PROXY_LENGTH)
+            continue;
+        if (result.includes(value))
+            continue;
+        if (result.length >= MAX_NO_PROXY)
+            break;
+        result.push(value);
+    }
+    return result;
+}
+export function createHostNetworkService(options) {
+    const currentSettings = async () => {
+        try {
+            const loaded = await loadSettings(options.settingsFile);
+            return loaded.getData() ?? options.settings;
+        }
+        catch {
+            return options.settings;
+        }
+    };
+    const stateOf = (settings) => ({
+        proxy: settings.network.proxy,
+    });
+    return {
+        async state() {
+            return stateOf(await currentSettings());
+        },
+        async saveProxy(input) {
+            const settings = await currentSettings();
+            const rawUrl = typeof input.url === "string" ? input.url.trim() : "";
+            if (rawUrl !== "" && !isHttpUrl(rawUrl)) {
+                return {
+                    ok: false,
+                    code: invalidCode("network.proxy.url"),
+                    state: stateOf(settings),
+                };
+            }
+            let proxy = null;
+            if (rawUrl !== "") {
+                proxy = {
+                    type: "http",
+                    url: rawUrl,
+                    noProxy: normalizeNoProxy(input.noProxy),
+                };
+            }
+            const next = { ...settings, network: { proxy } };
+            const saved = await saveSettings(next, options.settingsFile);
+            if (!saved.isSuccess()) {
+                return {
+                    ok: false,
+                    code: saved.getCode() ?? CONFIG_CODES.invalid,
+                    state: stateOf(settings),
+                };
+            }
+            options.logger?.info({ proxy: proxy?.url ?? null, noProxy: proxy?.noProxy ?? [] }, proxy === null ? "已关闭 HTTP 代理" : "已更新 HTTP 代理");
+            return { ok: true, state: stateOf(next) };
+        },
+    };
+}
+//# sourceMappingURL=network-service.js.map

package/dist/plugin/network-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-service.js","sourceRoot":"","sources":["../../src/plugin/network-service.ts"],"names":[],"mappings":"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"}

package/dist/plugin/package-manager.d.ts

@@ -0,0 +1,46 @@
+export type PluginPackageManagerName = "npm" | "pnpm" | "yarn" | "bun";
+export interface PluginPackageManager {
+    readonly name: PluginPackageManagerName;
+    readonly version: string | null;
+}
+export interface PluginPackageJsonLike {
+    readonly packageManager?: unknown;
+    readonly dependencies?: Record<string, unknown> | null;
+    readonly optionalDependencies?: Record<string, unknown> | null;
+}
+export interface PluginDependencyInstallResult {
+    readonly manager: PluginPackageManager | null;
+    readonly installed: boolean;
+    readonly reason: string | null;
+}
+/** 解析 "npm@11.20.0" / "pnpm" 这类声明；不合法返回 null */
+export declare function parsePackageManager(value: unknown): PluginPackageManager | null;
+/** 没声明 packageManager 时按 lockfile 推断，兼容旧插件 */
+export declare function lockfilePackageManager(files: readonly string[]): PluginPackageManager | null;
+export declare function hasPluginDependencies(pkg: PluginPackageJsonLike): boolean;
+/** 实际执行的命令；Windows 下 .cmd 需要 shell */
+export declare function pluginInstallCommand(manager: PluginPackageManager): {
+    readonly command: string;
+    readonly args: readonly string[];
+};
+export interface RunPackageInstallOptions {
+    readonly timeoutMs?: number;
+}
+/** 在插件目录里执行包管理器安装；失败时抛出带输出尾部的错误 */
+export declare function runPackageInstall(directory: string, manager: PluginPackageManager, options?: RunPackageInstallOptions): Promise<void>;
+export interface InstallPluginDependenciesOptions {
+    /** 插件目录里的文件名；默认读目录，用于 lockfile 推断 */
+    readonly files?: readonly string[];
+    /** 测试注入；默认 runPackageInstall */
+    readonly run?: typeof runPackageInstall;
+    readonly timeoutMs?: number;
+}
+/**
+ * 安装插件依赖。
+ *
+ * - 没有 dependencies / optionalDependencies：直接跳过
+ * - 有依赖但没有 packageManager：先用 lockfile 推断；仍没有则报错
+ *   （不允许猜 npm，避免在错误的目录里跑错包管理器）
+ */
+export declare function installPluginDependencies(directory: string, pkg: PluginPackageJsonLike, options?: InstallPluginDependenciesOptions): Promise<PluginDependencyInstallResult>;
+export declare function packageManagerLabel(manager: PluginPackageManager): string;

package/dist/plugin/package-manager.js

@@ -0,0 +1,148 @@
+/*
+ * 插件依赖安装：插件自己的 package.json 用 packageManager 字段声明包管理器。
+ *
+ * 只认白名单命令（npm / pnpm / yarn / bun），字段不会变成任意命令执行；
+ * 版本号只作声明，实际使用 PATH 里的同名命令（不安装新版本，也不走 corepack）。
+ */
+import { spawn } from "node:child_process";
+import { readdir } from "node:fs/promises";
+const MANAGERS = new Map([
+    ["npm", { binary: "npm", args: ["install", "--no-audit", "--no-fund", "--omit=dev"] }],
+    ["pnpm", { binary: "pnpm", args: ["install", "--prod"] }],
+    ["yarn", { binary: "yarn", args: ["install", "--production"] }],
+    ["bun", { binary: "bun", args: ["install", "--production"] }],
+]);
+const INSTALL_TIMEOUT_MS = 5 * 60 * 1000;
+const MAX_OUTPUT_CHARS = 4000;
+function isManagerName(value) {
+    return MANAGERS.has(value);
+}
+/** 解析 "npm@11.20.0" / "pnpm" 这类声明；不合法返回 null */
+export function parsePackageManager(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    const match = /^([A-Za-z][A-Za-z0-9-]*)(?:@(.+))?$/.exec(trimmed);
+    if (match === null) {
+        return null;
+    }
+    const name = (match[1] ?? "").toLowerCase();
+    if (!isManagerName(name)) {
+        return null;
+    }
+    const version = match[2] ?? null;
+    // 允许 corepack 常见的 "pnpm@10.0.0+sha512..." 形式
+    if (version !== null && !/^[0-9A-Za-z][0-9A-Za-z.+-]*$/.test(version)) {
+        return null;
+    }
+    return { name, version };
+}
+/** 没声明 packageManager 时按 lockfile 推断，兼容旧插件 */
+export function lockfilePackageManager(files) {
+    if (files.includes("pnpm-lock.yaml")) {
+        return { name: "pnpm", version: null };
+    }
+    if (files.includes("yarn.lock")) {
+        return { name: "yarn", version: null };
+    }
+    if (files.includes("bun.lockb") || files.includes("bun.lock")) {
+        return { name: "bun", version: null };
+    }
+    if (files.includes("package-lock.json")) {
+        return { name: "npm", version: null };
+    }
+    return null;
+}
+export function hasPluginDependencies(pkg) {
+    return (Object.keys(pkg.dependencies ?? {}).length > 0 ||
+        Object.keys(pkg.optionalDependencies ?? {}).length > 0);
+}
+/** 实际执行的命令；Windows 下 .cmd 需要 shell */
+export function pluginInstallCommand(manager) {
+    const spec = MANAGERS.get(manager.name);
+    if (spec === undefined) {
+        throw new Error(`不支持的包管理器：${manager.name}`);
+    }
+    const command = process.platform === "win32" ? `${spec.binary}.cmd` : spec.binary;
+    return { command, args: spec.args };
+}
+/** 在插件目录里执行包管理器安装；失败时抛出带输出尾部的错误 */
+export async function runPackageInstall(directory, manager, options = {}) {
+    const { command, args } = pluginInstallCommand(manager);
+    const timeoutMs = options.timeoutMs ?? INSTALL_TIMEOUT_MS;
+    await new Promise((resolvePromise, rejectPromise) => {
+        let output = "";
+        let settled = false;
+        const append = (chunk) => {
+            if (output.length >= MAX_OUTPUT_CHARS) {
+                return;
+            }
+            output += chunk.toString("utf8");
+        };
+        const child = spawn(command, [...args], {
+            cwd: directory,
+            env: process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+            // Windows 的 npm.cmd / pnpm.cmd 必须经 shell 才能启动；args 都是固定白名单
+            shell: process.platform === "win32",
+        });
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill("SIGKILL");
+            rejectPromise(new Error(`${manager.name} 安装依赖超时（${Math.round(timeoutMs / 1000)}s）`));
+        }, timeoutMs);
+        child.stdout?.on("data", append);
+        child.stderr?.on("data", append);
+        child.once("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            rejectPromise(new Error(`无法运行 ${manager.name}：${error.message}`));
+        });
+        child.once("close", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (code === 0) {
+                resolvePromise();
+                return;
+            }
+            const tail = output.trim().slice(-MAX_OUTPUT_CHARS);
+            rejectPromise(new Error(`${manager.name} 安装依赖失败（退出码 ${String(code)}）` +
+                (tail === "" ? "" : `：${tail}`)));
+        });
+    });
+}
+/**
+ * 安装插件依赖。
+ *
+ * - 没有 dependencies / optionalDependencies：直接跳过
+ * - 有依赖但没有 packageManager：先用 lockfile 推断；仍没有则报错
+ *   （不允许猜 npm，避免在错误的目录里跑错包管理器）
+ */
+export async function installPluginDependencies(directory, pkg, options = {}) {
+    if (!hasPluginDependencies(pkg)) {
+        return { manager: null, installed: false, reason: null };
+    }
+    const declared = parsePackageManager(pkg.packageManager);
+    if (declared === null && pkg.packageManager !== undefined) {
+        throw new Error('package.json 的 packageManager 不合法，支持 "npm@11"、"pnpm@10"、"yarn@1"、"bun@1"');
+    }
+    const files = options.files ?? (await readdir(directory).catch(() => []));
+    const manager = declared ?? lockfilePackageManager(files);
+    if (manager === null) {
+        throw new Error('插件声明了 dependencies，但 package.json 缺少 packageManager（例如 "npm@11.20.0"）');
+    }
+    const run = options.run ?? runPackageInstall;
+    await run(directory, manager, { timeoutMs: options.timeoutMs ?? INSTALL_TIMEOUT_MS });
+    return { manager, installed: true, reason: null };
+}
+export function packageManagerLabel(manager) {
+    return manager.version === null ? manager.name : `${manager.name}@${manager.version}`;
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/plugin/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../src/plugin/package-manager.ts"],"names":[],"mappings":"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"}

package/dist/plugin/paths.d.ts

@@ -0,0 +1,6 @@
+import { type ResolvedPaths } from "../platform/path.js";
+/** 插件目录名/包名：字母数字开头，允许 . _ -，最长 64 */
+export declare const PLUGIN_NAME: RegExp;
+/** 插件根目录：<dataDir>/plugins */
+export declare function pluginsRoot(paths?: ResolvedPaths): string;
+export declare function isValidPluginName(name: string): boolean;