@aalis/core 0.1.0

package/dist/plugin.js

@@ -0,0 +1,549 @@
+import { activatePlugin, computeTargetState, ensureServiceProvider } from './plugin-activation.js';
+import { evictDownstreamConsumers, topoSortByDeps } from './plugin-topology.js';
+import { normalizeDependency } from './service.js';
+import { parseInstanceId, } from './types/plugin.js';
+// 类型与纯辅助 re-export，保留同名旧导入路径
+export { parseInstanceId };
+/**
+ * 插件管理器
+ *
+ * 负责:
+ * - 注册/加载/卸载插件
+ * - 依赖追踪 (required + optional, 支持 capability 匹配)
+ * - 当所需服务就绪时自动激活插件
+ * - 当所需服务移除时自动停用插件
+ * - 插件启用/禁用控制
+ */
+export class PluginManager {
+    plugins = new Map();
+    rootCtx;
+    logger;
+    /** recompute 单飞标志：true 表示一次 recompute（含排队补跑）正在进行 */
+    reloading = false;
+    /**
+     * 手动 dispose 段计数器：disablePlugin / unload / bouncePlugin 在「dispose 旧
+     * ctx → 改 entry.state」这段不可分割的状态变更期间 +1。期间 dispose 触发的
+     * service:unregistered 反应式 recompute 会被**排队**（而非立即跑——那会看到
+     * 半成品状态，比如把正在禁用的插件重新激活），由这些方法收尾的 softReload 统一消化。
+     *
+     * 用计数器而非布尔：dispose hook 内可能同步级联调用 disablePlugin/unload（级联
+     * 禁用），嵌套时内层的 finally 若复位布尔会过早解除外层的挂起态——计数器确保
+     * 只有最外层退出（归零）才解除（审计 HIGH #3）。
+     */
+    suspendDepth = 0;
+    get suspended() {
+        return this.suspendDepth > 0;
+    }
+    /**
+     * 被推迟的 recompute 请求（修 lost wakeup：在飞期间到达的请求不再被丢弃）。
+     * 多个请求合并为一——除 shutdown 保留原 reason 外统一退化为
+     * plugin-state-changed（service-up/down 的特殊语义本就只在第一轮生效）。
+     */
+    queuedReason = null;
+    /**
+     * 全局关机标志。app.stop() 在 dispose 前置位，所有反应式级联（service:registered/
+     * unregistered → checkPending/Active）都会因此跳过——避免「正在关机还去 bounce
+     * 一个永远不会被重新激活的插件」这种无意义噪声，也避免下游插件 dispose 中
+     * 试图 register 命令 / 监听服务等动作触发误重入。
+     */
+    shuttingDown = false;
+    /** 是否正在关机——供插件 dispose hook 短路用 */
+    isShuttingDown() {
+        return this.shuttingDown;
+    }
+    /**
+     * 必需服务列表: softReload 完成后若缺失会自动恢复。
+     * 由 App 设置。
+     */
+    requiredServices = [];
+    /**
+     * 必需服务恢复政策（由 App 从 AppOptions.serviceRecovery 设置）。
+     * autoEnableDisabled=false 时恢复路径不会自动启用被用户禁用的提供者插件。
+     */
+    recoveryPolicy = { autoEnableDisabled: true };
+    constructor(rootCtx, logger) {
+        this.rootCtx = rootCtx;
+        this.logger = logger.child('plugins');
+        // 监听服务注册/注销，路由到统一 recompute()。
+        // 单飞/挂起/关机的取舍都在 recompute 内部处理（在飞期间排队，关机后跳过）。
+        rootCtx.on('service:registered', name => {
+            this.recompute({ type: 'service-up', service: name }).catch(err => {
+                this.logger.error(`recompute(service-up:${name}) 报错: ${err instanceof Error ? err.message : String(err)}`);
+            });
+        });
+        rootCtx.on('service:unregistered', name => {
+            this.recompute({ type: 'service-down', service: name }).catch(err => {
+                this.logger.error(`recompute(service-down:${name}) 报错: ${err instanceof Error ? err.message : String(err)}`);
+            });
+        });
+    }
+    /**
+     * 注册并尝试加载一个插件
+     *
+     * @param module    插件模块
+     * @param config    插件配置
+     * @param instanceId 实例 ID（多实例时为 `name:suffix`，留空则使用 module.name）
+     */
+    async register(module, config = {}, instanceId) {
+        const id = instanceId ?? module.name;
+        // 多实例检查：同一 module 非 reusable 时不允许重复注册
+        if (this.plugins.has(id)) {
+            this.logger.warn(`插件 "${id}" 已注册，跳过`);
+            return;
+        }
+        if (id !== module.name && !module.reusable) {
+            this.logger.warn(`插件 "${module.name}" 未声明 reusable，不允许多实例注册 "${id}"`);
+            return;
+        }
+        const inject = module.inject ?? {};
+        const requiredDeps = (inject.required ?? []).map(normalizeDependency);
+        const optionalDeps = (inject.optional ?? []).map(normalizeDependency);
+        // 检查是否被配置禁用（按 instanceId 检查）
+        const isDisabled = this.rootCtx.config.isPluginDisabled(id);
+        const entry = {
+            module,
+            instanceId: id,
+            config,
+            state: isDisabled ? 'disabled' : 'pending',
+            requiredDeps,
+            optionalDeps,
+        };
+        this.plugins.set(id, entry);
+        if (isDisabled) {
+            this.logger.info(`插件已注册(禁用): ${id}`);
+        }
+        else {
+            this.logger.info(`插件已注册: ${id}`);
+            // 走统一 recompute：依赖满足则被拓扑正序激活，否则保持 pending
+            await this.recompute({ type: 'plugin-state-changed' });
+        }
+    }
+    /**
+     * 卸载一个插件
+     */
+    async unload(name) {
+        const entry = this.plugins.get(name);
+        if (!entry)
+            return;
+        // dispose 段守卫（与 disablePlugin 对齐）：dispose 触发的反应式 recompute
+        // 排队到收尾的 softReload，避免在 entry 半卸载态下重算。
+        this.suspendDepth++;
+        try {
+            if (entry.state === 'active' && entry.context) {
+                entry.context.dispose();
+                entry.context = undefined;
+                this.rootCtx.emit('plugin:unloaded', name).catch(err => {
+                    this.logger.warn(`emit plugin:unloaded 失败 (${name}): ${err}`);
+                });
+            }
+            entry.state = 'disposed';
+            this.plugins.delete(name);
+            this.logger.info(`插件已卸载: ${name}`);
+        }
+        finally {
+            this.suspendDepth--;
+        }
+        // 级联重算：依赖被卸载插件所提供服务的下游需要转 pending
+        await this.softReload();
+    }
+    /**
+     * 启用一个已禁用的插件
+     */
+    async enablePlugin(name) {
+        const entry = this.plugins.get(name);
+        if (!entry)
+            return false;
+        if (entry.state !== 'disabled' && entry.state !== 'error')
+            return true; // 已经启用
+        entry.state = 'pending';
+        entry.error = undefined;
+        this.rootCtx.config.setPluginEnabled(name, true);
+        this.logger.info(`插件已启用: ${name}`);
+        await this.softReload();
+        return true;
+    }
+    /**
+     * 禁用一个活跃的插件（core 插件不能禁用）
+     */
+    async disablePlugin(name) {
+        const entry = this.plugins.get(name);
+        if (!entry)
+            return false;
+        if (entry.module.core) {
+            this.logger.warn(`核心插件 "${name}" 不能被禁用`);
+            return false;
+        }
+        if (entry.state === 'disabled')
+            return true; // 已经禁用
+        // dispose 段守卫：期间反应式 recompute 排队到收尾的 softReload
+        this.suspendDepth++;
+        try {
+            if (entry.state === 'active' && entry.context) {
+                entry.context.dispose();
+                entry.context = undefined;
+                this.rootCtx.emit('plugin:unloaded', name).catch(err => {
+                    this.logger.warn(`emit plugin:unloaded 失败 (${name}): ${err}`);
+                });
+            }
+            entry.state = 'disabled';
+            this.rootCtx.config.setPluginEnabled(name, false);
+            this.logger.info(`插件已禁用: ${name}`);
+        }
+        finally {
+            this.suspendDepth--;
+        }
+        await this.softReload();
+        return true;
+    }
+    /**
+     * 获取所有已注册插件的状态
+     *
+     * 返回类型即 PluginManagerService 接口的 PluginStatusEntry（types/app.ts），
+     * 编译期保证两边不漂移。
+     */
+    getStatus() {
+        return [...this.plugins.entries()].map(([, entry]) => {
+            // subsystem / extends 由 @aalis/plugin-webui-api 通过 declaration merging
+            // 注入，core 不感知其语义，仅透传给 listPlugins() 调用方。
+            // 实际消费者：plugin-webui-server（按 subsystem 将插件归组渲染到 dashboard，
+            // 见 packages/plugin-webui-server/src/index.ts）。"core 不消费 ≠ 系统未消费"。
+            const m = entry.module;
+            return {
+                name: entry.module.name,
+                instanceId: entry.instanceId,
+                displayName: entry.module.displayName,
+                subsystem: m.subsystem,
+                state: entry.state,
+                provides: entry.module.provides,
+                core: entry.module.core,
+                reusable: entry.module.reusable,
+                extends: m.extends,
+                requiredServices: entry.requiredDeps.length > 0 ? entry.requiredDeps.map(d => d.service) : undefined,
+                optionalServices: entry.optionalDeps.length > 0 ? entry.optionalDeps.map(d => d.service) : undefined,
+                config: entry.config,
+                configSchema: entry.module.configSchema,
+                defaultConfig: entry.module.defaultConfig,
+                error: entry.error,
+            };
+        });
+    }
+    /**
+     * 获取单个插件
+     */
+    getPlugin(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * 更新插件配置（thin alias，转发到 bouncePlugin）。保留独立方法名是为了
+     * 让 host 层调用点（WebUI / 配置文件热重载）语义清晰且向后兼容。
+     */
+    async updatePluginConfig(name, config) {
+        return this.bouncePlugin(name, { config });
+    }
+    /**
+     * 增量重载单个插件（核心入口）：
+     *
+     * 1. 持久化新 config（如有）+ 替换 module（如有）+ dispose 旧 ctx
+     *    + 转 pending + softReload 重新激活。下游消费者默认不会被级联 bounce，
+     *    除非显式声明 `requiresBounceOnDepChange: true`（见 evictDownstreamConsumers）。
+     * 2. `error` 态插件会被重置为 pending 重试 apply。
+     *
+     * 不负责"重新从磁盘 import"——那是宿主层的职责。
+     *
+     * @returns false 表示找不到 entry 或处于 disabled 态（拒绝 bounce）。
+     */
+    async bouncePlugin(name, opts) {
+        const entry = this.plugins.get(name);
+        if (!entry)
+            return false;
+        if (entry.state === 'disabled') {
+            this.logger.warn(`bouncePlugin: 插件 "${name}" 处于 disabled 态，跳过`);
+            return false;
+        }
+        const newConfig = opts?.config;
+        const newModule = opts?.module;
+        if (newConfig) {
+            entry.config = newConfig;
+            this.rootCtx.config.setPluginConfig(name, newConfig);
+        }
+        if (newModule)
+            entry.module = newModule;
+        // dispose 段守卫（与 disablePlugin / unload 对齐）：dispose 触发的反应式
+        // recompute 不能在 entry 尚未转 pending 时跑——会把半 bounce 态误判。
+        this.suspendDepth++;
+        try {
+            if (entry.state === 'active' && entry.context) {
+                evictDownstreamConsumers({
+                    provider: entry,
+                    plugins: this.plugins,
+                    rootCtx: this.rootCtx,
+                    logger: this.logger,
+                });
+                entry.context.dispose();
+                entry.context = undefined;
+                this.rootCtx.emit('plugin:unloaded', name).catch(err => {
+                    this.logger.warn(`emit plugin:unloaded 失败 (${name}): ${err}`);
+                });
+            }
+            entry.state = 'pending';
+            entry.error = undefined;
+        }
+        finally {
+            this.suspendDepth--;
+        }
+        await this.softReload();
+        return true;
+    }
+    /**
+     * 在运行时基于 reusable 模块新增一个实例（写入配置 + 触发激活）。
+     *
+     * @param moduleName 原始模块名（如 `@aalis/plugin-openai`）
+     * @param suffix     实例后缀（如 `vision`），将生成 instanceId `moduleName:suffix`
+     * @param config     新实例的配置
+     * @returns 新实例的 instanceId，失败返回 undefined
+     */
+    async createInstance(moduleName, suffix, config = {}) {
+        // 从已注册的插件中查找同 module 的 entry
+        let sourceModule;
+        for (const entry of this.plugins.values()) {
+            if (entry.module.name === moduleName) {
+                sourceModule = entry.module;
+                break;
+            }
+        }
+        if (!sourceModule) {
+            this.logger.warn(`创建实例失败: 模块 "${moduleName}" 未找到`);
+            return undefined;
+        }
+        if (!sourceModule.reusable) {
+            this.logger.warn(`创建实例失败: 模块 "${moduleName}" 未声明 reusable`);
+            return undefined;
+        }
+        const instanceId = `${moduleName}:${suffix}`;
+        if (this.plugins.has(instanceId)) {
+            this.logger.warn(`创建实例失败: "${instanceId}" 已存在`);
+            return undefined;
+        }
+        // 合并配置：默认配置 ← 传入配置
+        const defaults = sourceModule.defaultConfig ?? {};
+        const mergedConfig = { ...defaults, ...config };
+        // 写入配置文件
+        this.rootCtx.config.setPluginConfig(instanceId, mergedConfig);
+        // 注册并尝试激活
+        await this.register(sourceModule, mergedConfig, instanceId);
+        return instanceId;
+    }
+    /**
+     * 移除一个多实例插件（不允许移除主实例）
+     */
+    async removeInstance(instanceId) {
+        const { suffix } = parseInstanceId(instanceId);
+        if (!suffix) {
+            this.logger.warn(`不能移除主实例 "${instanceId}"`);
+            return false;
+        }
+        const entry = this.plugins.get(instanceId);
+        if (!entry)
+            return false;
+        // 卸载
+        await this.unload(instanceId);
+        // 从配置文件中移除
+        this.rootCtx.config.removePluginConfig(instanceId);
+        await this.softReload();
+        return true;
+    }
+    /**
+     * 全局停机：按依赖拓扑逆序 dispose 所有 active 插件。
+     *
+     * 顺序原则：「消费者先关，提供者后关」——一个插件若 require/optional 依赖另一个
+     * 插件 provides 的服务，则前者 dispose 必须先于后者。这样下游插件的 dispose hook
+     * 还能安全地访问其依赖的服务（如把待持久化数据冲到 storage、把订阅从 gateway 摘掉）。
+     *
+     * 实现是 Kahn 风格 BFS：
+     * 1. 把 active 插件构成「依赖图」边：consumer → provider（基于 module.provides）
+     * 2. 反复挑出 in-degree==0 的节点（没人依赖它们 = 处于拓扑顶端 = 应当先 dispose）
+     * 3. dispose 后从图中移除，刷新 in-degree
+     * 4. 若残留环（不应该发生，softReload 期间会警告），按声明顺序 dispose 兜底
+     *
+     * 此方法预设 `shuttingDown=true`，service:unregistered 不再触发反应式 bounce；
+     * 因此本方法是**关机时唯一**的 dispose 编排者，不与级联机制竞争。
+     */
+    async stopAll() {
+        await this.recompute({ type: 'shutdown' });
+    }
+    /**
+     * 软重载（薄壳）：把"插件状态需要重算"统一委托给 recompute()。
+     *
+     * 历史上 softReload / stopAll / checkActivePlugins / checkPendingPlugins 是四
+     * 条独立路径，每条都自己判断"哪些插件该跑、按什么顺序"。逻辑漂移导致 stopAll
+     * 之外的三条路径在"同一轮多个插件同时变状态"时无法保证消费者先于提供者关闭，
+     * 瞬态会出现 dispose hook 访问已失效服务的情况。现在四条路径共用 recompute()。
+     */
+    async softReload() {
+        await this.recompute({ type: 'plugin-state-changed' });
+    }
+    // ---- 单一状态转移入口 ----
+    /**
+     * 重算所有插件的目标态并按依赖拓扑序应用转移。
+     *
+     * 这是 PluginManager 唯一的状态变更入口（除 ensureServiceProvider 这种显式
+     * 启用 disabled 提供者的恢复策略之外）。
+     *
+     * 算法：
+     * 1. 反应式 reason 决定"是否走完整 fixed-point + 是否触发 optional bounce"；
+     *    shutdown 走单向 down 路径，其它走 fixed-point。
+     * 2. 每轮先按依赖正序（提供者→消费者）做拓扑排序。
+     * 3. Phase A：反向遍历，把"目标不再 active"的 entry 一并 dispose
+     *    （消费者先关、提供者后关，dispose hook 访问依赖服务安全）。
+     * 4. Phase B（非 shutdown）：正向遍历，激活"目标 active 且依赖满足"的 pending entry
+     *    （提供者先起、消费者后起）。
+     * 5. 若本轮有变动则继续下一轮，直到稳定或达到 maxRounds。
+     * 6. 非 shutdown 时检查必需服务并发出 plugins:changed。
+     *
+     * Aalis 直接用"服务在不在 + capabilities 命中"
+     * 做判断 —— 表达力等价、复杂度更低。
+     */
+    async recompute(reason) {
+        if (this.shuttingDown && reason.type !== 'shutdown') {
+            // 关机已置位时非关机请求无意义；但若队列里躺着一个被挂起的 shutdown
+            // （stop() 与手动 dispose 段竞态），借这次调用把它接过来跑完。
+            if (this.queuedReason?.type !== 'shutdown')
+                return;
+            reason = this.queuedReason;
+            this.queuedReason = null;
+        }
+        if (reason.type === 'shutdown')
+            this.shuttingDown = true;
+        // 单飞 + 排队（修 lost wakeup）：在飞期间/手动 dispose 段的请求合并排队，
+        // 由在飞 run 收尾时补跑或 dispose 段收尾的 softReload 消化。注意这里必须
+        // 立即返回而不能把在飞 promise 交还调用方——若调用方恰在某插件 apply()
+        // 内同步调用（在飞 run 正 await 它），等待在飞 promise 会自我死锁。
+        if (this.reloading || this.suspended) {
+            this.queuedReason = reason.type === 'shutdown' ? reason : (this.queuedReason ?? { type: 'plugin-state-changed' });
+            return;
+        }
+        this.reloading = true;
+        try {
+            let current = reason;
+            while (current) {
+                await this.recomputeOnce(current);
+                current = this.queuedReason;
+                this.queuedReason = null;
+            }
+        }
+        finally {
+            this.reloading = false;
+        }
+    }
+    /** 单次完整重算：fixed-point 状态转移 + （非关机）必需服务恢复与 plugins:changed 通知 */
+    async recomputeOnce(reason) {
+        let currentReason = reason;
+        let changed = true;
+        let rounds = 0;
+        const maxRounds = 20;
+        while (changed && rounds < maxRounds) {
+            changed = false;
+            rounds++;
+            const entries = [...this.plugins.values()];
+            const order = topoSortByDeps(entries, this.logger);
+            // Phase A: 反向遍历，关掉目标不是 active 的 active entry
+            for (const entry of [...order].reverse()) {
+                if (entry.state !== 'active')
+                    continue;
+                const target = computeTargetState(entry, currentReason, this.rootCtx);
+                if (target === 'active')
+                    continue;
+                // 日志：区分 shutdown / required 不满 / optional bounce
+                if (currentReason.type === 'shutdown') {
+                    // 静默
+                }
+                else {
+                    const unmet = entry.requiredDeps.find(d => !this.rootCtx.hasService(d.service, d.capabilities.length > 0 ? d.capabilities : undefined));
+                    if (unmet) {
+                        this.logger.info(`依赖 "${unmet.service}" 不可用，停用插件: ${entry.instanceId}`);
+                    }
+                    else if (currentReason.type === 'service-down') {
+                        // 被动级联降级（依赖服务下线 → 转 pending 等待重新满足），
+                        // 区别于 bouncePlugin() 的主动重载，措辞不混用 bounce。
+                        this.logger.info(`依赖服务 "${currentReason.service}" 已下线，降级插件为待激活: ${entry.instanceId}`);
+                    }
+                }
+                if (entry.context) {
+                    try {
+                        entry.context.dispose();
+                    }
+                    catch (err) {
+                        this.logger.error(`插件 "${entry.instanceId}" dispose 抛错: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                    entry.context = undefined;
+                }
+                entry.state = currentReason.type === 'shutdown' ? 'disposed' : 'pending';
+                if (currentReason.type !== 'shutdown') {
+                    this.rootCtx.emit('plugin:unloaded', entry.instanceId).catch(err => {
+                        this.logger.warn(`emit plugin:unloaded 失败 (${entry.instanceId}): ${err}`);
+                    });
+                }
+                changed = true;
+            }
+            // 关机不需要再激活
+            if (currentReason.type === 'shutdown')
+                break;
+            // Phase B: 正向遍历，激活目标 active 的 pending entry
+            for (const entry of order) {
+                if (entry.state !== 'pending')
+                    continue;
+                const target = computeTargetState(entry, currentReason, this.rootCtx);
+                if (target !== 'active')
+                    continue;
+                await activatePlugin(entry, { plugins: this.plugins, rootCtx: this.rootCtx, logger: this.logger });
+                if (entry.state === 'active')
+                    changed = true;
+            }
+            // service-up / service-down 的"特殊语义"只在第一轮生效（避免无限 bounce）；
+            // 第二轮起退化为普通的 plugin-state-changed 重算。
+            if (currentReason.type === 'service-up' || currentReason.type === 'service-down') {
+                currentReason = { type: 'plugin-state-changed' };
+            }
+        }
+        if (rounds >= maxRounds) {
+            this.logger.warn('recompute 达到最大迭代次数，可能存在循环依赖');
+        }
+        if (reason.type === 'shutdown')
+            return;
+        // 必需服务自动恢复
+        for (const service of this.requiredServices) {
+            if (!this.rootCtx.hasService(service)) {
+                this.logger.warn(`必需服务 "${service}" 缺失，尝试自动恢复...`);
+                const activated = await ensureServiceProvider(service, {
+                    plugins: this.plugins,
+                    rootCtx: this.rootCtx,
+                    logger: this.logger,
+                    recovery: this.recoveryPolicy,
+                });
+                if (activated) {
+                    this.logger.info(`必需服务 "${service}" 已通过插件 "${activated}" 恢复`);
+                }
+                else {
+                    this.logger.error(`必需服务 "${service}" 自动恢复失败！`);
+                }
+            }
+        }
+        this.rootCtx.emit('plugins:changed').catch(err => {
+            this.logger.warn(`emit plugins:changed 失败: ${err}`);
+        });
+    }
+    /**
+     * 为外部（App）暴露的「必需服务自动恢复」入口。
+     *
+     * 实际逻辑在 plugin-activation.ts。PluginManager 仅负责注入 plugins/rootCtx/logger。
+     */
+    async ensureServiceProvider(serviceName) {
+        return ensureServiceProvider(serviceName, {
+            plugins: this.plugins,
+            rootCtx: this.rootCtx,
+            logger: this.logger,
+            recovery: this.recoveryPolicy,
+        });
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/providers.d.ts

@@ -0,0 +1,85 @@
+import type { AalisConfig } from './config.js';
+import type { PluginModule } from './plugin.js';
+/**
+ * `@aalis/core` 注入点（host providers）。
+ *
+ * 把"配置从哪里来 / 插件从哪里来 / 怎么重启"这三件 I/O 相关的事
+ * 抽成接口，由宿主（src/runtime 或外部嵌入者）实现并注入。core 本身
+ * 不再 import 任何 `node:fs` / `node:path` / `node:url` / `node:child_process`
+ * / `yaml`，可在浏览器、单文件二进制、嵌入式集成等场景里运行。
+ *
+ * 设计原则：
+ * - **同步优先**：能同步就同步（fs sync 读 yaml 完全可接受）；异步留给真异步源
+ *   （HTTP、远程配置中心等）。
+ * - **可选能力**：`save` / `watch` / `reload` 都标记为可选；只读宿主可以不提供。
+ * - **opaque metadata**：descriptor.source 等字段是 loader 自己理解的字符串；core 不解释。
+ */
+/**
+ * 配置提供者：负责"持久化层"。core 内部的 `ConfigManager` 持有运行时
+ * 解析后的 `AalisConfig` 快照，所有读写都走自己的内存结构；
+ * `save()` / `watch()` 才转交给 provider。
+ *
+ * 因此 provider 不必提供 `load()`——`AalisConfig` 由宿主在构造 `App` 之前
+ * 自己加载好传进来即可。这让 core 完全无视"配置从哪里读"的细节。
+ */
+export interface ConfigProvider {
+    /**
+     * 持久化当前完整 config 快照。
+     *
+     * 实现可以做：写文件、PUT 到 HTTP 端点、写 KV 存储等。
+     * 不提供时表示宿主拒绝持久化（典型场景：内存配置 / 只读部署）。
+     */
+    save?(config: AalisConfig): void | Promise<void>;
+    /**
+     * 订阅外部对配置源的变更（其他进程改了配置文件、远端推送等）。
+     *
+     * 当 provider 检测到 config 已变化时调用 `onChange(next)`，
+     * core 的 ConfigManager 会用新快照重置内部状态并触发热重载。
+     *
+     * 返回的 dispose 函数会在 `App.stop()` 时被调用。
+     */
+    watch?(onChange: (next: AalisConfig) => void): () => void;
+}
+/**
+ * 已发现但尚未导入的插件条目。`source` 是 loader 自己理解的字符串
+ * （fs loader 用绝对路径，URL loader 用 URL，内存 loader 用 module 别名）。
+ * core 仅用它在 `reload()` 调用时回传——不解释含义。
+ */
+export interface PluginDescriptor {
+    /** 插件模块名，与 `PluginModule.name` 一致；core 用此匹配多实例配置 */
+    name: string;
+    /** 给 loader 自己用的不透明定位串 */
+    source: string;
+    /** loader 可挂任意辅助元数据（cache key、版本号、manifest 等） */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 插件加载器：负责"插件从哪里来"。
+ *
+ * - `discover()` 列出当前可用的插件条目
+ * - `load(descriptor)` 把条目 import 成 `PluginModule`
+ * - `reload(descriptor)` 可选——支持热重载（fs loader 用 mtime 做 cache buster）
+ */
+export interface PluginLoader {
+    discover(): Promise<PluginDescriptor[]>;
+    load(descriptor: PluginDescriptor): Promise<PluginModule | null>;
+    /** 热重载——不提供时 `App.rescanPlugins()` 会退化为 `load()` */
+    reload?(descriptor: PluginDescriptor): Promise<PluginModule | null>;
+}
+/**
+ * 重启策略：`App.restart()` 把"如何重启"委托给宿主。
+ *
+ * - Node 进程宿主：spawn 一个新进程然后退出
+ * - 浏览器宿主：`location.reload()`
+ * - 嵌入式宿主：可能就是 noop，或者通知外层重新创建 App
+ *
+ * `restart(opts.stop)` 由 App 传入"先停掉当前实例"的回调；
+ * **时序由 strategy 决定**——例如 HTTP 宿主可能想先延迟几百毫秒让响应返回客户端再 stop，
+ * CLI/嵌入式宿主可能直接 `await stop()` 后立刻重启，core 不再硬编码时延。
+ */
+export interface RestartStrategy {
+    restart(opts: {
+        stop: () => Promise<void>;
+    }): void | Promise<void>;
+}
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AAMH;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3D;AAMD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACjE,oDAAoD;IACpD,MAAM,CAAC,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACrE;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE"}

package/dist/providers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=providers.js.map