@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/plugin/host-alias.js

@@ -0,0 +1,57 @@
+/*
+ * 插件侧模块别名。
+ * 插件不在 wellspring 包的解析路径内，用 Node 的 resolve hook 把
+ * "wellspring" / "wellspring/..." 映射到本仓库的 src 目录，
+ * 这样插件可以 import { onMessage, getHost } from "wellspring/api/host/index.ts"。
+ */
+import { statSync } from "node:fs";
+import { registerHooks } from "node:module";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+const PROJECT_ROOT = resolve(import.meta.dirname, "../..");
+const SOURCE_ROOT = join(PROJECT_ROOT, "src");
+const PREFIX = "wellspring/";
+let installed = false;
+function existingFile(path) {
+    try {
+        const info = statSync(path);
+        return info.isFile() ? path : null;
+    }
+    catch {
+        return null;
+    }
+}
+function resolveHostTarget(specifier) {
+    if (specifier === "wellspring") {
+        return existingFile(join(SOURCE_ROOT, "api", "host", "index.ts"));
+    }
+    if (!specifier.startsWith(PREFIX)) {
+        return null;
+    }
+    const rest = specifier.slice(PREFIX.length);
+    if (rest === "" || rest.startsWith("..") || rest.startsWith("/") || rest.includes("\\")) {
+        return null;
+    }
+    const direct = existingFile(join(SOURCE_ROOT, rest));
+    if (direct !== null) {
+        return direct;
+    }
+    return existingFile(join(SOURCE_ROOT, rest, "index.ts"));
+}
+/** 注册一次即可；在加载插件前调用 */
+export function ensureHostAlias() {
+    if (installed) {
+        return;
+    }
+    installed = true;
+    registerHooks({
+        resolve(specifier, context, nextResolve) {
+            const target = resolveHostTarget(specifier);
+            if (target !== null) {
+                return { url: pathToFileURL(target).href, shortCircuit: true };
+            }
+            return nextResolve(specifier, context);
+        },
+    });
+}
+//# sourceMappingURL=host-alias.js.map

package/dist/plugin/host-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-alias.js","sourceRoot":"","sources":["../../src/plugin/host-alias.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAA;AAC7C,MAAM,MAAM,GAAG,aAAa,CAAA;AAE5B,IAAI,SAAS,GAAG,KAAK,CAAA;AAErB,SAAS,YAAY,CAAC,IAAY;IAC9B,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAA;IACf,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IACxC,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IACrE,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAA;IACf,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3C,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtF,OAAO,IAAI,CAAA;IACf,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAA;IACpD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,MAAM,CAAA;IACjB,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,eAAe;IAC3B,IAAI,SAAS,EAAE,CAAC;QACZ,OAAM;IACV,CAAC;IACD,SAAS,GAAG,IAAI,CAAA;IAChB,aAAa,CAAC;QACV,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW;YACnC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAA;YAC3C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAA;YAClE,CAAC;YACD,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC1C,CAAC;KACJ,CAAC,CAAA;AACN,CAAC"}

package/dist/plugin/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./console-guard.js";
+export * from "./host-alias.js";
+export * from "./install.js";
+export * from "./loader.js";
+export * from "./paths.js";
+export * from "./registry.js";
+export * from "./zip.js";

package/dist/plugin/index.js

@@ -0,0 +1,11 @@
+/*
+ * 插件层入口。
+ */
+export * from "./console-guard.js";
+export * from "./host-alias.js";
+export * from "./install.js";
+export * from "./loader.js";
+export * from "./paths.js";
+export * from "./registry.js";
+export * from "./zip.js";
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA"}

package/dist/plugin/install.d.ts

@@ -0,0 +1,17 @@
+import { type ResolvedPaths } from "../platform/path.js";
+export interface InstallPluginOptions {
+    readonly force?: boolean;
+    /** 解析出插件名后、写入磁盘前调用；返回非空字符串表示拒绝安装 */
+    readonly validateId?: (id: string) => string | null;
+    /** 测试注入；默认使用真实包管理器安装依赖 */
+    readonly runInstall?: typeof import("./package-manager.js").runPackageInstall;
+}
+export interface InstallPluginResult {
+    readonly id: string;
+    readonly target: string;
+    /** 实际使用的包管理器（带声明版本，例如 npm@11.20.0）；没有安装依赖时为 null */
+    readonly packageManager: string | null;
+    readonly dependenciesInstalled: boolean;
+}
+/** 安装本地插件目录或 zip 包 */
+export declare function installPlugin(sourcePath: string, paths?: ResolvedPaths, options?: InstallPluginOptions): Promise<InstallPluginResult>;

