mozi-bot 1.0.0

package/dist/gateway/index.js

@@ -0,0 +1,5 @@
+/**
+ * Gateway 导出
+ */
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/gateway/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/gateway/server.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Gateway 服务器 - HTTP Webhook 处理 + WebChat
+ */
+import { type Express } from "express";
+import type { MoziConfig } from "../types/index.js";
+export declare class Gateway {
+    private app;
+    private httpServer;
+    private config;
+    private agent;
+    private feishuChannel?;
+    private dingtalkChannel?;
+    private wsServer?;
+    /** 已处理的消息 ID 缓存（用于去重） */
+    private processedMessages;
+    /** 消息缓存过期时间 (5分钟) */
+    private readonly MESSAGE_CACHE_TTL;
+    constructor(config: MoziConfig);
+    /** 设置中间件 */
+    private setupMiddleware;
+    /** 设置路由 */
+    private setupRoutes;
+    /** 处理入站消息 */
+    private handleMessage;
+    /** 发送回复 */
+    private sendReply;
+    /** 检查是否为重复消息 */
+    private isDuplicateMessage;
+    /** 初始化 */
+    initialize(): Promise<void>;
+    /** 启动服务器 */
+    start(): Promise<void>;
+    /** 关闭 */
+    shutdown(): Promise<void>;
+    /** 获取 Express 应用 */
+    getApp(): Express;
+}
+/** 创建 Gateway */
+export declare function createGateway(config: MoziConfig): Gateway;
+/** 启动 Gateway 服务器 */
+export declare function startGateway(config: MoziConfig): Promise<Gateway>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/gateway/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAgB,EAAE,KAAK,OAAO,EAA+B,MAAM,SAAS,CAAC;AAE7E,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAY3E,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,yBAAyB;IACzB,OAAO,CAAC,iBAAiB,CAA6B;IACtD,qBAAqB;IACrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;gBAEvC,MAAM,EAAE,UAAU;IAU9B,YAAY;IACZ,OAAO,CAAC,eAAe;IAWvB,WAAW;IACX,OAAO,CAAC,WAAW;IA4CnB,aAAa;YACC,aAAa;IA6C3B,WAAW;YACG,SAAS;IAkBvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAoB1B,UAAU;IACJ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBjC,YAAY;IACN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B,SAAS;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB/B,oBAAoB;IACpB,MAAM,IAAI,OAAO;CAGlB;AAED,iBAAiB;AACjB,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED,qBAAqB;AACrB,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBvE"}

package/dist/gateway/server.js

