@aalis/core 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,64 @@
+import type { AalisEvents } from './types/index.js';
+type EventHandler<Args extends unknown[]> = (...args: Args) => void | Promise<void>;
+/**
+ * 类型安全的事件总线
+ *
+ * 内置事件使用 AalisEvents 接口提供类型推导。
+ * 第三方插件可以通过 TS declaration merging 扩展 AalisEvents，
+ * 也可以使用任意字符串 key 注册/触发自定义事件（运行时安全）。
+ */
+export declare class EventBus {
+    private handlers;
+    /**
+     * handler 抛错时的上报回调（含 sticky 补发路径的同步/异步抛错）。
+     *
+     * EventBus 自身不依赖 Logger（保持环境无关）；宿主（App）在构造后
+     * 注入一个指向自己 logger 的上报器。未设置时错误被静默丢弃——
+     * 但无论是否设置，单个 handler 抛错都**不会**中断同事件的其余 handler，
+     * 也不会使 emit reject。
+     */
+    onHandlerError?: (event: string, error: unknown) => void;
+    private reportHandlerError;
+    /**
+     * 一次性事件（sticky）：emit 后保留最近一次参数；后续 on/once 监听该事件时
+     * 立即用缓存参数同步触发回调。用于"应用生命周期里只发一次的里程碑事件"，
+     * 让被热重载的插件在 reactivate 后仍能拿到启动通知。
+     * 当前标记为 sticky 的事件：'ready'、'app:started'。
+     *
+     * - 注册：`markSticky(event)` 由 App 在构造时调用
+     * - 清除：`clearSticky(event)` 由 App.restart()/stop() 在复用实例时调用，
+     *   避免下一轮启动时被旧的 sticky 参数误触发
+     */
+    private stickyArgs;
+    private stickyEvents;
+    markSticky(event: string): void;
+    clearSticky(event?: string): void;
+    /**
+     * 监听事件，返回 dispose 函数
+     *
+     * 若该事件已被标记为 sticky 且历史上 emit 过，则在下一个微任务里
+     * 立即用缓存的参数调用 handler 一次（保证语义同步：调用方注册完返回后
+     * 再触发，避免 handler 内部的 await 影响调用方流程）。
+     */
+    on<E extends string & keyof AalisEvents>(event: E, handler: EventHandler<AalisEvents[E]>): () => void;
+    /**
+     * 监听事件一次
+     */
+    once<E extends string & keyof AalisEvents>(event: E, handler: EventHandler<AalisEvents[E]>): () => void;
+    /**
+     * 触发事件，按注册顺序依次调用，支持异步 handler。
+     *
+     * Per-handler 隔离：单个 handler 抛错（同步或异步）只影响它自己——
+     * 错误经 {@link onHandlerError} 上报，其余 handler 照常执行，emit 始终 resolve。
+     * 事件是"通知多方"语义，一个旁观者失败不该连坐其他订阅者，更不该
+     * 反向把失败传染给发射方（如 plugin:loaded 的 emit 不能把刚激活成功的
+     * 插件打成 error 终态）。
+     */
+    emit<E extends string & keyof AalisEvents>(event: E, ...args: AalisEvents[E]): Promise<void>;
+    /**
+     * 移除指定事件的所有监听器
+     */
+    removeAll(event?: string): void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,KAAK,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF;;;;;;GAMG;AACH,qBAAa,QAAQ;IAEnB,OAAO,CAAC,QAAQ,CAA6C;IAE7D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzD,OAAO,CAAC,kBAAkB;IAa1B;;;;;;;;;OASG;IAEH,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAqB;IAEzC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAgCrG;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IASvG;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlG;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;CAOhC"}

package/dist/events.js

@@ -0,0 +1,145 @@
+/**
+ * 类型安全的事件总线
+ *
+ * 内置事件使用 AalisEvents 接口提供类型推导。
+ * 第三方插件可以通过 TS declaration merging 扩展 AalisEvents，
+ * 也可以使用任意字符串 key 注册/触发自定义事件（运行时安全）。
+ */
+export class EventBus {
+    // biome-ignore lint/suspicious/noExplicitAny: 泛型擦除场景，handlers 容器持有不同事件类型，运行时按事件名分发
+    handlers = new Map();
+    /**
+     * handler 抛错时的上报回调（含 sticky 补发路径的同步/异步抛错）。
+     *
+     * EventBus 自身不依赖 Logger（保持环境无关）；宿主（App）在构造后
+     * 注入一个指向自己 logger 的上报器。未设置时错误被静默丢弃——
+     * 但无论是否设置，单个 handler 抛错都**不会**中断同事件的其余 handler，
+     * 也不会使 emit reject。
+     */
+    onHandlerError;
+    reportHandlerError(event, error) {
+        try {
+            // onHandlerError 签名为 void，但运行时可能返回 promise（如异步 logger 实现）。
+            // 同步抛错被 catch；异步 rejection 单独吞掉，避免逃逸成 unhandledRejection（审计 #4）。
+            const ret = this.onHandlerError?.(event, error);
+            if (ret && typeof ret.then === 'function') {
+                ret.catch(() => { });
+            }
+        }
+        catch {
+            /* 上报器自身抛错不再向外传播 */
+        }
+    }
+    /**
+     * 一次性事件（sticky）：emit 后保留最近一次参数；后续 on/once 监听该事件时
+     * 立即用缓存参数同步触发回调。用于"应用生命周期里只发一次的里程碑事件"，
+     * 让被热重载的插件在 reactivate 后仍能拿到启动通知。
+     * 当前标记为 sticky 的事件：'ready'、'app:started'。
+     *
+     * - 注册：`markSticky(event)` 由 App 在构造时调用
+     * - 清除：`clearSticky(event)` 由 App.restart()/stop() 在复用实例时调用，
+     *   避免下一轮启动时被旧的 sticky 参数误触发
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: 同上
+    stickyArgs = new Map();
+    stickyEvents = new Set();
+    markSticky(event) {
+        this.stickyEvents.add(event);
+    }
+    clearSticky(event) {
+        if (event) {
+            this.stickyArgs.delete(event);
+        }
+        else {
+            this.stickyArgs.clear();
+        }
+    }
+    /**
+     * 监听事件，返回 dispose 函数
+     *
+     * 若该事件已被标记为 sticky 且历史上 emit 过，则在下一个微任务里
+     * 立即用缓存的参数调用 handler 一次（保证语义同步：调用方注册完返回后
+     * 再触发，避免 handler 内部的 await 影响调用方流程）。
+     */
+    on(event, handler) {
+        let set = this.handlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(event, set);
+        }
+        set.add(handler);
+        if (this.stickyEvents.has(event) && this.stickyArgs.has(event)) {
+            const args = this.stickyArgs.get(event);
+            queueMicrotask(() => {
+                // 注册可能在微任务执行前被立即 dispose；此时跳过补发
+                if (!set?.has(handler))
+                    return;
+                // 补发没有 emit 调用方兜底——handler 同步抛错会直达 uncaughtException
+                // 崩进程，异步抛错变 unhandledRejection，必须就地捕获。
+                try {
+                    const ret = handler(...args);
+                    if (ret && typeof ret.then === 'function') {
+                        ret.catch(err => this.reportHandlerError(event, err));
+                    }
+                }
+                catch (err) {
+                    this.reportHandlerError(event, err);
+                }
+            });
+        }
+        return () => {
+            set.delete(handler);
+            if (set.size === 0)
+                this.handlers.delete(event);
+        };
+    }
+    /**
+     * 监听事件一次
+     */
+    once(event, handler) {
+        const wrapper = (...args) => {
+            dispose();
+            return handler(...args);
+        };
+        const dispose = this.on(event, wrapper);
+        return dispose;
+    }
+    /**
+     * 触发事件，按注册顺序依次调用，支持异步 handler。
+     *
+     * Per-handler 隔离：单个 handler 抛错（同步或异步）只影响它自己——
+     * 错误经 {@link onHandlerError} 上报，其余 handler 照常执行，emit 始终 resolve。
+     * 事件是"通知多方"语义，一个旁观者失败不该连坐其他订阅者，更不该
+     * 反向把失败传染给发射方（如 plugin:loaded 的 emit 不能把刚激活成功的
+     * 插件打成 error 终态）。
+     */
+    async emit(event, ...args) {
+        if (this.stickyEvents.has(event)) {
+            this.stickyArgs.set(event, args);
+        }
+        const set = this.handlers.get(event);
+        if (!set)
+            return;
+        // 直接迭代活 Set：handler 中 dispose 尚未访问的条目会被正确跳过（Set 迭代语义）
+        for (const handler of set) {
+            try {
+                await handler(...args);
+            }
+            catch (err) {
+                this.reportHandlerError(event, err);
+            }
+        }
+    }
+    /**
+     * 移除指定事件的所有监听器
+     */
+    removeAll(event) {
+        if (event) {
+            this.handlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,49 @@
+import type { HookContextMap, MiddlewareFn } from './types/index.js';
+/**
+ * 钩子注册表 —— 命名生命周期事件的 handler 总线
+ *
+ * 设计哲学：每个钩子键代表一个 **语义清晰的生命周期事件**（例如
+ * `inbound:command` / `inbound:flow` / `agent:llm:before`），handler
+ * 在事件内部按 **注册顺序** 串行执行洋葱模型 (Koa-style next)。
+ *
+ * 不再使用数字 priority：相位之间的次序由调度方（plugin-gateway 等）
+ * 显式表达；相位内部的 handler 应顺序无关，或由相位拥有方约定。
+ *
+ * 插件通过 `ctx.middleware(hook, fn)` 注册 handler。
+ * 服务在关键流程点执行 `hooks.run(hook, data, defaultAction)`。
+ *
+ * Handler 可以：
+ * - 修改 data 对象（引用传递）
+ * - 调用 next() 继续管道
+ * - 不调用 next() 来中断流程（包括 defaultAction）—— 标准的"已处理"信号
+ *
+ * 第三方插件可通过 TS declaration merging 扩展 HookContextMap。
+ */
+export declare class HookRegistry {
+    private hooks;
+    /**
+     * 注册 handler，返回 dispose 函数。
+     * 同一钩子键内的多个 handler 按注册顺序执行。
+     */
+    register<K extends string & keyof HookContextMap>(hook: K, fn: MiddlewareFn<HookContextMap[K]>, contextId?: string): () => void;
+    /**
+     * 执行钩子链
+     *
+     * Handler 不调用 next() 即可中断整个管道（包括 defaultAction）。
+     * 这是拦截/跳过的标准手段，无需额外的 skip 标志。
+     *
+     * 返回 `true` 表示链路完整走完（执行了 defaultAction，或本就没有 handler）；
+     * 返回 `false` 表示被某个 handler swallow。
+     * 调度方（如 plugin-gateway 多相位调度）可据此决定是否进入后续相位。
+     *
+     * @param hook - 钩子键（命名生命周期事件）
+     * @param data - 传递给 handler 的数据对象（会被 handler 修改）
+     * @param defaultAction - 所有 handler 都 next() 通过后的默认操作
+     */
+    run<K extends string & keyof HookContextMap>(hook: K, data: HookContextMap[K], defaultAction?: () => Promise<void>): Promise<boolean>;
+    /**
+     * 按 contextId 移除所有中间件
+     */
+    unregisterByContext(contextId: string): void;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAOrF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,KAAK,CAAuC;IAEpD;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,cAAc,EAC9C,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EACnC,SAAS,GAAE,MAAe,GACzB,MAAM,IAAI;IAsBb;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,cAAc,EAC/C,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC;IAwBnB;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAU7C"}

package/dist/hooks.js

@@ -0,0 +1,102 @@
+/**
+ * 钩子注册表 —— 命名生命周期事件的 handler 总线
+ *
+ * 设计哲学：每个钩子键代表一个 **语义清晰的生命周期事件**（例如
+ * `inbound:command` / `inbound:flow` / `agent:llm:before`），handler
+ * 在事件内部按 **注册顺序** 串行执行洋葱模型 (Koa-style next)。
+ *
+ * 不再使用数字 priority：相位之间的次序由调度方（plugin-gateway 等）
+ * 显式表达；相位内部的 handler 应顺序无关，或由相位拥有方约定。
+ *
+ * 插件通过 `ctx.middleware(hook, fn)` 注册 handler。
+ * 服务在关键流程点执行 `hooks.run(hook, data, defaultAction)`。
+ *
+ * Handler 可以：
+ * - 修改 data 对象（引用传递）
+ * - 调用 next() 继续管道
+ * - 不调用 next() 来中断流程（包括 defaultAction）—— 标准的"已处理"信号
+ *
+ * 第三方插件可通过 TS declaration merging 扩展 HookContextMap。
+ */
+export class HookRegistry {
+    // biome-ignore lint/suspicious/noExplicitAny: 泛型擦除场景，hooks 容器持有不同钩子键的 entry，运行时按 key 分发
+    hooks = new Map();
+    /**
+     * 注册 handler，返回 dispose 函数。
+     * 同一钩子键内的多个 handler 按注册顺序执行。
+     */
+    register(hook, fn, contextId = 'root') {
+        let list = this.hooks.get(hook);
+        if (!list) {
+            list = [];
+            this.hooks.set(hook, list);
+        }
+        const entry = { fn, contextId };
+        list.push(entry);
+        return () => {
+            // 查 registry 当前数组而非闭包捕获的 list：unregisterByContext 会整体
+            // 换数组，捕获旧引用的 dispose 会变 no-op（中间件泄漏）。
+            const current = this.hooks.get(hook);
+            if (!current)
+                return;
+            const idx = current.indexOf(entry);
+            if (idx >= 0) {
+                current.splice(idx, 1);
+                if (current.length === 0)
+                    this.hooks.delete(hook);
+            }
+        };
+    }
+    /**
+     * 执行钩子链
+     *
+     * Handler 不调用 next() 即可中断整个管道（包括 defaultAction）。
+     * 这是拦截/跳过的标准手段，无需额外的 skip 标志。
+     *
+     * 返回 `true` 表示链路完整走完（执行了 defaultAction，或本就没有 handler）；
+     * 返回 `false` 表示被某个 handler swallow。
+     * 调度方（如 plugin-gateway 多相位调度）可据此决定是否进入后续相位。
+     *
+     * @param hook - 钩子键（命名生命周期事件）
+     * @param data - 传递给 handler 的数据对象（会被 handler 修改）
+     * @param defaultAction - 所有 handler 都 next() 通过后的默认操作
+     */
+    async run(hook, data, defaultAction) {
+        // 快照：handler 执行中 register/dispose（splice 活数组）不能扰动本次遍历的
+        // 游标——否则会跳过下一个 handler 或误报 reachedEnd。
+        const snapshot = [...(this.hooks.get(hook) ?? [])];
+        let index = 0;
+        let reachedEnd = false;
+        const next = async () => {
+            while (index < snapshot.length) {
+                const entry = snapshot[index++];
+                // 执行前确认 entry 仍在注册表中——运行途中被 dispose 的 handler 跳过
+                const current = this.hooks.get(hook);
+                if (!current?.includes(entry))
+                    continue;
+                await entry.fn(data, next);
+                return;
+            }
+            reachedEnd = true;
+            if (defaultAction)
+                await defaultAction();
+        };
+        await next();
+        return reachedEnd;
+    }
+    /**
+     * 按 contextId 移除所有中间件
+     */
+    unregisterByContext(contextId) {
+        for (const [hook, list] of this.hooks) {
+            const filtered = list.filter(e => e.contextId !== contextId);
+            if (filtered.length === 0) {
+                this.hooks.delete(hook);
+            }
+            else {
+                this.hooks.set(hook, filtered);
+            }
+        }
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/i18n.d.ts

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,26 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,26 @@
+/**
+ * 用户身份标识工具函数
+ *
+ * 统一 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,36 @@
+/**
+ * 用户身份标识工具函数
+ *
+ * 统一 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

@@ -0,0 +1 @@
+{"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { AppOptions } from './app.js';
+export { App, createApp } from './app.js';
+export type { AalisConfig, ConfigManagerOptions } from './config.js';
+export { CORE_CONFIG_SCHEMA, ConfigManager, ScopedConfigManager } from './config.js';
+export { Context } from './context.js';
+export { EventBus } from './events.js';
+export { HookRegistry } from './hooks.js';
+export type { LogEntry, LogLevel } from './logger.js';
+export { DefaultLogger, formatLogLine, type Logger, LogHub, parseLogLine } from './logger.js';
+export type { PluginEntry, PluginModule, PluginState } from './plugin.js';
+export { PluginManager, parseInstanceId } from './plugin.js';
+export type { ConfigProvider, PluginDescriptor, PluginLoader, RestartStrategy } from './providers.js';
+export type { NormalizedDependency, ServiceEntry, ServicePriorityValue } from './service.js';
+export { ScopedServiceContainer, ServiceContainer, ServicePriority } from './service.js';
+export type { AalisEvents, AppService, CapabilityList, CapabilityOf, ConfigSchema, DependencyDeclaration, DisposableService, HookContextMap, InjectDeclaration, MiddlewareFn, MiddlewareNext, PluginManagerService, PluginStatusEntry, SchemaArray, SchemaField, SchemaFieldType, SchemaFieldTypes, SchemaGroup, ServiceCapabilityMap, ServiceDependency, ServiceOf, ServiceTypeMap, } from './types/index.js';
+export { probeCapability, registerCapabilityProbe } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9F,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtG,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzF,YAAY,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+// ============================================================
+// @aalis/core — 公共 API 导出
+//
+// core 仅提供：
+//   - 运行时基础设施（App / Context / EventBus / ServiceContainer / HookRegistry / ConfigManager / Logger / PluginManager 等）
+//   - 通用 IoC 数据契约（Schema / AalisEvents / Middleware / Dependency 声明 等）
+//   - 三个扩展点（ServiceCapabilityMap / AalisEvents / HookContextMap）+ PluginModule augmentation
+//   - 服务能力声明框架（ServiceCapabilityMap + Probe）
+//
+// 所有业务/领域类型均由各 @aalis/plugin-*-api 包导出：
+//   - Message / ContentSegment           → @aalis/plugin-agent-api
+//   - ToolCall / ToolDefinition / ToolFunction → @aalis/plugin-tools-api
+//   - LLM / Memory / Storage / Embedding / VectorStore / Tools / Commands / Gateway /
+//     WebUI / Authority / Agent / Platform 等服务接口及关联业务类型同样在各自的 plugin-*-api。
+// ============================================================
+// ----- 运行时基础设施 -----
+export { App, createApp } from './app.js';
+export { CORE_CONFIG_SCHEMA, ConfigManager, ScopedConfigManager } from './config.js';
+export { Context } from './context.js';
+// 注：DisposableChain 是 Context 的内部清理链实现，不再从包根导出（零外部消费，
+// 避免 semver 负担）。嵌入方如确需独立使用，从 './disposable-chain.js' 直接 import。
+export { EventBus } from './events.js';
+export { HookRegistry } from './hooks.js';
+export { DefaultLogger, formatLogLine, LogHub, parseLogLine } from './logger.js';
+export { PluginManager, parseInstanceId } from './plugin.js';
+export { ScopedServiceContainer, ServiceContainer, ServicePriority } from './service.js';
+// ----- 服务能力声明框架 -----
+export { probeCapability, registerCapabilityProbe } from './types/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,0BAA0B;AAC1B,EAAE;AACF,YAAY;AACZ,qHAAqH;AACrH,uEAAuE;AACvE,4FAA4F;AAC5F,6CAA6C;AAC7C,EAAE;AACF,wCAAwC;AACxC,mEAAmE;AACnE,yEAAyE;AACzE,sFAAsF;AACtF,4EAA4E;AAC5E,+DAA+D;AAG/D,sBAAsB;AACtB,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,sDAAsD;AACtD,gEAAgE;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAe,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA0BzF,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 首启交互式初始化向导。
+ *
+ * 当 aalis.config.yaml 不存在时被 src/index.ts 调用。
+ *
+ * 设计：
+ * - 不依赖任何插件实例（只 dynamic import 各 plugin 的入口模块以读取静态导出的 provides/inject）。
+ * - 不再硬编码插件清单或"bundled 必装"概念：
+ *     · 扫 packages/plugin-* 与已经位于 node_modules/@aalis/plugin-* 的本地包；
+ *     · 用各 plugin 模块的 `provides[]` 把它们按服务分组，让用户在每个服务里多选；
+ *     · 不 provide 任何服务的归为"工具与扩展"。
+ * - 配置块写空对象 `{}`，密钥等留给用户启动后从 WebUI 或 yaml 填。
+ *   末尾会列出"启用了但通常需要进一步配置"的插件提醒。
+ */
+export interface InitWizardOptions {
+    configPath?: string;
+    requireTty?: boolean;
+}
+export declare function runInitWizardIfNeeded(opts?: InitWizardOptions): Promise<boolean>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8RH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmM1F"}