mioku 1.0.7 → 1.0.9

package/dist/index.d.cts

@@ -156,12 +156,6 @@ interface ButtonOptions {
   /** 客户端版本过低时的提示文案 */
   unsupportedTips?: string;
 }
-/** 会话引用：用于定位一段会话（含父会话） */
-interface ConversationRef {
-  readonly type: string;
-  readonly id: string;
-  readonly parent_id?: string;
-}
 declare class MessageSegmentImpl implements MessageSegment {
   readonly type: string;
   readonly data: Readonly<Record<string, unknown>>;
@@ -449,7 +443,6 @@ interface MessageEvent extends BotEventBase {
   readonly sender?: SenderInfo;
   readonly group?: Group;
   readonly friend?: Friend;
-  readonly conversation?: ConversationRef;
   readonly message: Message;
   readonly is_to_me?: boolean;
   readonly at?: string;
@@ -893,11 +886,8 @@ type ServiceFactory<T> = () => T;
 //# sourceMappingURL=registry.d.ts.map
 //#endregion
 //#region src/types.d.ts
-/** 框架服务的最小形态：init 负责初始化，api 是对外暴露的接口对象 */
 interface MiokuService {
   name: string;
-  version: string;
-  description?: string;
   init(): Promise<void>;
   api: Record<string, any>;
   dispose?(): Promise<void>;
@@ -956,9 +946,9 @@ interface PluginHelp {
 type CommandRole = "master" | "admin" | "owner" | "member";
 /**
  * - `"master"`：仅 bot 主人可触发
- * - `"owner"`：legacy alias
- * - `"admin"`：bot 主人或管理员
- * - `"member"`：群内任意成员
+ * - `"owner"`：bot 主人或当前群群主
+ * - `"admin"`：bot 主人、配置管理员、当前群群主或群管理员
+ * - `"member"`：所有人
  *
  */
 type SkillPermissionRole = "master" | "owner" | "admin" | "member";
@@ -1491,6 +1481,21 @@ declare const noticeOwners: (bots: readonly Bot[], owners: readonly string[], me
 declare const noticeAdmins: (bots: readonly Bot[], admins: readonly string[], message: MessageInput, options?: NoticeOptions) => Promise<void>;
 //# sourceMappingURL=actions.d.ts.map
 //#endregion
+//#region src/runtime/permissions.d.ts
+/** 从事件对象中提取发送者 id（支持裸 id / user_id / sender.user_id） */
+declare const toUserId: (value: unknown) => string | undefined;
+/** 当前群群主（仅限所在群） */
+declare const isEventGroupOwner: (event: unknown) => boolean;
+/** 当前群群主或群管理员（仅限所在群） */
+declare const isEventGroupAdmin: (event: unknown) => boolean;
+/** 仅看 owners 名单：bot 主人（无群身份加成） */
+
+/** 仅看 admins 名单：配置管理员 */
+declare const isEventAdminConfigOnly: (event: unknown) => boolean;
+/**
+ * master 或当前群群主
+ */
+//#endregion
 //#region src/utils.d.ts
 declare const ChromeUA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/131.0.0.0";
 type Noop = () => void;
@@ -1592,7 +1597,7 @@ interface MiokuConfig {
   status_permission?: "all" | "admin-only";
   /** 去重选项 */
   dedup?: {
-    /** 跨适配器指纹去重 */
+    /** 跨适配器事件关联去重 */
     cross_adapter?: boolean;
   };
   adapters?: Record<string, unknown>;
@@ -1656,6 +1661,7 @@ interface BusStats {
   readonly registered: number;
   readonly dispatched: number;
 }
+type RegistrationFilter = (registration: Registration, event: Event) => boolean;
 /**
  * 事件总线：按路由把事件分发给所有匹配的监听器。
  * 支持 `*` 通配符，同一优先级按注册顺序执行，不同优先级按数值升序。
@@ -1663,6 +1669,7 @@ interface BusStats {
 declare class EventBus {
   #private;
   setLogger(logger: ((level: 'error' | 'warn' | 'info', message: string, detail?: unknown) => void) | null): void;
+  setFilter(filter: RegistrationFilter | null): void;
   /** 注册事件监听，返回取消注册函数 */
   register<E extends Event = Event>(route: string, handler: EventHandler<E>, options?: {
     source?: string;
@@ -1685,12 +1692,149 @@ declare class BotRegistry {
   unregister(bot_id: string, adapter: string): boolean;
   /** 按 bot_id 取 bot（只按 id 匹配，不限适配器） */
   pick<T extends Bot = Bot>(bot_id: string | number): T | undefined;
+  find<T extends Bot = Bot>(adapter: string, bot_id: string): T | undefined;
   all<T extends Bot = Bot>(): readonly T[];
   size(): number;
   clear(): void;
 }
 //# sourceMappingURL=bots.d.ts.map
-
+//#endregion
+//#region src/runtime/event-correlator.d.ts
+/** 一个参与投递这条事件的 (适配器, bot) 组合 */
+interface CorrelationParticipant {
+  readonly adapter: string;
+  readonly botId?: string;
+  readonly eventType: string;
+  readonly messageId?: string;
+}
+/** 同一条逻辑事件被多个适配器/bot 投递时的关联记录 */
+interface CorrelationRecord {
+  readonly key: string;
+  /** 首个到达的参与方 */
+  readonly primary: CorrelationParticipant;
+  /** 观察到这条事件的全部参与方，首个即 primary */
+  readonly participants: readonly CorrelationParticipant[];
+  readonly firstSeenAt: number;
+  readonly expiresAt: number;
+}
+/** 单个事件在关联组里的位置 */
+interface EventObservation {
+  readonly record: CorrelationRecord;
+  /** 是否为该关联组首个到达的事件 */
+  readonly primary: boolean;
+  /** 是否为关联组内后续到达的重复投递 */
+  readonly duplicate: boolean;
+}
+interface CorrelationStats {
+  /** 当前保留的关联组数量 */
+  readonly groups: number;
+  /** 累计观察的事件数 */
+  readonly observed: number;
+  /** 累计判定的重复投递数 */
+  readonly duplicates: number;
+  /** 累计因超限被淘汰的关联组数 */
+  readonly evicted: number;
+}
+/**
+ * 跨适配器事件关联器
+ */
+declare class EventCorrelator {
+  #private;
+  constructor(options?: {
+    logger?: Logger;
+    maxSize?: number;
+  });
+  /** 观察一个事件，登记它所属的关联组并返回其定位（同一事件只登记一次） */
+  observe(event: Event): EventObservation | null;
+  /** 读取某事件此前登记的关联定位（未登记或已过期时返回 undefined） */
+  observationOf(event: Event): EventObservation | undefined;
+  /** 该事件是否属于关联组里后续到达的重复投递（未登记时会先登记） */
+  isDuplicate(event: Event): boolean;
+  stats(): CorrelationStats;
+  clear(): void;
+}
+//# sourceMappingURL=event-correlator.d.ts.map
+//#endregion
+//#region src/runtime/commands.d.ts
+type CommandMatcher = string | RegExp;
+interface CommandExecutionContext {
+  readonly ctx: MiokuContext;
+  readonly event: MessageEvent;
+  readonly command: RegisteredCommand;
+  readonly text: string;
+  readonly body: string;
+  readonly args: readonly string[];
+  readonly match?: RegExpMatchArray;
+}
+type CommandHandler = (context: CommandExecutionContext) => void | Promise<void>;
+interface CommandDefinition {
+  readonly id?: string;
+  readonly name: string;
+  readonly aliases?: readonly string[];
+  readonly match?: CommandMatcher;
+  readonly description?: string;
+  readonly usage?: string;
+  readonly permission?: CommandRole;
+  readonly priority?: number;
+  readonly prefixes?: string | readonly string[] | false;
+  readonly handler: CommandHandler;
+}
+interface CommandShortcutOptions extends Omit<CommandDefinition, "name" | "match" | "handler"> {
+  readonly id?: string;
+  readonly name?: string;
+}
+interface RegisteredCommand {
+  readonly plugin: string;
+  readonly id: string;
+  readonly name: string;
+  readonly aliases: readonly string[];
+  readonly matcher: CommandMatcher;
+  readonly description: string;
+  readonly usage?: string;
+  readonly permission: CommandRole;
+  readonly priority: number;
+  readonly prefixes?: string | readonly string[] | false;
+  readonly handler: CommandHandler;
+  readonly order: number;
+}
+interface CommandCatalogItem {
+  readonly kind: "plugin" | "command";
+  readonly plugin: string;
+  readonly id: string;
+  readonly label: string;
+  readonly desc?: string;
+  readonly usage?: string;
+  readonly permission?: CommandRole;
+  readonly priority?: number;
+  readonly match?: string;
+  readonly event?: string;
+  readonly source: "runtime" | "manifest";
+}
+declare class CommandManager {
+  #private;
+  constructor(options: {
+    getDefaultPrefix: () => string;
+    getOwners: () => readonly string[];
+    getAdmins: () => readonly string[];
+    logger?: {
+      error(message: string, detail?: unknown): void;
+    };
+  });
+  register(plugin: string, definition: CommandDefinition, context: MiokuContext): () => void;
+  register(plugin: string, matcher: CommandMatcher, handler: CommandHandler, options?: CommandShortcutOptions, context?: MiokuContext): () => void;
+  setAccessControl(config: AccessControlConfig | undefined): void;
+  syncMetadata(metadata: PluginMetadata): void;
+  removePlugin(plugin: string): void;
+  clear(): void;
+  list(): readonly RegisteredCommand[];
+  getPluginHelp(plugin: string): PluginHelp | undefined;
+  catalog(): CommandCatalogItem[];
+  dispatch(event: MessageEvent): Promise<boolean>;
+  shouldDispatch(source: string, event: Event): boolean;
+}
+declare const setActiveCommandManager: (manager: CommandManager | undefined) => void;
+declare const getActiveCommandManager: () => CommandManager | undefined;
+//# sourceMappingURL=commands.d.ts.map
 //#endregion
 //#region src/runtime/mioku-context.d.ts
 /** 插件管理器：插件列表查询与运行时启停 */
@@ -1707,7 +1851,9 @@ interface PluginManager {
 }
 interface ContextOptions {
   readonly pluginName: string;
+  readonly pluginId: string;
   readonly bus: EventBus;
+  readonly commands: CommandManager;
   readonly bots: BotRegistry;
   readonly driver: Driver;
   readonly capabilities: CapabilityRegistry;
@@ -1718,11 +1864,20 @@ interface ContextOptions {
   readonly listAdapters: () => readonly Adapter[];
   readonly onUpdateConfig: (updater: (config: MiokuConfig) => void | Promise<void>) => Promise<void>;
   readonly pluginManager: PluginManager;
-  readonly dedup?: boolean;
+  /** runtime 级事件关联器；缺省时不做跨适配器去重 */
+  readonly correlator?: EventCorrelator;
 }
 /** 从事件对象中提取发送者 id（支持裸 id / user_id / sender.user_id） */
-declare const toUserId: (value: unknown) => string | undefined;
+
+/** 仅看 owners 名单：bot 主人（无群身份加成） */
+declare const isEventMaster: (event: unknown) => boolean;
+/**
+ * master 或当前群群主。等价于 `ctx.command({ permission: "owner" })` 的判断。
+ */
 declare const isEventOwner: (event: unknown) => boolean;
+/**
+ * master、配置管理员、当前群群主或群管理员。等价于 `ctx.command({ permission: "admin" })` 的判断。
+ */
 declare const isEventAdmin: (event: unknown) => boolean;
 declare const isEventOwnerOrAdmin: (event: unknown) => boolean;
 declare const hasEventRight: (event: unknown) => boolean;
@@ -1794,6 +1949,7 @@ declare class MiokuContext {
   #private;
   constructor(options: ContextOptions);
   get pluginName(): string;
+  get pluginId(): string;
   /** 第一个已连接的 bot（多数单 bot 场景直接用这个） */
   get bot(): Bot | undefined;
   /** 所有已连接的 bot */
@@ -1801,6 +1957,26 @@ declare class MiokuContext {
   get self_id(): string | undefined;
   /** 按 bot_id 取指定 bot */
   pickBot<T extends Bot = Bot>(bot_id: string | number): T | undefined;
+  /**
+   * 取事件所属的跨适配器关联记录。
+   * 同一条逻辑消息被多个适配器/bot 投递时，可从这里读到全部参与方。
+   */
+  correlation(event: Event): CorrelationRecord | undefined;
+  /**
+   * 观察到该事件的全部已连接 bot（首个即 primary）。
+   * 跨适配器去重后，被标记为重复的投递不会进入普通 handler，
+   * 但这里依然能看到全部参与方。
+   */
+  botsForEvent(event: Event): Bot[];
+  /** 事件里被 @ 到的、且本运行时已连接的 bot */
+  mentionedBots(event: Event): Bot[];
+  /**
+   * 这条消息应当由哪个 bot 回应：优先「被 @ 的 bot」，其次是关联组里首个到达的 bot。
+   * 插件可用它替代隐式的 `event.bot`，从而不受适配器到达顺序影响。
+   */
+  pickReplyBot(event: Event): Bot | undefined;
+  /** 事件关联/去重的运行统计 */
+  correlationStats(): CorrelationStats | undefined;
   /**
    * 获取事件引用回复的消息内容。
    * 返回 null 表示没有引用、拿不到对应 bot 或消息已失效。
@@ -1819,6 +1995,9 @@ declare class MiokuContext {
    * `onebotv11:message`；返回取消监听函数。
    */
   handle<R extends string | readonly string[]>(route: R, handler: (event: RouteEvent<R>) => void | Promise<void>): () => void;
+  /** 注册消息命令；默认自动匹配框架前缀并在命中后消费消息 */
+  command(definition: CommandDefinition): () => void;
+  command(matcher: CommandMatcher, handler: CommandHandler, options?: CommandShortcutOptions): () => void;
   /** 注册 cron 定时任务，插件卸载时自动停止 */
   cron(expression: string, handler: CronHandler): ScheduledTask;
   /** 监听 bot 连接 / 断开 */
@@ -1837,6 +2016,8 @@ declare class MiokuContext {
   addService<T = unknown>(name: string, value: T, cover?: boolean): () => void;
   get capabilities(): CapabilityRegistry;
   get buses(): EventBus;
+  /** 当前运行时的命令管理器 */
+  get commands(): CommandManager;
   get segment(): typeof segment;
   /** 按模式匹配消息文本（支持正则/字符串/关键词数组） */
   match<T extends HasMessage>(event: T, pattern: Parameters<typeof match>[1], quote?: boolean): ReturnType<typeof match>;
@@ -1868,15 +2049,20 @@ declare class MiokuContext {
   noticeAdmins(message: MessageInput, options?: NoticeOptions): Promise<void>;
   isGroupMsg(event: unknown): boolean;
   isPrivateMsg(event: unknown): boolean;
-  /** 事件发送者是否为主人 */
+  /** 事件发送者是否为 bot 主人（仅看 owners 名单，不识别群身份） */
+  isMaster(event: unknown): boolean;
+  /** 事件发送者是否为 bot 主人或当前群群主；等价于 `permission: "owner"` */
   isOwner(event: unknown): boolean;
-  /** 事件发送者是否为管理员 */
+  /** 事件发送者是否为 bot 主人、配置管理员、当前群群主或群管理员；等价于 `permission: "admin"` */
   isAdmin(event: unknown): boolean;
+  /** 同 `isAdmin`，保留旧名称 */
   isOwnerOrAdmin(event: unknown): boolean;
+  /** 同 `isAdmin`，别名 */
   hasRight(event: unknown): boolean;
   dispose(): Promise<void>;
 }
 interface MiokuContext extends CtxUtils {}
+//# sourceMappingURL=mioku-context.d.ts.map
 //#endregion
 //#region src/plugin/plugin.d.ts
 /** 插件卸载时执行的清理函数 */
@@ -1887,13 +2073,13 @@ type BotHandler = (event: BotLifecycleEvent) => void | Promise<void>;
 type CronHandler = (ctx: MiokuContext, task: TaskContext) => void | Promise<void>;
 /** 定时任务实例，来自 node-cron */
 type ScheduledTask = node_cron0.ScheduledTask;
-/** 插件定义 */
+/**
+ * 插件定义
+ */
 interface MiokuPlugin {
   name: string;
-  version?: string;
   /** 加载顺序，数值越小越先加载 */
   priority?: number;
-  description?: string;
   /** 依赖的其他插件名 */
   dependencies?: string[];
   /** 插件入口，可返回清理函数供卸载时调用 */
@@ -1925,6 +2111,8 @@ declare class AdapterContextImpl implements AdapterContext {
     capabilities: CapabilityRegistry;
     logger: Logger;
     emit: (event: BotLifecycleEvent) => Promise<void>;
+    correlator?: EventCorrelator;
+    commands: CommandManager;
   });
   registerBot(bot: Bot): BotContext;
   unregisterBot(bot_id: string): void;
@@ -1984,9 +2172,9 @@ interface CreateRuntimeOptions {
   readonly logger: Logger;
   readonly builtinPlugins?: readonly MiokuPlugin[];
   readonly driverFactory?: () => Driver;
-  /** 去重选项；缺省全部开启 */
+  /** 去重选项；缺省开启 */
   readonly dedup?: {
-    /** 跨适配器指纹去重 */
+    /** 跨适配器事件关联去重 */
     readonly crossAdapter?: boolean;
   };
 }
@@ -2003,6 +2191,9 @@ declare class MiokuRuntime {
   get logger(): Logger;
   get driver(): Driver;
   get bus(): EventBus;
+  get commands(): CommandManager;
+  /** 事件关联器（跨适配器去重）；为 undefined 时表示已禁用 */
+  get correlator(): EventCorrelator | undefined;
   get bots(): readonly Bot[];
   get adapters(): readonly Adapter[];
   getAdapter<T extends Adapter = Adapter>(name: string): T | undefined;
@@ -2386,5 +2577,5 @@ declare function start(options?: MiokuStartOptions): Promise<{
 }>;
 declare const version: string;
 //#endregion
-export { type AIInstance, type AIInstanceInfo, type AIModelCapability, type AIModelDescriptor, type AIModelRole, type AIProtocol, type AIProviderConfig, type AIService, type AISkill, type AIThinkingLevel, type AITool, type AIUsageBotOption, type AIUsageBreakdown, type AIUsageContext, type AIUsageFinalization, type AIUsageRange, type AIUsageScope, type AIUsageSummary, AI_GEMINI_THINKING_LEVELS, AI_THINKING_LEVELS, type AccessAction, type AccessControlConfig, type AccessHook, type AccessRuleEntry, type AccessScopeConfig, Adapter, AdapterBotBase, AdapterBotMap, AdapterCandidate, AdapterContext, AdapterContextImpl, AdapterDefinition, AdapterEvent, AdapterFactoryOptions, AdapterGateway, AdapterInstanceStatus, AdapterRegistrationConflictError, AdapterReport, AdapterReportEntry, AdapterResource, AdapterResourceScope, AdapterStartResult, type AdapterStatus, type AdapterStatusStats, AnyFunc, ArchMap, Arrayable, type Attachment, AvatarSetRequest, Awaitable, BOT_CWD, BUILTIN_PLUGINS, Bot, BotAutoFilled, BotBase, BotConfigJson, BotContext, BotEvent, BotEventBase, BotHandler, BotLifecycleEvent, BotProvidedKeys, BotRegistry, BotStatus, BotStatusResult, BuildAdapterReportOptions, BuildStatusOptions, type BuiltinServiceRef, BusStats, ButtonOptions, CORE_PLUGINS, Capability, CapabilityHandler, CapabilityRegistry, CapabilityTarget, type ChatRuntime, type ChatRuntimeBaseOptions, type ChatRuntimeCollectedInfo, type ChatRuntimeGroupTarget, type ChatRuntimeInformationRequestOptions, type ChatRuntimeNoticeOptions, type ChatRuntimePrivateTarget, type ChatRuntimePromptInjection, type ChatRuntimeResult, type ChatRuntimeSource, ChromeUA, type CommandRole, type CompleteOptions, type CompleteResponse, type ConfigService, type ConsolaInstance, ContextOptions, ConversationGetHistoryRequest, type ConversationRef, CreateCmdOptions, CreateDriverOptions, CreateRuntimeOptions, CronHandler, Driver, DriverShutdownError, Event, EventBase, EventBus, EventFactoryOptions, EventHandler, EventIdentity, EventKindOfRoute, type EventMap, ExtendedNapCat, ForwardNode, ForwardSendNode, ForwardSendOptions, ForwardSendRequest, Friend, FriendDeleteRequest, FriendGetInfoRequest, FriendGetListRequest, FriendInfo, Gettable, Group, GroupGetInfoRequest, GroupGetListRequest, GroupGetMembersRequest, GroupInfo, GroupLeaveRequest, GroupSetNameRequest, GroupSetPortraitRequest, GroupSetWholeBanRequest, HasMessage, type HelpService, HistoryMessage, HttpClient, HttpRequestError, HttpRequestOptions, HttpResponse, LifecycleEvent, LifecycleEventMap, LifecycleHandler, LifecycleListener, LoadedAdapterDefinition, LoadedPluginDefinition, type LogLevel, type Logger, MatchHandler, MatchValue, MemberBanRequest, MemberGetInfoRequest, MemberInfo, MemberKickRequest, MemberPokeRequest, MemberSetAdminRequest, MemberSetCardRequest, MemberSetTitleRequest, type Message, MessageEvent, MessageGetForwardRequest, MessageGetRequest, MessageGetResult, type MessageInput, MessageRecallRequest, MessageSegment, MessageSegmentImpl, MessageSendRequest, type MessageTarget, MetaEvent, MiokuConfig, type MiokuContext, MiokuCoreServiceContrib, type MiokuPlugin, MiokuRuntime, type MiokuRuntimeConfig, type MiokuService, MiokuServices, MiokuStartOptions, type MiokuStatus, type MultimodalContentItem, type MultimodalMessage, Noop, NoticeEvent, NoticeOptions, PackageCandidate, PackageJson, type PackageJsonLike, PlatformId, PluginCandidate, PluginCleanup, type PluginHelp, PluginManager, type PluginMetadata, type PluginPackageConfig, type PluginStateRef, ProfileSetRequest, PureObject, Registration, ReplyArg, type ReplyOptions, RequestEvent, RouteEvent, type RunCommandResult, RuntimeAdapterState, RuntimeMiokuConfig, ScheduledTask, type ScreenshotService, SenderInfo, type SentMessage, SerializedMessageSegment, ServiceFactory, ServiceManager, type ServiceMetadata, type ServiceRef, Services, type SessionToolDefinition, type SkillPermissionRole, type SpawnPlan, StartOptions, type StatusProvider, StatusProviderContext, StatusProviderTarget, SystemMap, TOOL_RESULT_FOLLOWUP_KEY, type TextMessage, type ToolCallRecord, type ToolResultFollowup, UnsupportedCapabilityError, WebSocketClient, WebSocketConnectOptions, WebSocketConnectTimeoutError, WebSocketConnection, type WebUIService, addService, applyLogLevel, asMessage, atOf, avatarGet, avatarSet, base64Decode, base64Encode, bindCapabilities, botConfig, botStatus, box, buildAdapterReport, buildMiokuStatus, buildRoutes, buildSpawnPlan, clamp, collectBotStats, colorize, colors, commandExists, connectedBotKey, connectedBots, conversationGetHistory, createCmd, createDB, createDefaultDriver, createFriendRef, createGroupRef, createImportContext, createMessage, createMiokuLogger, createRuntime, createStore, dayjs, dedent, defineAdapter, defineCapability, definePlugin, defineService, defineState, deleteServiceConfig, discoverAdapterCandidates, discoverPluginCandidates, displayAdapterId, ensureDataDir, filesize, filter, find, findLocalPlugins, formatAdapterReport, formatDuration, formatMiokuStatus, formatMiokuStatusFn, forwardSend, friendDelete, friendGetInfo, friendGetList, fs, getAllPluginRuntimeStates, getBuiltinPlugins, getConfigDir, getDataDir, getGTk, getPluginConfigDir, getPluginDataDir, getPluginMetadata, getPluginMetadataList, getPluginRuntimeState, getService, getServiceConfig, getServiceConfigDir, getServiceConfigs, getServiceDataDir, getTerminalInput, groupGetInfo, groupGetList, groupGetMembers, groupLeave, groupSetName, groupSetPortrait, groupSetWholeBan, hasEventRight, hasPluginState, hasRight, hasService, isAdapterEvent, isAdmin, isBoolean, isBotEvent, isDefined, isEventAdmin, isEventOwner, isEventOwnerOrAdmin, isFunction, isMessage, isMessageEvent, isMetaEvent, isMiokuPlugin, isNoticeEvent, isNumber, isObject, isOwner, isOwnerOrAdmin, isRequestEvent, isSegment, isString, loadAdapterDefinition, loadLocalPlugin, loadNpmPlugin, localNum, localeDate, localeTime, rootLogger as logger, match, md5, memberBan, memberGetInfo, memberKick, memberPoke, memberSetAdmin, memberSetCard, memberSetTitle, messageGet, messageGetForward, messageRecall, messageSend, mriLib as mri, noNullish, normalizeAIThinkingLevel, normalizeAdmins, normalizeOwners, normalizePlugins, normalizeSkillPermissionRole, noticeAdmins, noticeFriends, noticeGroups, noticeOwners, path, prettyMs, profileSet, qs, randomId, randomInt, randomItem, randomItems, readMiokuConfig, readPackageJson, readPackageJsonSafe, registerPluginArtifacts, registerServiceConfig, registerStatusProvider, reloadMiokuConfig, removePluginMetadata, requireService, resetPluginMetadata, resetPluginRuntimeState, resolveCommand, resolveEntry, resolveLocalPluginEntry, resolveLocalPluginPath, rootLogger, runCommand, runCommandInherit, segment, sendMessage, _default as serviceManager, servicesRegistry, setBotCwd, setBuiltinPlugins, setPluginMetadata, setPluginRuntimeState, setService, setWritableConfig, start, startRuntime, string2argv, stringifyError, stripAnsi, text, toArray, toId, toUserId, unique, updateMiokuConfig, updateServiceConfig, uuid, version, wait, writePackageJson };
+export { type AIInstance, type AIInstanceInfo, type AIModelCapability, type AIModelDescriptor, type AIModelRole, type AIProtocol, type AIProviderConfig, type AIService, type AISkill, type AIThinkingLevel, type AITool, type AIUsageBotOption, type AIUsageBreakdown, type AIUsageContext, type AIUsageFinalization, type AIUsageRange, type AIUsageScope, type AIUsageSummary, AI_GEMINI_THINKING_LEVELS, AI_THINKING_LEVELS, type AccessAction, type AccessControlConfig, type AccessHook, type AccessRuleEntry, type AccessScopeConfig, Adapter, AdapterBotBase, AdapterBotMap, AdapterCandidate, AdapterContext, AdapterContextImpl, AdapterDefinition, AdapterEvent, AdapterFactoryOptions, AdapterGateway, AdapterInstanceStatus, AdapterRegistrationConflictError, AdapterReport, AdapterReportEntry, AdapterResource, AdapterResourceScope, AdapterStartResult, type AdapterStatus, type AdapterStatusStats, AnyFunc, ArchMap, Arrayable, type Attachment, AvatarSetRequest, Awaitable, BOT_CWD, BUILTIN_PLUGINS, Bot, BotAutoFilled, BotBase, BotConfigJson, BotContext, BotEvent, BotEventBase, BotHandler, BotLifecycleEvent, BotProvidedKeys, BotRegistry, BotStatus, BotStatusResult, BuildAdapterReportOptions, BuildStatusOptions, type BuiltinServiceRef, BusStats, ButtonOptions, CORE_PLUGINS, Capability, CapabilityHandler, CapabilityRegistry, CapabilityTarget, type ChatRuntime, type ChatRuntimeBaseOptions, type ChatRuntimeCollectedInfo, type ChatRuntimeGroupTarget, type ChatRuntimeInformationRequestOptions, type ChatRuntimeNoticeOptions, type ChatRuntimePrivateTarget, type ChatRuntimePromptInjection, type ChatRuntimeResult, type ChatRuntimeSource, ChromeUA, CommandCatalogItem, CommandDefinition, CommandExecutionContext, CommandHandler, CommandManager, CommandMatcher, type CommandRole, CommandShortcutOptions, type CompleteOptions, type CompleteResponse, type ConfigService, type ConsolaInstance, ContextOptions, ConversationGetHistoryRequest, CorrelationParticipant, CorrelationRecord, CorrelationStats, CreateCmdOptions, CreateDriverOptions, CreateRuntimeOptions, CronHandler, Driver, DriverShutdownError, Event, EventBase, EventBus, EventCorrelator, EventFactoryOptions, EventHandler, EventIdentity, EventKindOfRoute, type EventMap, EventObservation, ExtendedNapCat, ForwardNode, ForwardSendNode, ForwardSendOptions, ForwardSendRequest, Friend, FriendDeleteRequest, FriendGetInfoRequest, FriendGetListRequest, FriendInfo, Gettable, Group, GroupGetInfoRequest, GroupGetListRequest, GroupGetMembersRequest, GroupInfo, GroupLeaveRequest, GroupSetNameRequest, GroupSetPortraitRequest, GroupSetWholeBanRequest, HasMessage, type HelpService, HistoryMessage, HttpClient, HttpRequestError, HttpRequestOptions, HttpResponse, LifecycleEvent, LifecycleEventMap, LifecycleHandler, LifecycleListener, LoadedAdapterDefinition, LoadedPluginDefinition, type LogLevel, type Logger, MatchHandler, MatchValue, MemberBanRequest, MemberGetInfoRequest, MemberInfo, MemberKickRequest, MemberPokeRequest, MemberSetAdminRequest, MemberSetCardRequest, MemberSetTitleRequest, type Message, MessageEvent, MessageGetForwardRequest, MessageGetRequest, MessageGetResult, type MessageInput, MessageRecallRequest, MessageSegment, MessageSegmentImpl, MessageSendRequest, type MessageTarget, MetaEvent, MiokuConfig, type MiokuContext, MiokuCoreServiceContrib, type MiokuPlugin, MiokuRuntime, type MiokuRuntimeConfig, type MiokuService, MiokuServices, MiokuStartOptions, type MiokuStatus, type MultimodalContentItem, type MultimodalMessage, Noop, NoticeEvent, NoticeOptions, PackageCandidate, PackageJson, type PackageJsonLike, PlatformId, PluginCandidate, PluginCleanup, type PluginHelp, PluginManager, type PluginMetadata, type PluginPackageConfig, type PluginStateRef, ProfileSetRequest, PureObject, RegisteredCommand, Registration, RegistrationFilter, ReplyArg, type ReplyOptions, RequestEvent, RouteEvent, type RunCommandResult, RuntimeAdapterState, RuntimeMiokuConfig, ScheduledTask, type ScreenshotService, SenderInfo, type SentMessage, SerializedMessageSegment, ServiceFactory, ServiceManager, type ServiceMetadata, type ServiceRef, Services, type SessionToolDefinition, type SkillPermissionRole, type SpawnPlan, StartOptions, type StatusProvider, StatusProviderContext, StatusProviderTarget, SystemMap, TOOL_RESULT_FOLLOWUP_KEY, type TextMessage, type ToolCallRecord, type ToolResultFollowup, UnsupportedCapabilityError, WebSocketClient, WebSocketConnectOptions, WebSocketConnectTimeoutError, WebSocketConnection, type WebUIService, addService, applyLogLevel, asMessage, atOf, avatarGet, avatarSet, base64Decode, base64Encode, bindCapabilities, botConfig, botStatus, box, buildAdapterReport, buildMiokuStatus, buildRoutes, buildSpawnPlan, clamp, collectBotStats, colorize, colors, commandExists, connectedBotKey, connectedBots, conversationGetHistory, createCmd, createDB, createDefaultDriver, createFriendRef, createGroupRef, createImportContext, createMessage, createMiokuLogger, createRuntime, createStore, dayjs, dedent, defineAdapter, defineCapability, definePlugin, defineService, defineState, deleteServiceConfig, discoverAdapterCandidates, discoverPluginCandidates, displayAdapterId, ensureDataDir, filesize, filter, find, findLocalPlugins, formatAdapterReport, formatDuration, formatMiokuStatus, formatMiokuStatusFn, forwardSend, friendDelete, friendGetInfo, friendGetList, fs, getActiveCommandManager, getAllPluginRuntimeStates, getBuiltinPlugins, getConfigDir, getDataDir, getGTk, getPluginConfigDir, getPluginDataDir, getPluginMetadata, getPluginMetadataList, getPluginRuntimeState, getService, getServiceConfig, getServiceConfigDir, getServiceConfigs, getServiceDataDir, getTerminalInput, groupGetInfo, groupGetList, groupGetMembers, groupLeave, groupSetName, groupSetPortrait, groupSetWholeBan, hasEventRight, hasPluginState, hasRight, hasService, isAdapterEvent, isAdmin, isBoolean, isBotEvent, isDefined, isEventAdmin, isEventAdminConfigOnly, isEventGroupAdmin, isEventGroupOwner, isEventMaster, isEventOwner, isEventOwnerOrAdmin, isFunction, isMessage, isMessageEvent, isMetaEvent, isMiokuPlugin, isNoticeEvent, isNumber, isObject, isOwner, isOwnerOrAdmin, isRequestEvent, isSegment, isString, loadAdapterDefinition, loadLocalPlugin, loadNpmPlugin, localNum, localeDate, localeTime, rootLogger as logger, match, md5, memberBan, memberGetInfo, memberKick, memberPoke, memberSetAdmin, memberSetCard, memberSetTitle, messageGet, messageGetForward, messageRecall, messageSend, mriLib as mri, noNullish, normalizeAIThinkingLevel, normalizeAdmins, normalizeOwners, normalizePlugins, normalizeSkillPermissionRole, noticeAdmins, noticeFriends, noticeGroups, noticeOwners, path, prettyMs, profileSet, qs, randomId, randomInt, randomItem, randomItems, readMiokuConfig, readPackageJson, readPackageJsonSafe, registerPluginArtifacts, registerServiceConfig, registerStatusProvider, reloadMiokuConfig, removePluginMetadata, requireService, resetPluginMetadata, resetPluginRuntimeState, resolveCommand, resolveEntry, resolveLocalPluginEntry, resolveLocalPluginPath, rootLogger, runCommand, runCommandInherit, segment, sendMessage, _default as serviceManager, servicesRegistry, setActiveCommandManager, setBotCwd, setBuiltinPlugins, setPluginMetadata, setPluginRuntimeState, setService, setWritableConfig, start, startRuntime, string2argv, stringifyError, stripAnsi, text, toArray, toId, toUserId, unique, updateMiokuConfig, updateServiceConfig, uuid, version, wait, writePackageJson };
 //# sourceMappingURL=index.d.cts.map