@@ -0,0 +1,235 @@
+/**
+ * Gateway 服务器 - HTTP Webhook 处理 + WebChat
+ */
+import express from "express";
+import { createServer } from "http";
+import { createFeishuChannel } from "../channels/feishu/index.js";
+import { createDingtalkChannel } from "../channels/dingtalk/index.js";
+import { registerChannel } from "../channels/common/index.js";
+import { createAgent } from "../agents/agent.js";
+import { initializeProviders } from "../providers/index.js";
+import { getChildLogger, setLogger, createLogger } from "../utils/logger.js";
+import { WsServer } from "../web/websocket.js";
+import { handleStaticRequest } from "../web/static.js";
+const logger = getChildLogger("gateway");
+export class Gateway {
+    app;
+    httpServer;
+    config;
+    agent;
+    feishuChannel;
+    dingtalkChannel;
+    wsServer;
+    /** 已处理的消息 ID 缓存（用于去重） */
+    processedMessages = new Map();
+    /** 消息缓存过期时间 (5分钟) */
+    MESSAGE_CACHE_TTL = 5 * 60 * 1000;
+    constructor(config) {
+        this.config = config;
+        this.app = express();
+        this.httpServer = createServer(this.app);
+        this.agent = createAgent(config);
+        this.setupMiddleware();
+        this.setupRoutes();
+    }
+    /** 设置中间件 */
+    setupMiddleware() {
+        this.app.use(express.json());
+        this.app.use(express.urlencoded({ extended: true }));
+        // 请求日志
+        this.app.use((req, res, next) => {
+            logger.debug({ method: req.method, path: req.path }, "Incoming request");
+            next();
+        });
+    }
+    /** 设置路由 */
+    setupRoutes() {
+        // 健康检查
+        this.app.get("/health", (req, res) => {
+            res.json({ status: "ok", timestamp: new Date().toISOString() });
+        });
+        // 飞书 Webhook
+        if (this.config.channels.feishu) {
+            this.feishuChannel = createFeishuChannel(this.config.channels.feishu);
+            this.feishuChannel.setMessageHandler(this.handleMessage.bind(this));
+            this.app.use("/feishu", this.feishuChannel.createRouter());
+            registerChannel(this.feishuChannel);
+            logger.info("Feishu webhook enabled at /feishu/webhook");
+        }
+        // 钉钉 Webhook
+        if (this.config.channels.dingtalk) {
+            this.dingtalkChannel = createDingtalkChannel(this.config.channels.dingtalk);
+            this.dingtalkChannel.setMessageHandler(this.handleMessage.bind(this));
+            this.app.use("/dingtalk", this.dingtalkChannel.createRouter());
+            registerChannel(this.dingtalkChannel);
+            logger.info("DingTalk webhook enabled at /dingtalk/webhook");
+        }
+        // WebChat 静态文件服务 (放在其他路由之后，作为默认处理)
+        this.app.use((req, res, next) => {
+            const handled = handleStaticRequest(req, res, { config: this.config });
+            if (!handled) {
+                next();
+            }
+        });
+        // 404 处理
+        this.app.use((req, res) => {
+            res.status(404).json({ error: "Not found" });
+        });
+        // 错误处理
+        this.app.use((err, req, res, next) => {
+            logger.error({ error: err }, "Unhandled error");
+            res.status(500).json({ error: "Internal server error" });
+        });
+    }
+    /** 处理入站消息 */
+    async handleMessage(context) {
+        // 消息去重检查
+        if (this.isDuplicateMessage(context.messageId)) {
+            logger.debug({ messageId: context.messageId }, "Skipping duplicate message");
+            return;
+        }
+        logger.info({
+            channel: context.channelId,
+            chatId: context.chatId,
+            senderId: context.senderId,
+            content: context.content.slice(0, 100),
+        }, "Received message");
+        // 忽略空消息
+        if (!context.content.trim()) {
+            return;
+        }
+        try {
+            // 处理消息
+            const response = await this.agent.processMessage(context);
+            // 发送回复
+            await this.sendReply(context, response.content);
+            logger.info({
+                channel: context.channelId,
+                chatId: context.chatId,
+                responseLength: response.content.length,
+            }, "Reply sent");
+        }
+        catch (error) {
+            logger.error({ error, context }, "Failed to process message");
+            // 发送错误提示
+            await this.sendReply(context, "抱歉，处理您的消息时出现了错误。请稍后重试。");
+        }
+    }
+    /** 发送回复 */
+    async sendReply(context, text) {
+        switch (context.channelId) {
+            case "feishu":
+                if (this.feishuChannel) {
+                    await this.feishuChannel.sendText(context.chatId, text, context.messageId);
+                }
+                break;
+            case "dingtalk":
+                if (this.dingtalkChannel) {
+                    // 尝试使用 session webhook 回复
+                    const dingtalkContext = context;
+                    await this.dingtalkChannel.replyWithSession(dingtalkContext, text);
+                }
+                break;
+        }
+    }
+    /** 检查是否为重复消息 */
+    isDuplicateMessage(messageId) {
+        const now = Date.now();
+        // 清理过期的消息缓存
+        for (const [id, timestamp] of this.processedMessages) {
+            if (now - timestamp > this.MESSAGE_CACHE_TTL) {
+                this.processedMessages.delete(id);
+            }
+        }
+        // 检查消息是否已处理
+        if (this.processedMessages.has(messageId)) {
+            return true;
+        }
+        // 标记为已处理
+        this.processedMessages.set(messageId, now);
+        return false;
+    }
+    /** 初始化 */
+    async initialize() {
+        logger.info("Initializing gateway...");
+        // 初始化模型提供商
+        initializeProviders(this.config);
+        // 初始化 WebSocket 服务器
+        this.wsServer = new WsServer({
+            server: this.httpServer,
+            agent: this.agent,
+            config: this.config,
+        });
+        // 初始化通道
+        if (this.feishuChannel) {
+            await this.feishuChannel.initialize();
+        }
+        if (this.dingtalkChannel) {
+            await this.dingtalkChannel.initialize();
+        }
+        logger.info("Gateway initialized");
+    }
+    /** 启动服务器 */
+    async start() {
+        await this.initialize();
+        const { port, host } = this.config.server;
+        this.httpServer.listen(port, host || "0.0.0.0", () => {
+            logger.info({ port, host: host || "0.0.0.0" }, "Gateway server started");
+            console.log(`\n🚀 Mozi Gateway 已启动`);
+            console.log(`   地址: http://${host || "localhost"}:${port}`);
+            console.log(`   WebChat: http://${host || "localhost"}:${port}/`);
+            console.log(`   控制台: http://${host || "localhost"}:${port}/control`);
+            console.log(`   健康检查: http://${host || "localhost"}:${port}/health`);
+            if (this.feishuChannel) {
+                console.log(`   飞书 Webhook: http://${host || "localhost"}:${port}/feishu/webhook`);
+            }
+            if (this.dingtalkChannel) {
+                console.log(`   钉钉 Webhook: http://${host || "localhost"}:${port}/dingtalk/webhook`);
+            }
+            console.log("");
+        });
+    }
+    /** 关闭 */
+    async shutdown() {
+        logger.info("Shutting down gateway...");
+        if (this.wsServer) {
+            this.wsServer.close();
+        }
+        if (this.feishuChannel) {
+            await this.feishuChannel.shutdown();
+        }
+        if (this.dingtalkChannel) {
+            await this.dingtalkChannel.shutdown();
+        }
+        this.httpServer.close();
+        logger.info("Gateway shut down");
+    }
+    /** 获取 Express 应用 */
+    getApp() {
+        return this.app;
+    }
+}
+/** 创建 Gateway */
+export function createGateway(config) {
+    return new Gateway(config);
+}
+/** 启动 Gateway 服务器 */
+export async function startGateway(config) {
+    // 设置日志
+    setLogger(createLogger({ level: config.logging.level }));
+    const gateway = createGateway(config);
+    await gateway.start();
+    // 优雅关闭
+    process.on("SIGINT", async () => {
+        console.log("\n收到 SIGINT 信号，正在关闭...");
+        await gateway.shutdown();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        console.log("\n收到 SIGTERM 信号，正在关闭...");
+        await gateway.shutdown();
+        process.exit(0);
+    });
+    return gateway;
+}
+//# sourceMappingURL=server.js.map

