@aalis/core 0.1.0

package/dist/model-ref.js

@@ -0,0 +1,46 @@
+// ===== Model 引用编解码 =====
+//
+// 把 (provider, model) 二元组与配置/UI 友好的 string 形式互转，避免在 yaml 与 form 里
+// 引入复合 schema。yaml 与 WebUI dynamicOptions:'llm' 的 select value 都使用此格式：
+//
+//   "<providerContextId>::<modelId>"
+//
+// 例如：
+//   "@aalis/plugin-openai::gpt-4o"
+//   "@aalis/plugin-deepseek::deepseek-chat"
+//   "@aalis/plugin-ollama::qwen2.5:7b"   ← model id 内部出现 ':' 仍然安全（用 '::' 分隔）
+//
+// 只接受 contextId 作为 provider 部分；不接受 label，避免歧义。
+const MODEL_REF_SEPARATOR = '::';
+/**
+ * 解析复合 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 function parseModelRef(value) {
+    if (!value)
+        return {};
+    const idx = value.indexOf(MODEL_REF_SEPARATOR);
+    if (idx < 0)
+        return { model: value };
+    const provider = value.slice(0, idx);
+    const model = value.slice(idx + MODEL_REF_SEPARATOR.length);
+    return {
+        provider: provider || undefined,
+        model: model || undefined,
+    };
+}
+/**
+ * 将 (provider, model) 编码为复合 string，用于持久化或 UI 选项 value。
+ * 任一方缺失时不输出分隔符（避免产生 `::xxx` 或 `xxx::` 这种不规整形式）。
+ */
+export function formatModelRef(ref) {
+    if (ref.provider && ref.model)
+        return `${ref.provider}${MODEL_REF_SEPARATOR}${ref.model}`;
+    return ref.model ?? ref.provider ?? '';
+}
+//# sourceMappingURL=model-ref.js.map

package/dist/model-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-ref.js","sourceRoot":"","sources":["../src/model-ref.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,EAAE;AACF,kEAAkE;AAClE,uEAAuE;AACvE,EAAE;AACF,qCAAqC;AACrC,EAAE;AACF,MAAM;AACN,mCAAmC;AACnC,4CAA4C;AAC5C,6EAA6E;AAC7E,EAAE;AACF,+CAA+C;AAE/C,MAAM,mBAAmB,GAAG,IAAI,CAAC;AASjC;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgC;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/C,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO;QACL,QAAQ,EAAE,QAAQ,IAAI,SAAS;QAC/B,KAAK,EAAE,KAAK,IAAI,SAAS;KAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAa;IAC1C,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,GAAG,GAAG,CAAC,QAAQ,GAAG,mBAAmB,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1F,OAAO,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/pending-buffer.d.ts

@@ -0,0 +1,46 @@
+import type { DisposableChain } from './disposable-chain.js';
+import type { Logger } from './logger.js';
+import type { ServiceContainer } from './service.js';
+import type { RegisteredTool, ToolGroupInfo, CommandDefinition, AalisEvents } from './types/index.js';
+/**
+ * 工具/指令注册缓冲
+ *
+ * 用途：插件加载顺序无法保证 tools/commands 服务已就绪时，
+ * 调用 `ctx.registerTool / registerToolGroup / command` 会被临时收纳，
+ * 等 `service:registered` 事件触发后自动刷入真实服务。
+ *
+ * 从 Context 抽出以便独立测试与理解。
+ *
+ * 设计要点：
+ * - 该缓冲是"按 Context 实例一份"的，因为每条注册都要归属到发起者 contextId
+ * - 刷入成功后获得的 dispose 函数会被加入传入的 DisposableChain，保证 Context
+ *   dispose 时能统一回收
+ * - 如调用方尚未刷入前主动 dispose，会从本地数组里移除条目，不会到达底层服务
+ */
+export declare class PendingRegistrationBuffer {
+    private readonly contextId;
+    private readonly services;
+    private readonly logger;
+    private readonly disposables;
+    /** 由 Context 注入的 `on(event, handler)` —— 让生命周期统一托管 */
+    private readonly onEvent;
+    private _tools;
+    private _toolGroups;
+    private _commands;
+    private _flushListenerAttached;
+    constructor(contextId: string, services: ServiceContainer, logger: Logger, disposables: DisposableChain, 
+    /** 由 Context 注入的 `on(event, handler)` —— 让生命周期统一托管 */
+    onEvent: <E extends string & keyof AalisEvents>(event: E, handler: (...args: AalisEvents[E]) => void | Promise<void>) => () => void);
+    /** 注册 AI 工具。服务可用则直接注册，否则缓冲到 tools 服务就绪。 */
+    registerTool(tool: Omit<RegisteredTool, 'pluginName'>): () => void;
+    /** 注册工具分组。行为同 registerTool。 */
+    registerToolGroup(group: Omit<ToolGroupInfo, 'pluginName'>): () => void;
+    /** 注册斜杠指令。服务可用则直接注册，否则缓冲到 commands 服务就绪。 */
+    registerCommand(def: CommandDefinition): () => void;
+    /** 清空本地缓冲（Context.dispose 时调用，底层服务已由 DisposableChain 回收） */
+    clear(): void;
+    private _ensureFlushListener;
+    private _flushTools;
+    private _flushCommands;
+}
+//# sourceMappingURL=pending-buffer.d.ts.map