package/dist/plugin/install.js

@@ -0,0 +1,163 @@
+/*
+ * 本地插件安装：目录或 zip 包。
+ * zip 在插件根目录下的临时目录解压，校验后再搬到 plugins/<name>。
+ *
+ * 插件 package.json 可以用 packageManager 声明包管理器；声明了 dependencies 时
+ * 安装阶段会调用它自动安装依赖（没有声明则按 lockfile 推断，仍没有则报错）。
+ */
+import { cp, readFile, readdir, rename, stat } from "node:fs/promises";
+import { basename, extname, join, resolve } from "node:path";
+import { ensureDir, readJsonIfExists, removePath, statIfExists } from "../platform/file.js";
+import { getPaths } from "../platform/path.js";
+import { hasPluginDependencies, installPluginDependencies, packageManagerLabel, } from "./package-manager.js";
+import { PLUGIN_NAME, pluginsRoot } from "./paths.js";
+import { extractZip } from "./zip.js";
+const ENTRIES = ["index.ts", "index.js", "index.mjs", "index.mts"];
+async function hasEntry(dir) {
+    for (const entry of ENTRIES) {
+        if ((await statIfExists(join(dir, entry))) !== null) {
+            return true;
+        }
+    }
+    const pkg = await readJsonIfExists(join(dir, "package.json"));
+    if (pkg === null) {
+        return false;
+    }
+    const candidates = [];
+    if (typeof pkg.wellspring?.entry === "string") {
+        candidates.push(pkg.wellspring.entry);
+    }
+    if (typeof pkg.main === "string") {
+        candidates.push(pkg.main);
+    }
+    for (const candidate of candidates) {
+        if ((await statIfExists(resolve(dir, candidate))) !== null) {
+            return true;
+        }
+    }
+    return false;
+}
+/** 压缩包常见形态是外面套一层目录；没有根入口时向下找唯一子目录 */
+async function normalizeExtracted(root) {
+    if (await hasEntry(root)) {
+        return root;
+    }
+    const entries = await readdir(root, { withFileTypes: true });
+    const dirs = entries.filter((entry) => entry.isDirectory());
+    if (dirs.length === 1) {
+        const child = join(root, dirs[0]?.name ?? "");
+        if (await hasEntry(child)) {
+            return child;
+        }
+    }
+    throw new Error("zip 中找不到插件入口（index.ts/js/mjs/mts 或 package.json main）");
+}
+async function resolveSourceName(source, sourceDir, temp) {
+    const pkg = await readJsonIfExists(join(sourceDir, "package.json"));
+    if (typeof pkg?.name === "string" && pkg.name.trim() !== "") {
+        return pkg.name.trim();
+    }
+    const candidate = basename(source, extname(source));
+    return temp ? candidate : basename(sourceDir);
+}
+/** 复制插件目录到暂存区；node_modules 不复制，交给包管理器装 */
+async function copyToStage(source, stage) {
+    await cp(source, stage, {
+        recursive: true,
+        force: true,
+        filter: (path) => basename(path) !== "node_modules",
+    });
+}
+/** 安装本地插件目录或 zip 包 */
+export async function installPlugin(sourcePath, paths = getPaths(), options = {}) {
+    const source = resolve(sourcePath);
+    const info = await stat(source);
+    const root = pluginsRoot(paths);
+    await ensureDir(root);
+    const temp = join(root, `.install-${process.pid}-${Date.now().toString(36)}`);
+    let sourceDir;
+    let fromArchive = false;
+    if (info.isDirectory()) {
+        sourceDir = source;
+    }
+    else {
+        const buffer = await readFile(source);
+        await removePath(temp);
+        await ensureDir(temp);
+        await extractZip(buffer, temp);
+        sourceDir = await normalizeExtracted(temp);
+        fromArchive = true;
+    }
+    let stage = null;
+    let moved = false;
+    try {
+        if (!(await hasEntry(sourceDir))) {
+            throw new Error("插件缺少入口（index.ts/js/mjs/mts 或 package.json main）");
+        }
+        const name = await resolveSourceName(source, sourceDir, fromArchive);
+        if (!PLUGIN_NAME.test(name)) {
+            throw new Error(`插件名不合法：${name}`);
+        }
+        const rejected = options.validateId?.(name) ?? null;
+        if (rejected !== null) {
+            throw new Error(rejected);
+        }
+        const target = join(root, name);
+        const existing = await statIfExists(target);
+        if (existing !== null && options.force !== true) {
+            throw new Error(`插件已存在：${name}`);
+        }
+        const pkg = await readJsonIfExists(join(sourceDir, "package.json"));
+        const needsInstall = pkg !== null && hasPluginDependencies(pkg);
+        let installDir = sourceDir;
+        if (needsInstall && !fromArchive) {
+            /*
+             * 目录安装不能碰源目录：复制到暂存区后再安装依赖，
+             * node_modules 不复制，避免把开发目录里的依赖带进去。
+             */
+            stage = join(root, `.install-stage-${process.pid}-${Date.now().toString(36)}`);
+            await removePath(stage);
+            await copyToStage(sourceDir, stage);
+            installDir = stage;
+        }
+        let dependencies = {
+            manager: null,
+            installed: false,
+            reason: null,
+        };
+        if (needsInstall) {
+            dependencies = await installPluginDependencies(installDir, pkg, {
+                ...(options.runInstall === undefined ? {} : { run: options.runInstall }),
+            });
+        }
+        if (existing !== null) {
+            await removePath(target);
+        }
+        if (fromArchive) {
+            // 与临时目录同根，rename 保持原子
+            await rename(sourceDir, target);
+        }
+        else if (stage !== null) {
+            await rename(stage, target);
+            moved = true;
+        }
+        else {
+            await cp(sourceDir, target, { recursive: true, force: true });
+        }
+        return {
+            id: name,
+            target,
+            packageManager: dependencies.manager === null ? null : packageManagerLabel(dependencies.manager),
+            dependenciesInstalled: dependencies.installed,
+        };
+    }
+    finally {
+        if (fromArchive) {
+            await removePath(temp);
+        }
+        if (stage !== null && !moved) {
+            await removePath(stage);
+        }
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/plugin/install.js.map

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

package/dist/plugin/loader.d.ts

@@ -0,0 +1,45 @@
+import type { Logger } from "pino";
+import type { PluginStatus } from "../api/host/plugin.js";
+import type { AppSetting, SandboxSetting } from "../config/types.js";
+import { type ResolvedPaths } from "../platform/path.js";
+import type { SandboxBackend } from "../sandbox/types.js";
+import { AgentToolRegistry } from "./agent-tools.js";
+import { PluginDataService } from "./data-access.js";
+import { PluginRegistry } from "./registry.js";
+import { type HostAgentService } from "./agent-service.js";
+import { type PluginHotController, type PluginHotOutcome } from "./manage.js";
+export type PluginLoadStatus = PluginStatus | "disabled";
+export type { PluginStatus } from "../api/host/plugin.js";
+export interface LoadedPlugin {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly deps: readonly string[];
+    readonly dir: string;
+    readonly status: PluginLoadStatus;
+    readonly commands: readonly string[];
+    readonly error: string | null;
+}
+export interface LoadPluginsOptions {
+    readonly paths?: ResolvedPaths;
+    readonly config: AppSetting;
+    readonly logger: Logger;
+    readonly registry: PluginRegistry;
+    readonly sandbox?: SandboxSetting;
+    readonly agentTools?: AgentToolRegistry;
+    /** 测试注入 */
+    readonly dataAccess?: PluginDataService;
+    /** 测试注入；生产根据 sandbox.mode 探测 */
+    readonly sandboxBackend?: SandboxBackend;
+    /** 测试注入；默认按 settings 构造 */
+    readonly agent?: HostAgentService;
+}
+/** 取当前进程的插件热加载控制器；未经过 loadPlugins 时返回 null */
+export declare function getPluginRuntime(paths?: ResolvedPaths): PluginHotController | null;
+export declare function hotEnablePlugin(id: string, paths?: ResolvedPaths): Promise<PluginHotOutcome>;
+export declare function hotDisablePlugin(id: string, paths?: ResolvedPaths): Promise<PluginHotOutcome>;
+export declare function loadPlugins(options: LoadPluginsOptions): Promise<readonly LoadedPlugin[]>;
+/** 把本地插件目录链接进插件根目录，开发用；没有符号链接权限时退化为复制 */
+export declare function linkPlugin(sourcePath: string, paths?: ResolvedPaths): Promise<string>;
+/** 删除插件目录 */
+export declare function removePlugin(name: string, paths?: ResolvedPaths): Promise<void>;