package/dist/gateway/server.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Hooks 系统 - 事件钩子
+ */
+import type { InboundMessageContext, ChatMessage, ProviderId } from "../types/index.js";
+/** Hook 事件类型 */
+export type HookEventType = "message_received" | "message_sending" | "message_sent" | "agent_start" | "agent_end" | "tool_start" | "tool_end" | "session_start" | "session_end" | "compaction_start" | "compaction_end" | "error";
+/** Hook 事件数据基础 */
+interface HookEventBase {
+    type: HookEventType;
+    timestamp: number;
+    sessionKey?: string;
+}
+/** 消息接收事件 */
+export interface MessageReceivedEvent extends HookEventBase {
+    type: "message_received";
+    context: InboundMessageContext;
+}
+/** 消息发送事件 */
+export interface MessageSendingEvent extends HookEventBase {
+    type: "message_sending";
+    channelId: string;
+    chatId: string;
+    content: string;
+    replyToId?: string;
+}
+/** 消息已发送事件 */
+export interface MessageSentEvent extends HookEventBase {
+    type: "message_sent";
+    channelId: string;
+    chatId: string;
+    messageId?: string;
+    success: boolean;
+}
+/** Agent 开始事件 */
+export interface AgentStartEvent extends HookEventBase {
+    type: "agent_start";
+    provider: ProviderId;
+    model: string;
+    messages: ChatMessage[];
+}
+/** Agent 结束事件 */
+export interface AgentEndEvent extends HookEventBase {
+    type: "agent_end";
+    provider: ProviderId;
+    model: string;
+    response: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    durationMs: number;
+}
+/** 工具开始事件 */
+export interface ToolStartEvent extends HookEventBase {
+    type: "tool_start";
+    toolName: string;
+    toolCallId: string;
+    arguments: unknown;
+}
+/** 工具结束事件 */
+export interface ToolEndEvent extends HookEventBase {
+    type: "tool_end";
+    toolName: string;
+    toolCallId: string;
+    result: unknown;
+    isError: boolean;
+    durationMs: number;
+}
+/** 会话开始事件 */
+export interface SessionStartEvent extends HookEventBase {
+    type: "session_start";
+    channelId: string;
+    chatId: string;
+    senderId: string;
+}
+/** 会话结束事件 */
+export interface SessionEndEvent extends HookEventBase {
+    type: "session_end";
+    messageCount: number;
+    totalTokens: number;
+}
+/** 压缩开始事件 */
+export interface CompactionStartEvent extends HookEventBase {
+    type: "compaction_start";
+    messageCount: number;
+    estimatedTokens: number;
+}
+/** 压缩结束事件 */
+export interface CompactionEndEvent extends HookEventBase {
+    type: "compaction_end";
+    compactedMessages: number;
+    summaryLength: number;
+    durationMs: number;
+}
+/** 错误事件 */
+export interface ErrorEvent extends HookEventBase {
+    type: "error";
+    error: Error;
+    context?: string;
+}
+/** 所有事件类型 */
+export type HookEvent = MessageReceivedEvent | MessageSendingEvent | MessageSentEvent | AgentStartEvent | AgentEndEvent | ToolStartEvent | ToolEndEvent | SessionStartEvent | SessionEndEvent | CompactionStartEvent | CompactionEndEvent | ErrorEvent;
+/** Hook 处理器 */
+export type HookHandler<T extends HookEvent = HookEvent> = (event: T) => void | Promise<void>;
+/** Hook 处理器带返回值 (用于修改事件) */
+export type HookTransformer<T extends HookEvent = HookEvent> = (event: T) => T | Promise<T>;
+/** 注册 Hook */
+export declare function registerHook<T extends HookEventType>(eventType: T, handler: HookHandler): () => void;
+/** 批量注册 Hooks */
+export declare function registerHooks(hooks: Partial<Record<HookEventType, HookHandler>>): () => void;
+/** 触发 Hook */
+export declare function triggerHook(event: HookEvent): Promise<void>;
+/** 同步触发 Hook (不等待) */
+export declare function triggerHookSync(event: HookEvent): void;
+/** 清除所有 Hooks */
+export declare function clearHooks(): void;
+/** 获取已注册的 Hook 数量 */
+export declare function getHookCount(eventType?: HookEventType): number;
+/** 触发消息接收事件 */
+export declare function emitMessageReceived(context: InboundMessageContext): void;
+/** 触发消息发送事件 */
+export declare function emitMessageSending(params: {
+    channelId: string;
+    chatId: string;
+    content: string;
+    replyToId?: string;
+    sessionKey?: string;
+}): void;
+/** 触发 Agent 开始事件 */
+export declare function emitAgentStart(params: {
+    provider: ProviderId;
+    model: string;
+    messages: ChatMessage[];
+    sessionKey?: string;
+}): void;
+/** 触发 Agent 结束事件 */
+export declare function emitAgentEnd(params: {
+    provider: ProviderId;
+    model: string;
+    response: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    durationMs: number;
+    sessionKey?: string;
+}): void;
+/** 触发工具事件 */
+export declare function emitToolStart(params: {
+    toolName: string;
+    toolCallId: string;
+    arguments: unknown;
+    sessionKey?: string;
+}): void;
+export declare function emitToolEnd(params: {
+    toolName: string;
+    toolCallId: string;
+    result: unknown;
+    isError: boolean;
+    durationMs: number;
+    sessionKey?: string;
+}): void;
+/** 触发错误事件 */
+export declare function emitError(error: Error, context?: string): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/hooks/index.js

