mozi-bot 1.0.0

package/dist/agents/agent.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Agent - 消息处理核心 (增强版)
+ * 支持 OpenAI 原生 function calling 和 tool 消息格式
+ */
+import type { InboundMessageContext, MoziConfig, ProviderId } from "../types/index.js";
+import { type Tool, type ToolCallResult } from "../tools/index.js";
+import { type FallbackAttempt } from "./model-fallback.js";
+import { type SessionStore } from "./session-store.js";
+/** Agent 配置 */
+export interface AgentOptions {
+    /** 默认模型 */
+    model: string;
+    /** 默认提供商 */
+    provider?: ProviderId;
+    /** 系统提示 */
+    systemPrompt?: string;
+    /** 温度 */
+    temperature?: number;
+    /** 最大输出 token */
+    maxTokens?: number;
+    /** 最大历史消息数 */
+    maxHistoryMessages?: number;
+    /** 最大历史轮次 */
+    maxHistoryTurns?: number;
+    /** 上下文窗口大小 */
+    contextWindow?: number;
+    /** 是否启用工具 */
+    enableTools?: boolean;
+    /** 工具策略 */
+    toolPolicy?: {
+        allow?: string[];
+        deny?: string[];
+    };
+    /** 是否启用自动压缩 */
+    enableCompaction?: boolean;
+    /** 压缩阈值 (token 数) */
+    compactionThreshold?: number;
+    /** 模型回退列表 */
+    fallbacks?: Array<{
+        provider: ProviderId;
+        model: string;
+    }>;
+    /** 最大工具调用轮次 */
+    maxToolRounds?: number;
+    /** 工作目录 */
+    workingDirectory?: string;
+    /** 是否启用原生 function calling */
+    enableFunctionCalling?: boolean;
+    /** 会话存储 */
+    sessionStore?: SessionStore;
+}
+/** Agent 响应 */
+export interface AgentResponse {
+    content: string;
+    toolCalls?: ToolCallResult[];
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    provider: ProviderId;
+    model: string;
+    fallbackAttempts?: FallbackAttempt[];
+}
+/** Agent 类 */
+export declare class Agent {
+    private options;
+    private tools;
+    private openaiTools;
+    constructor(options: AgentOptions);
+    /** 初始化工具 */
+    private initializeTools;
+    /** 注册自定义工具 */
+    registerTool(tool: Tool): void;
+    /** 处理消息 */
+    processMessage(context: InboundMessageContext): Promise<AgentResponse>;
+    /** 执行对话 (包含原生 function calling) */
+    private executeWithTools;
+    /** 解析工具参数 */
+    private parseToolArguments;
+    /** 格式化工具结果为字符串 */
+    private formatToolResult;
+    /** 获取工具参数预览 (Claude Code 风格) */
+    private getToolArgsPreview;
+    /** 获取错误信息预览 */
+    private getErrorPreview;
+    /** 流式处理消息 (支持原生 function calling) */
+    processMessageStream(context: InboundMessageContext): AsyncGenerator<string, AgentResponse, unknown>;
+    /** 获取会话键 */
+    private getSessionKey;
+    /** 获取会话历史 */
+    private getSessionHistory;
+    /** 构建消息列表 */
+    private buildMessages;
+    /** 验证 tool_calls 和 tool 消息配对，清理不完整的工具调用 */
+    private validateToolCallPairs;
+    /** 裁剪历史消息 */
+    private trimHistory;
+    /** 检查并执行上下文压缩 */
+    private maybeCompactHistory;
+    /** 清除会话 */
+    clearSession(context: InboundMessageContext): void;
+    /** 获取会话信息 */
+    getSessionInfo(context: InboundMessageContext): {
+        messageCount: number;
+        estimatedTokens: number;
+        hasSummary: boolean;
+        lastUpdate: Date;
+    } | null;
+    /** 恢复会话历史（从 transcript 消息重建 Agent 上下文） */
+    restoreSessionFromTranscript(sessionKey: string, messages: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>): void;
+}
+/** 创建 Agent */
+export declare function createAgent(config: MoziConfig): Agent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agents/agent.d.ts.map

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