package/dist/pending-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-buffer.d.ts","sourceRoot":"","sources":["../src/pending-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAA+B,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnI;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAAyB;IAOlC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,SAAS,CAAmD;IACpE,OAAO,CAAC,sBAAsB,CAAS;gBAGpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe;IAC7C,sDAAsD;IACrC,OAAO,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAC7D,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KACvD,MAAM,IAAI;IAGjB,2CAA2C;IAC3C,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,MAAM,IAAI;IAgBlE,+BAA+B;IAC/B,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,GAAG,MAAM,IAAI;IAgBvE,4CAA4C;IAC5C,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAiBnD,4DAA4D;IAC5D,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,cAAc;CASvB"}

package/dist/pending-buffer.js

@@ -0,0 +1,131 @@
+/**
+ * 工具/指令注册缓冲
+ *
+ * 用途：插件加载顺序无法保证 tools/commands 服务已就绪时，
+ * 调用 `ctx.registerTool / registerToolGroup / command` 会被临时收纳，
+ * 等 `service:registered` 事件触发后自动刷入真实服务。
+ *
+ * 从 Context 抽出以便独立测试与理解。
+ *
+ * 设计要点：
+ * - 该缓冲是"按 Context 实例一份"的，因为每条注册都要归属到发起者 contextId
+ * - 刷入成功后获得的 dispose 函数会被加入传入的 DisposableChain，保证 Context
+ *   dispose 时能统一回收
+ * - 如调用方尚未刷入前主动 dispose，会从本地数组里移除条目，不会到达底层服务
+ */
+export class PendingRegistrationBuffer {
+    contextId;
+    services;
+    logger;
+    disposables;
+    onEvent;
+    _tools = [];
+    _toolGroups = [];
+    _commands = [];
+    _flushListenerAttached = false;
+    constructor(contextId, services, logger, disposables, 
+    /** 由 Context 注入的 `on(event, handler)` —— 让生命周期统一托管 */
+    onEvent) {
+        this.contextId = contextId;
+        this.services = services;
+        this.logger = logger;
+        this.disposables = disposables;
+        this.onEvent = onEvent;
+    }
+    /** 注册 AI 工具。服务可用则直接注册，否则缓冲到 tools 服务就绪。 */
+    registerTool(tool) {
+        const tools = this.services.get('tools');
+        if (tools) {
+            const dispose = tools.register(tool, this.contextId);
+            this.disposables.push(dispose);
+            return dispose;
+        }
+        this._tools.push(tool);
+        this._ensureFlushListener();
+        this.logger.debug(`工具 "${tool.definition.function.name}" 已缓冲，等待 tools 服务就绪`);
+        return () => {
+            const idx = this._tools.indexOf(tool);
+            if (idx >= 0)
+                this._tools.splice(idx, 1);
+        };
+    }
+    /** 注册工具分组。行为同 registerTool。 */
+    registerToolGroup(group) {
+        const tools = this.services.get('tools');
+        if (tools) {
+            const dispose = tools.registerGroup(group, this.contextId);
+            this.disposables.push(dispose);
+            return dispose;
+        }
+        this._toolGroups.push(group);
+        this._ensureFlushListener();
+        this.logger.debug(`工具分组 "${group.name}" 已缓冲，等待 tools 服务就绪`);
+        return () => {
+            const idx = this._toolGroups.indexOf(group);
+            if (idx >= 0)
+                this._toolGroups.splice(idx, 1);
+        };
+    }
+    /** 注册斜杠指令。服务可用则直接注册，否则缓冲到 commands 服务就绪。 */
+    registerCommand(def) {
+        const commands = this.services.get('commands');
+        if (commands) {
+            const dispose = commands.register(def, this.contextId);
+            this.disposables.push(dispose);
+            return dispose;
+        }
+        const entry = { def, ctxId: this.contextId };
+        this._commands.push(entry);
+        this._ensureFlushListener();
+        this.logger.debug(`指令 "${def.name}" 已缓冲，等待 commands 服务就绪`);
+        return () => {
+            const idx = this._commands.indexOf(entry);
+            if (idx >= 0)
+                this._commands.splice(idx, 1);
+        };
+    }
+    /** 清空本地缓冲（Context.dispose 时调用，底层服务已由 DisposableChain 回收） */
+    clear() {
+        this._tools = [];
+        this._toolGroups = [];
+        this._commands = [];
+    }
+    _ensureFlushListener() {
+        if (this._flushListenerAttached)
+            return;
+        this._flushListenerAttached = true;
+        const off = this.onEvent('service:registered', (svcName) => {
+            if (svcName === 'tools')
+                this._flushTools();
+            if (svcName === 'commands')
+                this._flushCommands();
+        });
+        this.disposables.push(off);
+    }
+    _flushTools() {
+        const tools = this.services.get('tools');
+        if (!tools)
+            return;
+        for (const tool of this._tools) {
+            const dispose = tools.register(tool, this.contextId);
+            this.disposables.push(dispose);
+        }
+        this._tools = [];
+        for (const group of this._toolGroups) {
+            const dispose = tools.registerGroup(group, this.contextId);
+            this.disposables.push(dispose);
+        }
+        this._toolGroups = [];
+    }
+    _flushCommands() {
+        const commands = this.services.get('commands');
+        if (!commands)
+            return;
+        for (const { def, ctxId } of this._commands) {
+            const dispose = commands.register(def, ctxId);
+            this.disposables.push(dispose);
+        }
+        this._commands = [];
+    }
+}
+//# sourceMappingURL=pending-buffer.js.map

