@aalis/core 0.1.0

package/dist/service.js.map

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

package/dist/types/agent.d.ts

@@ -0,0 +1,51 @@
+import type { IncomingMessage, PluginGroupInfo } from './core.js';
+/**
+ * 消息预处理器函数
+ *
+ * 在消息到达 LLM 之前对 IncomingMessage 进行变换。
+ * 遵循洋葱模型：调用 `next()` 将控制权传递给下一个预处理器，
+ * 不调用则中断整个流程（LLM 不会被调用）。
+ */
+export type PreprocessorFn = (message: IncomingMessage, next: () => Promise<void>) => Promise<void>;
+/** 已注册预处理器的元信息 */
+export interface PreprocessorInfo {
+    /** 预处理器名称 */
+    name: string;
+}
+/**
+ * Agent 服务 —— 对话编排引擎
+ *
+ * 负责接收用户消息并编排完整的对话流程：
+ * 组装系统提示、加载历史、调用 LLM、执行工具调用循环、发出回复。
+ *
+ * 默认由 plugin-agent-default 提供。
+ * 外部插件可以注册自己的 AgentService 来完全接管或扩展对话编排逻辑。
+ */
+export interface AgentService {
+    /** 处理一条传入消息，完成完整的对话循环 */
+    handleMessage(message: IncomingMessage): Promise<void>;
+    /** 中止指定会话的当前生成（可选实现） */
+    abort?(sessionId: string): void;
+    /**
+     * 注册消息预处理器
+     *
+     * 预处理器在 `agent:input:before` 阶段运行，可以修改 IncomingMessage（如将图片转文字、解析文件）。
+     * 底层通过中间件系统实现，priority 越大越先执行。
+     *
+     * @param name 预处理器名称（用于日志和调试）
+     * @param handler 处理函数
+     * @param priority 优先级（默认 500，越大越先执行）
+     * @returns dispose 函数，调用后注销此预处理器
+     */
+    registerPreprocessor?(name: string, handler: PreprocessorFn): () => void;
+    /** 获取当前所有已注册预处理器的元信息 */
+    getPreprocessors?(): PreprocessorInfo[];
+    /**
+     * 获取 Agent 子系统的插件分组
+     *
+     * 基于 Agent 的 inject 声明，自动找出所有为 Agent 提供服务的插件，
+     * 返回分组信息供 Dashboard 使用。
+     */
+    getPluginGroups?(): PluginGroupInfo[];
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,wBAAwB;IACxB,KAAK,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IAEzE,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,gBAAgB,EAAE,CAAC;IAExC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,eAAe,EAAE,CAAC;CACvC"}

package/dist/types/agent.js

@@ -0,0 +1,3 @@
+// ----- Agent 服务接口 -----
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA,yBAAyB"}

package/dist/types/app.d.ts

@@ -0,0 +1,74 @@
+import type { ConfigSchema } from './core.js';
+import type { PluginEntry, PluginState } from './plugin.js';
+/**
+ * App 生命周期 + 配置 + 市场 接口
+ *
+ * 插件通过 `ctx.getService('app')` 获取，
+ * 用于触发应用级操作，无需直接导入 App 类。
+ */
+export interface AppService {
+    /** 停止应用 */
+    stop(): Promise<void>;
+    /** 重启应用（延迟 spawn 新进程后退出当前进程） */
+    restart(): void;
+    /** 保存配置到磁盘 */
+    saveConfig(): void;
+    /** 重新扫描 packages/ 目录，返回新发现并加载的插件名列表 */
+    rescanPlugins(): Promise<string[]>;
+}
+/** PluginManager 暴露给插件消费的接口 */
+export interface PluginStatusEntry {
+    name: string;
+    instanceId: string;
+    displayName?: string;
+    /** 子系统归属（manifest 声明），用于 WebUI 分组展示 */
+    subsystem?: string;
+    state: PluginState;
+    provides?: string[];
+    core?: boolean;
+    reusable?: boolean;
+    extends?: unknown;
+    /** 必需依赖的服务名（来自 inject.required，能力披露用：该插件「要调用哪些子系统」） */
+    requiredServices?: string[];
+    /** 可选依赖的服务名（来自 inject.optional） */
+    optionalServices?: string[];
+    config: Record<string, unknown>;
+    configSchema?: ConfigSchema;
+    defaultConfig?: Record<string, unknown>;
+    error?: string;
+}
+/**
+ * 插件管理服务接口
+ *
+ * 通过 `ctx.getService('plugins')` 获取。
+ * 内部由 core 的 PluginManager 提供。消费方不应直接 import App 类。
+ */
+export interface PluginManagerService {
+    /** 获取所有已注册插件的状态 */
+    getStatus(): PluginStatusEntry[];
+    /** 获取单个插件条目 */
+    getPlugin(name: string): PluginEntry | undefined;
+    /** 更新插件配置（自动触发软重载） */
+    updatePluginConfig(name: string, config: Record<string, unknown>): Promise<boolean>;
+    /** 启用插件 */
+    enablePlugin(name: string): Promise<boolean>;
+    /** 禁用插件 */
+    disablePlugin(name: string): Promise<boolean>;
+    /** 基于 reusable 插件创建新实例，返回 instanceId */
+    createInstance(moduleName: string, suffix: string, config?: Record<string, unknown>): Promise<string | undefined>;
+    /** 删除实例 */
+    removeInstance(instanceId: string): Promise<boolean>;
+}
+declare module './capabilities.js' {
+    interface ServiceCapabilityMap {
+        app: 'lifecycle' | 'config';
+        plugins: 'plugin-mgmt';
+    }
+}
+declare module './services.js' {
+    interface ServiceTypeMap {
+        app: AppService;
+        plugins: PluginManagerService;
+    }
+}
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +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,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,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,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,mBAAmB,CAAC;IACjC,UAAU,oBAAoB;QAC5B,GAAG,EAAE,WAAW,GAAG,QAAQ,CAAC;QAC5B,OAAO,EAAE,aAAa,CAAC;KACxB;CACF;AAED,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,cAAc;QACtB,GAAG,EAAE,UAAU,CAAC;QAChB,OAAO,EAAE,oBAAoB,CAAC;KAC/B;CACF"}

package/dist/types/app.js

@@ -0,0 +1,3 @@
+// ----- App 服务接口 -----
+export {};
+//# sourceMappingURL=app.js.map

package/dist/types/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/types/app.ts"],"names":[],"mappings":"AAAA,uBAAuB"}

package/dist/types/archive.d.ts

@@ -0,0 +1,59 @@
+import type { IncomingMessage, Message } from './core.js';
+export interface ArchiveIncomingResult {
+    message: Message;
+    content: string;
+    imageRecognitionInfo?: IncomingMessage['_imageRecognitionInfo'];
+}
+/** 平台通知/事件归档参数（参考 OneBot v11/v12 notice 规范） */
+export interface ArchiveNoticeOptions {
+    /** 归档目标会话 ID（与正常消息共用同一会话） */
+    sessionId: string;
+    /** 通知类型：onebot 中的 notice_type / detail_type，例如 group_ban、group_recall、group_increase 等 */
+    noticeType: string;
+    /** 通知子类型（如 v11 group_ban 的 ban / lift_ban） */
+    subType?: string;
+    /** 人类可读的描述文本，将作为 system 消息内容写入记忆 */
+    content: string;
+    /** 平台标识（如 onebot） */
+    platform?: string;
+    /** 触发者用户 ID */
+    userId?: string;
+    /** 被操作者用户 ID（如禁言对象、撤回消息发送者） */
+    targetId?: string;
+    /** 群 ID（群聊场景） */
+    groupId?: string;
+    /** 操作者用户 ID（如管理员） */
+    operatorId?: string;
+    /** 事件时间戳（毫秒），缺省使用当前时间 */
+    timestamp?: number;
+    /** 任意附加数据（持续时长、消息 ID 等），透传至 metadata */
+    data?: Record<string, unknown>;
+}
+export interface MessageArchiveService {
+    saveMessage(sessionId: string, message: Message, options?: {
+        debugLabel?: string;
+    }): Promise<void>;
+    archiveIncoming(message: IncomingMessage): Promise<ArchiveIncomingResult>;
+    /** 平台 notice/事件入档（系统级条目，不会触发 agent 响应） */
+    archiveNotice?(options: ArchiveNoticeOptions): Promise<Message | null>;
+}
+export interface MessageArchiveCapabilityRegistry {
+    /** 支持入站消息归档（archiveIncoming，含图片预识别） */
+    Incoming: 'incoming';
+    /** 支持通用消息保存（saveMessage） */
+    Generic: 'generic';
+    /** 支持平台 notice 事件入档（archiveNotice） */
+    Notice: 'notice';
+}
+export type MessageArchiveCapability = MessageArchiveCapabilityRegistry[keyof MessageArchiveCapabilityRegistry];
+export declare const MessageArchiveCapabilities: {
+    readonly Incoming: "incoming";
+    readonly Generic: "generic";
+    readonly Notice: "notice";
+};
+declare module './capabilities.js' {
+    interface ServiceCapabilityMap {
+        'message-archive': MessageArchiveCapability;
+    }
+}
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/types/archive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,eAAe,CAAC,uBAAuB,CAAC,CAAC;CACjE;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1E,0CAA0C;IAC1C,aAAa,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACxE;AAID,MAAM,WAAW,gCAAgC;IAC/C,uCAAuC;IACvC,QAAQ,EAAE,UAAU,CAAC;IACrB,4BAA4B;IAC5B,OAAO,EAAE,SAAS,CAAC;IACnB,sCAAsC;IACtC,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,gCAAgC,CAAC,MAAM,gCAAgC,CAAC,CAAC;AAEhH,eAAO,MAAM,0BAA0B;;;;CAIc,CAAC;AAEtD,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,oBAAoB;QAC5B,iBAAiB,EAAE,wBAAwB,CAAC;KAC7C;CACF"}

package/dist/types/archive.js

@@ -0,0 +1,16 @@
+export const MessageArchiveCapabilities = {
+    Incoming: 'incoming',
+    Generic: 'generic',
+    Notice: 'notice',
+};
+import { registerCapabilityProbe } from './capabilities.js';
+registerCapabilityProbe('message-archive', MessageArchiveCapabilities.Incoming, inst => typeof inst.archiveIncoming === 'function'
+    ? true
+    : 'MessageArchiveService.archiveIncoming() is required for capability "incoming"');
+registerCapabilityProbe('message-archive', MessageArchiveCapabilities.Generic, inst => typeof inst.saveMessage === 'function'
+    ? true
+    : 'MessageArchiveService.saveMessage() is required for capability "generic"');
+registerCapabilityProbe('message-archive', MessageArchiveCapabilities.Notice, inst => typeof inst.archiveNotice === 'function'
+    ? true
+    : 'MessageArchiveService.archiveNotice() is required for capability "notice"');
+//# sourceMappingURL=archive.js.map

package/dist/types/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/types/archive.ts"],"names":[],"mappings":"AAsDA,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACmC,CAAC;AAQtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,uBAAuB,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CACrF,OAAQ,IAAsC,CAAC,eAAe,KAAK,UAAU;IAC3E,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,+EAA+E,CAAC,CAAC;AAEvF,uBAAuB,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CACpF,OAAQ,IAAkC,CAAC,WAAW,KAAK,UAAU;IACnE,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,0EAA0E,CAAC,CAAC;AAElF,uBAAuB,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CACnF,OAAQ,IAAoC,CAAC,aAAa,KAAK,UAAU;IACvE,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,2EAA2E,CAAC,CAAC"}

package/dist/types/authority.d.ts

@@ -0,0 +1,63 @@
+/** 高危操作确认请求信息 */
+export interface DangerousConfirmRequest {
+    /** 操作名称（指令名或工具名） */
+    name: string;
+    /** 操作类型 */
+    type: 'command' | 'tool';
+    /** 操作参数（工具调用时存在） */
+    args?: Record<string, unknown>;
+    /** 细粒度权限标识 */
+    permissions?: string[];
+    /** 会话 ID */
+    sessionId: string;
+    /** 来源平台 */
+    platform: string;
+    /** 用户 ID */
+    userId?: string;
+}
+export interface DangerousGrantRequest {
+    /** 授权范围：once 不会被持久记录；session 表示当前会话短时授权 */
+    scope: 'once' | 'session';
+    /** 授权秒数，仅 scope=session 时有效 */
+    durationSeconds?: number;
+    /** 最大使用次数，仅 scope=session 时有效 */
+    maxUses?: number;
+}
+export interface DangerousConfirmResult {
+    allowed: boolean;
+    grant?: DangerousGrantRequest;
+}
+export interface DangerousGrant {
+    id: string;
+    name: string;
+    type: 'command' | 'tool';
+    /** 创建授权时绑定的权限集合 */
+    permissions?: string[];
+    sessionId: string;
+    platform: string;
+    userId?: string;
+    expiresAt: number;
+    maxUses?: number;
+    used: number;
+    createdAt: number;
+}
+/** 确认回调：boolean 为旧格式；对象格式可附带短时 grant */
+export type DangerousConfirmHandler = (request: DangerousConfirmRequest) => Promise<boolean | DangerousConfirmResult>;
+/** 权限服务接口 */
+export interface AuthorityService {
+    getAuthority(platform: string, userId?: string): number;
+    setAuthority(platform: string, userId: string, level: number): void;
+    isOwner(platform: string, userId?: string): boolean;
+    isDangerousAllowed(name: string, permissions?: string[]): boolean;
+    confirmDangerous(request: DangerousConfirmRequest): Promise<boolean>;
+    listDangerousGrants(): DangerousGrant[];
+    revokeDangerousGrant(id: string): boolean;
+    save(): void;
+    setConfirmHandler(platform: string, handler: DangerousConfirmHandler): void;
+    listUsers(): Array<{
+        platform: string;
+        userId: string;
+        authority: number;
+    }>;
+}
+//# sourceMappingURL=authority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authority.d.ts","sourceRoot":"","sources":["../../src/types/authority.ts"],"names":[],"mappings":"AAEA,iBAAiB;AACjB,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,OAAO,GAAG,sBAAsB,CAAC,CAAC;AAEtH,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAClE,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,mBAAmB,IAAI,cAAc,EAAE,CAAC;IACxC,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,IAAI,IAAI,IAAI,CAAC;IACb,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC5E,SAAS,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E"}

package/dist/types/authority.js

@@ -0,0 +1,3 @@
+// ----- 权限服务接口 -----
+export {};
+//# sourceMappingURL=authority.js.map

package/dist/types/authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.js","sourceRoot":"","sources":["../../src/types/authority.ts"],"names":[],"mappings":"AAAA,qBAAqB"}

package/dist/types/capabilities.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 服务名 → 能力 union 的全局映射表
+ *
+ * 各服务类型文件通过 declaration merging 注册自己的条目；
+ * 第三方插件如需注册全新服务名，也通过同样方式扩展。
+ *
+ * 不在此处列出任何条目，所有内容由各服务文件就近声明，便于解耦与新增。
+ */
+export interface ServiceCapabilityMap {
+}
+/**
+ * 根据服务名解析其允许的能力字符串类型。
+ * - 已注册的服务名（在 ServiceCapabilityMap 中）→ 对应 union
+ * - 未注册的服务名 → `string`（保持向后兼容，不阻塞动态服务）
+ */
+export type CapabilityOf<TName extends string> = TName extends keyof ServiceCapabilityMap ? ServiceCapabilityMap[TName] & string : string;
+/**
+ * `provide()` / `getService()` 的能力参数类型
+ *
+ * 允许传入只读数组（如 `as const` 字面量）或普通数组。
+ */
+export type CapabilityList<TName extends string> = ReadonlyArray<CapabilityOf<TName>>;
+/**
+ * 能力探测函数：返回 `true` 表示通过；返回字符串表示失败原因。
+ *
+ * @example
+ * const probe: CapabilityProbe = inst =>
+ *   typeof (inst as { chat?: unknown }).chat === 'function'
+ *     ? true
+ *     : 'LLMService.chat() is required for capability "chat"';
+ */
+export type CapabilityProbe = (instance: unknown) => true | string;
+/**
+ * 注册一条能力探测器
+ *
+ * 重复注册相同 `(service, capability)` 会覆盖之前的注册，
+ * 这使得同一服务的不同实现版本可以通过自己的类型文件被覆盖/扩展。
+ *
+ * 注册本身始终生效——是否在 `provide` 时**调用**探测器，
+ * 由 `Context.devMode` 控制（生产模式 App 传 `devMode: false`，
+ * `Context.provide` 直接跳过探测，闭包仍驻留但不参与热路径）。
+ */
+export declare function registerCapabilityProbe(service: string, capability: string, probe: CapabilityProbe): void;
+/**
+ * 按服务+能力探测实例
+ *
+ * @returns
+ * - `true`：探测通过
+ * - `string`：探测失败（信息用于报错）
+ * - `null`：没有对应探测器（跳过校验）
+ */
+export declare function probeCapability(service: string, capability: string, instance: unknown): true | string | null;
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/types/capabilities.ts"],"names":[],"mappings":"AA8CA;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB;CAEpC;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,MAAM,IAAI,KAAK,SAAS,MAAM,oBAAoB,GACrF,oBAAoB,CAAC,KAAK,CAAC,GAAG,MAAM,GACpC,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAWtF;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,CAAC;AAInE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAOzG;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAU5G"}

package/dist/types/capabilities.js

@@ -0,0 +1,87 @@
+// ----- 服务能力声明框架 -----
+//
+// Aalis 的服务能力（capability）采用「按服务隔离的注册表 + declaration merging」模式，
+// 既保证编译期类型安全，也允许第三方插件扩展。
+//
+// ## 模式说明
+//
+// 每个服务类型文件（如 `types/llm.ts`）维护一个独立的 `XxxCapabilityRegistry` 接口，
+// 通过 interface declaration merging 让第三方可以追加能力键：
+//
+// ```ts
+// // types/llm.ts (内置)
+// export interface LLMCapabilityRegistry {
+//   Chat: 'chat';
+//   ToolCalling: 'tool_calling';
+//   // ...
+// }
+// export type LLMCapability = LLMCapabilityRegistry[keyof LLMCapabilityRegistry];
+// export const LLMCapabilities = { Chat: 'chat', ToolCalling: 'tool_calling', ... } as const;
+// ```
+//
+// ```ts
+// // 第三方插件扩展能力
+// declare module '@aalis/core' {
+//   interface LLMCapabilityRegistry {
+//     AudioInput: 'audio_input';
+//     FimCompletion: 'fim_completion';
+//   }
+// }
+// ```
+//
+// 然后通过 `ServiceCapabilityMap`（本文件）将服务名映射到其能力 union，
+// `Context.provide()` / `getService()` 即可在编译期约束传入的 capability 字符串。
+//
+// 各服务类型文件通过 declaration merging 注册自己的映射，本文件**不**列出具体服务
+// （保持模块化，新增服务无需修改本文件）：
+//
+// ```ts
+// // types/llm.ts
+// declare module './capabilities.js' {
+//   interface ServiceCapabilityMap {
+//     llm: LLMCapability;
+//   }
+// }
+// ```
+const _probes = new Map();
+/**
+ * 注册一条能力探测器
+ *
+ * 重复注册相同 `(service, capability)` 会覆盖之前的注册，
+ * 这使得同一服务的不同实现版本可以通过自己的类型文件被覆盖/扩展。
+ *
+ * 注册本身始终生效——是否在 `provide` 时**调用**探测器，
+ * 由 `Context.devMode` 控制（生产模式 App 传 `devMode: false`，
+ * `Context.provide` 直接跳过探测，闭包仍驻留但不参与热路径）。
+ */
+export function registerCapabilityProbe(service, capability, probe) {
+    let byCap = _probes.get(service);
+    if (!byCap) {
+        byCap = new Map();
+        _probes.set(service, byCap);
+    }
+    byCap.set(capability, probe);
+}
+/**
+ * 按服务+能力探测实例
+ *
+ * @returns
+ * - `true`：探测通过
+ * - `string`：探测失败（信息用于报错）
+ * - `null`：没有对应探测器（跳过校验）
+ */
+export function probeCapability(service, capability, instance) {
+    const byCap = _probes.get(service);
+    if (!byCap)
+        return null;
+    const probe = byCap.get(capability);
+    if (!probe)
+        return null;
+    try {
+        return probe(instance);
+    }
+    catch (err) {
+        return `probe threw: ${err instanceof Error ? err.message : String(err)}`;
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/types/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/types/capabilities.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,gEAAgE;AAChE,yBAAyB;AACzB,EAAE;AACF,UAAU;AACV,EAAE;AACF,gEAAgE;AAChE,gDAAgD;AAChD,EAAE;AACF,QAAQ;AACR,uBAAuB;AACvB,2CAA2C;AAC3C,kBAAkB;AAClB,iCAAiC;AACjC,WAAW;AACX,IAAI;AACJ,kFAAkF;AAClF,8FAA8F;AAC9F,MAAM;AACN,EAAE;AACF,QAAQ;AACR,eAAe;AACf,iCAAiC;AACjC,sCAAsC;AACtC,iCAAiC;AACjC,uCAAuC;AACvC,MAAM;AACN,IAAI;AACJ,MAAM;AACN,EAAE;AACF,oDAAoD;AACpD,mEAAmE;AACnE,EAAE;AACF,uDAAuD;AACvD,uBAAuB;AACvB,EAAE;AACF,QAAQ;AACR,kBAAkB;AAClB,uCAAuC;AACvC,qCAAqC;AACrC,0BAA0B;AAC1B,MAAM;AACN,IAAI;AACJ,MAAM;AAmDN,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwC,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,UAAkB,EAAE,KAAsB;IACjG,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,UAAkB,EAAE,QAAiB;IACpF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/types/cli.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI 服务 —— 命令行交互界面
+ *
+ * 提供终端 REPL 交互，支持指令输入和对话。
+ * 核心要求此服务必须运行。
+ * 默认由 plugin-cli 提供，第三方可提供自己的 CLI 实现。
+ */
+export interface CLIService {
+    /** 获取当前会话 ID */
+    getSessionId(): string;
+    /** CLI 是否正在运行 */
+    isRunning(): boolean;
+}
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,YAAY,IAAI,MAAM,CAAC;IACvB,iBAAiB;IACjB,SAAS,IAAI,OAAO,CAAC;CACtB"}

package/dist/types/cli.js

@@ -0,0 +1,3 @@
+// ----- CLI 服务接口 -----
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/types/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":"AAAA,uBAAuB"}

package/dist/types/commands.d.ts

@@ -0,0 +1,98 @@
+import type { CommandDefinition, RegisteredCommand, CommandContext, SubcommandDefinition, ExecutionGuard, SafetyLevel, CommandArgumentDefinition, CommandOptionDefinition } from './core.js';
+/**
+ * 指令树节点的扁平化视图（用于 WebUI 渲染、help 输出等）。
+ *
+ * 每个根指令及其所有递归后代都会产出一条记录，path 表示完整路径，
+ * key = path.join(':') 同时也是 override 的查找键。
+ */
+export interface CommandNodeInfo {
+    /** 完整路径，如 ['clear', 'all'] */
+    path: string[];
+    /** override 键 = path.join(':')，如 'clear:all' */
+    key: string;
+    /** 节点自身的名字（path 末段） */
+    name: string;
+    /** 嵌套深度，根为 0 */
+    depth: number;
+    /** 描述 */
+    description: string;
+    /** 有效权限等级（已应用 override + 父节点继承） */
+    authority: number;
+    /** 有效安全级别 */
+    safety: SafetyLevel;
+    /** 细粒度权限标识（含默认 command:<path> 与声明值） */
+    permissions: string[];
+    /** 节点本身声明的 authority；缺省时与父继承值相同 */
+    baseAuthority: number;
+    /** 节点本身声明的 safety；缺省时与父继承值相同 */
+    baseSafety: SafetyLevel;
+    /** 节点自身声明的权限标识（不含默认 command:<path>） */
+    basePermissions: string[];
+    /** 当前键是否存在 override 配置 */
+    overridden: boolean;
+    /** 是否为根指令 */
+    isRoot: boolean;
+    /** 是否含有子指令 */
+    hasSubcommands: boolean;
+    /** 是否提供了 action（无 action 的纯分组节点调用时返回 usage） */
+    hasAction: boolean;
+    /** 注册此根指令的插件名（同根的所有后代共用） */
+    pluginName: string;
+    /** 位置参数声明 */
+    arguments?: CommandArgumentDefinition[];
+    /** 选项声明 */
+    options?: CommandOptionDefinition[];
+    /** 自定义用法文本 */
+    usage?: string;
+    /** 示例 */
+    examples?: string[];
+}
+/**
+ * 指令服务接口
+ *
+ * 管理用户可调用的斜杠指令的注册、解析、执行。
+ * 由 plugin-commands 创建 CommandRegistry 并注册为服务。
+ */
+export interface CommandService {
+    /** 指令前缀 */
+    prefix: string;
+    register(command: CommandDefinition, pluginName: string): () => void;
+    unregisterByPlugin(pluginName: string): void;
+    execute(name: string, ctx: CommandContext): Promise<string | undefined>;
+    parseCommand(input: string): {
+        name: string;
+        args: string[];
+        raw: string;
+    } | null;
+    has(name: string): boolean;
+    get(name: string): RegisteredCommand | undefined;
+    /** 仅返回根指令；保持向后兼容（如 Dashboard chip） */
+    getAll(): RegisteredCommand[];
+    /**
+     * 返回所有节点的扁平化视图（含递归子指令），按深度优先顺序。
+     * 主要供权限管理 UI、help、调试使用。
+     */
+    getAllNodes(): CommandNodeInfo[];
+    /**
+     * 根据路径解析具体节点，返回扁平视图。未命中返回 undefined。
+      * 路径示例：'clear' 或 'clear:all' 或 ['clear','all']。
+     */
+    getNode(path: string | string[]): CommandNodeInfo | undefined;
+    loadOverrides(overrides: Record<string, {
+        authority?: number;
+        safety?: string;
+    }>): void;
+    setOverride(name: string, override: {
+        authority?: number;
+        safety?: string;
+    }): void;
+    removeOverride(name: string): void;
+    getOverrides(): Record<string, {
+        authority?: number;
+        safety?: string;
+    }>;
+    /** 设置执行守卫（由权限插件注入） */
+    setExecutionGuard(guard: ExecutionGuard): void;
+}
+export type { SubcommandDefinition };
+//# sourceMappingURL=commands.d.ts.map

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

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

package/dist/types/commands.js

@@ -0,0 +1,3 @@
+// ===== 指令服务接口 =====
+export {};
+//# sourceMappingURL=commands.js.map

package/dist/types/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAAA,qBAAqB"}