@vegamo/loom 0.1.1

package/dist/agents/core/agent.js

@@ -0,0 +1,277 @@
+/**
+ * Agent 主类
+ *
+ * 核心职责: 编排 LLM 调用与 Tool 执行的循环
+ *
+ * 流程:
+ * 1. 接收用户输入
+ * 2. 构建 messages (system prompt + memory + user message)
+ * 3. 调用 LLM (streaming)
+ * 4. 如果 LLM 返回 tool_calls → 执行工具 → 将结果拼入 messages → 回到步骤 3
+ * 5. 如果 LLM 返回纯文本 → 返回给用户
+ *
+ * 特性:
+ * - 支持 streaming (逐字输出到 TUI)
+ * - 自动降级到非 streaming (如果 streaming 不可用)
+ * - 完善的错误分类和向上传播
+ * - 通过事件系统通知上层进度
+ */
+import { LLMClient } from '../../llm/client.js';
+import { LLMError } from '../../llm/types.js';
+import { ToolRegistry } from '../../tools/registry.js';
+import { Memory } from '../memory/memory.js';
+import { buildSystemPrompt } from './prompt.js';
+import { listSchemaFiles } from '../../shared/schema-utils.js';
+import { listEntityFiles } from '../../shared/entity-utils.js';
+import { getOutDir } from '../../shared/config.js';
+import { logger } from '../../shared/logger.js';
+import { schemaGenTool } from '../../tools/schema-gen.js';
+import { schemaValidateTool } from '../../tools/schema-validate.js';
+import { listSchemasTool, readSchemaTool } from '../../tools/file-ops.js';
+import { listEntitiesTool, readEntityTool, writeEntityTool } from '../../tools/entity-file-ops.js';
+import { entityImpactTool, entitySyncTool, entityValidateTool } from '../../tools/entity-workflow.js';
+const DEFAULT_MAX_ITERATIONS = 10;
+export class Agent {
+    llm;
+    tools;
+    memory;
+    config;
+    toolContext;
+    state = 'idle';
+    abortController = null;
+    /** 事件回调 */
+    onEvent;
+    /** 向后兼容的状态变更回调 */
+    onStateChange;
+    constructor(config) {
+        this.config = config;
+        // 初始化 LLM 客户端
+        this.llm = new LLMClient(config.loomConfig.llm);
+        // 初始化工具注册中心
+        this.tools = new ToolRegistry();
+        this.tools.registerAll([
+            schemaGenTool,
+            schemaValidateTool,
+            listSchemasTool,
+            readSchemaTool,
+            listEntitiesTool,
+            readEntityTool,
+            writeEntityTool,
+            entityImpactTool,
+            entitySyncTool,
+            entityValidateTool,
+        ]);
+        // 初始化记忆
+        this.memory = new Memory();
+        // 工具执行上下文
+        const outDir = getOutDir(config.loomConfig, config.projectDir);
+        this.toolContext = {
+            projectDir: config.projectDir,
+            outDir,
+        };
+        // 设置 system prompt
+        this.initSystemPrompt();
+    }
+    /**
+     * 处理用户输入，返回 Agent 回复
+     *
+     * 根据 config.streaming 自动选择 streaming 或非 streaming 模式
+     */
+    async chat(userMessage) {
+        // 创建新的 abort controller
+        this.abortController = new AbortController();
+        // 添加用户消息到记忆
+        this.memory.add({ role: 'user', content: userMessage });
+        const schemasGenerated = [];
+        let totalToolCalls = 0;
+        let iterations = 0;
+        const maxIter = this.config.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+        const useStreaming = this.config.streaming !== false;
+        try {
+            while (iterations < maxIter) {
+                iterations++;
+                // 调用 LLM
+                this.setState('thinking');
+                let response;
+                if (useStreaming) {
+                    response = await this.callLLMStreaming();
+                }
+                else {
+                    response = await this.callLLM();
+                }
+                // 如果没有 tool calls，返回纯文本回复
+                if (response.toolCalls.length === 0) {
+                    const content = response.content || '';
+                    this.memory.add({ role: 'assistant', content });
+                    this.setState('idle');
+                    this.emit({ type: 'reply_done' });
+                    return { content, schemasGenerated, toolCallCount: totalToolCalls };
+                }
+                // 有 tool calls — 构建 assistant 消息并加入记忆
+                const assistantMessage = {
+                    role: 'assistant',
+                    content: response.content,
+                    tool_calls: response.toolCalls.map((tc) => ({
+                        id: tc.id,
+                        type: 'function',
+                        function: tc.function,
+                    })),
+                };
+                this.memory.add(assistantMessage);
+                // 执行每个 tool call
+                this.setState('calling_tool');
+                for (const toolCall of response.toolCalls) {
+                    const toolName = toolCall.function.name;
+                    totalToolCalls++;
+                    this.emit({
+                        type: 'tool_start',
+                        tool: { name: toolName },
+                    });
+                    // 向后兼容
+                    this.onStateChange?.({
+                        state: 'calling_tool',
+                        message: `Calling ${toolName}...`,
+                        toolName,
+                    });
+                    // 解析参数
+                    let args;
+                    try {
+                        args = JSON.parse(toolCall.function.arguments);
+                    }
+                    catch (parseErr) {
+                        logger.error(`Failed to parse arguments for tool "${toolName}": ${toolCall.function.arguments}`);
+                        // 参数解析失败 → 将错误返回给 LLM，让它修正
+                        const errorResult = {
+                            success: false,
+                            error: `Invalid JSON in tool arguments: ${parseErr instanceof Error ? parseErr.message : String(parseErr)}`,
+                        };
+                        this.memory.add({
+                            role: 'tool',
+                            tool_call_id: toolCall.id,
+                            content: JSON.stringify(errorResult),
+                        });
+                        this.emit({
+                            type: 'tool_end',
+                            tool: { name: toolName, success: false, message: 'Invalid arguments' },
+                        });
+                        continue;
+                    }
+                    // 执行工具
+                    const result = await this.tools.execute(toolName, args, this.toolContext);
+                    // 记录生成的 schema 文件
+                    if (toolName === 'write_schema' && result.success) {
+                        const data = result.data;
+                        if (data.filepath) {
+                            schemasGenerated.push(data.filepath);
+                        }
+                    }
+                    // 将 tool 结果加入记忆
+                    this.memory.add({
+                        role: 'tool',
+                        tool_call_id: toolCall.id,
+                        content: JSON.stringify(result),
+                    });
+                    this.emit({
+                        type: 'tool_end',
+                        tool: {
+                            name: toolName,
+                            success: result.success,
+                            message: result.success
+                                ? result.data?.message || 'Done'
+                                : result.error || 'Failed',
+                        },
+                    });
+                }
+            }
+            // 超出最大轮次
+            logger.warn(`Agent reached max iterations (${maxIter})`);
+            this.setState('idle');
+            return {
+                content: 'I have reached the maximum number of tool call iterations. ' +
+                    'Please try a simpler request or break it into smaller steps.',
+                schemasGenerated,
+                toolCallCount: totalToolCalls,
+            };
+        }
+        catch (err) {
+            this.setState('error');
+            // 分类错误，给上层有意义的信息
+            if (err instanceof LLMError) {
+                this.emit({ type: 'error', error: `LLM error (${err.code}): ${err.message}` });
+                throw err;
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            this.emit({ type: 'error', error: message });
+            throw new Error(`Agent error: ${message}`);
+        }
+        finally {
+            this.abortController = null;
+        }
+    }
+    /**
+     * 中断当前请求
+     */
+    abort() {
+        this.abortController?.abort();
+        this.setState('idle');
+    }
+    /**
+     * 重置对话
+     */
+    reset() {
+        this.abort();
+        this.memory.clear();
+        this.initSystemPrompt();
+        this.setState('idle');
+    }
+    // ============================================================
+    // LLM 调用 (内部)
+    // ============================================================
+    /**
+     * 非 streaming LLM 调用
+     */
+    async callLLM() {
+        return this.llm.chat({
+            messages: this.memory.getMessages(),
+            tools: this.tools.getDefinitions(),
+            signal: this.abortController?.signal,
+        });
+    }
+    /**
+     * Streaming LLM 调用
+     *
+     * 逐字发送 content_delta 事件到 TUI，同时累积完整响应
+     */
+    async callLLMStreaming() {
+        this.setState('streaming');
+        return this.llm.chatStream({
+            messages: this.memory.getMessages(),
+            tools: this.tools.getDefinitions(),
+            signal: this.abortController?.signal,
+        }, (event) => {
+            // 将 LLM stream 事件转发为 Agent 事件
+            if (event.type === 'content_delta' && event.delta) {
+                this.emit({ type: 'content_delta', delta: event.delta });
+            }
+        });
+    }
+    // ============================================================
+    // 内部工具方法
+    // ============================================================
+    initSystemPrompt() {
+        const existing = listSchemaFiles(this.toolContext.outDir);
+        const existingEntities = listEntityFiles(this.toolContext.outDir);
+        const prompt = buildSystemPrompt(existing.map((f) => f.filename), existingEntities.map((f) => f.filename));
+        this.memory.add({ role: 'system', content: prompt });
+    }
+    setState(state) {
+        this.state = state;
+        this.emit({ type: 'state_change', state });
+        // 向后兼容
+        this.onStateChange?.({ state });
+    }
+    emit(event) {
+        this.onEvent?.(event);
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agents/core/agent.js.map

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

package/dist/agents/core/prompt.d.ts

@@ -0,0 +1,11 @@
+/**
+ * System Prompt 模板管理
+ */
+/**
+ * 构建 Agent 的 system prompt
+ *
+ * @param existingSchemas 当前已有的 schema 文件列表 (提供上下文)
+ * @param existingEntities 当前已有的实体文件列表
+ */
+export declare function buildSystemPrompt(existingSchemas?: string[], existingEntities?: string[]): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/agents/core/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/agents/core/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,GAAE,MAAM,EAAO,EAC9B,gBAAgB,GAAE,MAAM,EAAO,GAC9B,MAAM,CA6GR"}

package/dist/agents/core/prompt.js

@@ -0,0 +1,117 @@
+/**
+ * System Prompt 模板管理
+ */
+/**
+ * 构建 Agent 的 system prompt
+ *
+ * @param existingSchemas 当前已有的 schema 文件列表 (提供上下文)
+ * @param existingEntities 当前已有的实体文件列表
+ */
+export function buildSystemPrompt(existingSchemas = [], existingEntities = []) {
+    const schemaList = existingSchemas.length > 0
+        ? `\nExisting schema files in docs directory:\n${existingSchemas.map((s) => `- ${s}`).join('\n')}`
+        : '\nNo existing schema files yet.';
+    const entityList = existingEntities.length > 0
+        ? `\nExisting entity files in docs/entities:\n${existingEntities.map((s) => `- ${s}`).join('\n')}`
+        : '\nNo existing entity files yet.';
+    return `You are Loom, an AI assistant specialized in generating JSON Schema API documentation.
+
+## Your Role
+
+Help users design RESTful API endpoints based on their business requirements, and generate well-structured JSON Schema documents that define API contracts.
+
+## Schema Document Format
+
+Each schema file groups related API endpoints (e.g., all user-related APIs in one file). The file structure MUST follow this exact format:
+
+\`\`\`json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "User Management API",
+  "description": "User registration, authentication, and profile management",
+  "version": "1.0.0",
+  "endpoints": [
+    {
+      "path": "/api/users/register",
+      "method": "POST",
+      "summary": "Register a new user",
+      "description": "Create a new user account with email and password",
+      "tags": ["auth"],
+      "request": {
+        "body": {
+          "type": "object",
+          "properties": {
+            "email": { "type": "string", "format": "email", "description": "User email address" },
+            "password": { "type": "string", "minLength": 8, "description": "User password, min 8 characters" },
+            "name": { "type": "string", "minLength": 1, "description": "Display name" }
+          },
+          "required": ["email", "password", "name"]
+        }
+      },
+      "response": {
+        "201": {
+          "type": "object",
+          "properties": {
+            "id": { "type": "integer", "description": "User ID" },
+            "email": { "type": "string" },
+            "name": { "type": "string" },
+            "createdAt": { "type": "string", "format": "date-time" }
+          },
+          "required": ["id", "email", "name", "createdAt"]
+        },
+        "400": {
+          "type": "object",
+          "properties": {
+            "error": { "type": "string" },
+            "message": { "type": "string" }
+          },
+          "required": ["error", "message"]
+        }
+      }
+    }
+  ]
+}
+\`\`\`
+
+## Rules
+
+1. **File naming**: Use lowercase with hyphens, always end with \`.schema.json\`. Examples: \`users.schema.json\`, \`order-management.schema.json\`.
+2. **Paths**: Use RESTful conventions. Use \`:paramName\` for path parameters (e.g., \`/api/users/:id\`).
+3. **Methods**: Use appropriate HTTP methods — GET (read), POST (create), PUT (full update), PATCH (partial update), DELETE (remove).
+4. **Request schemas**: Define \`body\` for POST/PUT/PATCH. Define \`query\` for GET filters/pagination. Define \`params\` for path parameters.
+5. **Response schemas**: Always include success status (200/201) and common error statuses (400, 404, 500). Each status code maps to a JSON Schema object.
+6. **JSON Schema**: Use draft-07. Include \`type\`, \`properties\`, \`required\`, \`description\`, and constraints (\`minLength\`, \`format\`, \`minimum\`, \`enum\`, etc.) where appropriate.
+7. **Grouping**: Group related endpoints in one file. For example, all user-related APIs (\`/api/users/*\`) in \`users.schema.json\`.
+8. **Modifying existing schemas**: When the user asks to modify/update/change existing APIs, ALWAYS:
+   - use \`list_schemas\` to find candidate files,
+   - use \`read_schema\` to load the target file,
+   - use \`write_schema\` with the SAME filename and \`mustExist: true\`.
+   Never create a new file unless the user explicitly asks for a new file.
+9. **Entity workflow**: When requests involve entities or entity-linked updates, follow this flow with tools:
+   - analyze impact using \`entity_impact\`,
+   - sync changes using \`entity_sync\` (dry-run first, then apply if user confirms or intent is explicit),
+   - validate consistency using \`entity_validate\`.
+10. **Entity references in endpoint schemas**: Use \`x-entity-ref\` on schema nodes:
+   - string form: \`"x-entity-ref": "User"\`
+   - object form: \`"x-entity-ref": { "entity": "User", "pick": ["id", "name"] }\`
+11. **Always use tools**: Never just show JSON in chat. Always use tools to read/write/validate.
+12. **Language**: Respond in the same language the user uses.
+
+## Available Tools
+
+- \`write_schema\` — Write a complete schema document to a file (creates or overwrites, supports \`mustExist\` for update-only mode)
+- \`validate_schema\` — Validate an existing schema file for correctness
+- \`list_schemas\` — List all existing schema files in the docs directory
+- \`read_schema\` — Read the full content of an existing schema file
+- \`list_entities\` — List all entity definition files in docs/entities
+- \`read_entity\` — Read one entity definition
+- \`write_entity\` — Write one entity definition (supports \`mustExist\` for update-only mode)
+- \`entity_impact\` — Analyze impacted endpoints/files for an entity change
+- \`entity_sync\` — Sync endpoint schema fragments from entity refs
+- \`entity_validate\` — Validate entity refs and schema consistency
+
+## Current State
+${schemaList}
+${entityList}`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/agents/core/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/agents/core/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,kBAA4B,EAAE,EAC9B,mBAA6B,EAAE;IAE/B,MAAM,UAAU,GACd,eAAe,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,+CAA+C,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClG,CAAC,CAAC,iCAAiC,CAAC;IACxC,MAAM,UAAU,GACd,gBAAgB,CAAC,MAAM,GAAG,CAAC;QACzB,CAAC,CAAC,8CAA8C,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClG,CAAC,CAAC,iCAAiC,CAAC;IAExC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiGP,UAAU;EACV,UAAU,EAAE,CAAC;AACf,CAAC"}

package/dist/agents/core/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent 核心类型定义
+ */
+import type { LoomConfig } from '../../shared/types.js';
+/** Agent 运行状态 */
+export type AgentState = 'idle' | 'thinking' | 'streaming' | 'calling_tool' | 'error';
+/** Agent 配置 */
+export interface AgentConfig {
+    /** 全局配置 */
+    loomConfig: LoomConfig;
+    /** 目标项目目录 */
+    projectDir: string;
+    /** 最大工具调用轮次 (防止无限循环) */
+    maxIterations?: number;
+    /** 是否启用 streaming (默认 true) */
+    streaming?: boolean;
+}
+/** 事件类型 */
+export type AgentEventType = 'state_change' | 'content_delta' | 'tool_start' | 'tool_end' | 'reply_done' | 'error';
+/** Agent 事件 */
+export interface AgentEvent {
+    type: AgentEventType;
+    /** state_change 时的新状态 */
+    state?: AgentState;
+    /** content_delta 时的文本片段 */
+    delta?: string;
+    /** tool_start / tool_end 时的工具信息 */
+    tool?: {
+        name: string;
+        /** tool_end 时表示是否成功 */
+        success?: boolean;
+        /** tool_end 时的结果摘要 */
+        message?: string;
+    };
+    /** error 时的错误信息 */
+    error?: string;
+}
+/** Agent 事件回调 */
+export type AgentEventCallback = (event: AgentEvent) => void;
+/** Agent 对用户的回复 */
+export interface AgentReply {
+    /** 文本回复 */
+    content: string;
+    /** 本轮是否生成了新的 schema 文件 */
+    schemasGenerated: string[];
+    /** 本轮使用的 tool calls 数量 */
+    toolCallCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,iBAAiB;AACjB,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AAEtF,eAAe;AACf,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,WAAW;AACX,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,eAAe,GACf,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,OAAO,CAAC;AAEZ,eAAe;AACf,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,yBAAyB;IACzB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,uBAAuB;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,sBAAsB;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iBAAiB;AACjB,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAM7D,mBAAmB;AACnB,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/agents/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * Agent 核心类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/core/types.js.map

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

package/dist/agents/memory/memory.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 对话历史管理
+ *
+ * 维护 Agent 与用户的对话上下文，支持上下文窗口控制
+ *
+ * 关键约束:
+ * - system 消息始终保留
+ * - tool_calls (assistant) 与 tool (result) 必须配对保留，不能截断一半
+ * - 裁剪时按"轮次"为单位，一轮 = user + assistant(可能带 tool_calls) + tool results
+ */
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions.js';
+import type { MemoryConfig, ConversationSnapshot } from './types.js';
+export declare class Memory {
+    private messages;
+    private maxMessages;
+    constructor(config?: MemoryConfig);
+    /**
+     * 添加一条消息
+     */
+    add(message: ChatCompletionMessageParam): void;
+    /**
+     * 批量添加消息
+     */
+    addAll(messages: ChatCompletionMessageParam[]): void;
+    /**
+     * 获取所有消息 (用于发送给 LLM)
+     */
+    getMessages(): ChatCompletionMessageParam[];
+    /**
+     * 获取消息数量
+     */
+    get length(): number;
+    /**
+     * 获取快照
+     */
+    snapshot(): ConversationSnapshot;
+    /**
+     * 清空历史
+     */
+    clear(): void;
+    /**
+     * 智能裁剪超出上限的旧消息
+     *
+     * 策略:
+     * 1. 分离 system 消息 (始终保留)
+     * 2. 将非 system 消息按"轮次"分组
+     *    - 一个轮次 = [user, assistant(+tool_calls), tool_result_1, tool_result_2, ..., assistant(纯文本)]
+     *    - 保证 tool_calls 和对应 tool results 不会被拆散
+     * 3. 从最老的轮次开始丢弃，直到总数 <= maxMessages
+     */
+    private trim;
+    /**
+     * 将消息序列按轮次分组
+     *
+     * 分组规则:
+     * - 遇到 user 消息 → 开始新轮次
+     * - assistant / tool 消息归入当前轮次
+     * - 保证每个轮次是一个完整的交互单元
+     */
+    private groupIntoRounds;
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/agents/memory/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIrE,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,CAAC,EAAE,YAAY;IAIjC;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAK9C;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,0BAA0B,EAAE,GAAG,IAAI;IAKpD;;OAEG;IACH,WAAW,IAAI,0BAA0B,EAAE;IAI3C;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,QAAQ,IAAI,oBAAoB;IAOhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAI;IAwBZ;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;CAoBxB"}

package/dist/agents/memory/memory.js

@@ -0,0 +1,113 @@
+/**
+ * 对话历史管理
+ *
+ * 维护 Agent 与用户的对话上下文，支持上下文窗口控制
+ *
+ * 关键约束:
+ * - system 消息始终保留
+ * - tool_calls (assistant) 与 tool (result) 必须配对保留，不能截断一半
+ * - 裁剪时按"轮次"为单位，一轮 = user + assistant(可能带 tool_calls) + tool results
+ */
+const DEFAULT_MAX_MESSAGES = 50;
+export class Memory {
+    messages = [];
+    maxMessages;
+    constructor(config) {
+        this.maxMessages = config?.maxMessages ?? DEFAULT_MAX_MESSAGES;
+    }
+    /**
+     * 添加一条消息
+     */
+    add(message) {
+        this.messages.push(message);
+        this.trim();
+    }
+    /**
+     * 批量添加消息
+     */
+    addAll(messages) {
+        this.messages.push(...messages);
+        this.trim();
+    }
+    /**
+     * 获取所有消息 (用于发送给 LLM)
+     */
+    getMessages() {
+        return [...this.messages];
+    }
+    /**
+     * 获取消息数量
+     */
+    get length() {
+        return this.messages.length;
+    }
+    /**
+     * 获取快照
+     */
+    snapshot() {
+        return {
+            messages: this.getMessages(),
+            messageCount: this.messages.length,
+        };
+    }
+    /**
+     * 清空历史
+     */
+    clear() {
+        this.messages = [];
+    }
+    /**
+     * 智能裁剪超出上限的旧消息
+     *
+     * 策略:
+     * 1. 分离 system 消息 (始终保留)
+     * 2. 将非 system 消息按"轮次"分组
+     *    - 一个轮次 = [user, assistant(+tool_calls), tool_result_1, tool_result_2, ..., assistant(纯文本)]
+     *    - 保证 tool_calls 和对应 tool results 不会被拆散
+     * 3. 从最老的轮次开始丢弃，直到总数 <= maxMessages
+     */
+    trim() {
+        if (this.messages.length <= this.maxMessages)
+            return;
+        const systemMessages = this.messages.filter((m) => m.role === 'system');
+        const nonSystemMessages = this.messages.filter((m) => m.role !== 'system');
+        // 将消息按轮次分组
+        const rounds = this.groupIntoRounds(nonSystemMessages);
+        // 从最新轮次开始保留，直到超出预算
+        const budget = this.maxMessages - systemMessages.length;
+        const kept = [];
+        let totalKept = 0;
+        for (let i = rounds.length - 1; i >= 0; i--) {
+            const round = rounds[i];
+            if (totalKept + round.length > budget)
+                break;
+            kept.unshift(...round);
+            totalKept += round.length;
+        }
+        this.messages = [...systemMessages, ...kept];
+    }
+    /**
+     * 将消息序列按轮次分组
+     *
+     * 分组规则:
+     * - 遇到 user 消息 → 开始新轮次
+     * - assistant / tool 消息归入当前轮次
+     * - 保证每个轮次是一个完整的交互单元
+     */
+    groupIntoRounds(messages) {
+        const rounds = [];
+        let current = [];
+        for (const msg of messages) {
+            if (msg.role === 'user' && current.length > 0) {
+                rounds.push(current);
+                current = [];
+            }
+            current.push(msg);
+        }
+        if (current.length > 0) {
+            rounds.push(current);
+        }
+        return rounds;
+    }
+}
+//# sourceMappingURL=memory.js.map