@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/plugin/paths.js

@@ -0,0 +1,15 @@
+/*
+ * 插件目录与命名规则。
+ */
+import { join } from "node:path";
+import { getPaths } from "../platform/path.js";
+/** 插件目录名/包名：字母数字开头，允许 . _ -，最长 64 */
+export const PLUGIN_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+/** 插件根目录：<dataDir>/plugins */
+export function pluginsRoot(paths = getPaths()) {
+    return join(paths.dataDir, "plugins");
+}
+export function isValidPluginName(name) {
+    return PLUGIN_NAME.test(name);
+}
+//# sourceMappingURL=paths.js.map

package/dist/plugin/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/plugin/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,QAAQ,EAAsB,MAAM,qBAAqB,CAAA;AAElE,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,mCAAmC,CAAA;AAE9D,8BAA8B;AAC9B,MAAM,UAAU,WAAW,CAAC,KAAK,GAAkB,QAAQ,EAAE;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC"}

package/dist/plugin/registry.d.ts

@@ -0,0 +1,17 @@
+import type { PluginCommand } from "../api/host/plugin.js";
+/** 内置命令名，插件不可占用 */
+export declare const RESERVED_COMMANDS: ReadonlySet<string>;
+export interface RegisteredPluginCommand {
+    readonly pluginName: string;
+    readonly command: PluginCommand;
+}
+export declare class PluginRegistry {
+    #private;
+    constructor(reserved?: ReadonlySet<string>);
+    /** 注册插件命令；非法、保留名或重名时抛错 */
+    register(pluginName: string, command: PluginCommand): void;
+    resolve(name: string): RegisteredPluginCommand | undefined;
+    list(): readonly RegisteredPluginCommand[];
+    removePlugin(pluginName: string): void;
+    pluginNames(): readonly string[];
+}

package/dist/plugin/registry.js

