@ai-setting/roy-agent-cli 1.3.18 → 1.3.22

package/dist/core/src/env/agent/summary-agent.parse-hint.test.js

@@ -1,267 +0,0 @@
-/**
- * @fileoverview SummaryAgent parseHintResponse 测试
- *
- * TDD 规范：覆盖 LLM 可能返回的各种输出格式
- *
- * 测试 parseCompactHintResponse 函数的解析逻辑
- *
- * Hint 阶段输出格式：JSON with guidance_prompt key
- * 需要兼容各种 LLM 输出格式
- */
-import { describe, expect, test } from "bun:test";
-import { parseCompactHintResponse } from "./summary-agent.js";
-// ============================================================================
-// 测试数据：各种 LLM 输出场景
-// ============================================================================
-/**
- * 场景1: JSON with guidance_prompt key (标准格式)
- * 新格式：包含 Work type, Progress, CRITICAL to preserve, Focus extraction on
- */
-const LLM_OUTPUT_JSON_STANDARD = `{
-  "guidance_prompt": "Bug investigation: User is debugging LSP diagnostics not updating after file edits. Progress: identified root cause (getDiagnostics needs to read latest file content and trigger didChange notification), implemented fix, CI verified. CRITICAL to preserve: the fix implementation details (file path, code changes), that 2 agent-node-integration tests still fail due to test assertion timing issue (expects 'running' but completes in ~78ms) - this is unrelated to LSP work. Focus extraction on: root cause analysis, fix implementation, known remaining test issues."
-}`;
-/**
- * 场景2: JSON with explanation (text + json 混合)
- */
-const LLM_OUTPUT_JSON_WITH_EXPLANATION = `Based on my analysis of the conversation, here is the guidance prompt:
-
-{
-  "guidance_prompt": "Feature development: User is implementing JWT authentication for auth-service. Progress: designed auth flow, implemented token refresh logic, middleware partially done. CRITICAL to preserve: auth flow decisions (token storage, refresh strategy), completed middleware components, modules pending implementation. Focus extraction on: architectural decisions, completed components, pending work."
-}
-
-This guidance will help generate a more focused checkpoint.`;
-/**
- * 场景3: JSON wrapped in ```json ```
- */
-const LLM_OUTPUT_JSON_CODE_BLOCK = `Here's the analysis:
-
-\`\`\`json
-{
-  "guidance_prompt": "Refactoring: User is migrating data layer to repository pattern. Progress: migrated UserRepository and OrderRepository, 3 more pending. CRITICAL to preserve: pattern decisions (interface definitions, dependency injection approach), completed repositories, modules pending migration. Focus extraction on: pattern implementation details, completed vs pending modules."
-}
-\`\`\`
-
-Let me know if you need any adjustments.`;
-/**
- * 场景4: JSON wrapped in plain ``` ```
- */
-const LLM_OUTPUT_JSON_PLAIN_CODE_BLOCK = `\`\`\`
-{
-  "guidance_prompt": "Bug investigation. User is debugging intermittent 500 errors on /api/users endpoint. CRITICAL to preserve: suspected root cause (race condition), metrics added, remaining investigation steps. Focus on: root cause analysis and next steps."
-}
-\`\`\``;
-/**
- * 场景5: Markdown code block with language hint
- */
-const LLM_OUTPUT_MARKDOWN_CODE_BLOCK = `### Guidance Prompt
-
-\`\`\`markdown
-Feature development. User is implementing JWT authentication. CRITICAL to preserve: auth flow decisions.
-\`\`\``;
-/**
- * 场景5a: 纯 markdown code block（无语言标识）
- */
-const LLM_OUTPUT_PLAIN_CODE_BLOCK_PLAIN = `\`\`\`
-Feature development. User is implementing JWT authentication. CRITICAL to preserve: auth flow decisions.
-\`\`\``;
-/**
- * 场景6: 纯文本（无 JSON）- 降级处理
- */
-const LLM_OUTPUT_PLAIN_TEXT = `Bug investigation: User is debugging LSP diagnostics not updating after file edits. Progress: identified root cause, implemented fix. CRITICAL to preserve: fix implementation details, remaining test issues. Focus on: root cause analysis, fix implementation.`;
-/**
- * 场景7: 带空白的 JSON
- */
-const LLM_OUTPUT_JSON_WITH_WHITESPACE = `
-
-{
-    "guidance_prompt": "Bug investigation: User is debugging intermittent 500 errors on /api/users endpoint. Progress: identified root cause. CRITICAL to preserve: race condition findings, metrics added. Focus on: remaining investigation steps."
-}
-
-`;
-/**
- * 场景8: JSON with additional fields
- */
-const LLM_OUTPUT_JSON_WITH_EXTRA_FIELDS = `{
-  "analysis": "The user is working on a feature implementation",
-  "guidance_prompt": "Feature development: User is implementing JWT authentication. Progress: designed auth flow. CRITICAL to preserve: token storage strategy, refresh logic. Focus extraction on: architectural decisions.",
-  "work_type": "feature",
-  "priority": "high"
-}`;
-/**
- * 场景9: 超长 JSON
- */
-const LLM_OUTPUT_JSON_LONG = `{
-  "guidance_prompt": "Feature development: User is implementing JWT authentication for the auth-service. Progress: designed auth flow, implemented token refresh logic, middleware partially done. CRITICAL to preserve: auth flow decisions (token storage, refresh strategy), completed middleware components, modules pending implementation. Focus extraction on: architectural decisions, completed components, pending work. ${"x".repeat(300)}"
-}`;
-/**
- * 场景10: 空白内容
- */
-const LLM_OUTPUT_EMPTY = "";
-// ============================================================================
-// TDD 测试：按场景覆盖
-// ============================================================================
-describe("SummaryAgent.parseCompactHintResponse", () => {
-    describe("场景1: JSON 标准格式 (新格式)", () => {
-        test("应正确解析 JSON 并提取 guidance_prompt", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_JSON_STANDARD);
-            expect(result).toContain("Bug investigation");
-            expect(result).toContain("Progress:");
-            expect(result).toContain("CRITICAL to preserve:");
-            expect(result).toContain("Focus extraction on:");
-        });
-    });
-    describe("场景2: JSON with explanation (text + json 混合)", () => {
-        test("应正确解析包含说明文本的 JSON", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_JSON_WITH_EXPLANATION);
-            expect(result).toContain("Feature development");
-            expect(result).toContain("Progress:");
-            expect(result).toContain("CRITICAL to preserve:");
-        });
-    });
-    describe("场景3: JSON wrapped in ```json ```", () => {
-        test("应正确解析 ```json ``` 包裹的 JSON", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_JSON_CODE_BLOCK);
-            expect(result).toContain("Refactoring");
-            expect(result).toContain("Progress:");
-            expect(result).toContain("CRITICAL to preserve:");
-        });
-    });
-    describe("场景4: JSON wrapped in plain ``` ```", () => {
-        test("应正确解析 ``` ``` 包裹的 JSON", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_JSON_PLAIN_CODE_BLOCK);
-            expect(result).toContain("Bug investigation");
-            expect(result).toContain("CRITICAL to preserve:");
-        });
-    });
-    describe("场景5: Markdown code block with language hint", () => {
-        test("应正确解析 markdown 包裹的纯文本", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_MARKDOWN_CODE_BLOCK);
-            // markdown ```...``` 提取内部内容，前面的文本会被保留
-            expect(result).toContain("Feature development");
-            expect(result).toContain("CRITICAL to preserve:");
-        });
-    });
-    describe("场景5a: 纯 code block（无语言标识）", () => {
-        test("应正确提取 code block 内的纯文本", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_PLAIN_CODE_BLOCK_PLAIN);
-            expect(result).toContain("Feature development");
-            expect(result).toContain("CRITICAL to preserve:");
-        });
-    });
-    describe("场景6: 纯文本（无 JSON）- 降级处理", () => {
-        test("纯文本应直接返回（作为降级方案）", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_PLAIN_TEXT);
-            expect(result).toContain("Bug investigation");
-            expect(result).toContain("Progress:");
-            expect(result).toContain("CRITICAL to preserve:");
-        });
-        test("纯文本应包含必要元素", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_PLAIN_TEXT);
-            expect(result).toMatch(/Bug investigation|Feature development|Refactoring/i);
-            expect(result).toMatch(/Progress:/i);
-            expect(result).toMatch(/CRITICAL to preserve:/i);
-        });
-    });
-    describe("场景7: 带空白的 JSON", () => {
-        test("应正确解析带空白的 JSON", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_JSON_WITH_WHITESPACE);
-            expect(result).toContain("Bug investigation");
-            expect(result).toContain("Progress:");
-            expect(result).toContain("CRITICAL to preserve:");
-        });
-    });
-    describe("场景8: JSON with extra fields", () => {
-        test("应忽略额外字段，只提取 guidance_prompt", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_JSON_WITH_EXTRA_FIELDS);
-            expect(result).toContain("Feature development");
-            expect(result).toContain("Progress:");
-            expect(result).toContain("CRITICAL to preserve:");
-            // 不应包含额外字段
-            expect(result).not.toContain('"analysis"');
-            expect(result).not.toContain('"work_type"');
-        });
-    });
-    describe("场景9: 超长 JSON guidance_prompt", () => {
-        test("超长内容应被截断到 500 字符", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_JSON_LONG);
-            expect(result.length).toBe(503); // 500 + "..."
-            expect(result.endsWith("...")).toBe(true);
-            expect(result).toContain("Feature development");
-        });
-    });
-    describe("场景10: 空白内容", () => {
-        test("空字符串应返回降级提示", () => {
-            const result = parseCompactHintResponse(LLM_OUTPUT_EMPTY);
-            expect(result).toBe("[Hint extraction failed]");
-        });
-    });
-    describe("边界情况", () => {
-        test("纯空白应返回降级提示", () => {
-            const result = parseCompactHintResponse("   \n\n  ");
-            expect(result).toBe("[Hint extraction failed]");
-        });
-        test("带 guidance_prompt key 但值为空应返回降级提示", () => {
-            const result = parseCompactHintResponse('{"guidance_prompt": ""}');
-            expect(result).toBe("[Hint extraction failed]");
-        });
-        test("JSON 但缺少 guidance_prompt 字段应降级处理", () => {
-            const result = parseCompactHintResponse('{"other_field": "some value"}');
-            // 降级到纯文本处理
-            expect(result).toBe('{"other_field": "some value"}');
-        });
-        test("无效 JSON 应降级处理", () => {
-            const result = parseCompactHintResponse("This is not JSON at all");
-            // 降级到纯文本处理
-            expect(result).toBe("This is not JSON at all");
-        });
-        test("JSON 解析失败但有代码块应尝试提取", () => {
-            const result = parseCompactHintResponse("```json\ninvalid json {}\n```");
-            // 降级处理后可能是原始内容
-            expect(typeof result).toBe("string");
-        });
-    });
-});
-// ============================================================================
-// 补充测试：指导 Prompt 格式验证 (新格式)
-// ============================================================================
-describe("Compact Guidance Prompt 格式示例 (新格式)", () => {
-    const goodExamples = [
-        "Bug investigation: User is debugging LSP diagnostics not updating. Progress: identified root cause, implemented fix. CRITICAL to preserve: fix implementation details, remaining test issues. Focus extraction on: root cause analysis.",
-        "Feature development: User is implementing JWT authentication. Progress: designed auth flow, implemented token refresh. CRITICAL to preserve: auth flow decisions, completed components. Focus extraction on: architectural decisions.",
-        "Refactoring: User is migrating data layer to repository pattern. Progress: migrated UserRepository, 3 more pending. CRITICAL to preserve: pattern decisions, completed repositories. Focus extraction on: pattern implementation details.",
-    ];
-    test.each(goodExamples)("示例应包含必要元素", (example) => {
-        const result = parseCompactHintResponse(example);
-        // 应该包含工作类型关键词
-        expect(result).toMatch(/Bug investigation:|Feature development:|Refactoring:/i);
-        // 应该包含 Progress:
-        expect(result).toMatch(/Progress:/i);
-        // 应该包含 CRITICAL to preserve:
-        expect(result).toMatch(/CRITICAL to preserve:/i);
-        // 应该包含 Focus extraction on:
-        expect(result).toMatch(/Focus extraction on:/i);
-    });
-});
-// ============================================================================
-// 输出约束测试
-// ============================================================================
-describe("LLM Output Format 约束", () => {
-    describe("guidance_prompt key 验证", () => {
-        test("正确格式的 JSON 应能被解析", () => {
-            const jsonInput = '{"guidance_prompt": "Test prompt"}';
-            const result = parseCompactHintResponse(jsonInput);
-            expect(result).toBe("Test prompt");
-        });
-        test("带转义字符的 guidance_prompt 应正确解析", () => {
-            const jsonInput = '{"guidance_prompt": "Test with \\"quotes\\" and \\\\ backslash"}';
-            const result = parseCompactHintResponse(jsonInput);
-            expect(result).toBe('Test with "quotes" and \\ backslash');
-        });
-        test("带换行符的 guidance_prompt 应正确解析", () => {
-            const jsonInput = '{"guidance_prompt": "Line 1\\nLine 2"}';
-            const result = parseCompactHintResponse(jsonInput);
-            expect(result).toBe("Line 1\nLine 2");
-        });
-    });
-});
-//# sourceMappingURL=summary-agent.parse-hint.test.js.map

