@aalis/core 0.8.0 → 0.9.1

package/dist/{service.d.ts → services.d.ts}

@@ -1,6 +1,44 @@
-import { type NormalizedDependency, normalizeDependency, type ServiceEntry, ServicePriority, type ServicePriorityValue } from './types/service.js';
-export type { NormalizedDependency, ServiceEntry, ServicePriorityValue };
-export { normalizeDependency, ServicePriority };
+import type { DependencyDeclaration } from './types/services.js';
+/**
+ * 服务优先级约定（数字越大越优先）
+ *
+ * 用于 `ctx.provide(name, instance, { priority })`。
+ * 同优先级时，先注册的胜出（稳定降序排序）。
+ *
+ * 设计目的：把『谁是默认胜者』变成静态、可预测的契约。
+ * 与 preferService 正交、非替代关系：优先级是静态默认序，偏好是用户显式覆盖，
+ * 解析序恒为「偏好 > 优先级 > 注册顺序」。
+ *
+ * 推荐用法：
+ * - `Backend = 0`：普通后端实现（如 plugin-openai / plugin-deepseek）。
+ * - `Override = 50`：用户级覆盖；同名服务希望默认胜过普通后端时使用。
+ * - `System = 200`：保留给核心系统级覆盖。
+ *
+ * 注：feat/service-granularity 之后已不再有 router/facade 层级——LLM / storage / platform
+ * 均改为按 model / root / sessionId 直接注册多 entry，跨 entry 的聚合与路由由各自
+ * `*-api` 的 helper 函数承担（`createStorageGateway` / `resolvePlatformBySession` / ...），
+ * 没有同名 facade entry，因此曾经的 `Router = 100` 槽位整体废弃。
+ */
+export declare const ServicePriority: {
+    readonly Backend: 0;
+    readonly Override: 50;
+    readonly System: 200;
+};
+export type ServicePriorityValue = (typeof ServicePriority)[keyof typeof ServicePriority];
+export interface ServiceEntry {
+    instance: unknown;
+    priority: number;
+    contextId: string;
+    /** 可选的展示标签（如 "OpenAI / gpt-4o"） */
+    label?: string;
+}
+export interface NormalizedDependency {
+    service: string;
+}
+/**
+ * 将 string | ServiceDependency 统一为 NormalizedDependency
+ */
+export declare function normalizeDependency(dep: DependencyDeclaration): NormalizedDependency;
 /**
  * 服务容器 —— 支持同名多实现
  *
@@ -32,10 +70,6 @@ export declare class ServiceContainer {
      * 获取一个满足能力要求的服务实例
      */
     get<T>(name: string): T | undefined;
-    /**
-     * 检查某个服务是否存在
-     */
-    has(name: string): boolean;
     /**
      * 检查指定 contextId 是否注册了某个服务。
      *
@@ -68,13 +102,14 @@ export declare class ServiceContainer {
      */
     getEntries(name: string): ServiceEntry[];
     /**
-     * 获取某个服务的所有实例（带提供者信息）
+     * 获取某个服务的所有实例（带提供者信息与优先级）
      *
      * 返回顺序遵循「偏好 > 优先级 > 注册顺序」。
      */
     getAll<T>(name: string): Array<{
         instance: T;
         contextId: string;
+        priority: number;
         label?: string;
     }>;
     /**
@@ -99,4 +134,4 @@ export declare class ServiceContainer {
      */
     getPreferred(name: string): string | undefined;
 }
-//# sourceMappingURL=service.d.ts.map
+//# sourceMappingURL=services.d.ts.map

package/dist/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAE1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,GAAG,oBAAoB,CAEpF;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAqC;IACpD,uEAAuE;IACvE,OAAO,CAAC,WAAW,CAA6B;IAEhD;;;;OAIG;IACH,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAe,EAC1B,KAAK,CAAC,EAAE,MAAM,GACb,YAAY;IAkBf;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKnC;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAOtD;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO;IAU3D;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAkBhD;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAIxC;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,QAAQ,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IASpG;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAKhD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAG/C"}

package/dist/{service.js → services.js}

