@aalis/core 0.1.0

package/dist/logger.d.ts

@@ -0,0 +1,76 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    /** 进程内单调递增的稳定序号（每个 LogHub 实例独立计数）。用作下游 React/UI key 与分页 cursor。 */
+    seq: number;
+    /** 本地时区 ISO-8601 时间戳（如 `2026-05-27T09:09:16.028+01:00`）。
+     *  保留完整日期与偏移，便于人读与机器解析；sink 按需截取显示。 */
+    timestamp: string;
+    level: LogLevel;
+    scope: string;
+    message: string;
+}
+/** 把一条 LogEntry 序列化为单行文本（含结尾换行）。 */
+export declare function formatLogLine(entry: LogEntry): string;
+/** 反向解析单行日志；格式错乱时返回 null。与 {@link formatLogLine} 对偶。 */
+export declare function parseLogLine(line: string): LogEntry | null;
+/**
+ * 日志中枢：纯 pub-sub 通道。
+ *
+ * 设计原则：
+ * - **零 I/O 知识**：LogHub 不感知 stdout / 文件 / TTY / 染色等任何渲染细节
+ * - **零状态**：不持有任何 buffer。启动期日志暂存由 runtime 的 bootstrap-buffer 负责
+ * - **写一次，多处订阅**：`push` 同步广播给所有 `onEntry` 订阅者
+ *
+ * 每个 `App` 拥有自己的 LogHub（沙盒、集成测试可独立通道）；
+ * `LogHub.default` 是进程级共享中枢，供未注入自定义 hub 的 Logger 使用。
+ */
+export declare class LogHub {
+    /** 进程级默认中枢——所有未显式传 hub 的 Logger 都用它 */
+    static readonly default: LogHub;
+    private listeners;
+    /** 单调递增的 entry seq；首条 = 0。 */
+    private nextSeq;
+    /** 分配下一个 seq 给即将 push 的 entry（Logger 内部使用）。 */
+    allocSeq(): number;
+    onEntry(listener: (entry: LogEntry) => void): () => void;
+    /** 接收一条日志（Logger 内部调用） */
+    push(entry: LogEntry): void;
+}
+/**
+ * 日志接口 —— core 各子系统与插件持有的最小日志面。
+ *
+ * core 不绑定具体实现：宿主可经 `AppOptions.logger` 注入任意实现
+ * （如 pino/winston 适配对象）；缺省使用 {@link DefaultLogger}（写入
+ * LogHub 管线，runtime 的 console/file/webui sink 监听该管线）。
+ * 注入自定义实现后 LogHub 管线不再由 core 写入，日志后端由注入方自理。
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    /** 派生带子作用域的 Logger（Context fork/createScope 时由 core 调用） */
+    child(scope: string): Logger;
+}
+/**
+ * 缺省 Logger 实现：按级别过滤后写入 {@link LogHub}。
+ */
+export declare class DefaultLogger implements Logger {
+    private scope;
+    private readonly minLevel;
+    private readonly hub;
+    /**
+     * @param scope    日志作用域（构造前缀）
+     * @param minLevel 最低输出级别
+     * @param hub      日志中枢；缺省使用 `LogHub.default`。
+     *                 多 App / 沙盒场景可注入独立 `new LogHub()` 实现隔离。
+     */
+    constructor(scope: string, minLevel?: LogLevel, hub?: LogHub);
+    child(scope: string): Logger;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    private log;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ;2CACuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAoBD,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAGrD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAkB1D;AAED;;;;;;;;;;GAUG;AACH,qBAAa,MAAM;IACjB,uCAAuC;IACvC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAgB;IAE/C,OAAO,CAAC,SAAS,CAA6C;IAC9D,8BAA8B;IAC9B,OAAO,CAAC,OAAO,CAAK;IAEpB,+CAA+C;IAC/C,QAAQ,IAAI,MAAM;IAIlB,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAOxD,0BAA0B;IAC1B,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAG5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,2DAA2D;IAC3D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAWxC,OAAO,CAAC,KAAK;IAVf,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B;;;;;OAKG;gBAEO,KAAK,EAAE,MAAM,EACrB,QAAQ,GAAE,QAAiB,EAC3B,GAAG,GAAE,MAAuB;IAM9B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,OAAO,CAAC,GAAG;CAmBZ"}

package/dist/logger.js

@@ -0,0 +1,187 @@
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// ════════════════════════════════════════════════════════════
+// 单行日志序列化契约（format ↔ parse 对偶）
+//
+// 行格式：`seq|timestamp|level|scope|message\n`
+//   - message 内部换行被转义为字面 `\n`，保证「一行一条」可逐行解析
+//   - 与 LogHub 一样零 I/O 知识：纯字符串变换，不感知文件/路径/编码
+//
+// 唯一权威：runtime 的 file-logger 写、webui-server / cli 读历史，全部复用这一对函数，
+// 避免格式契约在多个插件里各抄一份后悄然漂移。
+// ════════════════════════════════════════════════════════════
+/** 把一条 LogEntry 序列化为单行文本（含结尾换行）。 */
+export function formatLogLine(entry) {
+    const safeMsg = entry.message.replace(/\r?\n/g, '\\n');
+    return `${entry.seq}|${entry.timestamp}|${entry.level}|${entry.scope}|${safeMsg}\n`;
+}
+/** 反向解析单行日志；格式错乱时返回 null。与 {@link formatLogLine} 对偶。 */
+export function parseLogLine(line) {
+    const i1 = line.indexOf('|');
+    if (i1 < 0)
+        return null;
+    const i2 = line.indexOf('|', i1 + 1);
+    if (i2 < 0)
+        return null;
+    const i3 = line.indexOf('|', i2 + 1);
+    if (i3 < 0)
+        return null;
+    const i4 = line.indexOf('|', i3 + 1);
+    if (i4 < 0)
+        return null;
+    const seq = Number(line.slice(0, i1));
+    if (!Number.isFinite(seq))
+        return null;
+    return {
+        seq,
+        timestamp: line.slice(i1 + 1, i2),
+        level: line.slice(i2 + 1, i3),
+        scope: line.slice(i3 + 1, i4),
+        message: line.slice(i4 + 1).replace(/\\n/g, '\n'),
+    };
+}
+/**
+ * 日志中枢：纯 pub-sub 通道。
+ *
+ * 设计原则：
+ * - **零 I/O 知识**：LogHub 不感知 stdout / 文件 / TTY / 染色等任何渲染细节
+ * - **零状态**：不持有任何 buffer。启动期日志暂存由 runtime 的 bootstrap-buffer 负责
+ * - **写一次，多处订阅**：`push` 同步广播给所有 `onEntry` 订阅者
+ *
+ * 每个 `App` 拥有自己的 LogHub（沙盒、集成测试可独立通道）；
+ * `LogHub.default` 是进程级共享中枢，供未注入自定义 hub 的 Logger 使用。
+ */
+export class LogHub {
+    /** 进程级默认中枢——所有未显式传 hub 的 Logger 都用它 */
+    static default = new LogHub();
+    listeners = new Set();
+    /** 单调递增的 entry seq；首条 = 0。 */
+    nextSeq = 0;
+    /** 分配下一个 seq 给即将 push 的 entry（Logger 内部使用）。 */
+    allocSeq() {
+        return this.nextSeq++;
+    }
+    onEntry(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** 接收一条日志（Logger 内部调用） */
+    push(entry) {
+        for (const fn of this.listeners)
+            fn(entry);
+    }
+}
+/**
+ * 缺省 Logger 实现：按级别过滤后写入 {@link LogHub}。
+ */
+export class DefaultLogger {
+    scope;
+    minLevel;
+    hub;
+    /**
+     * @param scope    日志作用域（构造前缀）
+     * @param minLevel 最低输出级别
+     * @param hub      日志中枢；缺省使用 `LogHub.default`。
+     *                 多 App / 沙盒场景可注入独立 `new LogHub()` 实现隔离。
+     */
+    constructor(scope, minLevel = 'info', hub = LogHub.default) {
+        this.scope = scope;
+        this.minLevel = minLevel;
+        this.hub = hub;
+    }
+    child(scope) {
+        return new DefaultLogger(`${this.scope}:${scope}`, this.minLevel, this.hub);
+    }
+    debug(message, ...args) {
+        this.log('debug', message, ...args);
+    }
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+    log(level, message, ...args) {
+        if (LEVEL_PRIORITY[level] < LEVEL_PRIORITY[this.minLevel])
+            return;
+        // 本地时区 ISO 时间戳（YYYY-MM-DDTHH:mm:ss.sss±HH:mm）——信息保真且贴近人读。
+        // sink（console / CLI / WebUI）按显示需求自行截取，不在源头丢日期。
+        const timestamp = formatLocalIso(new Date());
+        // 将额外参数（错误对象 / 上下文等）序列化并拼到 message 末尾，
+        // 避免 sink 只读 message 时丢失错误细节。**保持运行时中立**：只用纯 ES
+        // 原语，不依赖 node:util / window 等任何宿主 API。
+        const tail = args.length === 0 ? '' : ` ${args.map(stringifyArg).join(' ')}`;
+        const entry = {
+            seq: this.hub.allocSeq(),
+            timestamp,
+            level,
+            scope: this.scope,
+            message: `${message}${tail}`,
+        };
+        this.hub.push(entry);
+    }
+}
+/**
+ * 把 logger.xxx(message, ...args) 里的 args 元素渲染成字符串。
+ *
+ * 设计目标：**零运行时依赖**——只用 ECMAScript 标准原语，Node/Deno/Bun/Browser
+ * 都能跑。需要 `util.inspect` 级别的深度对象渲染时，由外层 sink 自行处理
+ * （sink 可订阅 LogHub 后用宿主 API 二次格式化）。
+ *
+ * - `Error` / 任何带 `stack` 的对象：尽量打印 stack；否则退化为 name + message
+ * - `string`：原样
+ * - `null` / `undefined` / 原始值：`String(v)`
+ * - 普通对象 / 数组：尝试 `JSON.stringify`，遇到循环引用或不可序列化值时退化
+ *   为 `String(v)`（一般得到 `[object Object]`，但至少不会抛）
+ */
+/**
+ * 把 `Date` 渲染成本地时区 ISO-8601（带显式偏移），如：
+ *   `2026-05-27T09:09:16.028+01:00` / `2026-05-27T00:09:16.028Z`（UTC）
+ *
+ * 设计：日志默认以"运维所在地"读，避免把伦敦同事的 09:00 印成 08:00；
+ * 偏移段保证仍是合法 ISO-8601，下游解析器 (`new Date(...)`) 也能精确还原。
+ * 偏移 0 时输出 `Z` 以贴近通用习惯。零运行时依赖。
+ */
+function formatLocalIso(d) {
+    const pad = (n, w = 2) => String(n).padStart(w, '0');
+    const offMin = -d.getTimezoneOffset();
+    const sign = offMin >= 0 ? '+' : '-';
+    const abs = Math.abs(offMin);
+    const offStr = offMin === 0 ? 'Z' : `${sign}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
+    return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` +
+        `T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}` +
+        offStr);
+}
+function stringifyArg(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === null || value === undefined)
+        return String(value);
+    if (value instanceof Error) {
+        const head = `${value.name}: ${value.message}`;
+        return value.stack ? value.stack : head;
+    }
+    // 鸭子类型：异步链路里 Error 可能跨 realm，instanceof 失效；只要含 stack 就尽量打 stack
+    if (typeof value === 'object' && typeof value.stack === 'string') {
+        return value.stack;
+    }
+    if (typeof value === 'object') {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    return String(value);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/marketplace-bootstrap.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 最小化 marketplace HTTP 客户端，专供 init 向导/全新工程的 bootstrap 使用。
+ *
+ * 与 plugin-marketplace-client 的关系：
+ * - core 不依赖任何 plugin 包，因此这里独立实现一份"够用就好"的 HTTP fetch + 解压。
+ * - 不做签名校验（仅 sha256 对比 tarball.size/sha256，签名留给运行时插件）。
+ * - 安装目标固定为 packages/<dir>/，与 plugin-marketplace-client 的 install-pipeline 对齐。
+ *
+ * 路由与 plugin-marketplace-client/src/protocol.ts 的 ROUTES 保持一致：
+ *   GET /v1/plugins
+ *   GET /v1/plugins/:name/:version/tarball
+ */
+export interface BootstrapIndexEntry {
+    name: string;
+    latest: string;
+    versions: string[];
+    displayName?: string;
+    description?: string;
+    keywords?: string[];
+    provides?: string[];
+    inject?: string[];
+}
+export interface BootstrapListResponse {
+    protocol: string;
+    total: number;
+    items: BootstrapIndexEntry[];
+}
+/** 把 manifest.name 转成 packages/<dir> 的目录名（与 install-pipeline.pluginDirName 对齐）。 */
+export declare function pluginDirName(manifestName: string): string;
+export declare class MarketplaceBootstrap {
+    readonly baseUrl: string;
+    readonly timeoutMs: number;
+    constructor(baseUrl: string, timeoutMs?: number);
+    private get base();
+    /** 拉取插件列表 */
+    listPlugins(): Promise<BootstrapIndexEntry[]>;
+    /** 下载指定版本 tarball */
+    fetchTarball(name: string, version: string): Promise<Buffer>;
+    /**
+     * 下载 + 校验 + 解压到 packages/<dir>/。
+     * 调用方须自行决定是否在所有插件下载完毕后跑一次 pnpm install。
+     */
+    installToPackages(name: string, version: string, opts: {
+        packagesDir: string;
+        cacheDir?: string;
+        expectedSha256?: string;
+    }): Promise<{
+        pluginDir: string;
+        tarballPath?: string;
+    }>;
+}
+/** 在项目根触发 pnpm install（让 workspace 重新解析 deps） */
+export declare function runRootPnpmInstall(projectRoot: string, timeoutMs?: number): Promise<void>;
+//# sourceMappingURL=marketplace-bootstrap.d.ts.map

package/dist/marketplace-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-bootstrap.d.ts","sourceRoot":"","sources":["../src/marketplace-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,qBAAa,oBAAoB;aAEb,OAAO,EAAE,MAAM;aACf,SAAS,EAAE,MAAM;gBADjB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAe;IAG5C,OAAO,KAAK,IAAI,GAAuD;IAEvE,aAAa;IACP,WAAW,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAgBnD,qBAAqB;IACf,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAalE;;;OAGG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CA2CxD;AAMD,iDAAiD;AACjD,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhG"}

package/dist/marketplace-bootstrap.js

@@ -0,0 +1,132 @@
+/**
+ * 最小化 marketplace HTTP 客户端，专供 init 向导/全新工程的 bootstrap 使用。
+ *
+ * 与 plugin-marketplace-client 的关系：
+ * - core 不依赖任何 plugin 包，因此这里独立实现一份"够用就好"的 HTTP fetch + 解压。
+ * - 不做签名校验（仅 sha256 对比 tarball.size/sha256，签名留给运行时插件）。
+ * - 安装目标固定为 packages/<dir>/，与 plugin-marketplace-client 的 install-pipeline 对齐。
+ *
+ * 路由与 plugin-marketplace-client/src/protocol.ts 的 ROUTES 保持一致：
+ *   GET /v1/plugins
+ *   GET /v1/plugins/:name/:version/tarball
+ */
+import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/** 把 manifest.name 转成 packages/<dir> 的目录名（与 install-pipeline.pluginDirName 对齐）。 */
+export function pluginDirName(manifestName) {
+    if (manifestName.startsWith('@')) {
+        const slash = manifestName.indexOf('/');
+        return slash > 0 ? manifestName.slice(slash + 1) : manifestName;
+    }
+    return manifestName;
+}
+export class MarketplaceBootstrap {
+    baseUrl;
+    timeoutMs;
+    constructor(baseUrl, timeoutMs = 15_000) {
+        this.baseUrl = baseUrl;
+        this.timeoutMs = timeoutMs;
+    }
+    get base() { return this.baseUrl.replace(/\/+$/, ''); }
+    /** 拉取插件列表 */
+    async listPlugins() {
+        const ac = new AbortController();
+        const timer = setTimeout(() => ac.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(this.base + '/v1/plugins', {
+                signal: ac.signal,
+                headers: { accept: 'application/json' },
+            });
+            if (!res.ok)
+                throw new Error(`registry list ${res.status}`);
+            const data = (await res.json());
+            return data.items ?? [];
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** 下载指定版本 tarball */
+    async fetchTarball(name, version) {
+        const ac = new AbortController();
+        const timer = setTimeout(() => ac.abort(), this.timeoutMs * 4);
+        try {
+            const url = this.base + `/v1/plugins/${encodeURIComponent(name)}/${encodeURIComponent(version)}/tarball`;
+            const res = await fetch(url, { signal: ac.signal });
+            if (!res.ok)
+                throw new Error(`tarball ${name}@${version} ${res.status}`);
+            return Buffer.from(await res.arrayBuffer());
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * 下载 + 校验 + 解压到 packages/<dir>/。
+     * 调用方须自行决定是否在所有插件下载完毕后跑一次 pnpm install。
+     */
+    async installToPackages(name, version, opts) {
+        const dir = pluginDirName(name);
+        const finalDir = resolve(opts.packagesDir, dir);
+        if (existsSync(finalDir)) {
+            throw new Error(`packages/${dir}/ 已存在，拒绝覆盖`);
+        }
+        const tarball = await this.fetchTarball(name, version);
+        if (opts.expectedSha256) {
+            const got = sha256Hex(tarball);
+            if (got !== opts.expectedSha256) {
+                throw new Error(`sha256 mismatch: expected ${opts.expectedSha256}, got ${got}`);
+            }
+        }
+        let tarballPath;
+        if (opts.cacheDir) {
+            await mkdir(opts.cacheDir, { recursive: true });
+            tarballPath = resolve(opts.cacheDir, `${name.replace(/[\/@]/g, '-')}-${version}.tgz`);
+            await writeFile(tarballPath, tarball);
+        }
+        else {
+            // 没有 cacheDir 也得有个临时落点供 system tar 读取
+            tarballPath = resolve(opts.packagesDir, `.aalis-bootstrap-${Date.now()}.tgz`);
+            await writeFile(tarballPath, tarball);
+        }
+        await mkdir(finalDir, { recursive: true });
+        try {
+            await execFileAsync('tar', ['-xzf', tarballPath, '-C', finalDir, '--strip-components=1'], {
+                timeout: 60_000,
+                maxBuffer: 128 * 1024 * 1024,
+            });
+        }
+        catch (e) {
+            await rm(finalDir, { recursive: true, force: true });
+            throw e;
+        }
+        finally {
+            // 临时 tarball 用完即删
+            if (!opts.cacheDir && tarballPath && existsSync(tarballPath)) {
+                try {
+                    await rm(tarballPath, { force: true });
+                }
+                catch { /* ignore */ }
+            }
+        }
+        return { pluginDir: finalDir, tarballPath: opts.cacheDir ? tarballPath : undefined };
+    }
+}
+function sha256Hex(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+/** 在项目根触发 pnpm install（让 workspace 重新解析 deps） */
+export async function runRootPnpmInstall(projectRoot, timeoutMs = 180_000) {
+    await execFileAsync('pnpm', ['install', '--silent'], {
+        cwd: projectRoot,
+        timeout: timeoutMs,
+        maxBuffer: 32 * 1024 * 1024,
+        env: process.env,
+    });
+}
+//# sourceMappingURL=marketplace-bootstrap.js.map

package/dist/marketplace-bootstrap.js.map

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

package/dist/mixin-registry.d.ts

@@ -0,0 +1,34 @@
+import type { Logger } from './logger.js';
+/** Mixin 条目记录 */
+export interface MixinEntry {
+    service: string;
+    methods: string[];
+    contextId: string;
+}
+/** 承载 mixin 方法的目标 prototype（一般是 Context.prototype） */
+type MixinTarget = object;
+/**
+ * Mixin 注册表（进程级）
+ *
+ * 职责：
+ * - 维护 mixin 条目列表（哪些服务的哪些方法被代理到了 target prototype 上）
+ * - 在 target prototype 上安装 getter，按 `this` 运行时解析服务实例并 bind
+ * - `dispose()` 时如该方法已无其他 mixin 引用则清除
+ *
+ * 设计：静态类而非单例——因为 Context.prototype 是进程级共享资源，
+ * 不存在"每实例一个 registry"的语义；集中成静态便于测试和管理。
+ */
+export declare class MixinRegistry {
+    private static _entries;
+    /**
+     * 注册 mixin：把 `serviceName` 指代的服务实例的若干方法
+     * 代理到 `target` prototype 上。
+     *
+     * @returns 卸载函数
+     */
+    static register(target: MixinTarget, serviceName: string, methods: string[], contextId: string, logger: Logger): () => void;
+    /** 当前所有 mixin 注册信息（快照） */
+    static list(): MixinEntry[];
+}
+export {};
+//# sourceMappingURL=mixin-registry.d.ts.map

package/dist/mixin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin-registry.d.ts","sourceRoot":"","sources":["../src/mixin-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,iBAAiB;AACjB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,sDAAsD;AACtD,KAAK,WAAW,GAAG,MAAM,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CACb,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,IAAI;IAoCb,0BAA0B;IAC1B,MAAM,CAAC,IAAI,IAAI,UAAU,EAAE;CAG5B"}

package/dist/mixin-registry.js

@@ -0,0 +1,60 @@
+/**
+ * Mixin 注册表（进程级）
+ *
+ * 职责：
+ * - 维护 mixin 条目列表（哪些服务的哪些方法被代理到了 target prototype 上）
+ * - 在 target prototype 上安装 getter，按 `this` 运行时解析服务实例并 bind
+ * - `dispose()` 时如该方法已无其他 mixin 引用则清除
+ *
+ * 设计：静态类而非单例——因为 Context.prototype 是进程级共享资源，
+ * 不存在"每实例一个 registry"的语义；集中成静态便于测试和管理。
+ */
+export class MixinRegistry {
+    static _entries = [];
+    /**
+     * 注册 mixin：把 `serviceName` 指代的服务实例的若干方法
+     * 代理到 `target` prototype 上。
+     *
+     * @returns 卸载函数
+     */
+    static register(target, serviceName, methods, contextId, logger) {
+        const entry = { service: serviceName, methods, contextId };
+        MixinRegistry._entries.push(entry);
+        for (const method of methods) {
+            if (method in target) {
+                logger.warn(`mixin: 方法 "${method}" 已存在于 target，跳过`);
+                continue;
+            }
+            Object.defineProperty(target, method, {
+                configurable: true,
+                enumerable: false,
+                get() {
+                    const svc = this.getService(serviceName);
+                    if (!svc)
+                        return undefined;
+                    const val = svc[method];
+                    if (typeof val === 'function')
+                        return val.bind(svc);
+                    return val;
+                },
+            });
+        }
+        logger.debug(`mixin: ${methods.join(', ')} → ${serviceName}`);
+        return () => {
+            const idx = MixinRegistry._entries.indexOf(entry);
+            if (idx >= 0)
+                MixinRegistry._entries.splice(idx, 1);
+            for (const method of methods) {
+                const stillUsed = MixinRegistry._entries.some(e => e.methods.includes(method));
+                if (!stillUsed) {
+                    delete target[method];
+                }
+            }
+        };
+    }
+    /** 当前所有 mixin 注册信息（快照） */
+    static list() {
+        return MixinRegistry._entries.map(e => ({ ...e }));
+    }
+}
+//# sourceMappingURL=mixin-registry.js.map

package/dist/mixin-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin-registry.js","sourceRoot":"","sources":["../src/mixin-registry.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAiB,EAAE,CAAC;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CACb,MAAmB,EACnB,WAAmB,EACnB,OAAiB,EACjB,SAAiB,EACjB,MAAc;QAEd,MAAM,KAAK,GAAe,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACvE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,kBAAkB,CAAC,CAAC;gBACpD,SAAS;YACX,CAAC;YACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE;gBACpC,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,KAAK;gBACjB,GAAG;oBACD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAA0B,WAAW,CAAC,CAAC;oBAClE,IAAI,CAAC,GAAG;wBAAE,OAAO,SAAS,CAAC;oBAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;oBACxB,IAAI,OAAO,GAAG,KAAK,UAAU;wBAAE,OAAQ,GAAuC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACzF,OAAO,GAAG,CAAC;gBACb,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;QAE9D,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,GAAG,IAAI,CAAC;gBAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACpD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,OAAQ,MAAkC,CAAC,MAAM,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,MAAM,CAAC,IAAI;QACT,OAAO,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC"}

package/dist/model-ref.d.ts

@@ -0,0 +1,22 @@
+export interface ModelRef {
+    /** provider 的 contextId（instanceId）。未指定则 router 走"按 model id 在所有 provider listModels 中查找" */
+    provider?: string;
+    /** 模型 id；未指定则 provider 用其默认模型 */
+    model?: string;
+}
+/**
+ * 解析复合 model 引用字符串。
+ *
+ * - `"@aalis/plugin-openai::gpt-4o"` → `{ provider: "@aalis/plugin-openai", model: "gpt-4o" }`
+ * - `"gpt-4o"` （无 `::`）→ `{ model: "gpt-4o" }`（旧风格，仅 model）
+ * - `""` / null / undefined → `{}`（让调用方走默认 provider/model）
+ *
+ * 注意：分隔符使用 `::` 而非 `:`，因为 model id 中允许包含 `:`（如 ollama 的 `qwen2.5:7b`）。
+ */
+export declare function parseModelRef(value: string | null | undefined): ModelRef;
+/**
+ * 将 (provider, model) 编码为复合 string，用于持久化或 UI 选项 value。
+ * 任一方缺失时不输出分隔符（避免产生 `::xxx` 或 `xxx::` 这种不规整形式）。
+ */
+export declare function formatModelRef(ref: ModelRef): string;
+//# sourceMappingURL=model-ref.d.ts.map

package/dist/model-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-ref.d.ts","sourceRoot":"","sources":["../src/model-ref.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,CAUxE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAGpD"}