package/dist/pending-buffer.js.map

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

package/dist/platform-registry.d.ts

@@ -0,0 +1,40 @@
+import type { ServiceContainer } from './service.js';
+import type { PlatformAdapter, PlatformConnection, PlatformSelfIdentity } from './types/index.js';
+/**
+ * 平台注册表
+ *
+ * 从 ServiceContainer 中聚合 `'platform'` 服务的所有条目，返回按不同视角
+ * 的平台信息快照。不持有状态——每次调用直接从容器读取。
+ *
+ * 提取动机：把"领域聚合查询"从 Context 里抽出，与 LLMRouter 同风格。
+ */
+export declare class PlatformRegistry {
+    private readonly services;
+    constructor(services: ServiceContainer);
+    /**
+     * 获取所有已注册的平台适配器实例（过滤掉不合规的）。
+     */
+    listAdapters(): PlatformAdapter[];
+    /**
+     * 获取所有已注册的平台名称（去重）。
+     *
+     * 基于各 platform 服务的 capabilities 聚合，而非 adapter.platform 字段，
+     * 因此一个 adapter 可以声明承载多个 platform（罕见）。
+     */
+    listPlatformNames(): string[];
+    /**
+     * 获取所有平台适配器及其连接详情
+     */
+    listDetails(): Array<{
+        adapterName: string;
+        platform: string;
+        contextId: string;
+        capabilities: string[];
+        connections: PlatformConnection[];
+    }>;
+    /**
+     * 获取某个平台账号自身身份。
+     */
+    getSelfIdentity(platform: string, sessionId?: string): PlatformSelfIdentity | undefined;
+}
+//# sourceMappingURL=platform-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-registry.d.ts","sourceRoot":"","sources":["../src/platform-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAElG;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAEvD;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAMjC;;;;;OAKG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAQ7B;;OAEG;IACH,WAAW,IAAI,KAAK,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,kBAAkB,EAAE,CAAC;KACnC,CAAC;IAaF;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;CAQxF"}

