@aalis/core 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,174 @@
+import type { ConfigProvider } from './providers.js';
+import type { ConfigSchema } from './types/index.js';
+/**
+ * Aalis 应用配置（基础设施字段）
+ *
+ * 仅声明 core 自身管理的字段。业务字段（owners / agent / dangerousPolicy 等）
+ * 由对应 plugin 通过 declaration merging 注入：
+ *
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface AalisConfig {
+ *     owners?: Array<{ platform: string; userId: string }>;
+ *     defaultAuthority?: number;
+ *   }
+ * }
+ * ```
+ *
+ * `[key: string]: unknown` 兜底允许第三方插件即便不做 declaration merging
+ * 也能通过 `ctx.config.get('myField')` 读到 unknown，避免 core 知晓任何业务字段。
+ */
+export interface AalisConfig {
+    name: string;
+    logLevel: string;
+    plugins: Record<string, Record<string, unknown>>;
+    /** 被禁用的插件名列表 */
+    disabledPlugins?: string[];
+    /**
+     * 服务偏好：serviceName → preferred contextId。
+     * 详见 ServiceContainer.prefer / Context.preferService。语义：偏好 > 优先级 > 注册顺序。
+     */
+    servicePreferences?: Record<string, string>;
+    [key: string]: unknown;
+}
+/** 核心配置的 Schema，与插件 configSchema 走同一套渲染路径 */
+export declare const CORE_CONFIG_SCHEMA: ConfigSchema;
+export interface ConfigManagerOptions {
+    /** 持久化与外部变更监听由 provider 提供；省略则进入纯内存模式（save() 静默） */
+    provider?: ConfigProvider;
+    /**
+     * 业务数据目录（plugin 用于解析相对路径，如 sqlite db、persona 文件等）。
+     * core 自己不读写它；语义由宿主与插件约定。默认 `'.'`。
+     */
+    dataDir?: string;
+    /**
+     * `syncPluginDefaults` 是否按 configSchema 裁剪未知字段（默认 `true`）。
+     * 设为 `false` 时保留 schema 外的字段——适合宿主允许手写实验性配置、
+     * 或 schema 滞后于实现的场景。这是政策而非机制，故开放给宿主注入。
+     */
+    trimUnknownFields?: boolean;
+}
+/**
+ * 配置管理器：纯内存的配置中枢。
+ *
+ * 职责：
+ * - 持有当前配置快照（`AalisConfig`）
+ * - 提供 get/set/getPluginConfig 等访问器
+ * - 处理插件默认配置合并、schema 裁剪、服务偏好
+ *
+ * **不**做的事：
+ * - 不读写文件，不解析 yaml/json，不 watch 文件系统
+ *   ——这些由 `ConfigProvider`（宿主注入）负责
+ *
+ * 这样 core 可以在浏览器、嵌入式宿主、单元测试里直接使用：
+ * 测试代码可以 `new App({ config: { name: 'X', logLevel: 'error', plugins: {} } })`
+ * 而无需创建临时目录写 yaml 文件。
+ */
+export declare class ConfigManager {
+    private config;
+    private readonly provider?;
+    private readonly dataDir;
+    /** syncPluginDefaults 的字段裁剪政策（公开只读：scope 继承、宿主可内省） */
+    readonly trimUnknownFields: boolean;
+    private unwatchFn;
+    private onChangeCallback;
+    constructor(initial: AalisConfig, options?: ConfigManagerOptions);
+    get<K extends keyof AalisConfig>(key: K): AalisConfig[K];
+    getPluginConfig<T extends Record<string, unknown> = Record<string, unknown>>(pluginName: string): T;
+    /**
+     * 业务数据目录——plugin 用于解析相对路径。
+     * 命名沿用历史接口（`getConfigDir`），语义上是"宿主指定的数据根目录"。
+     */
+    getConfigDir(): string;
+    getAll(): Readonly<AalisConfig>;
+    set<K extends keyof AalisConfig>(key: K, value: AalisConfig[K]): void;
+    setPluginConfig(pluginName: string, config: Record<string, unknown>): void;
+    removePluginConfig(pluginName: string): void;
+    /**
+     * 将插件 defaultConfig 中缺失的字段合并到配置；同时按 configSchema
+     * 移除多余字段。返回发生变更的插件 instanceId 列表（调用方可决定要不要 log）。
+     *
+     * 副作用：内部对每个发生变化的条目调用 setPluginConfig；若有变化最终调用 save()。
+     */
+    syncPluginDefaults(plugins: ReadonlyArray<{
+        instanceId: string;
+        defaultConfig?: Record<string, unknown>;
+        configSchema?: Record<string, unknown>;
+    }>): string[];
+    isPluginDisabled(pluginName: string): boolean;
+    setPluginEnabled(pluginName: string, enabled: boolean): void;
+    getServicePreferences(): Record<string, string>;
+    setServicePreference(name: string, contextId: string): void;
+    removeServicePreference(name: string): void;
+    /**
+     * 持久化当前配置。委托给 provider，无 provider 时静默忽略（内存模式）。
+     * 同步语义：若 provider 异步保存，调用方不会等待完成——这与原 fs sync 行为一致。
+     */
+    save(): void;
+    /**
+     * 重新加载配置——把外部传入的快照写回内部状态。
+     *
+     * 历史上这是"从磁盘 re-read"的入口；现在交由 provider 决定何时
+     * 通过 `watch(onChange)` 把新快照推过来；本方法仅供 watch 回调使用。
+     *
+     * 注意：本方法（与 watch 回调）**不应用 trimUnknownFields 政策**——
+     * ConfigManager 不持有插件 schema，裁剪统一发生在 syncPluginDefaults
+     * （App.handleConfigFileChanged 热重载时会重新调用它对齐政策）。
+     */
+    reloadFrom(next: AalisConfig): AalisConfig;
+    /**
+     * 订阅配置外部变更。委托给 provider；无 provider 时为 no-op。
+     */
+    watch(onChange: () => void): void;
+    unwatch(): void;
+}
+/**
+ * 隔离作用域配置管理器（cleanup-7 新增）
+ *
+ * 与 {@link ScopedServiceContainer} 对称：fallback-read + override-write。
+ *   - `get(key)` 优先返回 overlay 内的值，否则回退到父配置
+ *   - `set(key, value)` 仅写入 overlay，不影响父配置
+ *   - `getPluginConfig(name)` 返回 `{ ...parent, ...overlay }`（浅合并）
+ *   - `setPluginConfig(name, conf)` 完整替换 overlay 中该插件条目
+ *   - 不接触任何 provider：`save()` 为 no-op（与基类"无 provider 内存模式"
+ *     同语义——通用插件代码可以照常调 save() 而不被炸），`watch()` 为 no-op
+ *
+ * ⚠️ 实现约定：本类继承 ConfigManager 仅为名义类型兼容（Context.config 等
+ * 处声明为 ConfigManager），**基类内部状态从不读写**——所有公开方法都被
+ * 显式覆写为「overlay 优先，回退 parentConfig」的委托。给基类新增公开方法
+ * 时必须同步在此覆写，否则继承下来的实现会读写无效的基类快照（写穿透 /
+ * 读过期）。test/core/config.test.ts 有反射式防漂移用例兜底。
+ */
+export declare class ScopedConfigManager extends ConfigManager {
+    private overlay;
+    private parentConfig;
+    constructor(parent: ConfigManager);
+    get<K extends keyof AalisConfig>(key: K): AalisConfig[K];
+    getPluginConfig<T extends Record<string, unknown> = Record<string, unknown>>(pluginName: string): T;
+    isPluginDisabled(pluginName: string): boolean;
+    getServicePreferences(): Record<string, string>;
+    getAll(): Readonly<AalisConfig>;
+    getConfigDir(): string;
+    set<K extends keyof AalisConfig>(key: K, value: AalisConfig[K]): void;
+    setPluginConfig(pluginName: string, config: Record<string, unknown>): void;
+    removePluginConfig(pluginName: string): void;
+    setPluginEnabled(pluginName: string, enabled: boolean): void;
+    setServicePreference(name: string, contextId: string): void;
+    removeServicePreference(name: string): void;
+    syncPluginDefaults(plugins: ReadonlyArray<{
+        instanceId: string;
+        defaultConfig?: Record<string, unknown>;
+        configSchema?: Record<string, unknown>;
+    }>): string[];
+    /**
+     * no-op——与基类"无 provider 内存模式 save() 静默忽略"同语义。
+     * 通用插件代码（如 ensureServiceProvider 的 config.save()）在 scope 内
+     * 运行时不应被炸；隔离性由"写只进 overlay"保证，而不是靠 save 抛错。
+     */
+    save(): void;
+    /** scope 没有外部来源，快照重载没有意义；显式拒绝以暴露误用。 */
+    reloadFrom(): AalisConfig;
+    watch(): void;
+    unwatch(): void;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,377 @@
+const DEFAULT_CONFIG = {
+    name: 'Aalis',
+    logLevel: 'info',
+    plugins: {},
+    disabledPlugins: [],
+};
+/** 核心配置的 Schema，与插件 configSchema 走同一套渲染路径 */
+export const CORE_CONFIG_SCHEMA = {
+    name: { type: 'string', label: '应用名称', description: '应用显示名称，用于日志和界面展示', default: 'Aalis' },
+    logLevel: {
+        type: 'select',
+        label: '日志等级',
+        description: '日志输出等级',
+        default: 'info',
+        options: [
+            { label: 'debug', value: 'debug' },
+            { label: 'info', value: 'info' },
+            { label: 'warn', value: 'warn' },
+            { label: 'error', value: 'error' },
+        ],
+    },
+};
+/**
+ * 配置管理器：纯内存的配置中枢。
+ *
+ * 职责：
+ * - 持有当前配置快照（`AalisConfig`）
+ * - 提供 get/set/getPluginConfig 等访问器
+ * - 处理插件默认配置合并、schema 裁剪、服务偏好
+ *
+ * **不**做的事：
+ * - 不读写文件，不解析 yaml/json，不 watch 文件系统
+ *   ——这些由 `ConfigProvider`（宿主注入）负责
+ *
+ * 这样 core 可以在浏览器、嵌入式宿主、单元测试里直接使用：
+ * 测试代码可以 `new App({ config: { name: 'X', logLevel: 'error', plugins: {} } })`
+ * 而无需创建临时目录写 yaml 文件。
+ */
+export class ConfigManager {
+    config;
+    provider;
+    dataDir;
+    /** syncPluginDefaults 的字段裁剪政策（公开只读：scope 继承、宿主可内省） */
+    trimUnknownFields;
+    unwatchFn = null;
+    onChangeCallback = null;
+    constructor(initial, options) {
+        this.config = mergeDefaultsConfig(initial);
+        this.provider = options?.provider;
+        this.dataDir = options?.dataDir ?? '.';
+        this.trimUnknownFields = options?.trimUnknownFields ?? true;
+    }
+    get(key) {
+        return this.config[key];
+    }
+    getPluginConfig(pluginName) {
+        return (this.config.plugins[pluginName] ?? {});
+    }
+    /**
+     * 业务数据目录——plugin 用于解析相对路径。
+     * 命名沿用历史接口（`getConfigDir`），语义上是"宿主指定的数据根目录"。
+     */
+    getConfigDir() {
+        return this.dataDir;
+    }
+    getAll() {
+        return this.config;
+    }
+    set(key, value) {
+        this.config[key] = value;
+    }
+    setPluginConfig(pluginName, config) {
+        this.config.plugins[pluginName] = config;
+    }
+    removePluginConfig(pluginName) {
+        delete this.config.plugins[pluginName];
+    }
+    /**
+     * 将插件 defaultConfig 中缺失的字段合并到配置；同时按 configSchema
+     * 移除多余字段。返回发生变更的插件 instanceId 列表（调用方可决定要不要 log）。
+     *
+     * 副作用：内部对每个发生变化的条目调用 setPluginConfig；若有变化最终调用 save()。
+     */
+    syncPluginDefaults(plugins) {
+        const changed = [];
+        for (const plugin of plugins) {
+            const defaults = plugin.defaultConfig ?? {};
+            const schema = plugin.configSchema;
+            const fileConfig = this.getPluginConfig(plugin.instanceId);
+            let merged = deepMergeDefaults(defaults, fileConfig);
+            if (this.trimUnknownFields && schema && Object.keys(schema).length > 0) {
+                merged = removeExtraFields(merged, schema);
+            }
+            if (JSON.stringify(merged) !== JSON.stringify(fileConfig)) {
+                this.setPluginConfig(plugin.instanceId, merged);
+                changed.push(plugin.instanceId);
+            }
+        }
+        if (changed.length > 0)
+            this.save();
+        return changed;
+    }
+    isPluginDisabled(pluginName) {
+        return (this.config.disabledPlugins ?? []).includes(pluginName);
+    }
+    setPluginEnabled(pluginName, enabled) {
+        if (!this.config.disabledPlugins) {
+            this.config.disabledPlugins = [];
+        }
+        const idx = this.config.disabledPlugins.indexOf(pluginName);
+        if (enabled && idx >= 0) {
+            this.config.disabledPlugins.splice(idx, 1);
+        }
+        else if (!enabled && idx < 0) {
+            this.config.disabledPlugins.push(pluginName);
+        }
+    }
+    getServicePreferences() {
+        return (this.config.servicePreferences ?? {});
+    }
+    setServicePreference(name, contextId) {
+        if (!this.config.servicePreferences)
+            this.config.servicePreferences = {};
+        this.config.servicePreferences[name] = contextId;
+    }
+    removeServicePreference(name) {
+        if (!this.config.servicePreferences)
+            return;
+        delete this.config.servicePreferences[name];
+    }
+    /**
+     * 持久化当前配置。委托给 provider，无 provider 时静默忽略（内存模式）。
+     * 同步语义：若 provider 异步保存，调用方不会等待完成——这与原 fs sync 行为一致。
+     */
+    save() {
+        if (!this.provider?.save)
+            return;
+        const result = this.provider.save(this.config);
+        if (result instanceof Promise) {
+            result.catch(() => {
+                /* provider 自身负责报错；core 不做处理 */
+            });
+        }
+    }
+    /**
+     * 重新加载配置——把外部传入的快照写回内部状态。
+     *
+     * 历史上这是"从磁盘 re-read"的入口；现在交由 provider 决定何时
+     * 通过 `watch(onChange)` 把新快照推过来；本方法仅供 watch 回调使用。
+     *
+     * 注意：本方法（与 watch 回调）**不应用 trimUnknownFields 政策**——
+     * ConfigManager 不持有插件 schema，裁剪统一发生在 syncPluginDefaults
+     * （App.handleConfigFileChanged 热重载时会重新调用它对齐政策）。
+     */
+    reloadFrom(next) {
+        this.config = mergeDefaultsConfig(next);
+        return this.config;
+    }
+    /**
+     * 订阅配置外部变更。委托给 provider；无 provider 时为 no-op。
+     */
+    watch(onChange) {
+        this.onChangeCallback = onChange;
+        if (!this.provider?.watch)
+            return;
+        if (this.unwatchFn)
+            return;
+        this.unwatchFn = this.provider.watch(next => {
+            this.config = mergeDefaultsConfig(next);
+            this.onChangeCallback?.();
+        });
+    }
+    unwatch() {
+        this.unwatchFn?.();
+        this.unwatchFn = null;
+        this.onChangeCallback = null;
+    }
+}
+/**
+ * 隔离作用域配置管理器（cleanup-7 新增）
+ *
+ * 与 {@link ScopedServiceContainer} 对称：fallback-read + override-write。
+ *   - `get(key)` 优先返回 overlay 内的值，否则回退到父配置
+ *   - `set(key, value)` 仅写入 overlay，不影响父配置
+ *   - `getPluginConfig(name)` 返回 `{ ...parent, ...overlay }`（浅合并）
+ *   - `setPluginConfig(name, conf)` 完整替换 overlay 中该插件条目
+ *   - 不接触任何 provider：`save()` 为 no-op（与基类"无 provider 内存模式"
+ *     同语义——通用插件代码可以照常调 save() 而不被炸），`watch()` 为 no-op
+ *
+ * ⚠️ 实现约定：本类继承 ConfigManager 仅为名义类型兼容（Context.config 等
+ * 处声明为 ConfigManager），**基类内部状态从不读写**——所有公开方法都被
+ * 显式覆写为「overlay 优先，回退 parentConfig」的委托。给基类新增公开方法
+ * 时必须同步在此覆写，否则继承下来的实现会读写无效的基类快照（写穿透 /
+ * 读过期）。test/core/config.test.ts 有反射式防漂移用例兜底。
+ */
+export class ScopedConfigManager extends ConfigManager {
+    overlay = {};
+    parentConfig;
+    constructor(parent) {
+        // 基类要求一个 initial 快照——传入独立的空白对象占位。绝不可传
+        // parent.getAll()：那会把 plugins/disabledPlugins 等容器按引用共享给
+        // 基类快照，一旦哪个方法漏覆写，继承实现的写入会穿透进父配置。
+        // 政策字段（trimUnknownFields）按值继承父配置——syncPluginDefaults 经
+        // 虚分派读 this.trimUnknownFields，scope 必须与父同政策。
+        super({ name: '', logLevel: '', plugins: {} }, { trimUnknownFields: parent.trimUnknownFields });
+        this.parentConfig = parent;
+    }
+    // ---- 读路径：overlay 优先，回退父配置 ----
+    get(key) {
+        if (this.overlay && key in this.overlay) {
+            return this.overlay[key];
+        }
+        return this.parentConfig.get(key);
+    }
+    getPluginConfig(pluginName) {
+        const parentConf = this.parentConfig.getPluginConfig(pluginName);
+        const ownConf = (this.overlay.plugins?.[pluginName] ?? {});
+        // 浅合并：scope 的覆盖只影响顶层 key；嵌套对象由调用方自行 deep-merge
+        return { ...parentConf, ...ownConf };
+    }
+    isPluginDisabled(pluginName) {
+        if (this.overlay.disabledPlugins !== undefined) {
+            return this.overlay.disabledPlugins.includes(pluginName);
+        }
+        return this.parentConfig.isPluginDisabled(pluginName);
+    }
+    getServicePreferences() {
+        return this.overlay.servicePreferences ?? this.parentConfig.getServicePreferences();
+    }
+    getAll() {
+        const parentAll = this.parentConfig.getAll();
+        const mergedPlugins = { ...parentAll.plugins };
+        if (this.overlay.plugins) {
+            for (const [name, conf] of Object.entries(this.overlay.plugins)) {
+                mergedPlugins[name] = { ...(parentAll.plugins[name] ?? {}), ...conf };
+            }
+        }
+        return {
+            ...parentAll,
+            ...this.overlay,
+            plugins: mergedPlugins,
+        };
+    }
+    getConfigDir() {
+        return this.parentConfig.getConfigDir();
+    }
+    // ---- 写路径：只进 overlay，绝不触碰父配置 ----
+    set(key, value) {
+        if (!this.overlay)
+            this.overlay = {};
+        this.overlay[key] = value;
+    }
+    setPluginConfig(pluginName, config) {
+        if (!this.overlay.plugins)
+            this.overlay.plugins = {};
+        this.overlay.plugins[pluginName] = config;
+    }
+    removePluginConfig(pluginName) {
+        if (this.overlay.plugins)
+            delete this.overlay.plugins[pluginName];
+    }
+    setPluginEnabled(pluginName, enabled) {
+        // copy-on-write：首写时把父级列表拷一份进 overlay，之后整列表 shadow 父级
+        if (this.overlay.disabledPlugins === undefined) {
+            this.overlay.disabledPlugins = [...(this.parentConfig.get('disabledPlugins') ?? [])];
+        }
+        const list = this.overlay.disabledPlugins;
+        const idx = list.indexOf(pluginName);
+        if (enabled && idx >= 0) {
+            list.splice(idx, 1);
+        }
+        else if (!enabled && idx < 0) {
+            list.push(pluginName);
+        }
+    }
+    setServicePreference(name, contextId) {
+        if (!this.overlay.servicePreferences) {
+            this.overlay.servicePreferences = { ...this.parentConfig.getServicePreferences() };
+        }
+        this.overlay.servicePreferences[name] = contextId;
+    }
+    removeServicePreference(name) {
+        if (!this.overlay.servicePreferences) {
+            this.overlay.servicePreferences = { ...this.parentConfig.getServicePreferences() };
+        }
+        delete this.overlay.servicePreferences[name];
+    }
+    syncPluginDefaults(plugins) {
+        // 基类算法走 this.getPluginConfig / this.setPluginConfig / this.save() 虚分派，
+        // 在本类上即为「合并进 overlay、不落盘」——语义正确，显式声明以防漂移。
+        return super.syncPluginDefaults(plugins);
+    }
+    // ---- provider 相关：scope 不持久化、不订阅 ----
+    /**
+     * no-op——与基类"无 provider 内存模式 save() 静默忽略"同语义。
+     * 通用插件代码（如 ensureServiceProvider 的 config.save()）在 scope 内
+     * 运行时不应被炸；隔离性由"写只进 overlay"保证，而不是靠 save 抛错。
+     */
+    save() {
+        /* scope 配置仅存活于内存 */
+    }
+    /** scope 没有外部来源，快照重载没有意义；显式拒绝以暴露误用。 */
+    reloadFrom() {
+        throw new Error('ScopedConfigManager.reloadFrom() 不可用：scope 配置没有外部来源。');
+    }
+    watch() {
+        /* scope 不订阅 provider */
+    }
+    unwatch() {
+        /* no-op */
+    }
+}
+// ---- helpers ----
+function mergeDefaultsConfig(input) {
+    const merged = {
+        name: input.name ?? DEFAULT_CONFIG.name,
+        logLevel: input.logLevel ?? DEFAULT_CONFIG.logLevel,
+        plugins: input.plugins ?? {},
+        disabledPlugins: input.disabledPlugins ?? [],
+    };
+    for (const [key, value] of Object.entries(input)) {
+        if (key === 'name' || key === 'logLevel' || key === 'plugins' || key === 'disabledPlugins')
+            continue;
+        merged[key] = value;
+    }
+    return merged;
+}
+/**
+ * 深度合并默认值：只填充缺失的键，不覆盖已有值。
+ * 嵌套对象会递归合并；数组与基础类型按"已存在则保留"处理。
+ */
+function deepMergeDefaults(defaults, current) {
+    const result = { ...current };
+    for (const [key, defaultValue] of Object.entries(defaults)) {
+        if (!(key in result)) {
+            result[key] = defaultValue;
+        }
+        else if (defaultValue !== null &&
+            typeof defaultValue === 'object' &&
+            !Array.isArray(defaultValue) &&
+            result[key] !== null &&
+            typeof result[key] === 'object' &&
+            !Array.isArray(result[key])) {
+            result[key] = deepMergeDefaults(defaultValue, result[key]);
+        }
+    }
+    return result;
+}
+/**
+ * 根据 configSchema 移除多余字段。
+ * SchemaGroup（含 fields）对应嵌套对象，递归清理；
+ * SchemaArray（type=array）直接保留；
+ * SchemaField 对应普通字段。
+ */
+function removeExtraFields(config, schema) {
+    const result = {};
+    for (const [key, value] of Object.entries(config)) {
+        if (!(key in schema))
+            continue;
+        const schemaDef = schema[key];
+        if (schemaDef.type === 'array') {
+            result[key] = value;
+        }
+        else if (schemaDef.fields &&
+            typeof schemaDef.fields === 'object' &&
+            value !== null &&
+            typeof value === 'object' &&
+            !Array.isArray(value)) {
+            result[key] = removeExtraFields(value, schemaDef.fields);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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

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

@@ -0,0 +1,36 @@
+/**
+ * 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

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