@@ -1,6 +1,35 @@
-import { normalizeDependency, ServicePriority, } from './types/service.js';
-// 类型与纯辅助 re-export，保留同名旧导入路径
-export { normalizeDependency, ServicePriority };
+// ----- 服务系统数据契约（与容器实现同文件，同 contributions.ts 的 Spec/Handle 惯例） -----
+/**
+ * 服务优先级约定（数字越大越优先）
+ *
+ * 用于 `ctx.provide(name, instance, { priority })`。
+ * 同优先级时，先注册的胜出（稳定降序排序）。
+ *
+ * 设计目的：把『谁是默认胜者』变成静态、可预测的契约。
+ * 与 preferService 正交、非替代关系：优先级是静态默认序，偏好是用户显式覆盖，
+ * 解析序恒为「偏好 > 优先级 > 注册顺序」。
+ *
+ * 推荐用法：
+ * - `Backend = 0`：普通后端实现（如 plugin-openai / plugin-deepseek）。
+ * - `Override = 50`：用户级覆盖；同名服务希望默认胜过普通后端时使用。
+ * - `System = 200`：保留给核心系统级覆盖。
+ *
+ * 注：feat/service-granularity 之后已不再有 router/facade 层级——LLM / storage / platform
+ * 均改为按 model / root / sessionId 直接注册多 entry，跨 entry 的聚合与路由由各自
+ * `*-api` 的 helper 函数承担（`createStorageGateway` / `resolvePlatformBySession` / ...），
+ * 没有同名 facade entry，因此曾经的 `Router = 100` 槽位整体废弃。
+ */
+export const ServicePriority = {
+    Backend: 0,
+    Override: 50,
+    System: 200,
+};
+/**
+ * 将 string | ServiceDependency 统一为 NormalizedDependency
+ */
+export function normalizeDependency(dep) {
+    return { service: typeof dep === 'string' ? dep : dep.service };
+}
 /**
  * 服务容器 —— 支持同名多实现
  *
@@ -62,12 +91,6 @@ export class ServiceContainer {
         const list = this.resolveEntries(name);
         return list.length > 0 ? list[0].instance : undefined;
     }
-    /**
-     * 检查某个服务是否存在
-     */
-    has(name) {
-        return this.get(name) !== undefined;
-    }
     /**
      * 检查指定 contextId 是否注册了某个服务。
      *
@@ -138,7 +161,7 @@ export class ServiceContainer {
         return this.resolveEntries(name);
     }
     /**
-     * 获取某个服务的所有实例（带提供者信息）
+     * 获取某个服务的所有实例（带提供者信息与优先级）
      *
      * 返回顺序遵循「偏好 > 优先级 > 注册顺序」。
      */
@@ -146,6 +169,7 @@ export class ServiceContainer {
         return this.resolveEntries(name).map(entry => ({
             instance: entry.instance,
             contextId: entry.contextId,
+            priority: entry.priority,
             label: entry.label,
         }));
     }
@@ -178,4 +202,4 @@ export class ServiceContainer {
         return this.preferences.get(name);
     }
 }
-//# sourceMappingURL=service.js.map
+//# sourceMappingURL=services.js.map

package/dist/services.js.map

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

package/dist/types/app.d.ts

@@ -1,4 +1,3 @@
-import type { ConfigSchema } from './core.js';
 import type { PluginEntry, PluginState } from './plugin.js';
 /**
  * App 生命周期 + 配置 + 市场 接口
@@ -29,9 +28,6 @@ export interface PluginStatusEntry {
     requiredServices?: string[];
     /** 可选依赖的服务名（来自 inject.optional） */
     optionalServices?: string[];
-    config: Record<string, unknown>;
-    configSchema?: ConfigSchema;
-    defaultConfig?: Record<string, unknown>;
     error?: string;
 }
 /**
@@ -53,10 +49,14 @@ export interface PluginManagerService {
     disablePlugin(name: string): Promise<boolean>;
     /** 彻底卸载插件：dispose 上下文并从注册表移除（用于市场卸载，区别于 disablePlugin 仅置禁用态） */
     unload(name: string): Promise<void>;