package/dist/platform-registry.js

@@ -0,0 +1,64 @@
+/**
+ * 平台注册表
+ *
+ * 从 ServiceContainer 中聚合 `'platform'` 服务的所有条目，返回按不同视角
+ * 的平台信息快照。不持有状态——每次调用直接从容器读取。
+ *
+ * 提取动机：把"领域聚合查询"从 Context 里抽出，与 LLMRouter 同风格。
+ */
+export class PlatformRegistry {
+    services;
+    constructor(services) {
+        this.services = services;
+    }
+    /**
+     * 获取所有已注册的平台适配器实例（过滤掉不合规的）。
+     */
+    listAdapters() {
+        return this.services.getEntries('platform')
+            .map(e => e.instance)
+            .filter(a => a && typeof a.getConnections === 'function');
+    }
+    /**
+     * 获取所有已注册的平台名称（去重）。
+     *
+     * 基于各 platform 服务的 capabilities 聚合，而非 adapter.platform 字段，
+     * 因此一个 adapter 可以声明承载多个 platform（罕见）。
+     */
+    listPlatformNames() {
+        const names = new Set();
+        for (const entry of this.services.getEntries('platform')) {
+            for (const cap of entry.capabilities)
+                names.add(cap);
+        }
+        return [...names];
+    }
+    /**
+     * 获取所有平台适配器及其连接详情
+     */
+    listDetails() {
+        return this.services.getEntries('platform').map(entry => {
+            const adapter = entry.instance;
+            return {
+                adapterName: adapter.adapterName,
+                platform: adapter.platform,
+                contextId: entry.contextId,
+                capabilities: [...entry.capabilities],
+                connections: adapter.getConnections(),
+            };
+        });
+    }
+    /**
+     * 获取某个平台账号自身身份。
+     */
+    getSelfIdentity(platform, sessionId) {
+        for (const entry of this.services.getEntries('platform')) {
+            const adapter = entry.instance;
+            if (!adapter || adapter.platform !== platform)
+                continue;
+            return adapter.getSelfIdentity?.(sessionId);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=platform-registry.js.map

package/dist/platform-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-registry.js","sourceRoot":"","sources":["../src/platform-registry.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAE3D;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;aACxC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAA2B,CAAC;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,iBAAiB;QACf,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,WAAW;QAOT,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACtD,MAAM,OAAO,GAAG,KAAK,CAAC,QAA2B,CAAC;YAClD,OAAO;gBACL,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;gBACrC,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE;aACtC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAgB,EAAE,SAAkB;QAClD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,MAAM,OAAO,GAAG,KAAK,CAAC,QAA2B,CAAC;YAClD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBAAE,SAAS;YACxD,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/plugin-activation.d.ts

@@ -0,0 +1,43 @@
+import type { Context } from './context.js';
+import type { Logger } from './logger.js';
+import type { PluginEntry, PluginState, RecomputeReason } from './types/plugin.js';
+interface ActivationDeps {
+    plugins: Map<string, PluginEntry>;
+    rootCtx: Context;
+    logger: Logger;
+    /** 必需服务恢复政策（宿主经 AppOptions.serviceRecovery 注入；缺省允许自动启用 disabled 提供者） */
+    recovery?: {
+        autoEnableDisabled: boolean;
+    };
+}
+/**
+ * 计算单个 entry 的目标状态。
+ *
+ * - disabled / disposed / error 是显式态，recompute 不动它们
+ * - required 依赖不满足 → pending
+ * - service-down 命中 optional 依赖且服务确实没了且声明了
+ *   `requiresBounceOnDepChange: true` → pending（级联 bounce）；
+ *   默认不级联，期望下游在每次访问时 `ctx.getService(...)` 惰性查询
+ * - 其余 active / pending / activating → active
+ */
+export declare function computeTargetState(entry: PluginEntry, reason: RecomputeReason, rootCtx: Context): PluginState;
+/**
+ * 尝试激活一个 pending 插件：依赖检查 → fork ctx → apply → provides 校验。
+ *
+ * 失败时把 entry 转为 error 态（带 message），ctx 已 dispose，外层 recompute 不会重试。
+ * 调用方需保证 entry.state === 'pending' 才调用本函数（否则直接 return）。
+ */
+export declare function activatePlugin(entry: PluginEntry, deps: ActivationDeps): Promise<void>;
+/**
+ * 查找能提供指定服务的插件并尝试激活它。
+ *
+ * 用于核心必需服务的自动恢复：
+ * 1. 优先找已注册但被禁用的提供者 → 启用
+ * 2. 其次找已注册但处于 pending/error 的提供者 → 重新激活
+ * 3. 已经 active 的跳过（说明服务应该已存在；若仍不存在则插件 bug）
+ *
+ * @returns 成功激活的插件 instanceId，或 undefined
+ */
+export declare function ensureServiceProvider(serviceName: string, deps: ActivationDeps, resolving?: Set<string>): Promise<string | undefined>;
+export {};
+//# sourceMappingURL=plugin-activation.d.ts.map

package/dist/plugin-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-activation.d.ts","sourceRoot":"","sources":["../src/plugin-activation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnF,UAAU,cAAc;IACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE;QAAE,kBAAkB,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAmB7G;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgE5F;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,cAAc,EACpB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAsE7B"}

package/dist/plugin-activation.js

@@ -0,0 +1,172 @@
+// ============================================================
+// plugin-activation.ts — 插件激活路径辅助
+//
+// 从 plugin.ts 拆出的"如何把单个 entry 推进到 active 态"逻辑：
+//   - computeTargetState：给定 reason，单个 entry 的目标态是什么
+//   - activatePlugin：fork ctx → apply → 校验 provides → 标记 active/error
+//   - ensureServiceProvider：必需服务自动恢复（启用 disabled / 重试 pending）
+//
+// 这些都需要 PluginManager 的状态（plugins map / requiredServices / rootCtx），
+// 但被有意提成 free function：传入 deps 对象，方便单测 mock + 让 PluginManager
+// 自身只负责"事件路由 + recompute 编排"。
+// ============================================================
+/**
+ * 计算单个 entry 的目标状态。
+ *
+ * - disabled / disposed / error 是显式态，recompute 不动它们
+ * - required 依赖不满足 → pending
+ * - service-down 命中 optional 依赖且服务确实没了且声明了
+ *   `requiresBounceOnDepChange: true` → pending（级联 bounce）；
+ *   默认不级联，期望下游在每次访问时 `ctx.getService(...)` 惰性查询
+ * - 其余 active / pending / activating → active
+ */
+export function computeTargetState(entry, reason, rootCtx) {
+    if (entry.state === 'disabled' || entry.state === 'disposed' || entry.state === 'error') {
+        return entry.state;
+    }
+    if (reason.type === 'shutdown')
+        return 'disposed';
+    const reqUnmet = entry.requiredDeps.some(d => !rootCtx.hasService(d.service, d.capabilities.length > 0 ? d.capabilities : undefined));
+    if (reqUnmet)
+        return 'pending';
+    if (reason.type === 'service-down' && entry.module.requiresBounceOnDepChange) {
+        const optHit = entry.optionalDeps.find(d => d.service === reason.service);
+        if (optHit &&
+            !rootCtx.hasService(optHit.service, optHit.capabilities.length > 0 ? optHit.capabilities : undefined)) {
+            return 'pending';
+        }
+    }
+    return 'active';
+}
+/**
+ * 尝试激活一个 pending 插件：依赖检查 → fork ctx → apply → provides 校验。
+ *
+ * 失败时把 entry 转为 error 态（带 message），ctx 已 dispose，外层 recompute 不会重试。
+ * 调用方需保证 entry.state === 'pending' 才调用本函数（否则直接 return）。
+ */
+export async function activatePlugin(entry, deps) {
+    const { rootCtx, logger } = deps;
+    if (entry.state !== 'pending')
+        return;
+    for (const dep of entry.requiredDeps) {
+        if (!rootCtx.hasService(dep.service, dep.capabilities.length > 0 ? dep.capabilities : undefined)) {
+            logger.debug(`插件 "${entry.instanceId}" 等待服务: ${dep.service}${dep.capabilities.length ? ` [${dep.capabilities.join(', ')}]` : ''}`);
+            return;
+        }
+    }
+    // 先标记为 activating，防止 service:registered 事件导致重入
+    entry.state = 'activating';
+    const ctx = rootCtx.fork(entry.instanceId);
+    entry.context = ctx;
+    try {
+        await entry.module.apply(ctx, entry.config);
+        if (entry.module.provides) {
+            const missing = entry.module.provides.filter(name => !rootCtx.serviceContainer.hasByContext(name, entry.instanceId));
+            if (missing.length > 0) {
+                throw new Error(`声明 provides [${missing.join(', ')}] 但未实际注册这些服务`);
+            }
+        }
+        // dev mode：反向一致性检查 —— 实际注册的服务名是否都在 provides 中声明
+        // 不在 provides 的服务无法享受拓扑排序与服务恢复，下游可能错过依赖关系
+        // 注：是否 dev 由宿主通过 `App({ devMode })` 显式注入，core 不读 process.env
+        if (rootCtx.devMode) {
+            const declared = new Set(entry.module.provides ?? []);
+            const actuallyProvided = rootCtx.serviceContainer
+                .getServiceNames()
+                .filter(name => rootCtx.serviceContainer.hasByContext(name, entry.instanceId));
+            const undeclared = actuallyProvided.filter(name => !declared.has(name));
+            if (undeclared.length > 0) {
+                logger.warn(`插件 "${entry.instanceId}" 注册了服务 [${undeclared.join(', ')}] 但未在 module.provides 中声明 —— ` +
+                    `下游依赖排序和自动恢复将无法找到该 provider（仅靠 reactive 兜底），建议补全 provides 列表`);
+            }
+        }
+        entry.state = 'active';
+        entry.error = undefined;
+        logger.info(`插件已激活: ${entry.instanceId}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`插件 "${entry.instanceId}" 激活失败: ${message}`);
+        ctx.dispose();
+        entry.context = undefined;
+        entry.state = 'error';
+        entry.error = message;
+        return;
+    }
+    // 激活成败只由 apply/provides 校验决定。emit 放在 try 块外：旁观插件的
+    // 监听器出问题不能把刚激活成功的无辜插件打成 error 终态（归因错位）。
+    await rootCtx.emit('plugin:loaded', entry.instanceId);
+}
+/**
+ * 查找能提供指定服务的插件并尝试激活它。
+ *
+ * 用于核心必需服务的自动恢复：
+ * 1. 优先找已注册但被禁用的提供者 → 启用
+ * 2. 其次找已注册但处于 pending/error 的提供者 → 重新激活
+ * 3. 已经 active 的跳过（说明服务应该已存在；若仍不存在则插件 bug）
+ *
+ * @returns 成功激活的插件 instanceId，或 undefined
+ */
+export async function ensureServiceProvider(serviceName, deps, resolving) {
+    const { plugins, rootCtx, logger } = deps;
+    if (rootCtx.hasService(serviceName))
+        return undefined;
+    const inFlight = resolving ?? new Set();
+    if (inFlight.has(serviceName)) {
+        logger.error(`检测到循环依赖，跳过: ${serviceName}`);
+        return undefined;
+    }
+    inFlight.add(serviceName);
+    const candidates = [];
+    for (const entry of plugins.values()) {
+        if (!entry.module.provides?.includes(serviceName))
+            continue;
+        candidates.push(entry);
+    }
+    if (candidates.length === 0) {
+        logger.error(`必需服务 "${serviceName}" 无可用提供者插件`);
+        return undefined;
+    }
+    // 政策：是否允许为恢复必需服务而自动启用被用户禁用的提供者。
+    // 默认允许（"必需服务可用"压过"尊重禁用"）；宿主可注入 false 反转取舍。
+    const allowAutoEnable = deps.recovery?.autoEnableDisabled ?? true;
+    const disabledCandidates = candidates.filter(e => e.state === 'disabled');
+    if (!allowAutoEnable && disabledCandidates.length > 0) {
+        logger.warn(`必需服务 "${serviceName}" 存在被禁用的提供者 [${disabledCandidates.map(e => e.instanceId).join(', ')}]，` +
+            `但 serviceRecovery.autoEnableDisabled=false，不自动启用`);
+    }
+    const ordered = [
+        ...(allowAutoEnable ? disabledCandidates : []),
+        ...candidates.filter(e => e.state === 'pending' || e.state === 'error'),
+    ];
+    for (const candidate of ordered) {
+        if (candidate.state === 'disabled') {
+            logger.warn(`必需服务 "${serviceName}" 缺失，自动启用插件: ${candidate.instanceId}`);
+            candidate.state = 'pending';
+            candidate.error = undefined;
+            rootCtx.config.setPluginEnabled(candidate.instanceId, true);
+        }
+        else {
+            logger.warn(`必需服务 "${serviceName}" 缺失，尝试激活插件: ${candidate.instanceId}`);
+            candidate.state = 'pending';
+            candidate.error = undefined;
+        }
+        for (const dep of candidate.requiredDeps) {
+            if (!rootCtx.hasService(dep.service, dep.capabilities.length > 0 ? dep.capabilities : undefined)) {
+                await ensureServiceProvider(dep.service, deps, inFlight);
+            }
+        }
+        await activatePlugin(candidate, deps);
+        if (candidate.state === 'active') {
+            rootCtx.config.save();
+            return candidate.instanceId;
+        }
+    }
+    const active = candidates.find(e => e.state === 'active');
+    if (active) {
+        logger.warn(`插件 "${active.instanceId}" 已激活但未提供 "${serviceName}" 服务`);
+    }
+    logger.error(`无法为必需服务 "${serviceName}" 找到可用的提供者`);
+    return undefined;
+}
+//# sourceMappingURL=plugin-activation.js.map

package/dist/plugin-activation.js.map

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

package/dist/plugin-topology.d.ts

@@ -0,0 +1,40 @@
+import type { Context } from './context.js';
+import type { Logger } from './logger.js';
+import type { PluginEntry } from './types/plugin.js';
+/**
+ * 按"提供者 → 消费者"方向的拓扑排序（Kahn）。
+ *
+ * 关闭顺序 = 此结果反向；激活顺序 = 此结果正序。
+ * 服务名 → 提供者映射只取首个 provides 该服务名的 entry，足以表达依赖图。
+ *
+ * 仅 `requiredDeps` 参与建图：optional 依赖语义为"如果存在则消费"，
+ * 由运行时 `service-up`/`service-down` recompute 异步补救（whenService 钩子等），
+ * 不应制造排序约束。否则插件之间互相 optional 会产生伪环并退化到声明序。
+ *
+ * 残留环（仅由 required 形成的真环）按声明序兜底追加。
+ */
+export declare function topoSortByDeps(entries: PluginEntry[], logger: Logger): PluginEntry[];
+/**
+ * 把下游消费者降级为 pending —— 仅对显式声明 `requiresBounceOnDepChange: true`
+ * 的插件生效。
+ *
+ * 历史背景：早期 core 默认对所有 active 下游做级联 bounce，前提是所有插件都会
+ * 在 apply 时把 `ctx.getService(...)` 的结果缓存到长寿命对象里（class field /
+ * 闭包），导致 provider 一旦 dispose+重启，下游缓存的裸引用立刻失效。
+ *
+ * 当前的契约改为："插件应在每次访问时通过 `ctx.getService(...)` 惰性查询"，
+ * 这样 provider 切换天然跟随，无需级联 bounce。绝大多数 first-party 插件已经
+ * 满足该契约，因此默认行为是**不**级联 dispose 下游。
+ *
+ * `requiresBounceOnDepChange: true` 是给少数无法响应式处理状态的插件
+ * （或迁移成本高的第三方插件）的逃生舱。
+ *
+ * 同步执行（不 await），caller 紧接着会 await softReload 完成全部重激活。
+ */
+export declare function evictDownstreamConsumers(args: {
+    provider: PluginEntry;
+    plugins: ReadonlyMap<string, PluginEntry>;
+    rootCtx: Context;
+    logger: Logger;
+}): void;
+//# sourceMappingURL=plugin-topology.d.ts.map

package/dist/plugin-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-topology.d.ts","sourceRoot":"","sources":["../src/plugin-topology.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CA+CpF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CA4BP"}