@aalis/core 0.1.0

package/dist/types/llm.d.ts

@@ -0,0 +1,146 @@
+import type { Message, ToolDefinition, ToolCall } from './core.js';
+export interface ChatRequest {
+    messages: Message[];
+    tools?: ToolDefinition[];
+    temperature?: number;
+    maxTokens?: number;
+    /** 覆盖模型（不指定则使用服务默认模型） */
+    model?: string;
+    /**
+     * 精确指定 provider（contextId / instanceId，如 `@aalis/plugin-openai`）。
+     *
+     * - 指定时 LLMRouter 直接路由到该 provider，不再依赖 model id 的全局唯一性
+     * - 未指定时 router 退化为"在所有 provider 的 listModels 中查找该 model id"，
+     *   命中多个 / 零个均会抛错
+     * - 这是解决"多个 provider 都声称支持同名 model"歧义的唯一正确手段
+     *
+     * 推荐通过 `parseModelRef("<provider>::<model>")` 从配置/UI 取值。
+     */
+    provider?: string;
+    /** 中止信号，用于取消正在进行的 LLM 调用 */
+    signal?: AbortSignal;
+    /** 是否启用扩展思考。设为 false 可显式关闭提供者默认的 think 模式 */
+    think?: boolean;
+}
+export interface ChatResponse {
+    content: string | null;
+    toolCalls?: ToolCall[];
+    reasoningContent?: string | null;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/** 流式响应的单个 chunk */
+export interface ChatStreamChunk {
+    /** 增量内容片段 */
+    contentDelta?: string;
+    /** 增量思考内容片段 */
+    reasoningDelta?: string;
+    /** 工具调用（仅在流结束时出现） */
+    toolCalls?: ToolCall[];
+    /** 是否结束 */
+    done?: boolean;
+    /** 用量统计（仅在最后一个 chunk 可能包含） */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/** 模型信息（含能力声明）。router 聚合后的条目会携带 provider/contextId 归属。 */
+export interface ModelInfo {
+    id: string;
+    capabilities: LLMCapability[];
+    /** router 聚合时填充（展示用 label 或 instanceId） */
+    provider?: string;
+    /** router 聚合时填充（用于精确定位提供者） */
+    contextId?: string;
+    /**
+     * 模型上下文窗口大小（token）。provider 在 listModels() 中填入该模型的真实窗口，
+     * 调用方（如 memory-summary）可据此为不同模型计算合适的 token 预算。
+     * 未提供时调用方应回退到 LLMService.getContextLength()。
+     */
+    contextLength?: number;
+}
+export interface LLMService {
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    chatStream(request: ChatRequest): AsyncIterable<ChatStreamChunk>;
+    getTemperature(): number;
+    getMaxTokens(): number;
+    /** 模型上下文窗口大小（token 数） */
+    getContextLength(): number;
+    /**
+     * 列出该 provider 推荐展示给用户的模型集合。
+     *
+     * - WebUI 下拉框、各插件 dynamicOptions:'llm' 的候选来源
+     * - 同时也是 LLMRouter 在仅指定 model 不指定 provider 时的定位依据
+     *   （在哪个 provider 的 listModels 里 → 归该 provider）
+     * - 如果 provider 希望支持“任意 model id 直通”（OpenAI 兼容 endpoint 通配），
+     *   用户需显式指定 `request.provider`；Router 不会仅凭 model id 猜测。
+     */
+    listModels?(): Promise<ModelInfo[]>;
+    /**
+     * 提供者自报默认模型 ID。
+     * LLMRouter 在用户未指定 `model` 时可参考此值。
+     */
+    getDefaultModelId?(): string | undefined;
+}
+/**
+ * LLM 服务能力注册表
+ *
+ * 第三方插件可通过 declaration merging 追加新能力：
+ *
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface LLMCapabilityRegistry {
+ *     AudioInput: 'audio_input';
+ *     FimCompletion: 'fim_completion';
+ *   }
+ * }
+ * ```
+ *
+ * 然后在自己的 LLM 服务里：
+ * ```ts
+ * ctx.provide('llm', service, { capabilities: ['chat', 'audio_input'] });
+ * ```
+ */
+export interface LLMCapabilityRegistry {
+    /** 基础对话能力（必备） */
+    Chat: 'chat';
+    /** 支持工具调用 / function calling */
+    ToolCalling: 'tool_calling';
+    /** 支持流式输出 */
+    Streaming: 'streaming';
+    /** 支持图像输入（多模态） */
+    Vision: 'vision';
+    /** 支持扩展思考 / reasoning */
+    Thinking: 'thinking';
+    /** 路由器 facade（按 model id 查找提供者，不提供 chat） */
+    Router: 'router';
+}
+/** LLM 能力字符串 union（自动包含第三方扩展） */
+export type LLMCapability = LLMCapabilityRegistry[keyof LLMCapabilityRegistry];
+/**
+ * LLM 内置能力常量
+ *
+ * 用于注册时引用，避免 magic string 拼写错误：
+ * ```ts
+ * ctx.provide('llm', service, { capabilities: [LLMCapabilities.Chat, LLMCapabilities.Streaming] });
+ * ```
+ */
+export declare const LLMCapabilities: {
+    readonly Chat: "chat";
+    readonly ToolCalling: "tool_calling";
+    readonly Streaming: "streaming";
+    readonly Vision: "vision";
+    readonly Thinking: "thinking";
+    readonly Router: "router";
+};
+declare module './capabilities.js' {
+    interface ServiceCapabilityMap {
+        llm: LLMCapability;
+    }
+}
+//# sourceMappingURL=llm.d.ts.map

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

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

package/dist/types/llm.js

@@ -0,0 +1,27 @@
+// ----- LLM 服务接口 -----
+/**
+ * LLM 内置能力常量
+ *
+ * 用于注册时引用，避免 magic string 拼写错误：
+ * ```ts
+ * ctx.provide('llm', service, { capabilities: [LLMCapabilities.Chat, LLMCapabilities.Streaming] });
+ * ```
+ */
+export const LLMCapabilities = {
+    Chat: 'chat',
+    ToolCalling: 'tool_calling',
+    Streaming: 'streaming',
+    Vision: 'vision',
+    Thinking: 'thinking',
+    Router: 'router',
+};
+// 注册能力↔方法探测器（dev 模式下在 ctx.provide 时校验）
+import { registerCapabilityProbe } from './capabilities.js';
+registerCapabilityProbe('llm', LLMCapabilities.Chat, inst => typeof inst.chat === 'function'
+    ? true
+    : 'LLMService.chat() is required for capability "chat"');
+registerCapabilityProbe('llm', LLMCapabilities.Streaming, inst => typeof inst.chatStream === 'function'
+    ? true
+    : 'LLMService.chatStream() is required for capability "streaming"');
+// ToolCalling / Vision / Thinking 为参数层能力，由调用方按请求传参判定，不做方法探测。
+//# sourceMappingURL=llm.js.map

package/dist/types/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/types/llm.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAwIvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;CACwB,CAAC;AAS3C,uCAAuC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,uBAAuB,CAAC,KAAK,EAAE,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAC1D,OAAQ,IAA2B,CAAC,IAAI,KAAK,UAAU;IACrD,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,qDAAqD,CAAC,CAAC;AAE7D,uBAAuB,CAAC,KAAK,EAAE,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAC/D,OAAQ,IAAiC,CAAC,UAAU,KAAK,UAAU;IACjE,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,gEAAgE,CAAC,CAAC;AAExE,6DAA6D"}

package/dist/types/memory.d.ts

@@ -0,0 +1,62 @@
+import type { Message } from './core.js';
+export interface MemoryService {
+    saveMessage(sessionId: string, message: Message): Promise<void>;
+    getHistory(sessionId: string, limit?: number): Promise<Message[]>;
+    clearSession(sessionId: string): Promise<void>;
+    /** 清空所有会话的所有消息和归档 */
+    clearAll?(): Promise<void>;
+    /** 归档旧消息，仅保留最近 keepRecent 条为活跃状态，返回被归档的条数 */
+    trimHistory?(sessionId: string, keepRecent: number): Promise<number>;
+    /** 获取完整历史（含已归档消息），用于 UI 展示 */
+    getFullHistory?(sessionId: string, limit?: number): Promise<Message[]>;
+    /** 范围查询：取指定会话内 [fromTs, toTs] 区间的消息（按时间升序，可按 role 过滤） */
+    getMessagesBySessionRange?(sessionId: string, fromTs: number, toTs: number, roles?: Array<Message['role']>): Promise<Message[]>;
+    /** 保存结构化元数据（namespace 隔离，key 唯一） */
+    saveMetadata?(namespace: string, key: string, data: Record<string, unknown>): Promise<void>;
+    /** 读取元数据 */
+    getMetadata?(namespace: string, key: string): Promise<Record<string, unknown> | undefined>;
+    /** 列出指定 namespace 下所有元数据条目 */
+    listMetadata?(namespace: string): Promise<Array<{
+        key: string;
+        data: Record<string, unknown>;
+    }>>;
+    /** 删除元数据条目 */
+    deleteMetadata?(namespace: string, key: string): Promise<void>;
+    /** 在指定会话的最近 N 条消息中，将 content 里的 oldText 替换为 newText，返回受影响的条数 */
+    updateMessageContent?(sessionId: string, oldText: string, newText: string, recentLimit?: number): Promise<number>;
+    /** 按时间戳批量删除指定会话的消息（用于回滚整轮对话），返回实际删除条数 */
+    deleteMessagesByTimestamps?(sessionId: string, timestamps: number[]): Promise<number>;
+}
+/**
+ * 记忆服务能力注册表
+ *
+ * 第三方可扩展：
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface MemoryCapabilityRegistry { Persistent: 'persistent'; Encrypted: 'encrypted'; }
+ * }
+ * ```
+ */
+export interface MemoryCapabilityRegistry {
+    /** 基础的消息历史保存/读取 */
+    History: 'history';
+    /** 支持结构化元数据存储（saveMetadata 等） */
+    Metadata: 'metadata';
+    /** 支持消息内容更新（updateMessageContent） */
+    ContentUpdate: 'content-update';
+    /** 支持按时间戳批量删除消息（deleteMessagesByTimestamps） */
+    MessageDelete: 'message-delete';
+}
+export type MemoryCapability = MemoryCapabilityRegistry[keyof MemoryCapabilityRegistry];
+export declare const MemoryCapabilities: {
+    readonly History: "history";
+    readonly Metadata: "metadata";
+    readonly ContentUpdate: "content-update";
+    readonly MessageDelete: "message-delete";
+};
+declare module './capabilities.js' {
+    interface ServiceCapabilityMap {
+        memory: MemoryCapability;
+    }
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,qBAAqB;IACrB,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,6CAA6C;IAC7C,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,8BAA8B;IAC9B,cAAc,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAIvE,yDAAyD;IACzD,yBAAyB,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAIhI,oCAAoC;IACpC,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,YAAY;IACZ,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3F,8BAA8B;IAC9B,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IACjG,cAAc;IACd,cAAc,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D,gEAAgE;IAChE,oBAAoB,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElH,yCAAyC;IACzC,0BAA0B,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvF;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,OAAO,EAAE,SAAS,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,UAAU,CAAC;IACrB,qCAAqC;IACrC,aAAa,EAAE,gBAAgB,CAAC;IAChC,+CAA+C;IAC/C,aAAa,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,MAAM,wBAAwB,CAAC,CAAC;AAExF,eAAO,MAAM,kBAAkB;;;;;CAKc,CAAC;AAE9C,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,oBAAoB;QAC5B,MAAM,EAAE,gBAAgB,CAAC;KAC1B;CACF"}

package/dist/types/memory.js

@@ -0,0 +1,22 @@
+// ----- 记忆服务接口 -----
+export const MemoryCapabilities = {
+    History: 'history',
+    Metadata: 'metadata',
+    ContentUpdate: 'content-update',
+    MessageDelete: 'message-delete',
+};
+import { registerCapabilityProbe } from './capabilities.js';
+registerCapabilityProbe('memory', MemoryCapabilities.History, inst => typeof inst.getHistory === 'function'
+    && typeof inst.saveMessage === 'function'
+    ? true
+    : 'MemoryService.saveMessage()/getHistory() are required for capability "history"');
+registerCapabilityProbe('memory', MemoryCapabilities.Metadata, inst => typeof inst.saveMetadata === 'function'
+    ? true
+    : 'MemoryService.saveMetadata() is required for capability "metadata"');
+registerCapabilityProbe('memory', MemoryCapabilities.ContentUpdate, inst => typeof inst.updateMessageContent === 'function'
+    ? true
+    : 'MemoryService.updateMessageContent() is required for capability "content-update"');
+registerCapabilityProbe('memory', MemoryCapabilities.MessageDelete, inst => typeof inst.deleteMessagesByTimestamps === 'function'
+    ? true
+    : 'MemoryService.deleteMessagesByTimestamps() is required for capability "message-delete"');
+//# sourceMappingURL=memory.js.map

package/dist/types/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAAA,qBAAqB;AA+DrB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;CACY,CAAC;AAQ9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CACnE,OAAQ,IAAiC,CAAC,UAAU,KAAK,UAAU;OAC9D,OAAQ,IAAkC,CAAC,WAAW,KAAK,UAAU;IACxE,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,gFAAgF,CAAC,CAAC;AAExF,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CACpE,OAAQ,IAAmC,CAAC,YAAY,KAAK,UAAU;IACrE,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,oEAAoE,CAAC,CAAC;AAE5E,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CACzE,OAAQ,IAA2C,CAAC,oBAAoB,KAAK,UAAU;IACrF,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,kFAAkF,CAAC,CAAC;AAE1F,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CACzE,OAAQ,IAAiD,CAAC,0BAA0B,KAAK,UAAU;IACjG,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,wFAAwF,CAAC,CAAC"}

package/dist/types/persona.d.ts

@@ -0,0 +1,45 @@
+/** 输出格式中单个字段的定义 */
+export interface OutputFormatField {
+    /** 字段用途描述（写入 system prompt 供 LLM 理解） */
+    description: string;
+    /** 字段类型（影响 system prompt 占位符和输出后的类型强制） */
+    type?: 'string' | 'number' | 'boolean';
+    /** 是否为发送给用户的回复字段（有且仅有一个） */
+    reply?: boolean;
+}
+/** 角色卡定义的结构化输出格式 */
+export interface OutputFormat {
+    /** 字段定义表：key = JSON 字段名 */
+    fields: Record<string, OutputFormatField>;
+    /** 回复字段名（自动推断，取 reply: true 的那个 key） */
+    replyField: string;
+}
+/**
+ * 会话级选项，由调用方（如 agent-default）从 SessionConfig 构造后传入。
+ * PersonaService 本身不关心 session-manager，只根据传入的选项调整行为。
+ */
+export interface PersonaSessionOptions {
+    /** 覆盖角色卡名称 */
+    persona?: string;
+    /** 禁用结构化输出格式 */
+    disableOutputFormat?: boolean;
+    /** 客户端渲染 JSON 覆盖 */
+    clientSideJsonRendering?: boolean;
+}
+export interface PersonaService {
+    getSystemPrompt(options?: PersonaSessionOptions): string;
+    getPersonaName(): string;
+    /** 获取角色卡定义的结构化输出格式，无定义时返回 undefined */
+    getOutputFormat?(options?: PersonaSessionOptions): OutputFormat | undefined;
+    /** 该角色卡是否配置为客户端渲染 JSON */
+    isClientSideJsonRendering?(options?: PersonaSessionOptions): boolean;
+    /** 列出可用的人设卡（用于前端下拉框） */
+    listModels?(): Promise<string[]>;
+    /** 获取角色卡定义的昵称列表（用于触发检测） */
+    getNickNames?(): string[];
+    /** 获取角色卡定义的禁言关键词列表 */
+    getMuteKeywords?(): string[];
+    /** 是否启用了时间注入（供其他插件判断是否需要注册时间相关工具） */
+    isTimeInjectionEnabled?(): boolean;
+}
+//# sourceMappingURL=persona.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/types/persona.ts"],"names":[],"mappings":"AAEA,mBAAmB;AACnB,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1C,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB;IACpB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC;IACzD,cAAc,IAAI,MAAM,CAAC;IACzB,uCAAuC;IACvC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,YAAY,GAAG,SAAS,CAAC;IAC5E,0BAA0B;IAC1B,yBAAyB,CAAC,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACrE,wBAAwB;IACxB,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,2BAA2B;IAC3B,YAAY,CAAC,IAAI,MAAM,EAAE,CAAC;IAC1B,sBAAsB;IACtB,eAAe,CAAC,IAAI,MAAM,EAAE,CAAC;IAC7B,qCAAqC;IACrC,sBAAsB,CAAC,IAAI,OAAO,CAAC;CACpC"}

package/dist/types/persona.js

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

package/dist/types/persona.js.map

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

package/dist/types/platform.d.ts

@@ -0,0 +1,126 @@
+/** 单个平台连接的状态 */
+export interface PlatformConnection {
+    /** 连接唯一标识 */
+    id: string;
+    /** 平台名称 (如 'cli', 'webui', 'onebot') */
+    platform: string;
+    /** 机器人自身 ID（仅协议平台使用） */
+    selfId?: string;
+    /** 机器人自身昵称/显示名（仅协议平台使用） */
+    selfNickname?: string;
+    /** 连接状态 */
+    status: 'online' | 'offline' | 'connecting';
+    /** 额外信息 (如 OneBot 的实现名称、版本等) */
+    detail?: Record<string, unknown>;
+}
+/** 平台自身身份（机器人/账号），用于 prompt 注入和历史消息归档 */
+export interface PlatformSelfIdentity {
+    /** 平台名称 (如 'onebot', 'cli', 'webui') */
+    platform: string;
+    /** 平台账号 ID（协议平台通常可用） */
+    selfId?: string;
+    /** 平台账号昵称/显示名 */
+    nickname?: string;
+}
+/**
+ * 平台适配器 —— 每个平台插件实现此接口
+ *
+ * 提供统一的平台抽象，使核心可以查询所有已接入平台的连接状态，
+ * 也使其他插件可以向指定平台发送消息。
+ *
+ * 第三方平台接入只需实现此接口并通过 `ctx.provide('platform', adapter)` 注册即可。
+ */
+export interface PlatformAdapter {
+    /** 适配器显示名称 */
+    adapterName: string;
+    /** 平台标识 (如 'cli', 'webui', 'onebot', 'telegram', 'discord') */
+    platform: string;
+    /**
+     * 平台可能发出的 IncomingMessage.sessionType 枚举。
+     *
+     * 消费者（如 plugin-flow-control / plugin-trigger-policy）可以从中汇总出
+     * 真实可选作用域，避免在 UI 上臆造不存在的选项。
+     *
+     * 未声明表示适配器不区分 sessionType（如 cli / webui 都是单会话）。
+     */
+    sessionTypes?: readonly string[];
+    /** 获取当前所有连接 */
+    getConnections(): PlatformConnection[];
+    /** 向指定 sessionId 发送纯文本消息 */
+    sendMessage(sessionId: string, content: string, options?: {
+        skipSplit?: boolean;
+    }): Promise<void>;
+    /**
+     * 判断该 adapter 是否能处理给定 sessionId（**路由用**）。
+     *
+     * - PlatformRouter 按 sessionId 路由时枚举所有 adapter 调此方法定位归属
+     * - 未实现时 router 默认 fallback 为 `sessionId.startsWith(this.platform + ':')`
+     *   —— 适合 sessionId 形如 `<platform>:<...>` 的协议平台（如 onebot）
+     * - sessionId 不携带 platform 前缀的 adapter（如 cli 的自定义 sessionId）
+     *   **必须**显式实现此方法
+     *
+     * 与 LLMService.supportsModel 的设计意图对称：每个 provider 自报"我接不接这个 key"，
+     * router 不假设 key 的格式约定。
+     */
+    canHandle?(sessionId: string): boolean | Promise<boolean>;
+    /** 获取当前平台账号自身身份；多连接平台可用 sessionId 定位具体连接 */
+    getSelfIdentity?(sessionId?: string): PlatformSelfIdentity | undefined;
+    /**
+     * 适配器是否至少有一个可用连接
+     * 默认实现：检查 getConnections() 中是否有 status === 'online'
+     */
+    isReady?(): boolean;
+    /**
+     * 调用平台原生 API（可选，由具体适配器实现）
+     *
+     * 例如 OneBot 适配器通过此接口调用 set_group_ban 等 Action。
+     * @param sessionId 用于定位连接的 sessionId
+     * @param action    API 名称
+     * @param params    API 参数
+     */
+    callAction?(sessionId: string, action: string, params: Record<string, unknown>): Promise<unknown>;
+}
+import type { PluginGroupInfo } from './core.js';
+/**
+ * 平台聚合服务 —— 同名 facade，对外暴露为 `'platform'`
+ *
+ * 与 storage-router / llm-router 同模式：以 `capability:['router']`
+ * 注册到 `'platform'` 服务名下，consumer 通过 `ctx.getService('platform')`
+ * 拿到聚合层；如需访问具体某个 adapter，可用
+ * `ctx.getService<PlatformAdapter>('platform', ['<platform-name>'])`。
+ *
+ * 默认由 plugin-platform 提供。
+ */
+export interface PlatformService {
+    /** 获取平台子系统的插件分组（基于 provides ∩ inject 自动计算） */
+    getPluginGroups(): PluginGroupInfo[];
+    /** 获取所有平台的聚合连接列表 */
+    getConnections(): PlatformConnection[];
+    /** 获取所有已注册的平台名称 */
+    getPlatformNames(): string[];
+    /** 获取所有合规的平台适配器实例（不含 router 自身） */
+    getAdapters(): PlatformAdapter[];
+    /** 获取所有平台适配器及其连接详情 */
+    getDetails(): Array<{
+        adapterName: string;
+        platform: string;
+        contextId: string;
+        capabilities: string[];
+        connections: PlatformConnection[];
+    }>;
+    /** 获取指定平台在当前会话中的自身身份 */
+    getSelfIdentity?(platform: string, sessionId?: string): PlatformSelfIdentity | undefined;
+}
+export interface PlatformCapabilityRegistry {
+    Router: 'router';
+}
+export type PlatformCapability = PlatformCapabilityRegistry[keyof PlatformCapabilityRegistry];
+export declare const PlatformCapabilities: {
+    readonly Router: "router";
+};
+declare module './capabilities.js' {
+    interface ServiceCapabilityMap {
+        platform: PlatformCapability | string;
+    }
+}
+//# sourceMappingURL=platform.d.ts.map

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

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

package/dist/types/platform.js

@@ -0,0 +1,5 @@
+// ----- 平台适配器接口 -----
+export const PlatformCapabilities = {
+    Router: 'router',
+};
+//# sourceMappingURL=platform.js.map

package/dist/types/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAAA,sBAAsB;AAgItB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,QAAQ;CAC6B,CAAC"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,84 @@
+import type { Context } from '../context.js';
+import type { ConfigSchema, InjectDeclaration } from './core.js';
+import type { NormalizedDependency } from './service.js';
+export interface PluginModule {
+    name: string;
+    /** 插件的显示名称，用于前端展示 */
+    displayName?: string;
+    inject?: InjectDeclaration;
+    provides?: string[];
+    /** 标记为 core 的插件不能被用户禁用 */
+    core?: boolean;
+    /**
+     * 是否允许同一插件以不同配置多次加载（多实例）
+     *
+     * 默认 false：同一 module 只能注册一次（防止重复注册命令等副作用）。
+     * 设为 true 后，可通过 `name:suffix` 格式注册多个实例，
+     * 每个实例拥有独立的 Context、配置和 contextId。
+     *
+     * 适合多实例的插件：LLM adapters、embedding adapters、platform adapters、memory backends。
+     */
+    reusable?: boolean;
+    /** 配置 Schema，用于前端自动生成配置表单 */
+    configSchema?: ConfigSchema;
+    /** 插件默认配置，当主配置文件中无此插件配置时使用 */
+    defaultConfig?: Record<string, unknown>;
+    /**
+     * 逃生舱：声明本插件在依赖的 provider 发生变化（被 dispose / 替换）时
+     * 必须由 core 主动级联 dispose + reapply 才能恢复正确状态。
+     *
+     * 默认 `false`：core **不会**主动级联 bounce 下游。绝大多数插件应让
+     * `ctx.getService(...)` 在 handler/方法体内每次惰性查询，从而天然跟随
+     * provider 切换，无需 bounce。
+     *
+     * 仅当插件无法响应式处理状态（如必须在启动期一次性把 provider 引用
+     * 缓存到第三方 SDK 内部、或必须在 apply 时跑昂贵的同步初始化）时设为
+     * `true`。第三方插件开发者迁移成本太高时也可以临时打开。
+     */
+    requiresBounceOnDepChange?: boolean;
+    apply(ctx: Context, config: Record<string, unknown>): void | Promise<void>;
+}
+export type PluginState = 'pending' | 'activating' | 'active' | 'disabled' | 'disposed' | 'error';
+/**
+ * recompute() 的触发原因。所有导致插件库状态需重新计算的事件
+ * 都收拢到这个判别联合上，让 PluginManager 只有一条状态转移路径。
+ *
+ * - service-up：某服务刚被 provide —— 可能让 pending 插件能激活
+ * - service-down：某服务刚被 unregister —— required 依赖其的要停用，
+ *   optional 依赖其的要 bounce（重新 apply 以对接可能的新实例）
+ * - plugin-state-changed：插件被显式禁用/启用/重载/改配置后调用
+ * - shutdown：App.stop() 调用，按拓扑逆序 dispose 所有插件
+ */
+export type RecomputeReason = {
+    type: 'service-up';
+    service: string;
+} | {
+    type: 'service-down';
+    service: string;
+} | {
+    type: 'plugin-state-changed';
+} | {
+    type: 'shutdown';
+};
+export interface PluginEntry {
+    module: PluginModule;
+    /** 实例 ID：单实例时与 module.name 相同，多实例时为 `name:suffix` */
+    instanceId: string;
+    config: Record<string, unknown>;
+    state: PluginState;
+    error?: string;
+    context?: Context;
+    requiredDeps: NormalizedDependency[];
+    optionalDeps: NormalizedDependency[];
+}
+/**
+ * 解析插件实例 ID
+ *
+ * 格式：`@scope/plugin-name:suffix` → { moduleName: '@scope/plugin-name', suffix: 'suffix' }
+ * 无 suffix 时返回 { moduleName, suffix: undefined }
+ */
+export declare function parseInstanceId(instanceId: string): {
+    moduleName: string;
+    suffix?: string;
+};
+//# sourceMappingURL=plugin.d.ts.map

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

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

package/dist/types/plugin.js

@@ -0,0 +1,24 @@
+// ----- 插件系统类型与纯辅助函数 -----
+//
+// 与运行时实现 (PluginManager) 分离，避免下游消费者只为类型而拉入 class。
+// 实现详见 ../plugin.ts。
+/**
+ * 解析插件实例 ID
+ *
+ * 格式：`@scope/plugin-name:suffix` → { moduleName: '@scope/plugin-name', suffix: 'suffix' }
+ * 无 suffix 时返回 { moduleName, suffix: undefined }
+ */
+export function parseInstanceId(instanceId) {
+    // 从右侧找最后一个冒号，但跳过 scope 中的冒号
+    // 格式: @scope/name:suffix 或 name:suffix
+    const slashIdx = instanceId.indexOf('/');
+    const searchFrom = slashIdx >= 0 ? slashIdx + 1 : 0;
+    const colonIdx = instanceId.indexOf(':', searchFrom);
+    if (colonIdx < 0)
+        return { moduleName: instanceId };
+    return {
+        moduleName: instanceId.slice(0, colonIdx),
+        suffix: instanceId.slice(colonIdx + 1),
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/types/plugin.js.map

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

package/dist/types/service.d.ts

@@ -0,0 +1,43 @@
+import type { DependencyDeclaration } from './core.js';
+/**
+ * 服务优先级约定（数字越大越优先）
+ *
+ * 用于 `ctx.provide(name, instance, { priority })`。
+ * 同优先级时，先注册的胜出（稳定降序排序）。
+ *
+ * 设计目的：把『谁是默认胜者』变成静态、可预测的契约，
+ * 替代旧版 preferService 那种「需要用户手动激活」的运行时偏好。
+ *
+ * 推荐用法：
+ * - `Backend = 0`：普通后端实现（如 plugin-openai / plugin-deepseek）。
+ * - `Override = 50`：用户级覆盖；同名服务希望默认胜过普通后端时使用。
+ * - `System = 200`：保留给核心系统级覆盖。
+ *
+ * 注：feat/service-granularity 之后已不再有 router/facade 层级——LLM / storage / platform
+ * 均改为按 model / root / sessionId 直接注册多 entry，跨 entry 的聚合与路由由各自
+ * `*-api` 的 helper 函数承担（`createStorageGateway` / `resolvePlatformBySession` / ...），
+ * 没有同名 facade entry，因此曾经的 `Router = 100` 槽位整体废弃。
+ */
+export declare const ServicePriority: {
+    readonly Backend: 0;
+    readonly Override: 50;
+    readonly System: 200;
+};
+export type ServicePriorityValue = (typeof ServicePriority)[keyof typeof ServicePriority];
+export interface ServiceEntry {
+    instance: unknown;
+    capabilities: Set<string>;
+    priority: number;
+    contextId: string;
+    /** 可选的展示标签（如 "OpenAI / gpt-4o"） */
+    label?: string;
+}
+export interface NormalizedDependency {
+    service: string;
+    capabilities: string[];
+}
+/**
+ * 将 string | ServiceDependency 统一为 NormalizedDependency
+ */
+export declare function normalizeDependency(dep: DependencyDeclaration): NormalizedDependency;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/types/service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAE1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,GAAG,oBAAoB,CAKpF"}