@hina114514/chaite 1.9.3

package/dist/index.d.ts

@@ -0,0 +1,1579 @@
+import { AsyncLocalStorage } from "async_hooks";
+import EventEmitter from "node:events";
+import { Server } from "node:http";
+import { SafetySetting } from "@google/genai";
+import { Application } from "express";
+import { Job } from "@karinjs/node-schedule";
+
+//#region src/types/models.d.ts
+type Feature = 'chat' | 'visual' | 'tool' | 'embedding';
+/**
+ * other roles like developer or function should be handled by different implementations
+ */
+type Role = 'system' | 'user' | 'assistant' | 'tool' | 'developer';
+interface MessageContent {
+  type: 'text' | 'image' | 'audio' | 'video' | 'tool' | 'reasoning';
+  thoughtSignature?: string;
+}
+interface TextContent extends MessageContent {
+  type: 'text';
+  /**
+   * Content of text
+   */
+  text: string;
+}
+interface ReasoningContent extends MessageContent {
+  type: 'reasoning';
+  /**
+   * thinking text
+   */
+  text: string;
+}
+interface ImageContent extends MessageContent {
+  type: 'image';
+  /**
+   * Either a URL of the image or the base64 encoded image data
+   */
+  image: string;
+  mimeType?: string;
+}
+interface AudioContent extends MessageContent {
+  type: 'audio';
+  /**
+   * Base64 encoded audio data
+   */
+  data: string;
+  format: 'mp3' | 'wav';
+}
+type History = {
+  id: string;
+  parentId: string | null;
+};
+interface IMessage {
+  role: Role;
+  content: MessageContent[];
+  toolCalls?: ToolCall[];
+}
+/**
+ * 模型返回的工具调用，role是assistant
+ */
+interface ToolCall {
+  id: string;
+  type: 'function';
+  function: FunctionCall;
+  thoughtSignature?: string;
+}
+type ArgumentValue = string | number | boolean | ArgumentValue[];
+type FunctionCall = {
+  name: string;
+  /**
+   * raw可能是JSON字符串，需要反序列化一次
+   */
+  arguments: Record<string, ArgumentValue | Record<string, ArgumentValue>>;
+};
+/**
+ * 用户发送的消息，可能有文本和多模态消息
+ */
+interface UserMessage extends IMessage {
+  role: 'user';
+  content: Array<TextContent | ImageContent | AudioContent>;
+}
+interface SystemMessage extends IMessage {
+  role: 'system';
+  content: TextContent[];
+}
+interface DeveloperMessage extends IMessage {
+  role: 'developer';
+  content: TextContent[];
+}
+/**
+ * 模型返回的消息，包括文本以及可能的工具调用
+ */
+interface AssistantMessage extends IMessage {
+  role: 'assistant';
+  content: Array<MessageContent>;
+  toolCalls?: ToolCall[];
+}
+interface ReasoningPart {
+  reasoning_content?: string;
+  reasoning?: string;
+  thinking_content?: string;
+  thinking?: string;
+  think?: string;
+}
+/**
+ * 客户端执行工具调用的函数结果
+ */
+interface ToolCallResultMessage extends IMessage {
+  role: 'tool';
+  content: ToolCallResult[];
+}
+interface ToolCallResult extends MessageContent {
+  type: 'tool';
+  tool_call_id?: string;
+  content: string;
+  name?: string;
+}
+type HistoryMessage = History & IMessage;
+interface ModelResponse {
+  id?: string;
+  model?: string;
+  contents: MessageContent[];
+  usage?: ModelUsage;
+}
+interface ModelUsage {
+  promptTokens?: number;
+  completionTokens?: number;
+  totalTokens?: number;
+  cachedTokens?: number;
+  reasoningTokens?: number;
+}
+interface ModelResponseChunk {
+  id?: string;
+  model?: string;
+  delta: MessageContent[];
+  toolCall?: ToolCall[];
+}
+interface EmbeddingResult {
+  embeddings: Array<number>[];
+}
+//#endregion
+//#region src/types/cloud.d.ts
+interface CloudAPIResponse<T> {
+  code: number;
+  data: T;
+  msg: string;
+}
+interface PaginationResult<T> {
+  items: T[];
+  pagination: {
+    currentPage: number;
+    pageSize: number;
+    totalItems: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+  };
+  type: string;
+}
+interface CloudSharingService<T extends AbstractShareable<unknown>> {
+  setUser(user: User): void;
+  getUser(): User | null;
+  authenticate(apiKey: string): Promise<User | null>;
+  upload(model: Serializable): Promise<T | null>;
+  download(shareId: string): Promise<T | null>;
+  initializeTransfer(model: Serializable): Promise<string | null>;
+  list(filter: Filter, query: string, searchOption: SearchOption): Promise<PaginationResult<T>>;
+  delete(shareId: string): Promise<boolean>;
+}
+type FilterValue = string | number | boolean | FilterValue[];
+type Filter = Record<string, FilterValue | Record<string, FilterValue>>;
+interface SearchOption {
+  searchFields?: string[];
+  page?: number;
+  pageSize?: number;
+}
+interface User {
+  username: string;
+  user_id: string | number;
+  api_key?: string;
+  github?: string;
+  email?: string;
+  google?: string;
+  linux_do?: string;
+  apple?: string;
+  microsoft?: string;
+}
+interface Serializable {
+  toString(): string;
+}
+interface DeSerializable<T> {
+  fromString(str: string): T;
+}
+interface CloudModel {
+  modelType: 'settings' | 'executable';
+  code?: string;
+  name: string;
+  id: string;
+  cloudId?: string;
+  embedded: boolean;
+  description: string;
+  uploader: User;
+  updatedAt: string;
+  createdAt: string;
+  md5: string;
+  toFormatedString(verbose?: boolean): string;
+}
+type Shareable<T> = Serializable & DeSerializable<T> & CloudModel;
+declare abstract class AbstractShareable<T> implements Shareable<T> {
+  constructor(params?: Partial<AbstractShareable<T>>);
+  modelType: 'settings' | 'executable';
+  code?: string;
+  createdAt: string;
+  description: string;
+  embedded: boolean;
+  id: string;
+  cloudId?: string;
+  name: string;
+  uploader: User;
+  updatedAt: string;
+  fromString(str: string): T;
+  toString(): string;
+  toFormatedString(verbose?: boolean): string;
+  md5: string;
+}
+interface Wait {
+  ready(): Promise<void>;
+}
+//#endregion
+//#region src/types/processors.d.ts
+declare class ProcessorDTO extends AbstractShareable<ProcessorDTO> {
+  constructor(params: Partial<ProcessorDTO>);
+  type: 'pre' | 'post';
+  fromString(str: string): ProcessorDTO;
+  toFormatedString(_verbose?: boolean): string;
+}
+interface Processor {
+  type: 'pre' | 'post';
+  name: string;
+}
+/**
+ * 继承这个来实现一个前处理器
+ */
+declare abstract class PreProcessor implements Processor {
+  type: 'pre';
+  abstract process(message: UserMessage): Promise<UserMessage>;
+  name: string;
+  id: string;
+}
+/**
+ * 继承这个来实现一个后处理器
+ */
+declare abstract class PostProcessor implements Processor {
+  type: 'post';
+  abstract process(message: AssistantMessage): Promise<AssistantMessage>;
+  name: string;
+  id: string;
+}
+//#endregion
+//#region src/types/adapter.d.ts
+interface ToolCallLimitConfig {
+  maxConsecutiveCalls?: number;
+  maxConsecutiveIdenticalCalls?: number;
+}
+declare class SendMessageOption implements Serializable, DeSerializable<SendMessageOption> {
+  constructor(option: Partial<SendMessageOption>);
+  static create(options?: SendMessageOption | Partial<SendMessageOption>): SendMessageOption;
+  model?: string;
+  temperature?: number;
+  maxToken?: number;
+  /**
+     * 将系统提示词覆盖
+     */
+  systemOverride?: string;
+  /**
+     * 本轮对话禁用历史
+     */
+  disableHistoryRead?: boolean;
+  /**
+     * 禁用本轮对话存储到历史
+     */
+  disableHistorySave?: boolean;
+  /**
+     * 对话ID。如果不传则默认为第一次对话
+     */
+  conversationId?: string;
+  /**
+     * 上一条消息的ID，如果不传则默认为第一次对话
+     */
+  parentMessageId?: string;
+  /**
+     * 流模式
+     */
+  stream?: boolean;
+  /**
+     * 是否是思考模型
+     */
+  isThinkingModel?: boolean;
+  enableReasoning?: boolean;
+  reasoningEffort?: 'high' | 'medium' | 'low' | 'minimal';
+  reasoningBudgetTokens?: number;
+  toolChoice?: ToolChoice;
+  postProcessorIds?: string[];
+  preProcessorIds?: string[];
+  toolGroupId?: string[];
+  responseModalities?: string[];
+  safetySettings?: SafetySetting[];
+  toolCallLimit?: ToolCallLimitConfig;
+  _consecutiveToolCallCount?: number;
+  _consecutiveIdenticalToolCallCount?: number;
+  _lastToolCallSignature?: string;
+  /**
+     * 流模式的回调
+     * @param chunk
+     */
+  onChunk?(chunk: ModelResponseChunk): Promise<void>;
+  /**
+     * 工具调用轮次，如果有其他非tool_call类消息会被丢弃最后不会返回，但是可以通过onMessageWithToolCall来处理
+     * @param message
+     */
+  onMessageWithToolCall?(message: MessageContent): Promise<void>;
+  fromString(str: string): SendMessageOption;
+  toString(): string;
+}
+interface ToolChoice {
+  type: 'none' | 'any' | 'auto' | 'specified';
+  tools?: string[];
+}
+interface EmbeddingOption {
+  model: string;
+  dimensions?: number;
+}
+type ClientType = 'openai' | 'gemini' | 'claude';
+interface IClient {
+  name: ClientType;
+  features: Feature[];
+  tools: Tool[];
+  baseUrl: string;
+  apiKey: string | string[];
+  multipleKeyStrategy: MultipleKeyStrategy;
+  historyManager: HistoryManager;
+  postProcessors?: PostProcessor[];
+  preProcessors?: PreProcessor[];
+  sendMessage(message: UserMessage | undefined, options?: SendMessageOption | Partial<SendMessageOption>): Promise<ModelResponse>;
+  sendMessageWithHistory(history: IMessage[], options?: SendMessageOption | Partial<SendMessageOption>): Promise<IMessage & {
+    usage: ModelUsage;
+  }>;
+  getEmbedding(text: string | string[], options: EmbeddingOption): Promise<EmbeddingResult>;
+  logger: ILogger;
+}
+interface HistoryManager {
+  name: string;
+  saveHistory(message: HistoryMessage, conversationId: string): Promise<void>;
+  getHistory(messageId?: string, conversationId?: string): Promise<HistoryMessage[]>;
+  deleteConversation(conversationId: string): Promise<void>;
+  getOneHistory(messageId: string, conversationId: string): Promise<HistoryMessage | undefined>;
+}
+declare abstract class AbstractHistoryManager implements HistoryManager {
+  name: string;
+  abstract saveHistory(message: HistoryMessage, conversationId: string): Promise<void>;
+  abstract getHistory(messageId?: string, conversationId?: string): Promise<HistoryMessage[]>;
+  abstract deleteConversation(conversationId: string): Promise<void>;
+  abstract getOneHistory(messageId: string, conversationId: string): Promise<HistoryMessage | undefined>;
+}
+//#endregion
+//#region src/channels/channels.d.ts
+declare class DefaultChannelLoadBalancer implements ChannelsLoadBalancer {
+  constructor();
+  getChannel(name: string, channels: Channel[]): Promise<Channel>;
+  private groupByPriority;
+  private selectByWeight;
+  /**
+   * 获取渠道列表及其分配的数量
+   * generated by qwen-2.5-max
+   *
+   * @param modelName 模型名称
+   * @param channels 渠道列表
+   * @param totalQuantity 总数量
+   * @returns 返回一个包含渠道及其分配数量的数组
+   */
+  getChannels(modelName: string, channels: Channel[], totalQuantity: number): Promise<{
+    channel: Channel;
+    quantity: number;
+  }[]>;
+}
+/**
+ * 渠道
+ * 每个渠道对应一个adapter，并记录客户端的options
+ */
+declare class Channel extends AbstractShareable<Channel> implements Wait {
+  constructor(params: Partial<Channel>);
+  init(): Promise<void>;
+  ready(): Promise<void>;
+  adapterType: ClientType;
+  options: BaseClientOptions;
+  models: string[];
+  type: ClientType;
+  weight: number;
+  priority: number;
+  status: 'enabled' | 'disabled';
+  disabledReason?: string;
+  statistics: ChannelStatistics;
+  fromString(str: string): Channel;
+  toString(): string;
+  toFormatedString(verbose?: boolean): string;
+}
+//#endregion
+//#region src/channels/preset.d.ts
+/**
+ * 对话模式预设，最终使用的
+ */
+declare class ChatPreset extends AbstractShareable<ChatPreset> {
+  constructor(params?: Partial<ChatPreset>);
+  prefix: string;
+  local: boolean;
+  namespace?: string;
+  sendMessageOption: SendMessageOption;
+  /**
+   * 携带群聊上下文
+   */
+  groupContext?: 'disable' | 'enabled' | 'use_system';
+  /**
+   * 禁止系统prompt
+   */
+  disableSystemInstructions?: boolean;
+  toString(): string;
+  fromString(str: string): ChatPreset;
+  toFormatedString(verbose?: boolean): string;
+}
+//#endregion
+//#region src/types/external.d.ts
+interface EventMessage {
+  sender: {
+    user_id: string;
+    nickname?: string;
+    card?: string;
+  };
+  group: {
+    group_id: number;
+  };
+}
+interface UserModeSelector {
+  getChatPreset(e: EventMessage): Promise<ChatPreset>;
+}
+declare abstract class AbstractUserModeSelector implements UserModeSelector {
+  abstract getChatPreset(e: EventMessage): Promise<ChatPreset>;
+}
+//#endregion
+//#region src/adapters/clients.d.ts
+declare class AbstractClient implements IClient {
+  options: BaseClientOptions;
+  constructor(options: BaseClientOptions | Partial<BaseClientOptions>, context?: ChaiteContext);
+  fullfillProcessors(preIds?: string[], postIds?: string[]): Promise<{
+    pre: PreProcessor[];
+    post: PostProcessor[];
+  }>;
+  fullfillTools(toolGroupIds?: string[]): Promise<Tool[]>;
+  sendMessage(message: UserMessage | undefined, options: SendMessageOption | Partial<SendMessageOption>): Promise<ModelResponse>;
+  protected shouldPersistHistory(message?: HistoryMessage): boolean;
+  protected isEffectivelyEmptyMessage(message?: IMessage): boolean;
+  private hasMeaningfulContent;
+  private isMessagePartMeaningful;
+  protected setToolCallLimitConfig(config?: ToolCallLimitConfig): void;
+  private getEffectiveToolCallLimit;
+  private updateToolCallTracking;
+  private resetToolCallTracking;
+  private buildToolCallSignature;
+  _sendMessage(_histories: IMessage[], _apiKey: string, _options: SendMessageOption): Promise<HistoryMessage & {
+    usage: ModelUsage;
+  }>;
+  sendMessageWithHistory(history: IMessage[], options?: SendMessageOption | Partial<SendMessageOption>): Promise<IMessage & {
+    usage: ModelUsage;
+  }>;
+  apiKey: string | string[];
+  baseUrl: string;
+  features: Feature[];
+  multipleKeyStrategy: MultipleKeyStrategy;
+  name: ClientType;
+  tools: Tool[];
+  logger: ILogger;
+  historyManager: HistoryManager;
+  context: ChaiteContext;
+  postProcessors?: PostProcessor[];
+  preProcessors?: PreProcessor[];
+  protected toolCallLimitConfig?: ToolCallLimitConfig;
+  getEmbedding(_text: string | string[], _options: EmbeddingOption): Promise<EmbeddingResult>;
+}
+//#endregion
+//#region src/adapters/create.d.ts
+declare function createClient(name: ClientType, options: BaseClientOptions | Partial<BaseClientOptions>, context?: ChaiteContext): IClient;
+//#endregion
+//#region src/adapters/impl/openai/OpenAIClient.d.ts
+type OpenAIClientOptions = BaseClientOptions;
+declare class OpenAIClient extends AbstractClient {
+  constructor(options: OpenAIClientOptions | Partial<OpenAIClientOptions>, context?: ChaiteContext);
+  _sendMessage(histories: IMessage[], apiKey: string, options: SendMessageOption): Promise<HistoryMessage & {
+    usage: ModelUsage;
+  }>;
+  getEmbedding(text: string | string[], options: EmbeddingOption): Promise<EmbeddingResult>;
+}
+//#endregion
+//#region src/adapters/impl/gemini/GeminiClient.d.ts
+type GeminiClientOptions = BaseClientOptions & {
+  toolCallLimit?: ToolCallLimitConfig;
+};
+declare class GeminiClient extends AbstractClient {
+  constructor(options: GeminiClientOptions | Partial<GeminiClientOptions>, context?: ChaiteContext);
+  /**
+   * 将 reasoningEffort 映射为 thinkingLevel
+   * 所有 Gemini 模型统一使用 thinkingLevel（不再区分 2.5/3 系列）
+   */
+  private resolveThinkingLevel;
+  _sendMessage(histories: IMessage[], apiKey: string, options: SendMessageOption): Promise<HistoryMessage & {
+    usage: ModelUsage;
+  }>;
+  getEmbedding(text: string | string[], options: EmbeddingOption): Promise<EmbeddingResult>;
+}
+//#endregion
+//#region src/adapters/impl/claude/ClaudeClient.d.ts
+declare class ClaudeClient extends AbstractClient {
+  constructor(options: GeminiClientOptions | Partial<GeminiClientOptions>, context?: ChaiteContext);
+  _sendMessage(histories: IMessage[], apiKey: string, options: SendMessageOption): Promise<HistoryMessage & {
+    usage: ModelUsage;
+  }>;
+}
+//#endregion
+//#region src/share/shareable.d.ts
+type ExecutableSShareableType = 'tool' | 'processor';
+/**
+ * T是DTO
+ * C是T对应的可执行的实例类型
+ * @interface ExecutableShareableManager
+ */
+declare abstract class ExecutableShareableManager<T extends Shareable<T>, C> {
+  private type;
+  private storage;
+  private watcher;
+  /**
+   * 存储示例名称和文件名的映射
+   * @private
+   */
+  protected instanceMap: Map<string, string>;
+  /**
+   * codeDirectory是存放实际代码的目录
+   * @private
+   */
+  protected codeDirectory: string;
+  /** @deprecated unused in local-only mode */
+  cloudService?: unknown;
+  protected constructor(type: ExecutableSShareableType, codeDirectory: string, storage: BasicStorage<T>);
+  /** @deprecated no-op in local-only mode */
+  setCloudService(_cloudService: unknown): void;
+  /**
+   * 只有可执行类型的实例才需要，如工具、处理器等。设置类不需要
+   * @private
+   */
+  initialize(): Promise<void>;
+  private setupFileWatcher;
+  private scanInstances;
+  /**
+   * 返回实例名字们
+   * @returns 实例名字列表
+   */
+  listInstanceNames(): Promise<string[]>;
+  listInstances(): Promise<T[]>;
+  getInstanceT(id: string): Promise<T | null>;
+  /**
+   * 获取实例对象而非Shareable DTO
+   * @param name
+   */
+  getInstance(name: string): Promise<C | undefined>;
+  /**
+   * 新增或更新
+   * 有id就是更新，靠storage实现去控制，这里不管
+   * @param instance
+   * @return id
+   */
+  addInstance(instance: T): Promise<string>;
+  addInstanceCode(name: string, code: string): Promise<void>;
+  upsertInstanceT(t: T): Promise<string>;
+  getInstanceTByCloudId(cloudId: string): Promise<T[]>;
+  renameFile(id: string, oldName: string, newName: string): Promise<void>;
+  deleteInstance(id: string): Promise<void>;
+  /**
+   * 序列化实例，返回DTO
+   * @param name
+   */
+  abstract serializeInstance(name: string): Promise<T | null>;
+  shareToCloud(_id: string): Promise<string | undefined>;
+  listFromCloud(_filter: unknown, _query: string, _searchOption: unknown): Promise<never>;
+  getFromCloud(_shareId: string): Promise<T | null>;
+  shareP2P(_name: string): Promise<string | null>;
+  dispose(): Promise<void>;
+}
+type NonExecutableSShareableType = 'chat-preset' | 'tool-settings' | 'channel' | 'tools-group';
+declare abstract class NonExecutableShareableManager<T extends Shareable<T>> {
+  protected type: NonExecutableSShareableType;
+  protected storage: BasicStorage<T>;
+  /** @deprecated unused in local-only mode */
+  cloudService?: unknown;
+  protected constructor(type: NonExecutableSShareableType, storage: BasicStorage<T>);
+  /** @deprecated no-op in local-only mode */
+  setCloudService(_cloudService: unknown): void;
+  addInstance(instance: T): Promise<string>;
+  deleteInstance(key: string): Promise<void>;
+  listInstances(): Promise<T[]>;
+  getInstance(key: string): Promise<T | null>;
+  upsertInstance(t: T): Promise<string>;
+  getInstanceByCloudId(cloudId: string): Promise<T[]>;
+  shareToCloud(_key: string): Promise<string | undefined>;
+  shareP2P(_key: string): Promise<string | null>;
+  getFromCloud(_shareId: string): Promise<T | null>;
+  listFromCloud(_filter: unknown, _query: string, _searchOption: unknown): Promise<never>;
+  deleteFromCloud(_key: string): Promise<void>;
+}
+//#endregion
+//#region src/share/tool.d.ts
+declare class ToolManager extends ExecutableShareableManager<ToolDTO, Tool> {
+  private static instance;
+  private constructor();
+  static init(toolsDirectory: string, storage: BasicStorage<ToolDTO>): Promise<ToolManager>;
+  static getInstance(): Promise<ToolManager | null>;
+  serializeInstance(name: string): Promise<ToolDTO | null>;
+}
+//#endregion
+//#region src/share/cloud.d.ts
+/**
+ * Cloud service stub — kept only to satisfy the CloudSharingService interface
+ * used by shareable.ts base classes. No-op implementation.
+ */
+declare class DefaultCloudService<T> {
+  constructor(_cloudApiBaseUrl: string, _type: string);
+}
+//#endregion
+//#region src/share/channels.d.ts
+declare class ChannelsManager extends NonExecutableShareableManager<Channel> {
+  protected storage: BasicStorage<Channel>;
+  private loadBalancer;
+  private static instance;
+  private constructor();
+  static init(storage: BasicStorage<Channel>, loadBalancer: ChannelsLoadBalancer): Promise<ChannelsManager>;
+  static getInstance(): Promise<ChannelsManager | null>;
+  getAllChannels(name?: string): Promise<Channel[]>;
+  getChannelByType(type: Channel['type']): Promise<Channel[]>;
+  getChannelByStatus(status: 'enabled' | 'disabled'): Promise<Channel[]>;
+  getChannelByModel(model: string): Promise<Channel[]>;
+  getChannelsByModel(model: string, totalQuantity: number): Promise<{
+    channel: Channel;
+    quantity: number;
+  }[]>;
+}
+//#endregion
+//#region src/share/processors.d.ts
+declare class ProcessorsManager extends ExecutableShareableManager<ProcessorDTO, Processor> {
+  private static instance;
+  private constructor();
+  static init(processorsDirectory: string, storage: BasicStorage<ProcessorDTO>): Promise<ProcessorsManager>;
+  static getInstance(): Promise<ProcessorsManager | null>;
+  serializeInstance(name: string): Promise<ProcessorDTO | null>;
+}
+//#endregion
+//#region src/share/preset.d.ts
+declare class ChatPresetManager extends NonExecutableShareableManager<ChatPreset> {
+  protected storage: BasicStorage<ChatPreset>;
+  private static instance;
+  private constructor();
+  static init(storage: BasicStorage<ChatPreset>): Promise<ChatPresetManager>;
+  static getInstance(): Promise<ChatPresetManager | null>;
+  getAllPresets(options?: {
+    includeLocal?: boolean;
+    namespace?: string;
+  }): Promise<ChatPreset[]>;
+  getPresetByPrefix(prefix: string): Promise<ChatPreset | null>;
+}
+//#endregion
+//#region src/share/tools_group.d.ts
+declare class ToolsGroupManager extends NonExecutableShareableManager<ToolsGroupDTO> {
+  private static instance;
+  private constructor();
+  static init(storage: BasicStorage<ToolsGroupDTO>): Promise<ToolsGroupManager>;
+  static getInstance(): Promise<ToolsGroupManager | null>;
+}
+//#endregion
+//#region src/share/trigger.d.ts
+/**
+ * 专门用于管理触发器的管理器
+ * 由于触发器需要注册并保持状态运行，因此管理方式不同于普通的可执行代码
+ */
+declare class TriggerManager<T extends TriggerDTO> {
+  private storage;
+  /**
+   * 存储触发器名称到 DTO ID 的映射
+   * 这样通过实例的 name 就可以找到对应的 DTO id
+   */
+  protected nameToIdMap: Map<string, string>;
+  private watcher;
+  /**
+   * 存储示例名称和文件名的映射
+   */
+  protected instanceMap: Map<string, string>;
+  /**
+   * 已注册的触发器实例
+   */
+  protected activeInstances: Map<string, Trigger>;
+  /**
+   * 全局上下文，用于传递给触发器
+   */
+  protected context: ChaiteContext;
+  /**
+   * codeDirectory是存放实际代码的目录
+   */
+  protected codeDirectory: string;
+  /** @deprecated unused in local-only mode */
+  cloudService?: unknown;
+  constructor(codeDirectory: string, storage: BasicStorage<T>);
+  /** @deprecated no-op in local-only mode */
+  setCloudService(_cloudService: unknown): void;
+  /**
+   * 初始化管理器，加载所有触发器并注册
+   */
+  initialize(): Promise<void>;
+  /**
+   * 设置文件监听器，监控触发器文件的变化
+   */
+  private setupFileWatcher;
+  /**
+   * 扫描触发器实例
+   */
+  private scanInstances;
+  /**
+   * 注册所有启用状态的触发器
+   */
+  private registerAllEnabledTriggers;
+  /**
+   * 注册单个触发器
+   */
+  registerTrigger(dtoName: string): Promise<void>;
+  /**
+  * 通过触发器实例的 name 删除触发器
+  * 注意：这里的 name 是触发器实例的 name，而不是 DTO 中的 name
+  */
+  deleteInstanceByName(triggerName: string): Promise<void>;
+  /**
+   * 取消注册触发器
+   */
+  unregisterTrigger(name: string): Promise<void>;
+  /**
+   * 返回实例名字们
+   */
+  listInstanceNames(): Promise<string[]>;
+  /**
+   * 获取所有触发器DTO
+   */
+  listInstances(): Promise<T[]>;
+  /**
+   * 获取触发器DTO
+   */
+  getInstanceT(id: string): Promise<T | null>;
+  /**
+   * 通过名称获取触发器DTO
+   */
+  getInstanceTByName(name: string): Promise<T | null>;
+  /**
+   * 获取触发器实例对象
+   */
+  getInstance(name: string): Promise<Trigger | undefined>;
+  /**
+   * 新增或更新触发器
+   */
+  addInstance(instance: T): Promise<string>;
+  /**
+   * 添加触发器代码
+   */
+  addInstanceCode(name: string, code: string): Promise<void>;
+  /**
+   * 更新或新增触发器
+   */
+  upsertInstanceT(t: T): Promise<string>;
+  /**
+   * 通过云ID获取触发器
+   */
+  getInstanceTByCloudId(cloudId: string): Promise<T[]>;
+  /**
+   * 重命名触发器文件
+   */
+  renameFile(id: string, oldName: string, newName: string): Promise<void>;
+  /**
+   * 删除触发器
+   */
+  deleteInstance(id: string): Promise<void>;
+  /**
+   * 更新上下文
+   */
+  updateContext(context: ChaiteContext): void;
+  /**
+   * 序列化触发器，返回DTO
+   */
+  serializeInstance(name: string): Promise<T | null>;
+  shareToCloud(_id: string): Promise<string | undefined>;
+  listFromCloud(_filter: unknown, _query: string, _searchOption: unknown): Promise<never>;
+  getFromCloud(_shareId: string): Promise<T | null>;
+  shareP2P(_name: string): Promise<string | null>;
+  /**
+   * 清理资源，关闭文件监听器
+   */
+  dispose(): Promise<void>;
+  /**
+   * 启用触发器
+   */
+  enableTrigger(id: string): Promise<void>;
+  /**
+   * 禁用触发器
+   */
+  disableTrigger(id: string): Promise<void>;
+  /**
+   * 检查触发器是否正在运行
+   */
+  isRunning(name: string): boolean;
+  /**
+   * 获取当前运行中的所有触发器
+   */
+  getRunningTriggers(): string[];
+}
+//#endregion
+//#region src/utils/helpers.d.ts
+declare function getKey(apiKeys: string[] | string, strategy: MultipleKeyStrategy): Promise<string>;
+declare const asyncLocalStorage: AsyncLocalStorage<ChaiteContext>;
+declare function useEvent(): Promise<EventMessage | undefined>;
+/**
+ * 表示构造函数的类型
+ */
+type AbstractConstructor<T> = abstract new (...args: unknown[]) => T;
+/**
+ * 将JS代码保存到指定目录并导入其默认导出
+ *
+ * @param {string} jsContent - JS代码内容
+ * @param {string} modulesDir - 保存模块的目录
+ * @param {string} fileName - 文件名（不含路径）
+ * @param {Function} AbstractClass - 抽象类，用于检查实例是否继承自它
+ * @returns {Promise<T | null>} 如果默认导出继承自AbstractClass则返回该实例，否则返回null
+ */
+declare function saveAndLoadModule<T>(jsContent: string, modulesDir: string, fileName: string, AbstractClass: AbstractConstructor<T>): Promise<T | null>;
+/**
+ * 解析 JavaScript 代码中的 class 变量 name 的值
+ * @param {string} code - 输入的 JavaScript 代码
+ * @returns {string|null} - 解析出的 class 的 name 值，或者 null 如果没有找到
+ */
+declare function extractClassName(code: string): string | null;
+//#endregion
+//#region src/utils/kv_history.d.ts
+interface KVStore {
+  get(key: string): Promise<string>;
+  set(key: string, value: string): Promise<void>;
+  delete(key: string): Promise<void>;
+}
+declare class KVHistoryManager implements HistoryManager {
+  private kvStore;
+  name: string;
+  constructor(kvStore: KVStore, name: string);
+  private getConversationKey;
+  private getMessageKey;
+  saveHistory(message: HistoryMessage, conversationId: string): Promise<void>;
+  getHistory(messageId?: string, conversationId?: string): Promise<HistoryMessage[]>;
+  deleteConversation(conversationId: string): Promise<void>;
+  getOneHistory(messageId: string, conversationId: string): Promise<HistoryMessage | undefined>;
+}
+//#endregion
+//#region src/utils/history.d.ts
+type HistoryCache = Map<string, Map<string, HistoryMessage>>;
+declare class InMemoryHistoryManager extends AbstractHistoryManager {
+  cache: HistoryCache;
+  constructor();
+  saveHistory(message: HistoryMessage, conversationId: string): Promise<void>;
+  getHistory(messageId?: string, conversationId?: string): Promise<HistoryMessage[]>;
+  deleteConversation(conversationId: string): Promise<void>;
+  getOneHistory(messageId: string, conversationId: string): Promise<HistoryMessage | undefined>;
+  name: string;
+}
+//#endregion
+//#region src/utils/config.d.ts
+declare const DEFAULT_HOST = "127.0.0.1";
+declare const DEFAULT_PORT = 48370;
+declare class GlobalConfig extends EventEmitter {
+  /**
+   * JWT signing secret (used for JWT verification in middleware)
+   */
+  private authKey;
+  /**
+   * Listen host
+   */
+  private host;
+  /**
+   * Listen port
+   */
+  private port;
+  /**
+   * Debug mode
+   */
+  private debug;
+  /**
+   * Login validity period in seconds
+   */
+  private loginValidTime;
+  /**
+   * Access token — the actual token used for URL-based auth
+   */
+  private accessToken;
+  setAuthKey(key: string): void;
+  setHost(host: string): void;
+  setPort(port: number): void;
+  setDebug(debug: boolean): void;
+  setLoginValidTime(time: number): void;
+  setAccessToken(token: string): void;
+  getAuthKey(): string;
+  getHost(): string;
+  getPort(): number;
+  getDebug(): boolean;
+  getLoginValidTime(): number;
+  getAccessToken(): string;
+  static generateRandomToken(length?: number): string;
+}
+//#endregion
+//#region src/utils/auth.d.ts
+declare class FrontEndAuthHandler {
+  private token;
+  constructor();
+  generateToken(timeout?: number, onetime?: boolean): string;
+  validateToken(token: string): boolean;
+  /**
+   * Generate a static random key for JWT signing (persistent across logins)
+   */
+  static generateStaticKey(): string;
+  /**
+   * Generate JWT with configurable expiration
+   */
+  static generateJWT(key: string, expiresInSec?: number): string;
+  static validateJWT(key: string, token: string): boolean;
+}
+//#endregion
+//#region src/utils/logger.d.ts
+declare function getLogger(): ILogger;
+//#endregion
+//#region src/rag/vector.d.ts
+/**
+ * generated by claude-3-5-sonnet
+ */
+interface VectorDatabase {
+  /**
+   * 添加单个向量到数据库
+   * @param vector - 要添加的向量，表示为数字数组
+   * @param text - 与向量关联的文本
+   * @returns 返回添加的向量的唯一标识符
+   */
+  addVector(vector: number[], text: string): Promise<string>;
+  /**
+   * 批量添加多个向量到数据库
+   * @param vectors - 要添加的向量数组，每个向量表示为数字数组
+   * @param texts - 与向量关联的文本数组，顺序应与向量数组对应
+   * @returns 返回添加的向量的唯一标识符数组
+   */
+  addVectors(vectors: number[][], texts: string[]): Promise<string[]>;
+  /**
+   * 搜索与给定查询向量最相似的向量
+   * @param queryVector - 查询向量，表示为数字数组
+   * @param k - 要返回的最相似向量的数量
+   * @returns 返回最相似向量的数组，每个元素包含id、相似度分数和关联文本
+   */
+  search(queryVector: number[], k: number): Promise<Array<{
+    id: string;
+    score: number;
+    text: string;
+  }>>;
+  /**
+   * 根据ID获取特定的向量
+   * @param id - 向量的唯一标识符
+   * @returns 返回包含向量和关联文本的对象，如果未找到则返回null
+   */
+  getVector(id: string): Promise<{
+    vector: number[];
+    text: string;
+  } | null>;
+  /**
+   * 从数据库中删除指定ID的向量
+   * @param id - 要删除的向量的唯一标识符
+   * @returns 返回一个布尔值，表示删除操作是否成功
+   */
+  deleteVector(id: string): Promise<boolean>;
+  /**
+   * 更新数据库中指定ID的向量
+   * @param id - 要更新的向量的唯一标识符
+   * @param newVector - 新的向量，表示为数字数组
+   * @param newText - 新的关联文本
+   * @returns 返回一个布尔值，表示更新操作是否成功
+   */
+  updateVector(id: string, newVector: number[], newText: string): Promise<boolean>;
+  /**
+   * 获取数据库中向量的总数
+   * @returns 返回数据库中存储的向量总数
+   */
+  count(): Promise<number>;
+  /**
+   * 清空数据库中的所有向量
+   * @returns 无返回值
+   */
+  clear(): Promise<void>;
+}
+declare abstract class AbstractVectorDatabase implements VectorDatabase {
+  abstract addVector(vector: number[], text: string): Promise<string>;
+  abstract addVectors(vectors: number[][], texts: string[]): Promise<string[]>;
+  abstract search(queryVector: number[], k: number): Promise<Array<{
+    id: string;
+    score: number;
+    text: string;
+  }>>;
+  abstract getVector(id: string): Promise<{
+    vector: number[];
+    text: string;
+  } | null>;
+  abstract deleteVector(id: string): Promise<boolean>;
+  abstract clear(): Promise<void>;
+  abstract count(): Promise<number>;
+  abstract updateVector(id: string, newVector: number[], newText: string): Promise<boolean>;
+}
+//#endregion
+//#region src/rag/manager.d.ts
+declare class RAGManager {
+  private vectorDb;
+  private vectorizer;
+  constructor(vectorDb: VectorDatabase, vectorizer: Vectorizer);
+  /**
+   * 添加文档到 RAG 系统
+   * @param document 文档文本
+   * @param maxNum 最大分割数
+   */
+  addDocument(document: string, maxNum?: number): Promise<void>;
+  /**
+   * 执行 RAG 查询
+   * @param query 查询文本
+   * @param k 返回结果数量
+   * @returns 查询结果
+   */
+  query(query: string, k: number): Promise<RAGResult[]>;
+  /**
+   * 聚合检索出来的结果
+   * @param results 文本形式
+   * @param filterScore 过滤的最低分数
+   */
+  getAggregatedResults(results: RAGResult[], filterScore?: number): string;
+}
+//#endregion
+//#region src/rag/impl/VectorizerImpl.d.ts
+declare class VectorizerImpl implements Vectorizer {
+  private client;
+  private model;
+  private dimensions;
+  constructor(client: IClient, model: string, dimensions: number);
+  textToVector(text: string): Promise<number[]>;
+  batchTextToVector(texts: string[]): Promise<number[][]>;
+}
+//#endregion
+//#region src/types/document.d.ts
+type ParserType = 'docx' | 'xlsx' | 'pptx' | 'pdf' | 'txt' | 'other';
+type TypePredicate<T> = (value: unknown) => value is T;
+interface Parser<T> {
+  type: ParserType;
+  supportedExtensions: ValidExtension[];
+  isCompatibleType: TypePredicate<T>;
+  parse(document: T): Promise<string>;
+}
+type ValidExtension = `.${string}` | string;
+type FilePath = `${string}${ValidExtension}`;
+declare class DocumentPathParser implements Parser<FilePath> {
+  isCompatibleType(value: unknown): value is string;
+  supportedExtensions: ValidExtension[];
+  type: ParserType;
+  parse(document: FilePath): Promise<string>;
+}
+declare class DocumentFileParser implements Parser<Buffer> {
+  isCompatibleType(value: unknown): value is Buffer;
+  supportedExtensions: ValidExtension[];
+  type: ParserType;
+  parse(document: Buffer): Promise<string>;
+}
+//#endregion
+//#region src/rag/impl/PdfParser.d.ts
+declare class PdfFileParser extends DocumentPathParser {
+  constructor();
+  private initPromise;
+  valid: boolean;
+  type: ParserType;
+  supportedExtensions: string[];
+  private initializePdfParse;
+  ready(): Promise<void>;
+  parse(documentPath: string): Promise<string>;
+}
+declare class PdfBufferParser extends DocumentFileParser {
+  constructor();
+  private initPromise;
+  private initializePdfParse;
+  valid: boolean;
+  type: ParserType;
+  supportedExtensions: string[];
+  ready(): Promise<void>;
+  parse(buffer: Buffer): Promise<string>;
+}
+//#endregion
+//#region src/rag/impl/DocxParser.d.ts
+declare class DocxFileParser extends DocumentPathParser {
+  constructor();
+  type: ParserType;
+  supportedExtensions: string[];
+  parse(documentPath: string): Promise<string>;
+}
+declare class DocxBufferParser extends DocumentFileParser {
+  constructor();
+  type: ParserType;
+  supportedExtensions: string[];
+  parse(buffer: Buffer): Promise<string>;
+}
+//#endregion
+//#region src/rag/impl/PureTextParser.d.ts
+declare class PureTextFileParser extends DocumentPathParser {
+  constructor();
+  type: ParserType;
+  supportedExtensions: string[];
+  parse(documentPath: string): Promise<string>;
+}
+declare class PureTextBufferParser extends DocumentFileParser {
+  constructor();
+  type: ParserType;
+  supportedExtensions: string[];
+  parse(buffer: Buffer): Promise<string>;
+}
+//#endregion
+//#region src/rag/text.d.ts
+declare class TextProcessor {
+  private static readonly punctuationRegex;
+  private static readonly stopWords;
+  /**
+   * 将文本分割成小段落
+   * @param text 输入的长文本
+   * @param maxLength 每个段落的最大长度
+   * @returns 分割后的段落数组
+   */
+  static splitIntoChunks(text: string, maxLength: number): string[];
+  /**
+   * 清理和标准化文本
+   * @param text 输入文本
+   * @returns 清理后的文本
+   */
+  static cleanText(text: string): string;
+  /**
+   * 简单的分词（按空格分割英文，按字符分割中文）
+   * @param text 输入文本
+   * @returns 分词后的数组
+   */
+  static tokenize(text: string): string[];
+  /**
+   * 从文本中移除停用词
+   * @param text 输入文本
+   * @returns 移除停用词后的文本
+   */
+  static removeStopWords(text: string): string;
+  /**
+   * 提取文本中的关键词（基于简单频率）
+   * @param text 输入文本
+   * @param topN 返回的关键词数量
+   * @returns 关键词数组
+   */
+  static extractKeywords(text: string, topN?: number): string[];
+  /**
+   * 计算两个文本之间的简单相似度
+   * @param text1 第一个文本
+   * @param text2 第二个文本
+   * @returns 相似度分数（0-1之间）
+   */
+  static simpleSimilarity(text1: string, text2: string): number;
+}
+//#endregion
+//#region src/core/chaite.d.ts
+/**
+ * 入口
+ */
+declare class Chaite extends EventEmitter {
+  private channelsManager;
+  private toolsManager;
+  private processorsManager;
+  private chatPresetManager;
+  private toolsGroupManager;
+  private triggerManager;
+  private userModeSelector;
+  private userStateStorage;
+  private historyManager;
+  private logger;
+  private static instance;
+  private ragManager?;
+  private frontendAuthHandler;
+  private globalConfig?;
+  private expressApp?;
+  private constructor();
+  static init(channelsManager: ChannelsManager, toolsManager: ToolManager, processorsManager: ProcessorsManager, chatPresetManager: ChatPresetManager, toolsGroupManager: ToolsGroupManager, triggerManager: TriggerManager<TriggerDTO>, userModeSelector: UserModeSelector, userStateStorage: BasicStorage<UserState>, historyManager: HistoryManager | undefined, logger: ILogger): Chaite;
+  static getInstance(): Chaite;
+  onUpdateCustomConfig: (config: CustomConfig) => Promise<CustomConfig>;
+  setUpdateConfigCallback(callback: (config: CustomConfig) => Promise<CustomConfig>): void;
+  getCustomConfig: () => Promise<CustomConfig>;
+  setGetConfig(callback: () => Promise<CustomConfig>): void;
+  setRAGManager(ragManager: RAGManager): void;
+  getRAGManager(): RAGManager | undefined;
+  setGlobalConfig(globalConfig: GlobalConfig): void;
+  getGlobalConfig(): GlobalConfig | undefined;
+  setFrontendAuthHandler(frontendAuthHandler: FrontEndAuthHandler): void;
+  getFrontendAuthHandler(): FrontEndAuthHandler;
+  /**
+     * 对话
+     * @param message
+     * @param e
+     * @param options 包含对话id和消息id
+     */
+  sendMessage(message: UserMessage, e: EventMessage, options: SendMessageOption & {
+    chatPreset?: ChatPreset;
+  }): Promise<ModelResponse>;
+  getChannelsManager(): ChannelsManager;
+  setChannelsManager(channelsManager: ChannelsManager): void;
+  getToolsManager(): ToolManager;
+  setToolsManager(toolsManager: ToolManager): void;
+  getProcessorsManager(): ProcessorsManager;
+  setProcessorsManager(processorsManager: ProcessorsManager): void;
+  getChatPresetManager(): ChatPresetManager;
+  setChatPresetManager(chatPresetManager: ChatPresetManager): void;
+  getToolsGroupManager(): ToolsGroupManager;
+  setToolsGroupManager(toolsGroupManager: ToolsGroupManager): void;
+  getTriggerManager(): TriggerManager<TriggerDTO>;
+  setTriggerManager(triggerManager: TriggerManager<TriggerDTO>): void;
+  getUserModeSelector(): UserModeSelector;
+  setUserModeSelector(userModeSelector: UserModeSelector): void;
+  getUserStateStorage(): BasicStorage<UserState>;
+  setUserStateStorage(userStateStorage: BasicStorage<UserState>): void;
+  getHistoryManager(): HistoryManager;
+  setHistoryManager(historyManager: HistoryManager): void;
+  getLogger(): ILogger;
+  setLogger(logger: ILogger): void;
+  /**
+   * @deprecated Cloud service removed — local-only mode
+   */
+  setCloudService(_cloudServiceBaseUrl: string): void;
+  /**
+   * @deprecated Cloud service removed — local-only mode
+   */
+  auth(_apiKey: string): Promise<void>;
+  getExpressApp(): Application | undefined;
+  runApiServer(configureApp?: (app: Application) => void): Application;
+}
+//#endregion
+//#region src/types/common.d.ts
+declare const MultipleKeyStrategyChoice: {
+  RANDOM: MultipleKeyStrategy;
+  ROUND_ROBIN: MultipleKeyStrategy;
+  CONVERSATION_HASH: MultipleKeyStrategy;
+};
+type MultipleKeyStrategy = 'random' | 'round-robin' | 'conversation-hash';
+declare class BaseClientOptions implements Serializable, DeSerializable<BaseClientOptions>, Wait {
+  features: Feature[];
+  tools: Tool[];
+  baseUrl: string;
+  apiKey: string | string[];
+  multipleKeyStrategy?: MultipleKeyStrategy;
+  proxy?: string;
+  historyManager: HistoryManager;
+  logger?: ILogger;
+  postProcessorIds?: string[];
+  private postProcessors?;
+  preProcessorIds?: string[];
+  private preProcessors?;
+  constructor(options?: Partial<BaseClientOptions>);
+  static create(options: BaseClientOptions | Partial<BaseClientOptions>): BaseClientOptions;
+  private initPromise;
+  ready(): Promise<void>;
+  setHistoryManager(historyManager: HistoryManager): void;
+  setLogger(logger: ILogger): void;
+  getPostProcessors(): PostProcessor[];
+  getPreProcessors(): PreProcessor[];
+  init(): Promise<void>;
+  toString(): string;
+  fromString(str: string): BaseClientOptions;
+}
+interface ILogger {
+  debug(msg: object | string, ...args: never[]): void;
+  info(msg: object | string, ...args: never[]): void;
+  warn(msg: object | string, ...args: never[]): void;
+  error(msg: object | string, ...args: never[]): void;
+}
+declare const DefaultLogger: {
+  readonly name: string;
+  readonly enableColors: boolean;
+  formatDate(): string;
+  formatMessage(level: string, msg: object | string, args: never[]): string;
+  debug(msg: object | string, ...args: never[]): void;
+  error(msg: object | string, ...args: never[]): void;
+  info(msg: object | string, ...args: never[]): void;
+  warn(msg: object | string, ...args: never[]): void;
+};
+declare class ChaiteContext {
+  constructor(logger?: ILogger);
+  logger?: ILogger;
+  chaite: Chaite;
+  private options?;
+  private historyMessages?;
+  private event?;
+  private data?;
+  private client?;
+  setHistoryMessages(histories: HistoryMessage[]): void;
+  getHistoryMessages(): HistoryMessage[] | undefined;
+  setOptions(options: SendMessageOption): void;
+  getOptions(): SendMessageOption | undefined;
+  setEvent(event: EventMessage): void;
+  setChaite(chaite: Chaite): void;
+  getEvent(): EventMessage | undefined;
+  setData(data: Record<string, any>): void;
+  getData(): Record<string, any> | undefined;
+  setClient(client: AbstractClient): void;
+  getClient(): AbstractClient | undefined;
+  getChaite(): Chaite;
+}
+interface Into<U> {
+  into(): U;
+}
+interface From<T> {
+  from(value: T): this;
+}
+interface RAGResult {
+  content: string;
+  score: number;
+}
+interface Vectorizer {
+  /**
+   * 将文本转换为向量
+   * @param text 输入文本
+   * @returns 文本的向量表示
+   */
+  textToVector(text: string): Promise<number[]>;
+  /**
+   * 批量将文本转换为向量
+   * @param texts 输入文本数组
+   * @returns 文本向量数组
+   */
+  batchTextToVector(texts: string[]): Promise<number[][]>;
+}
+type CloudAPIType = 'tool' | 'processor' | 'chat-preset' | 'channel' | 'tool-group' | 'trigger';
+type CustomConfigValueType = string | number | boolean | object | undefined | null | CustomConfigValueType[];
+type CustomConfig = Record<string, CustomConfigValueType | Record<string, CustomConfigValueType>>;
+//#endregion
+//#region src/types/tools.d.ts
+interface Function {
+  name: string;
+  description: string;
+  parameters: Parameter;
+}
+interface Parameter {
+  type: 'object';
+  properties: Record<string, Property>;
+  required: string[];
+}
+interface Property {
+  type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+  description: string | null;
+}
+interface Tool {
+  name: Function['name'];
+  type: 'function';
+  function: Function;
+  run(args: Record<string, ArgumentValue | Record<string, ArgumentValue>>, chaiteContext?: ChaiteContext): Promise<string>;
+}
+declare class ToolDTO extends AbstractShareable<ToolDTO> {
+  constructor(params: Partial<ToolDTO>);
+  status: 'enabled' | 'disabled';
+  permission: 'public' | 'private' | 'onetime';
+  toFormatedString(_verbose?: boolean): string;
+  fromString(str: string): ToolDTO;
+}
+/**
+ * 工具组，与若干个工具关联
+ */
+interface ToolsGroup {
+  id: string;
+  name: string;
+  description: string;
+  toolIds: string[];
+  isDefault?: boolean;
+}
+declare class ToolsGroupDTO extends AbstractShareable<ToolsGroupDTO> implements ToolsGroup {
+  constructor(params: Partial<ToolsGroupDTO>);
+  toolIds: string[];
+  isDefault?: boolean | undefined;
+  toFormatedString(_verbose?: boolean): string;
+}
+/**
+ * js写的工具可以继承这个抽象类
+ */
+declare abstract class CustomTool implements Tool {
+  constructor();
+  type: "function";
+  function: Function;
+  run(_args: Record<string, ArgumentValue | Record<string, ArgumentValue>>, _context?: ChaiteContext): Promise<string>;
+  name: Function['name'];
+}
+//#endregion
+//#region src/types/channel.d.ts
+declare class ChannelStatistics implements Serializable, DeSerializable<ChannelStatistics> {
+  callTimes?: number;
+  useToken?: number;
+  perModel: Record<string, Omit<ChannelStatistics, 'perModel'>>;
+  fromString(str: string): ChannelStatistics;
+  toString(): string;
+}
+interface ChannelsLoadBalancer {
+  getChannel(model: string, channels: Channel[]): Promise<Channel | null>;
+  getChannels(model: string, channels: Channel[], totalQuantity: number): Promise<{
+    channel: Channel;
+    quantity: number;
+  }[]>;
+}
+//#endregion
+//#region src/types/storage.d.ts
+/**
+ * 基本存储接口
+ */
+interface BasicStorage<T> {
+  getName(): string;
+  getItem(key: string): Promise<T | null>;
+  setItem(key: string, value: T): Promise<string>;
+  removeItem(key: string): Promise<void>;
+  listItems(): Promise<T[]>;
+  listItemsByEqFilter(filter: Record<string, unknown>): Promise<T[]>;
+  listItemsByInQuery(query: Array<{
+    field: string;
+    values: unknown[];
+  }>): Promise<T[]>;
+  clear(): Promise<void>;
+}
+declare abstract class ChaiteStorage<T> implements BasicStorage<T> {
+  abstract getItem(key: string): Promise<T | null>;
+  abstract setItem(key: string, value: T): Promise<string>;
+  abstract removeItem(key: string): Promise<void>;
+  abstract listItems(): Promise<T[]>;
+  abstract listItemsByEqFilter(filter: Record<string, unknown>): Promise<T[]>;
+  abstract listItemsByInQuery(query: Array<{
+    field: string;
+    values: unknown[];
+  }>): Promise<T[]>;
+  abstract clear(): Promise<void>;
+  getName(): string;
+}
+interface UserState {
+  userId: number | string;
+  nickname?: string;
+  card?: string;
+  conversations: Conversation[];
+  settings: UserSettings;
+  current: {
+    conversationId?: string;
+    messageId?: string;
+  };
+}
+interface Conversation {
+  id: string;
+  name: string;
+  lastMessageId: string;
+}
+interface UserSettings {
+  preset: string;
+  model: string;
+  temperature: number;
+  maxToken: number;
+  systemOverride: string;
+  enableReasoning: boolean;
+  reasoningEffort: 'high' | 'medium' | 'low' | 'minimal';
+  reasoningBudgetTokens: number;
+  toolChoice: ToolChoice;
+}
+//#endregion
+//#region src/types/server.d.ts
+declare class ChaiteResponse<T> {
+  private code;
+  private data;
+  private message;
+  constructor(code: number, data: T, message: string);
+  static ok<T>(data: T): ChaiteResponse<T>;
+  static okm<T>(data: T, msg: string): ChaiteResponse<T>;
+  static fail<T>(data: T, msg: string): ChaiteResponse<T>;
+  static failc<T>(data: T, msg: string, code: number): ChaiteResponse<T>;
+}
+//#endregion
+//#region src/types/trigger.d.ts
+declare class TriggerDTO extends AbstractShareable<TriggerDTO> {
+  constructor(params: Partial<TriggerDTO>);
+  status: 'enabled' | 'disabled';
+  isOneTime?: boolean;
+  fromString(str: string): TriggerDTO;
+  toFormatedString(verbose?: boolean): string;
+}
+interface Trigger {
+  name: string;
+  isOneTime?: boolean;
+  register(context: ChaiteContext): Promise<void>;
+  unregister(): Promise<void>;
+  queryLLM(message: UserMessage, options: SendMessageOption & {
+    chatPreset?: ChatPreset;
+  }): Promise<ModelResponse>;
+}
+declare abstract class BaseTrigger implements Trigger {
+  name: string;
+  isOneTime?: boolean;
+  private triggerExecuted;
+  constructor(params: {
+    name: string;
+    isOneTime?: boolean;
+  });
+  protected abstract registerImpl(context: ChaiteContext): Promise<void>;
+  protected abstract unregisterImpl(): Promise<void>;
+  register(context: ChaiteContext): Promise<void>;
+  unregister(): Promise<void>;
+  protected checkOneTimeAndCleanup(): Promise<boolean>;
+  protected triggerAction(action: () => Promise<void>): Promise<void>;
+  queryLLM(message: UserMessage, options: SendMessageOption & {
+    chatPreset?: ChatPreset;
+  }): Promise<ModelResponse>;
+}
+declare abstract class CronTrigger extends BaseTrigger {
+  protected cronExpression: string;
+  protected cronJob?: Job;
+  constructor(params: {
+    name: string;
+    description: string;
+    cronExpression: string;
+    isOneTime?: boolean;
+  });
+  protected registerImpl(context: ChaiteContext): Promise<void>;
+  protected unregisterImpl(): Promise<void>;
+  unregister(): Promise<void>;
+  protected abstract execute(context: ChaiteContext): Promise<void>;
+}
+declare abstract class EventTrigger extends BaseTrigger {
+  protected bot: EventEmitter;
+  protected eventName: string;
+  protected eventHandler: (...args: any[]) => void;
+  private isRegistered;
+  constructor(params: {
+    id: string;
+    name: string;
+    description: string;
+    eventName: string;
+    bot: EventEmitter;
+    isOneTime?: boolean;
+  });
+  register(context: ChaiteContext): Promise<void>;
+  unregister(): Promise<void>;
+  protected abstract handleEvent(...args: any[]): Promise<void>;
+}
+//#endregion
+//#region src/const/map.d.ts
+declare const CHANNEL_STATUS_MAP: {
+  enabled: string;
+  disabled: string;
+};
+declare const PROCESSOR_TYPE_MAP: {
+  pre: string;
+  post: string;
+};
+//#endregion
+//#region src/version.d.ts
+declare const VERSION = "1.9.3";
+//#endregion
+//#region src/controllers/index.d.ts
+declare function createApp(configure?: (app: Application) => void): Application;
+declare function runServer(host: string, port: number, configure?: (app: Application) => void): {
+  app: Application;
+  server: Server;
+};
+//#endregion
+export { AbstractClient, AbstractHistoryManager, AbstractShareable, AbstractUserModeSelector, AbstractVectorDatabase, ArgumentValue, AssistantMessage, AudioContent, BaseClientOptions, BaseTrigger, BasicStorage, CHANNEL_STATUS_MAP, Chaite, ChaiteContext, ChaiteResponse, ChaiteStorage, Channel, ChannelStatistics, ChannelsLoadBalancer, ChannelsManager, ChatPreset, ChatPresetManager, ClaudeClient, ClientType, CloudAPIResponse, CloudAPIType, CloudModel, CloudSharingService, Conversation, CronTrigger, CustomConfig, CustomConfigValueType, CustomTool, DEFAULT_HOST, DEFAULT_PORT, DeSerializable, DefaultChannelLoadBalancer, DefaultCloudService, DefaultLogger, DeveloperMessage, DocumentFileParser, DocumentPathParser, DocxBufferParser, DocxFileParser, EmbeddingOption, EmbeddingResult, EventMessage, EventTrigger, ExecutableSShareableType, ExecutableShareableManager, Feature, FilePath, Filter, From, FrontEndAuthHandler, Function, FunctionCall, GeminiClient, GeminiClientOptions, GlobalConfig, History, HistoryManager, HistoryMessage, IClient, ILogger, IMessage, ImageContent, InMemoryHistoryManager, Into, KVHistoryManager, KVStore, MessageContent, ModelResponse, ModelResponseChunk, ModelUsage, MultipleKeyStrategy, MultipleKeyStrategyChoice, NonExecutableSShareableType, NonExecutableShareableManager, OpenAIClient, OpenAIClientOptions, PROCESSOR_TYPE_MAP, PaginationResult, Parameter, Parser, ParserType, PdfBufferParser, PdfFileParser, PostProcessor, PreProcessor, Processor, ProcessorDTO, ProcessorsManager, Property, PureTextBufferParser, PureTextFileParser, RAGManager, RAGResult, ReasoningContent, ReasoningPart, Role, SearchOption, SendMessageOption, Serializable, Shareable, SystemMessage, TextContent, TextProcessor, Tool, ToolCall, ToolCallLimitConfig, ToolCallResult, ToolCallResultMessage, ToolChoice, ToolDTO, ToolManager, ToolsGroup, ToolsGroupDTO, ToolsGroupManager, Trigger, TriggerDTO, TriggerManager, User, UserMessage, UserModeSelector, UserSettings, UserState, VERSION, ValidExtension, VectorDatabase, Vectorizer, VectorizerImpl, Wait, asyncLocalStorage, createApp, createClient, extractClassName, getKey, getLogger, runServer, saveAndLoadModule, useEvent };