@@ -0,0 +1,82 @@
+/*
+ * 插件命令注册表。
+ * 内置命令保留，插件命令挂在顶级；重名拒绝，别名同样参与冲突检查。
+ */
+/** 内置命令名，插件不可占用 */
+export const RESERVED_COMMANDS = new Set([
+    "chat",
+    "run",
+    "session",
+    "config",
+    "plugin",
+    "doctor",
+    "version",
+    "help",
+]);
+const COMMAND_NAME = /^[a-z][a-z0-9-]*$/;
+export class PluginRegistry {
+    #reserved;
+    #commands = new Map();
+    #aliases = new Map();
+    #pluginNames = new Set();
+    constructor(reserved = RESERVED_COMMANDS) {
+        this.#reserved = reserved;
+    }
+    /** 注册插件命令；非法、保留名或重名时抛错 */
+    register(pluginName, command) {
+        if (!COMMAND_NAME.test(command.name) ||
+            command.name.length < 2 ||
+            command.name.length > 32) {
+            throw new Error(`插件命令名不合法：${command.name}`);
+        }
+        if (this.#reserved.has(command.name)) {
+            throw new Error(`插件不能覆盖内置命令：${command.name}`);
+        }
+        if (this.#commands.has(command.name) || this.#aliases.has(command.name)) {
+            throw new Error(`插件命令重名：${command.name}`);
+        }
+        if (typeof command.summary !== "string" || command.summary.trim() === "") {
+            throw new Error(`插件命令缺少 summary：${command.name}`);
+        }
+        if (typeof command.run !== "function") {
+            throw new Error(`插件命令缺少 run：${command.name}`);
+        }
+        const record = { pluginName, command };
+        this.#commands.set(command.name, record);
+        this.#pluginNames.add(pluginName);
+        for (const alias of command.aliases ?? []) {
+            if (!COMMAND_NAME.test(alias) || alias.length < 2 || alias.length > 32) {
+                throw new Error(`插件命令别名不合法：${alias}`);
+            }
+            if (this.#reserved.has(alias) ||
+                this.#commands.has(alias) ||
+                this.#aliases.has(alias)) {
+                throw new Error(`插件命令别名冲突：${alias}`);
+            }
+            this.#aliases.set(alias, record);
+        }
+    }
+    resolve(name) {
+        return this.#commands.get(name) ?? this.#aliases.get(name);
+    }
+    list() {
+        return [...this.#commands.values()];
+    }
+    removePlugin(pluginName) {
+        for (const [name, record] of this.#commands) {
+            if (record.pluginName === pluginName) {
+                this.#commands.delete(name);
+            }
+        }
+        for (const [alias, record] of this.#aliases) {
+            if (record.pluginName === pluginName) {
+                this.#aliases.delete(alias);
+            }
+        }
+        this.#pluginNames.delete(pluginName);
+    }
+    pluginNames() {
+        return [...this.#pluginNames];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugin/registry.js.map

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

package/dist/plugin/runtime.d.ts

@@ -0,0 +1,9 @@
+import type { PluginConfig } from "../api/host/plugin.js";
+import { type ResolvedPaths } from "../platform/path.js";
+/** 插件专属数据目录，平台会确保存在 */
+export declare function pluginDataDir(id: string, paths?: ResolvedPaths): string;
+/** 插件专属配置文件 */
+export declare function pluginConfigFile(id: string, paths?: ResolvedPaths): string;
+export declare function ensurePluginDataDir(id: string, paths?: ResolvedPaths): Promise<string>;
+/** 读取插件配置；文件不存在时返回空对象 */
+export declare function loadPluginConfig(id: string, paths?: ResolvedPaths): Promise<PluginConfig>;

package/dist/plugin/runtime.js

@@ -0,0 +1,43 @@
+/*
+ * 插件运行时目录：
+ * - 数据：<dataDir>/plugin-data/<id>/
+ * - 配置：<configDir>/plugins/<id>.json（插件自己的 JSON 配置）
+ */
+import { join } from "node:path";
+import { ensureDir, readJsonIfExists } from "../platform/file.js";
+import { getPaths } from "../platform/path.js";
+import { PLUGIN_NAME } from "./paths.js";
+// eslint-disable-next-line no-control-regex
+const CONTROL_CHARS = /[\u0000-\u001f\u007f]/;
+function assertPluginId(id) {
+    if (!PLUGIN_NAME.test(id) || CONTROL_CHARS.test(id)) {
+        throw new Error(`插件 id 不合法：${id}`);
+    }
+}
+/** 插件专属数据目录，平台会确保存在 */
+export function pluginDataDir(id, paths = getPaths()) {
+    assertPluginId(id);
+    return join(paths.dataDir, "plugin-data", id);
+}
+/** 插件专属配置文件 */
+export function pluginConfigFile(id, paths = getPaths()) {
+    assertPluginId(id);
+    return join(paths.configDir, "plugins", `${id}.json`);
+}
+export async function ensurePluginDataDir(id, paths = getPaths()) {
+    const dir = pluginDataDir(id, paths);
+    await ensureDir(dir);
+    return dir;
+}
+/** 读取插件配置；文件不存在时返回空对象 */
+export async function loadPluginConfig(id, paths = getPaths()) {
+    const value = await readJsonIfExists(pluginConfigFile(id, paths));
+    if (value === null) {
+        return {};
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`插件配置必须是 JSON 对象：${pluginConfigFile(id, paths)}`);
+    }
+    return value;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/plugin/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/plugin/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,QAAQ,EAAsB,MAAM,qBAAqB,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,4CAA4C;AAC5C,MAAM,aAAa,GAAG,uBAAuB,CAAA;AAE7C,SAAS,cAAc,CAAC,EAAU;IAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;IACtC,CAAC;AACL,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,KAAK,GAAkB,QAAQ,EAAE;IACvE,cAAc,CAAC,EAAE,CAAC,CAAA;IAClB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACjD,CAAC;AAED,eAAe;AACf,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,KAAK,GAAkB,QAAQ,EAAE;IAC1E,cAAc,CAAC,EAAE,CAAC,CAAA;IAClB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,EAAU,EACV,KAAK,GAAkB,QAAQ,EAAE;IAEjC,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IACpC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;IACpB,OAAO,GAAG,CAAA;AACd,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,EAAU,EACV,KAAK,GAAkB,QAAQ,EAAE;IAEjC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAU,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAA;IAC1E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,CAAA;IACb,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,mBAAmB,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,KAAgC,CAAA;AAC3C,CAAC"}

package/dist/plugin/scaffold.d.ts

@@ -0,0 +1,13 @@
+export interface ScaffoldPluginOptions {
+    readonly name: string;
+    /** 生成到哪个父目录，默认当前工作目录 */
+    readonly parentDir?: string;
+    readonly force?: boolean;
+}
+export interface ScaffoldPluginResult {
+    readonly dir: string;
+    readonly commandName: string;
+}
+/** 插件名 → 合法命令名；名字不适用时回落到 hello */
+export declare function commandNameOf(pluginName: string): string;
+export declare function scaffoldPlugin(options: ScaffoldPluginOptions): Promise<ScaffoldPluginResult>;

package/dist/plugin/scaffold.js

@@ -0,0 +1,132 @@
+/*
+ * 插件脚手架：生成可加载的最小插件目录。
+ */
+import { join, resolve } from "node:path";
+import { ensureDir, removePath, statIfExists, writeJsonAtomic, writeTextAtomic, } from "../platform/file.js";
+import { PLUGIN_NAME } from "./paths.js";
+/** 插件名 → 合法命令名；名字不适用时回落到 hello */
+export function commandNameOf(pluginName) {
+    let slug = pluginName
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (!/^[a-z][a-z0-9-]*$/.test(slug) || slug.length < 2) {
+        slug = "hello";
+    }
+    return slug.slice(0, 32).replace(/-+$/, "");
+}
+function template(pluginName, commandName) {
+    return [
+        'import { onMessage, onInit, onShutdown } from "wellspring/api/host/index.ts"',
+        'import type { WellspringPlugin } from "wellspring/api/host/index.ts"',
+        "",
+        "// 钩子可以放在模块顶层；平台在 import 时会把它们归属到当前插件",
+        "onMessage(({ phase, prompt }) => {",
+        '    if (phase === "before") prompt.push("你是一个运行在 Wellspring 里的助手")',
+        "})",
+        "",
+        "export function setup() {",
+        "    onInit(() => {",
+        "        // wellspring start 时触发",
+        "    })",
+        "    onShutdown(() => {",
+        "        // wellspring start 关闭时触发",
+        "    })",
+        "",
+        "    const plugin = {",
+        `        id: ${JSON.stringify(pluginName)},`,
+        `        name: ${JSON.stringify(pluginName)},`,
+        '        version: "0.1.0",',
+        '        status: "ok",',
+        "        deps: [],",
+        "        commands: [",
+        "            {",
+        `                name: ${JSON.stringify(commandName)},`,
+        `                summary: ${JSON.stringify(`${pluginName} 示例命令`)},`,
+        "                run: (ctx) => {",
+        '                    ctx.output.info("argv=" + ctx.argv.join(","))',
+        "                    return 0",
+        "                },",
+        "            },",
+        "        ],",
+        "    } satisfies WellspringPlugin",
+        "",
+        "    return plugin",
+        "}",
+        "",
+    ].join("\n");
+}
+function readmeTemplate(pluginName, commandName) {
+    return [
+        `# ${pluginName}`,
+        "",
+        "## 开发",
+        "",
+        "编辑器 / tsc 解析 `wellspring/api/host/index.ts` 需要先把 Wellspring 链接进来：",
+        "",
+        "```bash",
+        "pnpm link /path/to/Wellspring",
+        "pnpm add -D typescript @types/node   # 如果还没有",
+        "pnpm exec tsc --noEmit",
+        "```",
+        "",
+        "运行时不需要链接：通过 `wellspring plugin link <this-dir>` 加载时，平台会解析宿主 API。",
+        "",
+        "## 依赖",
+        "",
+        "`package.json` 的 `packageManager` 声明插件使用哪个包管理器（`npm@11.20.0`、`pnpm@10` 等）。",
+        "安装 zip 或目录时，有 `dependencies` 会按这个声明自动安装；没有声明时按 lockfile 推断。",
+        "",
+        "## 加载",
+        "",
+        "```bash",
+        `wellspring plugin link \"$PWD\"`,
+        "wellspring plugin list",
+        `wellspring ${commandName}`,
+        "```",
+        "",
+    ].join("\n");
+}
+export async function scaffoldPlugin(options) {
+    const name = options.name.trim();
+    if (!PLUGIN_NAME.test(name)) {
+        throw new Error(`插件名不合法：${name}`);
+    }
+    const parentDir = resolve(options.parentDir ?? process.cwd());
+    const dir = join(parentDir, name);
+    const existing = await statIfExists(dir);
+    if (existing !== null) {
+        if (options.force !== true) {
+            throw new Error(`目录已存在：${dir}`);
+        }
+        await removePath(dir);
+    }
+    await ensureDir(dir);
+    const commandName = commandNameOf(name);
+    await writeJsonAtomic(join(dir, "package.json"), {
+        name,
+        version: "0.1.0",
+        packageManager: "npm@11.20.0",
+        type: "module",
+        main: "index.ts",
+        wellspring: { apiVersion: 1 },
+    });
+    await writeTextAtomic(join(dir, "index.ts"), template(name, commandName));
+    await writeJsonAtomic(join(dir, "tsconfig.json"), {
+        compilerOptions: {
+            target: "ES2024",
+            module: "NodeNext",
+            moduleResolution: "NodeNext",
+            strict: true,
+            noEmit: true,
+            allowImportingTsExtensions: true,
+            skipLibCheck: true,
+            types: ["node"],
+        },
+        include: ["index.ts"],
+    });
+    await writeTextAtomic(join(dir, "README.md"), readmeTemplate(name, commandName));
+    return { dir, commandName };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/plugin/scaffold.js.map

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

package/dist/plugin/state.d.ts

@@ -0,0 +1,6 @@
+import { type ResolvedPaths } from "../platform/path.js";
+export declare function pluginStateFile(paths?: ResolvedPaths): string;
+/** 读取被禁用的插件目录名集合 */
+export declare function readPluginState(paths?: ResolvedPaths): Promise<ReadonlySet<string>>;
+/** 设置插件启用/禁用，返回是否发生变化 */
+export declare function setPluginEnabled(name: string, enabled: boolean, paths?: ResolvedPaths): Promise<boolean>;

package/dist/plugin/state.js

@@ -0,0 +1,38 @@
+/*
+ * 插件启用状态：<dataDir>/plugins-state.json。
+ * 以插件目录名为 key，禁用后 loader 不再 import 该插件。
+ */
+import { join } from "node:path";
+import { readJsonIfExists, writeJsonAtomic } from "../platform/file.js";
+import { getPaths } from "../platform/path.js";
+export function pluginStateFile(paths = getPaths()) {
+    return join(paths.dataDir, "plugins-state.json");
+}
+/** 读取被禁用的插件目录名集合 */
+export async function readPluginState(paths = getPaths()) {
+    const value = await readJsonIfExists(pluginStateFile(paths));
+    if (value === null || !Array.isArray(value.disabled)) {
+        return new Set();
+    }
+    return new Set(value.disabled.filter((item) => typeof item === "string"));
+}
+/** 设置插件启用/禁用，返回是否发生变化 */
+export async function setPluginEnabled(name, enabled, paths = getPaths()) {
+    const disabled = new Set(await readPluginState(paths));
+    const had = disabled.has(name);
+    if (enabled) {
+        disabled.delete(name);
+    }
+    else {
+        disabled.add(name);
+    }
+    if (had === !enabled) {
+        return false;
+    }
+    await writeJsonAtomic(pluginStateFile(paths), {
+        version: 1,
+        disabled: [...disabled].sort(),
+    });
+    return true;
+}
+//# sourceMappingURL=state.js.map

package/dist/plugin/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/plugin/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAsB,MAAM,qBAAqB,CAAA;AAOlE,MAAM,UAAU,eAAe,CAAC,KAAK,GAAkB,QAAQ,EAAE;IAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAA;AACpD,CAAC;AAED,oBAAoB;AACpB,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,KAAK,GAAkB,QAAQ,EAAE;IAEjC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAkB,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7E,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,GAAG,EAAE,CAAA;IACpB,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAA;AAC7F,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,IAAY,EACZ,OAAgB,EAChB,KAAK,GAAkB,QAAQ,EAAE;IAEjC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,OAAO,EAAE,CAAC;QACV,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IACD,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,MAAM,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE;QAC1C,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE;KACjC,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACf,CAAC"}

package/dist/plugin/zip.d.ts

@@ -0,0 +1,7 @@
+export interface ZipEntry {
+    readonly name: string;
+    readonly data: Buffer;
+}
+export declare function readZip(buffer: Buffer): ZipEntry[];
+/** 解压到目标目录；调用方负责临时目录与清理 */
+export declare function extractZip(buffer: Buffer, destination: string): Promise<void>;

package/dist/plugin/zip.js

@@ -0,0 +1,138 @@
+/*
+ * 最小 ZIP 读取器，只服务本地插件安装。
+ * 支持 store/deflate 两种压缩方式，拒绝加密、ZIP64、符号链接与路径穿越。
+ */
+import { inflateRawSync } from "node:zlib";
+import { ensureDir, writeBytesAtomic } from "../platform/file.js";
+import { dirname, resolve, sep } from "node:path";
+const EOCD_SIGNATURE = 0x06054b50;
+const CENTRAL_SIGNATURE = 0x02014b50;
+const LOCAL_SIGNATURE = 0x04034b50;
+const MAX_ENTRIES = 10_000;
+const MAX_ENTRY_BYTES = 100 * 1024 * 1024;
+const MAX_TOTAL_BYTES = 200 * 1024 * 1024;
+function fail(message) {
+    throw new Error(`zip 包非法：${message}`);
+}
+function validateName(name) {
+    if (name === "" || name.startsWith("/") || name.includes("\\") || /^[A-Za-z]:/.test(name)) {
+        fail(`非法路径：${name}`);
+    }
+    for (const segment of name.split("/")) {
+        if (segment === ".." || segment === ".") {
+            fail(`非法路径：${name}`);
+        }
+    }
+}
+function findEocd(buffer) {
+    const minimum = Math.max(0, buffer.length - 65_557);
+    for (let offset = buffer.length - 22; offset >= minimum; offset -= 1) {
+        if (buffer.readUInt32LE(offset) === EOCD_SIGNATURE) {
+            return offset;
+        }
+    }
+    return fail("找不到中央目录");
+}
+export function readZip(buffer) {
+    if (buffer.length < 22) {
+        fail("文件过短");
+    }
+    const eocd = findEocd(buffer);
+    const entries = buffer.readUInt16LE(eocd + 10);
+    const centralOffset = buffer.readUInt32LE(eocd + 16);
+    if (entries > MAX_ENTRIES) {
+        fail("文件条目过多");
+    }
+    if (centralOffset === 0xffffffff) {
+        fail("不支持 ZIP64");
+    }
+    const result = [];
+    let total = 0;
+    let offset = centralOffset;
+    for (let index = 0; index < entries; index += 1) {
+        if (offset + 46 > buffer.length || buffer.readUInt32LE(offset) !== CENTRAL_SIGNATURE) {
+            fail("中央目录损坏");
+        }
+        const flags = buffer.readUInt16LE(offset + 8);
+        const method = buffer.readUInt16LE(offset + 10);
+        const compressedSize = buffer.readUInt32LE(offset + 20);
+        const uncompressedSize = buffer.readUInt32LE(offset + 24);
+        const nameLength = buffer.readUInt16LE(offset + 28);
+        const extraLength = buffer.readUInt16LE(offset + 30);
+        const commentLength = buffer.readUInt16LE(offset + 32);
+        const externalAttributes = buffer.readUInt32LE(offset + 38);
+        const localOffset = buffer.readUInt32LE(offset + 42);
+        const name = buffer.subarray(offset + 46, offset + 46 + nameLength).toString("utf8");
+        offset += 46 + nameLength + extraLength + commentLength;
+        validateName(name);
+        if ((flags & 0x1) !== 0) {
+            fail(`不支持加密条目：${name}`);
+        }
+        if (compressedSize === 0xffffffff || uncompressedSize === 0xffffffff) {
+            fail("不支持 ZIP64 条目");
+        }
+        if (uncompressedSize > MAX_ENTRY_BYTES) {
+            fail(`单文件过大：${name}`);
+        }
+        total += uncompressedSize;
+        if (total > MAX_TOTAL_BYTES) {
+            fail("解压后总大小超限");
+        }
+        if (name.endsWith("/")) {
+            result.push({ name, data: Buffer.alloc(0) });
+            continue;
+        }
+        if (((externalAttributes >>> 16) & 0o170000) === 0o120000) {
+            fail(`不支持符号链接：${name}`);
+        }
+        if (localOffset + 30 > buffer.length ||
+            buffer.readUInt32LE(localOffset) !== LOCAL_SIGNATURE) {
+            fail(`本地文件头损坏：${name}`);
+        }
+        const localNameLength = buffer.readUInt16LE(localOffset + 26);
+        const localExtraLength = buffer.readUInt16LE(localOffset + 28);
+        const dataStart = localOffset + 30 + localNameLength + localExtraLength;
+        const end = dataStart + compressedSize;
+        if (end > buffer.length) {
+            fail(`数据越界：${name}`);
+        }
+        const compressed = buffer.subarray(dataStart, end);
+        let data;
+        if (method === 0) {
+            data = Buffer.from(compressed);
+        }
+        else if (method === 8) {
+            try {
+                data = inflateRawSync(compressed);
+            }
+            catch (error) {
+                fail(`解压失败：${name}（${error instanceof Error ? error.message : String(error)}）`);
+            }
+        }
+        else {
+            fail(`不支持的压缩方式 ${method}：${name}`);
+        }
+        if (data.length !== uncompressedSize) {
+            fail(`解压大小不符：${name}`);
+        }
+        result.push({ name, data });
+    }
+    return result;
+}
+/** 解压到目标目录；调用方负责临时目录与清理 */
+export async function extractZip(buffer, destination) {
+    const root = resolve(destination);
+    for (const entry of readZip(buffer)) {
+        const target = resolve(root, entry.name);
+        if (target !== root && !target.startsWith(`${root}${sep}`)) {
+            fail(`路径穿越：${entry.name}`);
+        }
+        if (entry.name.endsWith("/")) {
+            await ensureDir(target);
+            continue;
+        }
+        await ensureDir(dirname(target));
+        await writeBytesAtomic(target, entry.data);
+    }
+}
+//# sourceMappingURL=zip.js.map

package/dist/plugin/zip.js.map

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

package/dist/sandbox/audit.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedPaths } from "../platform/path.js";
+export interface SandboxAuditEvent {
+    readonly type: string;
+    readonly sandboxId: string;
+    readonly pluginId?: string;
+    readonly backend?: string;
+    readonly decision?: "allowed" | "denied";
+    readonly reason?: string;
+    readonly [key: string]: unknown;
+}
+export declare function auditSandbox(paths: ResolvedPaths, event: SandboxAuditEvent): void;
+export declare function flushSandboxAudit(): Promise<void>;

package/dist/sandbox/audit.js

@@ -0,0 +1,20 @@
+/*
+ * sandbox 审计日志：<logDir>/sandbox-audit.log，JSONL。
+ */
+import { appendFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { ensureDir } from "../platform/file.js";
+let queue = Promise.resolve();
+export function auditSandbox(paths, event) {
+    const file = join(paths.logDir, "sandbox-audit.log");
+    queue = queue
+        .then(async () => {
+        await ensureDir(dirname(file));
+        await appendFile(file, `${JSON.stringify({ time: new Date().toISOString(), ...event })}\n`);
+    })
+        .catch(() => undefined);
+}
+export async function flushSandboxAudit() {
+    await queue;
+}
+//# sourceMappingURL=audit.js.map

package/dist/sandbox/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/sandbox/audit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAa/C,IAAI,KAAK,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAA;AAE5C,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,KAAwB;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IACpD,KAAK,GAAG,KAAK;SACR,IAAI,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QAC9B,MAAM,UAAU,CACZ,IAAI,EACJ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,IAAI,CACtE,CAAA;IACL,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACnC,MAAM,KAAK,CAAA;AACf,CAAC"}

package/dist/sandbox/backends/bwrap.d.ts

@@ -0,0 +1,28 @@
+import type { AgentLaunchInput, LaunchSpec, PluginLaunchInput, SandboxBackend, SandboxBackendStatus } from "../types.js";
+/** 沙箱内挂载 Node 运行时的目录 */
+export declare const NODE_ROOT = "/opt/wellspring";
+export interface NodeRuntimeLayout {
+    /** 可整体挂载的 Node 前缀（含 bin/npm 与 lib/node_modules）；只有裸二进制时为 null */
+    readonly prefix: string | null;
+    /** 沙箱内的 node 路径 */
+    readonly nodePath: string;
+    /** PATH 里的目录 */
+    readonly pathEntry: string;
+}
+/**
+ * 找到当前 node 的安装前缀。
+ *
+ * 只 bind 单个 node 二进制会丢掉同目录的 npm/npx（npm 在 lib/node_modules/npm 里），
+ * 所以优先把整个前缀挂到 /opt/wellspring；找不到 npm 的发行版才退回裸二进制。
+ */
+export declare function resolveNodeRuntime(execPath?: string, exists?: (path: string) => boolean): NodeRuntimeLayout;
+/** 纯函数，方便单测 */
+export declare function buildBwrapLaunch(input: AgentLaunchInput): LaunchSpec;
+/** 纯函数：插件 profile 的 bwrap launch spec */
+export declare function buildBwrapPluginLaunch(input: PluginLaunchInput): LaunchSpec;
+export declare class BwrapBackend implements SandboxBackend {
+    readonly name = "bwrap";
+    probe(): Promise<SandboxBackendStatus>;
+    buildAgentLaunch(input: AgentLaunchInput): LaunchSpec;
+    buildPluginLaunch(input: PluginLaunchInput): LaunchSpec;
+}