@@ -0,0 +1,148 @@
+/**
+ * Hooks 系统 - 事件钩子
+ */
+import { getChildLogger } from "../utils/logger.js";
+const logger = getChildLogger("hooks");
+/** Hook 注册表 */
+const hookRegistry = new Map();
+// ============== Hook 管理 ==============
+/** 注册 Hook */
+export function registerHook(eventType, handler) {
+    const handlers = hookRegistry.get(eventType) ?? [];
+    handlers.push(handler);
+    hookRegistry.set(eventType, handlers);
+    logger.debug({ eventType }, "Hook registered");
+    // 返回取消注册函数
+    return () => {
+        const currentHandlers = hookRegistry.get(eventType);
+        if (currentHandlers) {
+            const index = currentHandlers.indexOf(handler);
+            if (index >= 0) {
+                currentHandlers.splice(index, 1);
+            }
+        }
+    };
+}
+/** 批量注册 Hooks */
+export function registerHooks(hooks) {
+    const unsubscribers = [];
+    for (const [eventType, handler] of Object.entries(hooks)) {
+        if (handler) {
+            unsubscribers.push(registerHook(eventType, handler));
+        }
+    }
+    return () => {
+        for (const unsubscribe of unsubscribers) {
+            unsubscribe();
+        }
+    };
+}
+/** 触发 Hook */
+export async function triggerHook(event) {
+    const handlers = hookRegistry.get(event.type);
+    if (!handlers || handlers.length === 0)
+        return;
+    for (const handler of handlers) {
+        try {
+            await handler(event);
+        }
+        catch (error) {
+            logger.error({ error, eventType: event.type }, "Hook handler error");
+        }
+    }
+}
+/** 同步触发 Hook (不等待) */
+export function triggerHookSync(event) {
+    triggerHook(event).catch((error) => {
+        logger.error({ error, eventType: event.type }, "Hook trigger error");
+    });
+}
+/** 清除所有 Hooks */
+export function clearHooks() {
+    hookRegistry.clear();
+}
+/** 获取已注册的 Hook 数量 */
+export function getHookCount(eventType) {
+    if (eventType) {
+        return hookRegistry.get(eventType)?.length ?? 0;
+    }
+    let count = 0;
+    for (const handlers of hookRegistry.values()) {
+        count += handlers.length;
+    }
+    return count;
+}
+// ============== 便捷函数 ==============
+/** 创建事件基础数据 */
+function createEventBase(type, sessionKey) {
+    return {
+        type,
+        timestamp: Date.now(),
+        sessionKey,
+    };
+}
+/** 触发消息接收事件 */
+export function emitMessageReceived(context) {
+    triggerHookSync({
+        ...createEventBase("message_received"),
+        context,
+    });
+}
+/** 触发消息发送事件 */
+export function emitMessageSending(params) {
+    triggerHookSync({
+        ...createEventBase("message_sending", params.sessionKey),
+        channelId: params.channelId,
+        chatId: params.chatId,
+        content: params.content,
+        replyToId: params.replyToId,
+    });
+}
+/** 触发 Agent 开始事件 */
+export function emitAgentStart(params) {
+    triggerHookSync({
+        ...createEventBase("agent_start", params.sessionKey),
+        provider: params.provider,
+        model: params.model,
+        messages: params.messages,
+    });
+}
+/** 触发 Agent 结束事件 */
+export function emitAgentEnd(params) {
+    triggerHookSync({
+        ...createEventBase("agent_end", params.sessionKey),
+        provider: params.provider,
+        model: params.model,
+        response: params.response,
+        usage: params.usage,
+        durationMs: params.durationMs,
+    });
+}
+/** 触发工具事件 */
+export function emitToolStart(params) {
+    triggerHookSync({
+        ...createEventBase("tool_start", params.sessionKey),
+        toolName: params.toolName,
+        toolCallId: params.toolCallId,
+        arguments: params.arguments,
+    });
+}
+export function emitToolEnd(params) {
+    triggerHookSync({
+        ...createEventBase("tool_end", params.sessionKey),
+        toolName: params.toolName,
+        toolCallId: params.toolCallId,
+        result: params.result,
+        isError: params.isError,
+        durationMs: params.durationMs,
+    });
+}
+/** 触发错误事件 */
+export function emitError(error, context) {
+    triggerHookSync({
+        ...createEventBase("error"),
+        error,
+        context,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Mozi - 国产AI模型 + 国产通讯软件的智能助手
+ *
+ * 主入口文件
+ */
+export * from "./types/index.js";
+export { loadConfig, validateRequiredConfig } from "./config/index.js";
+export { BaseProvider, DeepSeekProvider, KimiProvider, StepfunProvider, MiniMaxProvider, createDeepSeekProvider, createKimiProvider, createStepfunProvider, createMiniMaxProvider, initializeProviders, getProvider, getAllProviders, findProviderForModel, getAllModels, } from "./providers/index.js";
+export { BaseChannelAdapter, FeishuChannel, DingtalkChannel, createFeishuChannel, createDingtalkChannel, FeishuApiClient, DingtalkApiClient, registerChannel, getChannel, getAllChannels, setGlobalMessageHandler, } from "./channels/index.js";
+export { Agent, createAgent, estimateTokens, estimateMessagesTokens, summarizeInStages, limitHistoryTurns, pruneHistoryForContextShare, FailoverError, runWithModelFallback, } from "./agents/index.js";
+export { type Tool, type ToolCall, type ToolCallResult, type ToolResult, registerTool, registerTools, getTool, getAllTools, filterToolsByPolicy, executeToolCalls, toolsToOpenAIFunctions, createBuiltinTools, jsonResult, errorResult, textResult, } from "./tools/index.js";
+export { type HookEventType, type HookEvent, type HookHandler, registerHook, registerHooks, triggerHook, triggerHookSync, clearHooks, getHookCount, emitMessageReceived, emitMessageSending, emitAgentStart, emitAgentEnd, emitToolStart, emitToolEnd, emitError, } from "./hooks/index.js";
+export { type PluginMeta, type PluginApi, type PluginDefinition, registerPlugin, unregisterPlugin, getLoadedPlugins, isPluginLoaded, unregisterAllPlugins, definePlugin, defineToolPlugin, } from "./plugins/index.js";
+export { type CommandContext, type CommandHandler, type CommandDefinition, registerCommand, registerCommands, getCommand, getAllCommands, isCommand, parseCommand, executeCommand, registerBuiltinCommands, } from "./commands/index.js";
+export { Gateway, createGateway, startGateway } from "./gateway/index.js";
+export { getLogger, createLogger, setLogger, getChildLogger } from "./utils/logger.js";
+export { generateId, getEnvVar, requireEnvVar, delay, retry, truncate, safeJsonParse, deepMerge, computeHmacSha256, aesDecrypt, } from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACd,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,EACL,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,aAAa,EACb,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,YAAY,EACZ,aAAa,EACb,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,SAAS,GACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,cAAc,EACd,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,KAAK,EACL,KAAK,EACL,QAAQ,EACR,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,UAAU,GACX,MAAM,kBAAkB,CAAC"}