package/dist/core/src/env/agent/types.d.ts

@@ -1,394 +0,0 @@
-/**
- * @fileoverview AgentComponent Types
- *
- * 基于 roy-agent docs/agent-component-design.md
- *
- * 注意：Tool 相关类型从 ToolComponent 复用，保持统一
- */
-import type { ModelMessage } from "ai";
-import type { Tool, ToolResult } from "../tool/types";
-import type { LLMOutput } from "../llm/types";
-type AbortSignalType = AbortSignal;
-export { Tool, ToolResult };
-export interface ProjectSummary {
-    projectPath: string;
-    projectName: string;
-    lastUpdated: number;
-    summary: string;
-    shortSummary: string;
-    draftCount: number;
-    memoryMdPath: string;
-    draftsDir: string;
-    detailsDir: string;
-}
-/**
- * Agent 执行上下文
- */
-export interface AgentContext {
-    /** 会话 ID */
-    sessionId?: string;
-    /** 消息 ID */
-    messageId?: string;
-    /** 中断信号 */
-    abort?: AbortSignalType;
-    /** 额外的上下文信息（会添加到 system prompt） */
-    additionInfo?: string;
-    /** 元数据 */
-    metadata?: Record<string, unknown>;
-    /** Agent 类型（用于选择 Behavior Spec） */
-    agentType?: string;
-    /** 使用的模型 */
-    model?: string;
-    /** 允许的工具列表（上下文级别，会覆盖 agent 配置） */
-    allowedTools?: string[];
-    /** 拒绝的工具列表（上下文级别，会覆盖 agent 配置） */
-    deniedTools?: string[];
-    /** 是否过滤 history 中的 tool 消息（上下文级别，会覆盖 agent 配置） */
-    filterHistory?: boolean;
-}
-/**
- * 工具调用（内部使用）
- */
-export interface ToolCall {
-    /** 调用 ID */
-    id: string;
-    /** 工具名称 */
-    name: string;
-    /** 调用参数 */
-    arguments: Record<string, unknown>;
-}
-/**
- * 工具调用结果
- */
-export interface ToolCallResult {
-    /** 调用 ID */
-    id: string;
-    /** 工具名称 */
-    name: string;
-    /** 调用结果 */
-    result: ToolResult;
-    /** 是否成功 */
-    success: boolean;
-}
-/**
- * Hook 点枚举（带 component 前缀）
- */
-export type HookPoint = "agent:before.start" | "agent:before.llm" | "agent:after.llm" | "agent:before.tool" | "agent:after.tool" | "agent:on.iteration" | "agent:on.threshold" | "agent:after.complete" | "agent:on.error" | "agent:after.react" | "on.error";
-/**
- * Context data for agent:after.react hook
- */
-export interface AgentReactContext {
-    /** Current messages for memory extraction */
-    messages: ModelMessage[];
-    /** Current session ID */
-    sessionId?: string;
-    /** Execution summary */
-    summary?: string;
-}
-/**
- * Hook 上下文（Agent 特有版本）
- *
- * 注意：这是 AgentComponent 使用的 HookContext 扩展版本
- * 包含 iteration, maxIterations, messages 等 Agent 特有字段
- */
-export interface HookContext {
-    /** 当前 LLM 输出（after.llm hook 可用） */
-    llmOutput?: AgentLLMOutput;
-    /** 当前工具调用（before.tool/after.tool hook 可用） */
-    currentToolCall?: ToolCall;
-    /** 工具执行结果（after.tool hook 可用） */
-    toolResult?: ToolCallResult;
-    /** 阈值信息（on.threshold hook 可用） */
-    threshold?: {
-        type: "tokens" | "turns" | "iterations" | "custom";
-        value: number;
-        limit?: number;
-    };
-    /** 当前错误（on.error hook 可用） */
-    error?: Error;
-    /** 当前 Agent 实例 */
-    agent: AgentInstance;
-    /** 当前迭代次数（可修改） */
-    iteration: number;
-    /** 最大迭代次数限制（before.llm hook 可用） */
-    maxIterations: number;
-    /** 消息列表（可直接修改） */
-    messages: ModelMessage[];
-    /** 可用工具列表（可直接修改） */
-    tools: Tool[];
-    /** 当前 system prompt（可直接修改） */
-    systemPrompt: string;
-    /** 额外的上下文信息（可直接修改） */
-    additionInfo?: string;
-    /** 执行上下文（可直接修改属性） */
-    context: AgentContext;
-    /** 是否已停止 */
-    _stopped?: boolean;
-    /** 停止原因 */
-    _stopReason?: string;
-    /** 待执行的干预动作 */
-    _pendingAction?: {
-        type: HookActionType;
-        payload?: unknown;
-    };
-    /** 错误列表 */
-    _errors?: Array<{
-        plugin: string;
-        error: string;
-    }>;
-    /** Project Memory Agent 生成的摘要列表（由 Project Agent 写入，Global Agent 读取） */
-    projectSummaries?: ProjectSummary[];
-}
-/**
- * Hook 干预动作
- */
-export type HookActionType = "stop" | "retry" | "compress" | "extract_memory" | "inject_message" | "skip_tool";
-/**
- * Hook 返回结果
- */
-export interface HookResult {
-    /** 是否继续执行（false = 停止 Agent） */
-    continue: boolean;
-    /** 干预动作（可选） */
-    action?: {
-        type: HookActionType;
-        payload?: unknown;
-    };
-}
-/**
- * Plugin 定义
- */
-export interface Plugin {
-    /** Plugin 唯一名称 */
-    name: string;
-    /** Plugin 版本 */
-    version: string;
-    /** Plugin 描述 */
-    description?: string;
-    /** 订阅的 Hook 点及优先级 */
-    hooks: Array<{
-        point: HookPoint;
-        /** 优先级，默认 0，数字越大越先执行 */
-        priority?: number;
-    }>;
-    /** 执行函数 */
-    execute: (ctx: HookContext) => HookResult | Promise<HookResult>;
-}
-/**
- * Agent 类型
- */
-export type AgentType = "primary" | "sub" | "summary";
-/**
- * Agent 状态
- */
-export type AgentStatus = "idle" | "running" | "paused" | "stopped" | "error";
-/**
- * Agent 实例配置
- */
-export interface AgentInstanceConfig {
-    /** Agent 类型 */
-    type: AgentType;
-    /** Agent 名称 */
-    name?: string;
-    /** System Prompt */
-    systemPrompt?: string;
-    /** Behavior Spec ID */
-    behaviorSpecId?: string;
-    /** 使用的模型 */
-    model?: string;
-    /** 最大迭代次数 */
-    maxIterations?: number;
-    /** 最大错误重试次数 */
-    maxErrorRetries?: number;
-    /** 死循环检测阈值 */
-    doomLoopThreshold?: number;
-    /** 允许的工具列表 */
-    allowedTools?: string[];
-    /** 拒绝的工具列表 */
-    deniedTools?: string[];
-    /** 工具超时（毫秒） */
-    toolTimeout?: number;
-    /** 工具重试次数 */
-    toolRetries?: number;
-    /** 是否过滤 history 中的 tool 消息（默认过滤，避免上下文过长） */
-    filterHistory?: boolean;
-}
-/**
- * Agent 实例
- */
-export interface AgentInstance {
-    /** Agent 名称 */
-    name: string;
-    /** Agent 配置 */
-    config: Required<AgentInstanceConfig>;
-    /** 当前状态 */
-    status: AgentStatus;
-    /** 注册的 Plugins */
-    plugins: Map<string, Plugin>;
-}
-/**
- * Agent 执行结果
- */
-export interface AgentRunResult {
-    /** 最终文本响应 */
-    finalText?: string;
-    /** 是否被 hook 停止 */
-    stopped?: boolean;
-    /** 停止原因 */
-    stopReason?: string;
-    /** 执行的迭代次数 */
-    iterations: number;
-    /** 工具调用列表 */
-    toolCalls: ToolCall[];
-    /** 错误信息（如有） */
-    error?: string;
-}
-/**
- * LLM 调用结果
- *
- * 复用 LLMComponent 的 LLMOutput，并扩展 Agent 特有字段
- */
-export interface LLMCallResult {
-    /** 成功 */
-    success: boolean;
-    /** 输出 */
-    output?: LLMOutput;
-    /** 错误信息 */
-    error?: string;
-    /** Usage 信息 */
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-}
-/**
- * Agent 内部使用的 LLM 输出
- * 独立定义以避免与 LLMOutput 的类型冲突
- */
-export interface AgentLLMOutput {
-    /** 生成的内容 */
-    content: string;
-    /** 完成原因 */
-    finishReason: "stop" | "length" | "content-filter" | "tool-calls" | "function-call";
-    /** 工具调用（兼容格式） */
-    toolCalls?: Array<{
-        id: string;
-        function?: {
-            name: string;
-            arguments: string;
-        };
-        name?: string;
-        arguments?: string;
-    }>;
-    /** Usage 信息 */
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-    /** 生成模型 */
-    model?: string;
-    /** 推理内容（思考过程） */
-    reasoning?: string;
-}
-/**
- * Summary Agent 配置
- *
- * 专门用于生成 session checkpoint 的 Agent
- */
-export interface SummaryAgentConfig extends AgentInstanceConfig {
-    /** Agent 类型 */
-    type: "summary";
-    /** 使用的 prompt */
-    promptName: "session/compact";
-    /** 默认模型 */
-    model?: string;
-    /** 最大迭代次数（summary 任务只需 1 次） */
-    maxIterations: 1;
-}
-/**
- * Summary Agent 运行选项
- */
-export interface SummaryAgentRunOptions {
-    /** 消息列表 */
-    messages: Array<{
-        role: string;
-        content: string;
-    }>;
-    /** 用户提供的上下文/提示 */
-    userContext?: string;
-    /** 期望的输出格式 */
-    outputFormat: "json";
-    /**
-     * 场景化提示 (Scenario Hint)
-     *
-     * 用于指导 checkpoint 生成的重点方向。
-     * 当提供此参数时，会在系统提示中添加场景上下文，
-     * 帮助 LLM 生成更符合当前场景的 checkpoint。
-     */
-    scenarioHint?: string;
-}
-/**
- * Summary Agent 运行结果
- */
-export interface SummaryAgentResult {
-    /** Checkpoint 标题 */
-    title: string;
-    /** 过程要点 */
-    processKeyPoints: string[];
-    /** 当前状态 */
-    currentState: string;
-    /** 后续待跟进 */
-    nextSteps: string[];
-    /** 用户意图列表 - 从对话中提取的用户相关意图 */
-    userIntents: string[];
-    /** 原始 LLM 响应 */
-    rawResponse?: string;
-}
-/**
- * Compact Hint 生成选项
- *
- * 用于两阶段自动压缩流程中的第一阶段：
- * 根据会话历史生成场景化的压缩提示
- */
-export interface CompactHintGenerationOptions {
-    /** 消息列表 */
-    messages: Array<{
-        role: string;
-        content: string;
-    }>;
-    /**
-     * 会话上下文信息（可选）
-     *
-     * 包含会话相关的额外信息，如：
-     * - 当前活跃任务信息
-     * - 工作目录
-     * - 最近的操作记录等
-     */
-    sessionContext?: {
-        activeTaskId?: string;
-        activeTaskTitle?: string;
-        workingDirectory?: string;
-        recentActions?: string[];
-    };
-}
-/**
- * Compact Hint 生成结果
- */
-export interface CompactHintGenerationResult {
-    /**
-     * 场景化压缩指导提示（自然语言）
-     *
-     * 这是一段"压缩指导 Prompt"，用于告诉 Compact 阶段：
-     * "在当前这个场景/目标/任务下，生成 checkpoint 时应该重点关注什么"
-     *
-     * 示例：
-     * "Feature development. User is implementing JWT authentication for auth-service.
-     *  Focus on: auth flow decisions, token refresh progress, middleware implementation."
-     */
-    hint: string;
-    /** 原始 LLM 响应 */
-    rawResponse?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/core/src/env/agent/types.js

@@ -1,9 +0,0 @@
-/**
- * @fileoverview AgentComponent Types
- *
- * 基于 roy-agent docs/agent-component-design.md
- *
- * 注意：Tool 相关类型从 ToolComponent 复用，保持统一
- */
-export {};
-//# sourceMappingURL=types.js.map