-    /** 基于 reusable 插件创建新实例，返回 instanceId */
-    createInstance(moduleName: string, suffix: string, config?: Record<string, unknown>): Promise<string | undefined>;
-    /** 删除实例 */
-    removeInstance(instanceId: string): Promise<boolean>;
+    /** 注册并尝试激活一个插件模块（多实例经 instanceId 区分；供管理面基于 register/unload 组合实例编排） */
+    register(module: PluginEntry['module'], config?: Record<string, unknown>, instanceId?: string): Promise<void>;
+    /**
+     * 等待插件状态机静置（无在飞/排队的 recompute）。变更 API 在 flight 在飞时
+     * 排队早退，需要"尘埃落定后再观察"的调用方在变更后 await 本方法。
+     * ⚠． 不得在插件 apply / onDispose 内调用（互等死锁）。
+     */
+    idle(): Promise<void>;
 }
 declare module './services.js' {
     interface ServiceTypeMap {

package/dist/types/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/types/app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,gCAAgC;IAChC,OAAO,IAAI,IAAI,CAAC;IAChB,cAAc;IACd,UAAU,IAAI,IAAI,CAAC;IAEnB,uCAAuC;IACvC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,SAAS,IAAI,iBAAiB,EAAE,CAAC;IACjC,eAAe;IACf,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACjD,sBAAsB;IACtB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,WAAW;IACX,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,WAAW;IACX,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,wCAAwC;IACxC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClH,WAAW;IACX,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD;AAED,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,cAAc;QACtB,GAAG,EAAE,UAAU,CAAC;QAChB,OAAO,EAAE,oBAAoB,CAAC;KAC/B;CACF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/types/app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,gCAAgC;IAChC,OAAO,IAAI,IAAI,CAAC;IAChB,cAAc;IACd,UAAU,IAAI,IAAI,CAAC;IAEnB,uCAAuC;IACvC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAGhB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,SAAS,IAAI,iBAAiB,EAAE,CAAC;IACjC,eAAe;IACf,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACjD,sBAAsB;IACtB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,WAAW;IACX,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,WAAW;IACX,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9G;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,cAAc;QACtB,GAAG,EAAE,UAAU,CAAC;QAChB,OAAO,EAAE,oBAAoB,CAAC;KAC/B;CACF"}

package/dist/types/events.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 内置事件表
+ *
+ * 第三方插件可通过 TypeScript declaration merging 扩展：
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface AalisEvents {
+ *     'scheduler:tick': [jobId: string];
+ *   }
+ * }
+ * ```
+ */
+export interface AalisEvents {
+    'service:registered': [name: string];
+    'service:unregistered': [name: string];
+    /**
+     * 某服务的偏好 provider 发生切换（preferService / unpreferService）。
+     * 偏好切换会改变 getService(name) 的胜者但不改变 entry 集合，
+     * 因此不能复用 registered/unregistered 语义；whenService 借此事件跟随重挂。
+     */
+    'service:preference-changed': [name: string];
+    'plugin:loaded': [name: string];
+    'plugin:unloaded': [name: string];
+    'plugins:changed': [];
+    ready: [];
+    /** 应用已启动完成，适合 CLI / TUI 等用户交互入口接管终端 */
+    'app:started': [];
+    restarting: [];
+    /** 应用正在启动（start() 开头，在服务检查和消息路由注册之前） */
+    'app:starting': [];
+    /**
+     * 应用正在停止（stop() 开头，在插件拓扑逆序 dispose 之前）。
+     *
+     * 本事件的定位是**通知**（如 CLI 打印告别语、状态条切换），**不是清理通道**。
+     *
+     * ⚠． 插件内部清理副作用（关连接、停计时器、flush 缓冲区、落盘等）一律用
+     *    `ctx.onDispose(cb)`：它覆盖 bounce / unload / updatePluginConfig 等
+     *    全部拆卸路径，且异步清理会被编排层的 disposeAsync 等待完成。
+     *    本事件只在 app 全局停机时触发一次，用它做清理会在热重载路径上
+     *    造成资源泄漏与数据丢失。
+     */
+    'app:stopping': [];
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAK1B,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,sBAAsB,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC;;;;OAIG;IACH,4BAA4B,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClC,iBAAiB,EAAE,EAAE,CAAC;IACtB,KAAK,EAAE,EAAE,CAAC;IACV,uCAAuC;IACvC,aAAa,EAAE,EAAE,CAAC;IAClB,UAAU,EAAE,EAAE,CAAC;IACf,wCAAwC;IACxC,cAAc,EAAE,EAAE,CAAC;IACnB;;;;;;;;;;OAUG;IACH,cAAc,EAAE,EAAE,CAAC;CACpB"}

package/dist/types/events.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 事件扩展点：内置事件表 + declaration merging 靶子。
+// 与 hooks / services / contributions 的扩展点文件同构——一原语一文件。
+// ============================================================
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wCAAwC;AACxC,uDAAuD;AACvD,+DAA+D"}

package/dist/types/hooks.d.ts

@@ -1,3 +1,11 @@
 export interface HookContextMap {
 }
+/**
+ * 中间件 next 函数，调用它将控制传递给下一个中间件或默认行为
+ */
+export type MiddlewareNext = () => Promise<void>;
+/**
+ * 中间件函数签名：接收数据和 next，可选择修改数据或中断流程
+ */
+export type MiddlewareFn<T> = (data: T, next: MiddlewareNext) => Promise<void>;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/types/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;CAAG"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;CAAG;AAIlC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -1,7 +1,8 @@
 export type { AppService, PluginManagerService, PluginStatusEntry } from './app.js';
 export type { ContributionPointMap } from './contributions.js';
-export type { AalisEvents, ConfigSchema, DependencyDeclaration, InjectDeclaration, MiddlewareFn, MiddlewareNext, SchemaArray, SchemaField, SchemaFieldType, SchemaFieldTypes, SchemaGroup, ServiceDependency, } from './core.js';
 export type { DisposableService } from './disposable-service.js';
-export type { HookContextMap } from './hooks.js';
-export type { ServiceOf, ServiceTypeMap } from './services.js';
+export type { AalisEvents } from './events.js';
+export type { HookContextMap, MiddlewareFn, MiddlewareNext } from './hooks.js';
+export type { InjectDeclaration } from './plugin.js';
+export type { DependencyDeclaration, ServiceDependency, ServiceOf, ServiceTypeMap } from './services.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAkBA,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEpF,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EACV,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAmBA,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEpF,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/E,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/index.js

@@ -1,12 +1,13 @@
 // ============================================================
 // @aalis/core - types 子模块统一导出
 //
-// 仅包含 core 自身定义的：
-//   - 通用 IoC 数据契约（types/core.ts：Schema / Middleware / Dependency / AalisEvents 等）
-//   - 钩子扩展点（types/hooks.ts，仅空 HookContextMap）
-//   - 贡献点扩展点（types/contributions.ts，仅空 ContributionPointMap）
-//   - 服务类型注册表（types/services.ts，仅空 ServiceTypeMap）
-//   - App 服务接口（types/app.ts）
+// 四原语一人一个扩展点文件（均为 declaration merging 靶子 + 域词汇）：
+//   - types/events.ts        AalisEvents（事件名 → 参数元组）
+//   - types/hooks.ts         HookContextMap（钩子名 → 中间件上下文）+ Middleware 签名
+//   - types/services.ts      ServiceTypeMap（服务名 → 实例接口）+ 服务依赖声明
+//   - types/contributions.ts ContributionPointMap（贡献点名 → spec 类型）
+// 另：types/app.ts（App 服务接口）、types/plugin.ts（插件模块词汇）、
+//     types/disposable-service.ts（服务自清理协议）。
 //
 // 业务/领域类型一律由 plugin-*-api 包导出：
 //   - Message / ContentSegment           → @aalis/plugin-message-api

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8BAA8B;AAC9B,EAAE;AACF,kBAAkB;AAClB,kFAAkF;AAClF,8CAA8C;AAC9C,6DAA6D;AAC7D,mDAAmD;AACnD,6BAA6B;AAC7B,EAAE;AACF,+BAA+B;AAC/B,qEAAqE;AACrE,yEAAyE;AACzE,sFAAsF;AACtF,qEAAqE;AACrE,+DAA+D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8BAA8B;AAC9B,EAAE;AACF,iDAAiD;AACjD,qDAAqD;AACrD,yEAAyE;AACzE,gEAAgE;AAChE,kEAAkE;AAClE,oDAAoD;AACpD,4CAA4C;AAC5C,EAAE;AACF,+BAA+B;AAC/B,qEAAqE;AACrE,yEAAyE;AACzE,sFAAsF;AACtF,qEAAqE;AACrE,+DAA+D"}

package/dist/types/plugin.d.ts

@@ -1,6 +1,10 @@
 import type { Context } from '../context.js';
-import type { ConfigSchema, InjectDeclaration } from './core.js';
-import type { NormalizedDependency } from './service.js';
+import type { NormalizedDependency } from '../services.js';
+import type { DependencyDeclaration } from './services.js';
+export interface InjectDeclaration {
+    required?: DependencyDeclaration[];
+    optional?: DependencyDeclaration[];
+}
 export interface PluginModule {
     name: string;
     /** 插件的显示名称，用于前端展示 */
@@ -19,8 +23,12 @@ export interface PluginModule {
      * 适合多实例的插件：LLM adapters、embedding adapters、platform adapters、memory backends。
      */
     reusable?: boolean;
-    /** 配置 Schema，用于前端自动生成配置表单 */
-    configSchema?: ConfigSchema;
+    /**
+     * 配置 Schema——core 视为 **opaque 数据**原样透传，不解释任何字段。
+     * 表单形状类型由 @aalis/plugin-config-api 定义，渲染宿主与配置同步
+     * 政策（@aalis/runtime）自行消费。
+     */
+    configSchema?: Record<string, unknown>;
     /** 插件默认配置，当主配置文件中无此插件配置时使用 */
     defaultConfig?: Record<string, unknown>;
     /**

package/dist/types/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAIjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAK5E;AAID,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAElG;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAW3F"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAI3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAK5E;AAID,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAElG;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAW3F"}

package/dist/types/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,kDAAkD;AAClD,qBAAqB;AAqFrB;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,4BAA4B;IAC5B,uCAAuC;IACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IACpD,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;QACzC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,kDAAkD;AAClD,qBAAqB;AA+FrB;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,4BAA4B;IAC5B,uCAAuC;IACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IACpD,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;QACzC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/types/services.d.ts

@@ -14,4 +14,8 @@ export interface ServiceTypeMap {
  * 用户便利类型；core 自己用 `ServiceTypeMap[TName]` 直接索引。
  */
 export type ServiceOf<TName extends string> = TName extends keyof ServiceTypeMap ? ServiceTypeMap[TName] : unknown;
+export interface ServiceDependency {
+    service: string;
+}
+export type DependencyDeclaration = string | ServiceDependency;
 //# sourceMappingURL=services.d.ts.map

package/dist/types/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/types/services.ts"],"names":[],"mappings":"AAsCA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;CAAG;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI,KAAK,SAAS,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/types/services.ts"],"names":[],"mappings":"AAsCA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;CAAG;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI,KAAK,SAAS,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;AAInH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aalis/core",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "license": "MIT",
   "repository": {
     "type": "git",

package/dist/constants.d.ts

@@ -1,31 +0,0 @@
-/**
- * Aalis 核心常量
- */
-/**
- * Gateway 入站消息生命周期相位（按下面的顺序串行执行）。
- *
- * 每个相位是一个独立的命名钩子键，对应一个职责清晰的拦截点。
- * 同一相位内部的多个 handler 按 **注册顺序** 执行洋葱模型 (next 语义)，
- * 跨相位则由 plugin-gateway 顺序调度，无需任何优先级数字。
- *
- *   COMMAND  → 指令解析与执行（由 plugin-commands 占据）
- *   FLOW     → 流控前置闸门（禁言/冷却/限速；由 plugin-flow-control 占据）
- *   TRIGGER  → 触发策略判定（mute 关键词/@/计数评分；由 plugin-trigger-policy 占据）
- *   DISPATCH → 默认派发到 agent.handleMessage（plugin-gateway 提供 default action）
- *
- * 任一相位的 handler 不调用 next() 即视为"我已处理"，
- * 整个入站管道立即停止（不再进入后续相位）。
- *
- * 第三方插件可以注册到任一相位以获得清晰的语义位置，
- * 无需理解优先级数字、无需与其他插件协商占位。
- */
-export declare const INBOUND_PHASE: {
-    readonly COMMAND: "inbound:command";
-    readonly FLOW: "inbound:flow";
-    readonly TRIGGER: "inbound:trigger";
-    readonly DISPATCH: "inbound:dispatch";
-};
-/** 默认相位执行顺序（gateway 内部调度使用）。 */
-export declare const INBOUND_PHASE_ORDER: readonly ["inbound:command", "inbound:flow", "inbound:trigger", "inbound:dispatch"];
-export type InboundPhase = typeof INBOUND_PHASE_ORDER[number];
-//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,qFAKtB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC"}

package/dist/constants.js

@@ -1,36 +0,0 @@
-/**
- * Aalis 核心常量
- */
-// ----- Gateway 入站生命周期相位 -----
-/**
- * Gateway 入站消息生命周期相位（按下面的顺序串行执行）。
- *
- * 每个相位是一个独立的命名钩子键，对应一个职责清晰的拦截点。
- * 同一相位内部的多个 handler 按 **注册顺序** 执行洋葱模型 (next 语义)，
- * 跨相位则由 plugin-gateway 顺序调度，无需任何优先级数字。
- *
- *   COMMAND  → 指令解析与执行（由 plugin-commands 占据）
- *   FLOW     → 流控前置闸门（禁言/冷却/限速；由 plugin-flow-control 占据）
- *   TRIGGER  → 触发策略判定（mute 关键词/@/计数评分；由 plugin-trigger-policy 占据）
- *   DISPATCH → 默认派发到 agent.handleMessage（plugin-gateway 提供 default action）
- *
- * 任一相位的 handler 不调用 next() 即视为"我已处理"，
- * 整个入站管道立即停止（不再进入后续相位）。
- *
- * 第三方插件可以注册到任一相位以获得清晰的语义位置，
- * 无需理解优先级数字、无需与其他插件协商占位。
- */
-export const INBOUND_PHASE = {
-    COMMAND: 'inbound:command',
-    FLOW: 'inbound:flow',
-    TRIGGER: 'inbound:trigger',
-    DISPATCH: 'inbound:dispatch',
-};
-/** 默认相位执行顺序（gateway 内部调度使用）。 */
-export const INBOUND_PHASE_ORDER = [
-    INBOUND_PHASE.COMMAND,
-    INBOUND_PHASE.FLOW,
-    INBOUND_PHASE.TRIGGER,
-    INBOUND_PHASE.DISPATCH,
-];
-//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,iBAAiB;IAC1B,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,kBAAkB;CACpB,CAAC;AAEX,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa,CAAC,OAAO;IACrB,aAAa,CAAC,IAAI;IAClB,aAAa,CAAC,OAAO;IACrB,aAAa,CAAC,QAAQ;CACd,CAAC"}

package/dist/i18n.d.ts

@@ -1,6 +0,0 @@
-import type { I18nResources } from './types/index.js';
-export declare const DEFAULT_LOCALE = "zh-CN";
-export declare function resolveI18nText(resources: I18nResources | undefined, locale: string | undefined, key: string, fallback?: string): string;
-export declare function normalizeLocale(locale: string | undefined): string;
-export declare function resolveLocalePreference(locale: string | undefined, fallbackLocale?: string): string;
-//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,wBAAgB,eAAe,CAC7B,SAAS,EAAE,aAAa,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,MAAM,EACX,QAAQ,SAAM,GACb,MAAM,CAWR;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIlE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,SAAiB,GAAG,MAAM,CAI3G"}

package/dist/i18n.js

@@ -1,26 +0,0 @@
-export const DEFAULT_LOCALE = 'zh-CN';
-export function resolveI18nText(resources, locale, key, fallback = key) {
-    const normalized = normalizeLocale(locale);
-    const exact = resources?.[normalized]?.[key];
-    if (exact)
-        return exact;
-    const baseLocale = normalized.split('-')[0];
-    const base = resources?.[baseLocale]?.[key];
-    if (base)
-        return base;
-    const zh = resources?.[DEFAULT_LOCALE]?.[key];
-    return zh ?? fallback;
-}
-export function normalizeLocale(locale) {
-    const value = locale?.trim();
-    if (!value || value === 'auto')
-        return DEFAULT_LOCALE;
-    return value;
-}
-export function resolveLocalePreference(locale, fallbackLocale = DEFAULT_LOCALE) {
-    const value = locale?.trim();
-    if (!value || value === 'auto')
-        return normalizeLocale(fallbackLocale);
-    return value;
-}
-//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,UAAU,eAAe,CAC7B,SAAoC,EACpC,MAA0B,EAC1B,GAAW,EACX,QAAQ,GAAG,GAAG;IAEd,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,EAAE,IAAI,QAAQ,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,MAAM,KAAK,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,cAAc,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAA0B,EAAE,cAAc,GAAG,cAAc;IACjG,MAAM,KAAK,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,eAAe,CAAC,cAAc,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/identity.d.ts

@@ -1,26 +0,0 @@
-/**
- * 用户身份标识工具函数
- *
- * 统一 userId / nickname 的使用模式，避免各插件实现不一致。
- */
-/**
- * 获取消息发送者的显示标签。
- * 同时展示 nickname 和 userId 帮助 LLM 关联身份。
- * - 两者都有时返回 `昵称(ID)`
- * - 只有 nickname 返回 nickname
- * - 只有 userId 返回 userId
- * - 都无返回 undefined
- */
-export declare function getSenderLabel(nickname?: string, userId?: string): string | undefined;
-/**
- * 将发送者标签格式化为消息前缀。
- * 有标签时返回 `[label]: content`，无标签时原样返回 content。
- */
-export declare function prefixSender(content: string, nickname?: string, userId?: string): string;
-/**
- * 获取适用于 Message.name / OpenAI API name 字段的安全标识符。
- * 使用 userId（稳定不变）而非 nickname（可变）。
- * 返回 undefined 表示不设置 name 字段。
- */
-export declare function getMessageName(userId?: string): string | undefined;
-//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIrF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE"}

package/dist/identity.js

@@ -1,36 +0,0 @@
-/**
- * 用户身份标识工具函数
- *
- * 统一 userId / nickname 的使用模式，避免各插件实现不一致。
- */
-/**
- * 获取消息发送者的显示标签。
- * 同时展示 nickname 和 userId 帮助 LLM 关联身份。
- * - 两者都有时返回 `昵称(ID)`
- * - 只有 nickname 返回 nickname
- * - 只有 userId 返回 userId
- * - 都无返回 undefined
- */
-export function getSenderLabel(nickname, userId) {
-    const nick = nickname?.trim();
-    if (nick && userId)
-        return `${nick}(${userId})`;
-    return nick || userId || undefined;
-}
-/**
- * 将发送者标签格式化为消息前缀。
- * 有标签时返回 `[label]: content`，无标签时原样返回 content。
- */
-export function prefixSender(content, nickname, userId) {
-    const label = getSenderLabel(nickname, userId);
-    return label ? `[${label}]: ${content}` : content;
-}
-/**
- * 获取适用于 Message.name / OpenAI API name 字段的安全标识符。
- * 使用 userId（稳定不变）而非 nickname（可变）。
- * 返回 undefined 表示不设置 name 字段。
- */
-export function getMessageName(userId) {
-    return userId || undefined;
-}
-//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,QAAiB,EAAE,MAAe;IAC/D,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,IAAI,IAAI,MAAM;QAAE,OAAO,GAAG,IAAI,IAAI,MAAM,GAAG,CAAC;IAChD,OAAO,IAAI,IAAI,MAAM,IAAI,SAAS,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,QAAiB,EAAE,MAAe;IAC9E,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,OAAO,MAAM,IAAI,SAAS,CAAC;AAC7B,CAAC"}