@aalis/core 0.1.0

package/dist/types/core.d.ts

@@ -0,0 +1,117 @@
+export interface ServiceDependency {
+    service: string;
+    capabilities?: string[];
+}
+export type DependencyDeclaration = string | ServiceDependency;
+export interface InjectDeclaration {
+    required?: DependencyDeclaration[];
+    optional?: DependencyDeclaration[];
+}
+/**
+ * Schema 字段类型注册表 —— declaration merging 扩展点。
+ *
+ * core 只内置环境无关的基础类型；带业务/宿主语义的类型由对应 api 包合并声明
+ * （如 `'llm-ref'` 由 @aalis/plugin-llm-api 注入）。key 即类型名，value 恒为 true。
+ *
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface SchemaFieldTypes {
+ *     'llm-ref': true;
+ *   }
+ * }
+ * ```
+ */
+export interface SchemaFieldTypes {
+    string: true;
+    number: true;
+    boolean: true;
+    select: true;
+    multiselect: true;
+    textarea: true;
+}
+export type SchemaFieldType = keyof SchemaFieldTypes & string;
+/**
+ * 单个配置字段。
+ *
+ * core 只声明任意宿主都需要的中立字段；渲染/交互相关的扩展属性
+ * （如 `secret` / `dynamicOptions` / `allowCustom`）由消费它们的宿主 api 包
+ * （@aalis/plugin-webui-api）通过 declaration merging 注入——core 不感知
+ * 任何具体宿主的表单语义。
+ */
+export interface SchemaField {
+    type: SchemaFieldType;
+    label: string;
+    description?: string;
+    default?: unknown;
+    required?: boolean;
+    /** select / multiselect 类型的静态选项 */
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+}
+export interface SchemaGroup {
+    label?: string;
+    description?: string;
+    fields: Record<string, SchemaField>;
+}
+/** 数组 Schema：对象数组，每个元素用 items 描述其字段结构 */
+export interface SchemaArray {
+    type: 'array';
+    label: string;
+    description?: string;
+    /** 数组每个元素的字段定义 */
+    items: Record<string, SchemaField>;
+    default?: unknown[];
+}
+/** 配置 Schema：顶层 key 可以是字段、分组或数组 */
+export type ConfigSchema = Record<string, SchemaField | SchemaGroup | SchemaArray>;
+/**
+ * 内置事件表
+ *
+ * 第三方插件可通过 TypeScript declaration merging 扩展：
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface AalisEvents {
+ *     'scheduler:tick': [jobId: string];
+ *   }
+ * }
+ * ```
+ */
+export interface AalisEvents {
+    'service:registered': [name: string, capabilities: 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 之前）。
+     *
+     * ⚠． 插件内部清理副作用（关连接、停计时器、flush 缓冲区等）请用
+     *    `ctx.onDispose(cb)` 而不是订阅任何事件。事件只在 app 全局停机
+     *    时触发一次，**不会**在插件 bounce / unload / updatePluginConfig 等
+     *    增量重载路径上触发——会造成资源泄漏（旧 ws/db 连接未关闭等）。
+     */
+    'app:stopping': [];
+}
+/**
+ * 中间件 next 函数，调用它将控制传递给下一个中间件或默认行为
+ */
+export type MiddlewareNext = () => Promise<void>;
+/**
+ * 中间件函数签名：接收数据和 next，可选择修改数据或中断流程
+ */
+export type MiddlewareFn<T> = (data: T, next: MiddlewareNext) => Promise<void>;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,IAAI,CAAC;IAClB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAInF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAK1B,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,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;;;;;;;OAOG;IACH,cAAc,EAAE,EAAE,CAAC;CACpB;AAID;;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/core.js

@@ -0,0 +1,6 @@
+// ===== 核心机制类型 =====
+export {};
+// 注：指令系统类型（CommandContext / CommandValueType / CommandArgumentDefinition /
+// CommandOptionDefinition / CommandDefinition / SubcommandDefinition / RegisteredCommand）
+// 已迁出到 @aalis/plugin-commands-api（cleanup-6）
+//# sourceMappingURL=core.js.map

package/dist/types/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA,qBAAqB;;AAoJrB,2EAA2E;AAC3E,0FAA0F;AAC1F,6CAA6C"}

package/dist/types/disposable-service.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 服务自清理协议
+ *
+ * 任何接受插件注册项（tools / commands / pages / strategies 等）的服务，
+ * **应当**实现该接口的 `unregisterByPlugin(contextId)`。当某个 Context dispose 时，
+ * core 会遍历所有已注册服务并调用该方法，使服务释放属于该 contextId 的所有注册项。
+ *
+ * core 自身不需要知道每个服务内部的注册结构，只通过这个简单接口与服务沟通。
+ *
+ * @example
+ * class ToolService implements DisposableService {
+ *   private byPlugin = new Map<string, Set<string>>();
+ *   register(tool: Tool, contextId: string) { ... }
+ *   unregisterByPlugin(contextId: string) {
+ *     for (const name of this.byPlugin.get(contextId) ?? []) {
+ *       this.tools.delete(name);
+ *     }
+ *     this.byPlugin.delete(contextId);
+ *   }
+ * }
+ */
+export interface DisposableService {
+    /**
+     * 清理由指定 contextId 注册到本服务的所有副作用。
+     *
+     * 在 Context.dispose() 时由 core 自动调用。
+     * 失败应当抛错（core 会记录 warn 日志但不中断 dispose 链）。
+     */
+    unregisterByPlugin(contextId: string): void;
+}
+//# sourceMappingURL=disposable-service.d.ts.map

package/dist/types/disposable-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable-service.d.ts","sourceRoot":"","sources":["../../src/types/disposable-service.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C"}

package/dist/types/disposable-service.js

@@ -0,0 +1,3 @@
+// ----- 服务自清理协议 -----
+export {};
+//# sourceMappingURL=disposable-service.js.map

package/dist/types/disposable-service.js.map

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

package/dist/types/embedding.d.ts

@@ -0,0 +1,7 @@
+export interface EmbeddingService {
+    /** 将文本转为向量 */
+    embed(text: string): Promise<number[]>;
+    /** 列出远端可用模型（用于前端下拉框）*/
+    listModels?(): Promise<string[]>;
+}
+//# sourceMappingURL=embedding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/types/embedding.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,uBAAuB;IACvB,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAClC"}

package/dist/types/embedding.js

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

package/dist/types/embedding.js.map

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

package/dist/types/flow-control.d.ts

@@ -0,0 +1,51 @@
+/** 单会话的流控状态快照（只读视图，便于 trigger-policy 计算） */
+export interface FlowSessionStateSnapshot {
+    messageCount: number;
+    activityScore: number;
+    lastReplyTime: number;
+    lastMessageTime: number;
+    cooldownUntil: number;
+    mutedUntil: number;
+    idleBackoff: number;
+    /** 当前限速窗口内已使用的回复槽 */
+    rateLimitUsed: number;
+    /** 限速窗口最大可回复次数（0 表示未启用限速） */
+    rateLimitMax: number;
+    /** 间隔触发使用的固定间隔阈值（供 trigger-policy 复用同一参数） */
+    fixedInterval: number;
+    /** 用户交互次数表（userId → count） */
+    userInteractions: ReadonlyMap<string, {
+        count: number;
+        lastTime: number;
+    }>;
+}
+export interface FlowControlService {
+    /** 获取或创建 session 状态（首次访问会初始化） */
+    ensureState(sessionId: string, platform: string): void;
+    /** 只读快照（trigger-policy 用） */
+    getStateSnapshot(sessionId: string): FlowSessionStateSnapshot | undefined;
+    /** 入站消息累加（messageCount, activityScore, lastMessageTime, userInteractions, 应用衰减） */
+    recordIncoming(sessionId: string, platform: string, userId?: string): void;
+    /** 触发后重置（messageCount=0, activityScore=0, lastReplyTime=now, idleBackoff=1） */
+    recordTriggered(sessionId: string): void;
+    /** 出站消息后处理：设置冷却 + 限速窗口记录 + 重置退避 + 重排 idle 调度 */
+    recordReply(sessionId: string, platform: string): void;
+    /** 当前是否在冷却 */
+    isCoolingDown(sessionId: string): boolean;
+    /** 当前是否在禁言 */
+    isMuted(sessionId: string): boolean;
+    /** 限速检查（返回 true 表示已超限） */
+    isRateLimited(sessionId: string): boolean;
+    /**
+     * 设置自禁言（平台 mute 事件或关键词命中时调用）。
+     * - durationSec > 0：mutedUntil = now + durationSec*1000
+     * - durationSec <= 0：解除禁言（mutedUntil = 0）
+     * 若状态未初始化但提供 platform，会自动创建。
+     */
+    setMuted(sessionId: string, durationSec: number, platform?: string): void;
+    /** 计算当前阈值（动态衰减） */
+    getThreshold(sessionId: string): number;
+    /** 重新调度本会话的 idle trigger（在每次入站后调用） */
+    rescheduleIdle(sessionId: string, platform: string): void;
+}
+//# sourceMappingURL=flow-control.d.ts.map

package/dist/types/flow-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-control.d.ts","sourceRoot":"","sources":["../../src/types/flow-control.ts"],"names":[],"mappings":"AAWA,4CAA4C;AAC5C,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,6BAA6B;IAC7B,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAAC;IAE1E,mFAAmF;IACnF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3E,+EAA+E;IAC/E,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,gDAAgD;IAChD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvD,cAAc;IACd,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,cAAc;IACd,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,0BAA0B;IAC1B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1E,mBAAmB;IACnB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAExC,sCAAsC;IACtC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D"}

package/dist/types/flow-control.js

@@ -0,0 +1,12 @@
+// ----- Flow Control 服务接口 -----
+//
+// FlowControlService 负责管理每会话的"流控状态"：
+//   - 计数器/活跃指数（间隔触发依据）
+//   - 冷却/禁言时段
+//   - 限速窗口（防 DDoS）
+//   - 闲置触发调度
+//
+// 状态由 plugin-flow-control 持有；trigger-policy 通过本服务读取/更新。
+// 平台适配器（如 OneBot）可调用 setMuted() 上报平台层面的禁言事件。
+export {};
+//# sourceMappingURL=flow-control.js.map

package/dist/types/flow-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-control.js","sourceRoot":"","sources":["../../src/types/flow-control.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,qCAAqC;AACrC,uBAAuB;AACvB,cAAc;AACd,mBAAmB;AACnB,aAAa;AACb,EAAE;AACF,wDAAwD;AACxD,6CAA6C"}

package/dist/types/gateway.d.ts

@@ -0,0 +1,24 @@
+import type { IncomingMessage, OutgoingMessage } from './core.js';
+/**
+ * Gateway 服务 —— 消息流编排中枢
+ *
+ * 默认实现由 `@aalis/plugin-gateway` 提供。
+ * 业务层不应再直接 `emit('outbound:message')`，而应调用 `dispatchOutbound()`，
+ * 以便所有出站消息都经过 outbound:dispatch 钩子链（脱敏、限速、审计等）。
+ */
+export interface GatewayService {
+    /**
+     * 主动注入一条入站消息（用于 idle-trigger、webui 直发、内部自检等）。
+     * 与直接 `emit('inbound:message')` 等价 —— 都会走 gateway 入站相位链。
+     */
+    ingressMessage(message: IncomingMessage): Promise<void>;
+    /**
+     * 派发一条出站消息。
+     *
+     * 替代 `ctx.emit('outbound:message', msg)` —— 后者将逐步迁移：
+     *   - 平台适配器仍可监听 `outbound:message` 接收最终发送指令；
+     *   - 发出方应改用本接口，以经过 `outbound:dispatch` 钩子链。
+     */
+    dispatchOutbound(message: OutgoingMessage): Promise<void>;
+}
+//# sourceMappingURL=gateway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/types/gateway.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D"}

package/dist/types/gateway.js

@@ -0,0 +1,15 @@
+// ----- Gateway 服务接口 -----
+//
+// Gateway 是 Aalis 的运行时编排中枢：
+//   - 入站：监听 `inbound:message`，按 INBOUND_PHASE_ORDER 顺序运行
+//           inbound:command → inbound:flow → inbound:trigger → inbound:dispatch
+//           四个命名相位，dispatch 的默认动作是调用 agent.handleMessage。
+//           前三相位任一被 swallow（handler 不调用 next）即停止后续调度。
+//   - 出站：提供 `dispatchOutbound()` 接口，运行 `outbound:dispatch` 钩子链，
+//           默认动作是向 `outbound:message` 事件总线广播，平台插件接收并发送。
+//
+// core 不再绑定具体的路由实现，gateway 服务由 plugin-gateway 提供。
+// 完整发行入口可通过 `requiredServices` 声明 gateway 依赖；最小应用可不加载 gateway，
+// 由 core fallback 入站路由直接派发给 agent。
+export {};
+//# sourceMappingURL=gateway.js.map

package/dist/types/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/types/gateway.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,4BAA4B;AAC5B,yDAAyD;AACzD,gFAAgF;AAChF,0DAA0D;AAC1D,sDAAsD;AACtD,gEAAgE;AAChE,wDAAwD;AACxD,EAAE;AACF,kDAAkD;AAClD,+DAA+D;AAC/D,mCAAmC"}

package/dist/types/hooks.d.ts

@@ -0,0 +1,3 @@
+export interface HookContextMap {
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;CAAG"}

package/dist/types/hooks.js

@@ -0,0 +1,18 @@
+// ----- 钩子/中间件上下文映射 -----
+//
+// 这是一个可扩展的「字符串键 → 上下文类型」映射。core 自身不预声明任何
+// 业务钩子键；具体钩子由各 api 包通过 declaration merging 注入：
+//
+//   - @aalis/plugin-agent-api       → agent:*（含 llm/tool/reply/input/turn）
+//   - @aalis/plugin-gateway-api     → inbound:* / outbound:dispatch（含 InboundPhaseData）
+//   - @aalis/plugin-memory-api      → memory:clear
+//   - @aalis/plugin-session-manager → session:*
+//
+// 第三方插件可继续 augment 自定义钩子：
+//   declare module '@aalis/core' {
+//     interface HookContextMap {
+//       'schedule:before': { jobId: string; cron: string };
+//     }
+//   }
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/types/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,EAAE;AACF,yCAAyC;AACzC,+CAA+C;AAC/C,EAAE;AACF,2EAA2E;AAC3E,wFAAwF;AACxF,mDAAmD;AACnD,gDAAgD;AAChD,EAAE;AACF,0BAA0B;AAC1B,mCAAmC;AACnC,iCAAiC;AACjC,4DAA4D;AAC5D,QAAQ;AACR,MAAM"}

package/dist/types/image-recognition.d.ts

@@ -0,0 +1,123 @@
+import type { IncomingMessage } from './core.js';
+/** 图像识别处理消息的输入 */
+export interface ImageRecognitionInput {
+    /** 文本内容 */
+    content: string;
+    /** 图片列表（URL / data URI / 本地路径） */
+    images: string[];
+    /** 可选：当前消息、引用消息或最近上下文，用于指导图片识别重点 */
+    context?: string;
+    /** 可选：附件出现顺序，用于在 transformedContent 中保留图文混排 */
+    attachmentOrder?: Array<'image' | 'file'>;
+}
+/** 图像识别上下文构造选项 */
+export interface ImageRecognitionContextOptions {
+    /** 最近前文条数，默认由实现决定 */
+    beforeLimit?: number;
+}
+/** 图像识别处理消息的结果 */
+export interface ImageRecognitionResult {
+    /** 原始 content（便于下游比对） */
+    content: string;
+    /** 各图片对应的描述 */
+    imageDescriptions?: string[];
+    /** 处理信息（用于日志/归档） */
+    info: {
+        imageCount: number;
+        successCount: number;
+        descriptions: string[];
+        /** 替换掉图片占位后的文本（如 "[图片: xxx描述]" 形式） */
+        transformedContent: string;
+    };
+}
+/**
+ * 图像识别服务
+ *
+ * 内置能力（`ImageRecognitionCapabilityRegistry`）：
+ * - `describe`: 单张图片描述
+ * - `process-message`: 整条消息批处理（图文混排）
+ * - `build-context`: 为图片识别构造上下文
+ * - `animated`: 支持 GIF/视频帧提取与综合描述
+ *
+ * 第三方可扩展能力：
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface ImageRecognitionCapabilityRegistry {
+ *     Ocr: 'ocr';
+ *     ObjectDetection: 'object_detection';
+ *   }
+ * }
+ * ```
+ */
+export interface ImageRecognitionService {
+    /** 当前是否可用（如 LLM 尚未就绪时为 false） */
+    readonly available: boolean;
+    /**
+     * 当前是否处于「本插件主动识别」模式
+     *
+     * - true：识别后把图片替换为文字描述交给主 Agent
+     * - false：直接把图片原样透传给主 Agent（要求主模型具备 vision 能力）
+     */
+    readonly enabled: boolean;
+    /**
+     * 描述单张图片，返回文字描述。失败/不可用时返回空串。
+     * @param imageUrl 图片 URL 或 data URI
+     * @param localRefPath 可选的本地缓存文件路径（用于动图帧提取等）
+     */
+    describe(imageUrl: string, localRefPath?: string): Promise<string>;
+    /**
+     * 对整条含图消息做批处理：识别所有图片并返回处理结果。
+     * 不可用或 images 为空时返回 null。
+     */
+    processMessage(input: ImageRecognitionInput): Promise<ImageRecognitionResult | null>;
+    /**
+     * 为含图消息构造视觉识别上下文。
+     * 实现应把上下文作为识别线索，而不是覆盖图片事实的强约束。
+     */
+    buildContext?(message: IncomingMessage, options?: ImageRecognitionContextOptions): Promise<string>;
+    /**
+     * 查询已缓存的图片描述（不会触发识别）。未命中返回 null。
+     * 用于引用回复等场景：同一张图片在主消息流程中被识别过后，可以免费复用。
+     */
+    lookupDescription?(imageUrl: string): string | null;
+}
+/**
+ * 图像识别服务能力注册表
+ *
+ * 第三方可通过 declaration merging 追加：
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface ImageRecognitionCapabilityRegistry {
+ *     Ocr: 'ocr';
+ *   }
+ * }
+ * ```
+ */
+export interface ImageRecognitionCapabilityRegistry {
+    /** 单图描述 */
+    Describe: 'describe';
+    /** 批处理整条消息（含图文混排） */
+    ProcessMessage: 'process-message';
+    /** 构造图片识别上下文 */
+    BuildContext: 'build-context';
+    /** 支持动图/视频帧提取 */
+    Animated: 'animated';
+    /** 描述缓存查询 */
+    DescriptionCache: 'description-cache';
+}
+/** 图像识别能力字符串 union（自动包含第三方扩展） */
+export type ImageRecognitionCapability = ImageRecognitionCapabilityRegistry[keyof ImageRecognitionCapabilityRegistry];
+/** 图像识别内置能力常量 */
+export declare const ImageRecognitionCapabilities: {
+    readonly Describe: "describe";
+    readonly ProcessMessage: "process-message";
+    readonly BuildContext: "build-context";
+    readonly Animated: "animated";
+    readonly DescriptionCache: "description-cache";
+};
+declare module './capabilities.js' {
+    interface ServiceCapabilityMap {
+        'image-recognition': ImageRecognitionCapability;
+    }
+}
+//# sourceMappingURL=image-recognition.d.ts.map

package/dist/types/image-recognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-recognition.d.ts","sourceRoot":"","sources":["../../src/types/image-recognition.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;CAC3C;AAED,kBAAkB;AAClB,MAAM,WAAW,8BAA8B;IAC7C,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,kBAAkB;AAClB,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB;IACpB,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,sCAAsC;QACtC,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnE;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAErF;;;OAGG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnG;;;OAGG;IACH,iBAAiB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACrD;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kCAAkC;IACjD,WAAW;IACX,QAAQ,EAAE,UAAU,CAAC;IACrB,qBAAqB;IACrB,cAAc,EAAE,iBAAiB,CAAC;IAClC,gBAAgB;IAChB,YAAY,EAAE,eAAe,CAAC;IAC9B,iBAAiB;IACjB,QAAQ,EAAE,UAAU,CAAC;IACrB,aAAa;IACb,gBAAgB,EAAE,mBAAmB,CAAC;CACvC;AAED,iCAAiC;AACjC,MAAM,MAAM,0BAA0B,GAAG,kCAAkC,CAAC,MAAM,kCAAkC,CAAC,CAAC;AAEtH,iBAAiB;AACjB,eAAO,MAAM,4BAA4B;;;;;;CAMc,CAAC;AAExD,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,oBAAoB;QAC5B,mBAAmB,EAAE,0BAA0B,CAAC;KACjD;CACF"}

package/dist/types/image-recognition.js

@@ -0,0 +1,31 @@
+// ----- 图像识别服务接口 -----
+//
+// 由 plugin-image-recognition 等插件实现。其他插件（如 plugin-message-archive、
+// plugin-memory-summary）通过 `ctx.getService<ImageRecognitionService>('image-recognition')`
+// 消费该服务，无需依赖具体实现。
+//
+// 第三方若要实现替代方案（如调用专用视觉 API），只需满足本接口即可。
+/** 图像识别内置能力常量 */
+export const ImageRecognitionCapabilities = {
+    Describe: 'describe',
+    ProcessMessage: 'process-message',
+    BuildContext: 'build-context',
+    Animated: 'animated',
+    DescriptionCache: 'description-cache',
+};
+// 注册能力↔方法探测器
+import { registerCapabilityProbe } from './capabilities.js';
+registerCapabilityProbe('image-recognition', ImageRecognitionCapabilities.Describe, inst => typeof inst.describe === 'function'
+    ? true
+    : 'ImageRecognitionService.describe() is required for capability "describe"');
+registerCapabilityProbe('image-recognition', ImageRecognitionCapabilities.ProcessMessage, inst => typeof inst.processMessage === 'function'
+    ? true
+    : 'ImageRecognitionService.processMessage() is required for capability "process-message"');
+registerCapabilityProbe('image-recognition', ImageRecognitionCapabilities.BuildContext, inst => typeof inst.buildContext === 'function'
+    ? true
+    : 'ImageRecognitionService.buildContext() is required for capability "build-context"');
+registerCapabilityProbe('image-recognition', ImageRecognitionCapabilities.DescriptionCache, inst => typeof inst.lookupDescription === 'function'
+    ? true
+    : 'ImageRecognitionService.lookupDescription() is required for capability "description-cache"');
+// Animated 为配置/运行时开关，无固定方法签名，不做探测。
+//# sourceMappingURL=image-recognition.js.map

package/dist/types/image-recognition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-recognition.js","sourceRoot":"","sources":["../../src/types/image-recognition.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,kEAAkE;AAClE,0FAA0F;AAC1F,kBAAkB;AAClB,EAAE;AACF,sCAAsC;AA4HtC,iBAAiB;AACjB,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,iBAAiB;IACjC,YAAY,EAAE,eAAe;IAC7B,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,mBAAmB;CACgB,CAAC;AAQxD,aAAa;AACb,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,uBAAuB,CAAC,mBAAmB,EAAE,4BAA4B,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CACzF,OAAQ,IAA+B,CAAC,QAAQ,KAAK,UAAU;IAC7D,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,0EAA0E,CAAC,CAAC;AAElF,uBAAuB,CAAC,mBAAmB,EAAE,4BAA4B,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,CAC/F,OAAQ,IAAqC,CAAC,cAAc,KAAK,UAAU;IACzE,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,uFAAuF,CAAC,CAAC;AAE/F,uBAAuB,CAAC,mBAAmB,EAAE,4BAA4B,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAC7F,OAAQ,IAAmC,CAAC,YAAY,KAAK,UAAU;IACrE,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,mFAAmF,CAAC,CAAC;AAE3F,uBAAuB,CAAC,mBAAmB,EAAE,4BAA4B,CAAC,gBAAgB,EAAE,IAAI,CAAC,EAAE,CACjG,OAAQ,IAAwC,CAAC,iBAAiB,KAAK,UAAU;IAC/E,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,4FAA4F,CAAC,CAAC;AAEpG,mCAAmC"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+export type { AppService, PluginManagerService, PluginStatusEntry } from './app.js';
+export type { CapabilityList, CapabilityOf, CapabilityProbe, ServiceCapabilityMap } from './capabilities.js';
+export { probeCapability, registerCapabilityProbe } from './capabilities.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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAiBA,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEpF,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,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"}

package/dist/types/index.js

@@ -0,0 +1,17 @@
+// ============================================================
+// @aalis/core - types 子模块统一导出
+//
+// 仅包含 core 自身定义的：
+//   - 通用 IoC 数据契约（types/core.ts：Schema / Middleware / Dependency / AalisEvents 等）
+//   - 钩子扩展点（types/hooks.ts，仅空 HookContextMap）
+//   - 服务能力声明框架（types/capabilities.ts）
+//   - App 服务接口（types/app.ts）
+//
+// 业务/领域类型一律由 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 { probeCapability, registerCapabilityProbe } from './capabilities.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +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,sCAAsC;AACtC,6BAA6B;AAC7B,EAAE;AACF,+BAA+B;AAC/B,mEAAmE;AACnE,yEAAyE;AACzE,sFAAsF;AACtF,qEAAqE;AACrE,+DAA+D;AAM/D,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}