@ai-setting/roy-agent-core 1.7.52 → 1.7.55

package/dist/env/agent/agent-registry.d.ts

@@ -0,0 +1,500 @@
+/**
+ * @fileoverview AgentRegistry - Agent 配置注册与管理
+ *
+ * 功能：
+ * - 从配置文件加载 agent 定义
+ * - 运行时注册/注销 agent
+ * - 解析 systemPromptRef（引用 PromptComponent）
+ * - 持久化 agent 配置到 YAML 文件
+ *
+ * Agent 配置位置：
+ * - 默认：~/.local/share/roy-agent/agents/
+ * - 可通过 agent.configDir 配置覆盖
+ */
+import type { ConfigComponent } from "../../config/config-component";
+import type { PromptComponent } from "../prompt/prompt-component";
+import { z } from "zod";
+/**
+ * Agent 类型
+ */
+export type AgentType = "primary" | "sub" | "workflow";
+/**
+ * Agent 定义接口
+ */
+export interface AgentDefinition {
+    /** Agent 名称（唯一标识） */
+    name: string;
+    /** Agent 类型 */
+    type: AgentType;
+    /** Agent 描述 */
+    description?: string;
+    /** 引用 PromptComponent 中的 prompt 名称 */
+    systemPromptRef?: string;
+    /** 内联 system prompt（systemPromptRef 优先） */
+    systemPrompt?: string;
+    /** 使用的模型 */
+    model?: string;
+    /** 最大迭代次数 */
+    maxIterations?: number;
+    /** 最大错误重试次数 */
+    maxErrorRetries?: number;
+    /** 允许的工具列表（白名单） */
+    allowedTools?: string[];
+    /** 拒绝的工具列表（黑名单） */
+    deniedTools?: string[];
+    /** 工具超时（毫秒） */
+    toolTimeout?: number;
+    /** 工具重试次数 */
+    toolRetries?: number;
+    /** 死循环检测阈值 */
+    doomLoopThreshold?: number;
+    /** 是否过滤 history 中的 tool 消息 */
+    filterHistory?: boolean;
+    /** 关联的已注册 workflow 名称（仅 type=workflow 时有效） */
+    workflow?: string;
+    /**
+     * 入口 agent 名称（仅 type=workflow 时有效）
+     *
+     * 当 delegate_task 收到 workflow 类型 subagent 时，不会直接执行 workflow，
+     * 而是委托给入口 agent（默认 "workflow-runner"）。
+     * 入口 agent 负责通过 workflow run 命令执行实际 workflow。
+     *
+     * 背景：.roy/design/2026-06-29-workflow-subagent-entry-agent-design.md
+     */
+    entryAgent?: string;
+}
+/**
+ * Agent 配置格式（YAML）
+ */
+export declare const AgentConfigSchema: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<["primary", "sub", "workflow"]>;
+    workflow: z.ZodOptional<z.ZodString>;
+    entryAgent: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    systemPromptRef: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    maxIterations: z.ZodOptional<z.ZodNumber>;
+    maxErrorRetries: z.ZodOptional<z.ZodNumber>;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    deniedTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    toolTimeout: z.ZodOptional<z.ZodNumber>;
+    toolRetries: z.ZodOptional<z.ZodNumber>;
+    doomLoopThreshold: z.ZodOptional<z.ZodNumber>;
+    filterHistory: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "primary" | "sub" | "workflow";
+    name: string;
+    description?: string | undefined;
+    workflow?: string | undefined;
+    entryAgent?: string | undefined;
+    systemPromptRef?: string | undefined;
+    systemPrompt?: string | undefined;
+    model?: string | undefined;
+    maxIterations?: number | undefined;
+    maxErrorRetries?: number | undefined;
+    allowedTools?: string[] | undefined;
+    deniedTools?: string[] | undefined;
+    toolTimeout?: number | undefined;
+    toolRetries?: number | undefined;
+    doomLoopThreshold?: number | undefined;
+    filterHistory?: boolean | undefined;
+}, {
+    type: "primary" | "sub" | "workflow";
+    name: string;
+    description?: string | undefined;
+    workflow?: string | undefined;
+    entryAgent?: string | undefined;
+    systemPromptRef?: string | undefined;
+    systemPrompt?: string | undefined;
+    model?: string | undefined;
+    maxIterations?: number | undefined;
+    maxErrorRetries?: number | undefined;
+    allowedTools?: string[] | undefined;
+    deniedTools?: string[] | undefined;
+    toolTimeout?: number | undefined;
+    toolRetries?: number | undefined;
+    doomLoopThreshold?: number | undefined;
+    filterHistory?: boolean | undefined;
+}>, {
+    type: "primary" | "sub" | "workflow";
+    name: string;
+    description?: string | undefined;
+    workflow?: string | undefined;
+    entryAgent?: string | undefined;
+    systemPromptRef?: string | undefined;
+    systemPrompt?: string | undefined;
+    model?: string | undefined;
+    maxIterations?: number | undefined;
+    maxErrorRetries?: number | undefined;
+    allowedTools?: string[] | undefined;
+    deniedTools?: string[] | undefined;
+    toolTimeout?: number | undefined;
+    toolRetries?: number | undefined;
+    doomLoopThreshold?: number | undefined;
+    filterHistory?: boolean | undefined;
+}, {
+    type: "primary" | "sub" | "workflow";
+    name: string;
+    description?: string | undefined;
+    workflow?: string | undefined;
+    entryAgent?: string | undefined;
+    systemPromptRef?: string | undefined;
+    systemPrompt?: string | undefined;
+    model?: string | undefined;
+    maxIterations?: number | undefined;
+    maxErrorRetries?: number | undefined;
+    allowedTools?: string[] | undefined;
+    deniedTools?: string[] | undefined;
+    toolTimeout?: number | undefined;
+    toolRetries?: number | undefined;
+    doomLoopThreshold?: number | undefined;
+    filterHistory?: boolean | undefined;
+}>;
+export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+/**
+ * Export options
+ */
+export interface ExportOptions {
+    format?: "json" | "yaml";
+    includeSource?: boolean;
+}
+/**
+ * AgentRegistry - Agent 配置注册与管理中心
+ *
+ * 负责：
+ * - 加载 agent 配置文件
+ * - 管理运行时 agent 注册
+ * - 提供统一的 agent 查询接口
+ * - 解析 systemPromptRef
+ */
+export declare class AgentRegistry {
+    private agents;
+    private configDir;
+    private configComponent;
+    private promptComponent;
+    private resolvePromptComponent?;
+    private fs;
+    private fsPromises;
+    constructor(options: {
+        configComponent: ConfigComponent | null;
+        promptComponent?: PromptComponent | null;
+        resolvePromptComponent?: () => PromptComponent | null;
+        baseDir?: string;
+        fs?: {
+            existsSync: typeof import("fs")["existsSync"];
+        };
+        fsPromises?: {
+            readdir: typeof import("fs/promises")["readdir"];
+            readFile: typeof import("fs/promises")["readFile"];
+            writeFile: typeof import("fs/promises")["writeFile"];
+            mkdir: typeof import("fs/promises")["mkdir"];
+            unlink: typeof import("fs/promises")["unlink"];
+        };
+    });
+    /**
+     * 获取配置目录
+     */
+    getConfigDir(): string;
+    /**
+     * 检查 agent 是否存在
+     */
+    hasAgent(name: string): boolean;
+    /**
+     * 获取 agent 定义
+     */
+    get(name: string): AgentDefinition | undefined;
+    /**
+     * 列出所有 agent
+     */
+    list(): AgentDefinition[];
+    /**
+     * 按类型列出 agent
+     */
+    listAgentsByType(type: AgentType): AgentDefinition[];
+    /**
+     * 注册 agent（运行时）
+     */
+    register(agent: AgentDefinition): void;
+    /**
+     * 注销 agent（运行时）
+     */
+    unregister(name: string): boolean;
+    /**
+     * 清空所有 agent
+     */
+    clear(): void;
+    /**
+     * 获取 system prompt
+     *
+     * 优先级：
+     * 1. systemPromptRef（引用 PromptComponent）
+     * 2. systemPrompt（内联）
+     * 3. undefined
+     */
+    getSystemPrompt(name: string): Promise<string | undefined>;
+    /**
+     * 同步获取内联 system prompt（不解析 systemPromptRef）
+     */
+    private getActivePromptComponent;
+    getInlineSystemPrompt(name: string): string | undefined;
+    /**
+     * 获取 workflow 类型 agent 关联的 workflow 名称
+     */
+    getWorkflowName(name: string): string | undefined;
+    /**
+     * 获取 workflow 类型 agent 关联的 entry-agent 名称
+     *
+     * 当 delegate_task 被调用时，workflow 类型的 subagent 不会被直接执行，
+     * 而是委托给 entry-agent（默认 "workflow-runner"）。调用方应使用
+     * `getEntryAgent(name) ?? "workflow-runner"` 作为兜底。
+     *
+     * 返回 undefined 的场景：
+     * - agent 不存在
+     * - agent 不是 workflow 类型（语义上不需要 entryAgent）
+     * - agent 未显式配置 entryAgent
+     *
+     * 背景：.roy/design/2026-06-29-workflow-subagent-entry-agent-design.md
+     */
+    getEntryAgent(name: string): string | undefined;
+    /**
+     * 注册内置 workflow-runner (Task #2164 beta-compare)
+     *
+     * workflow-runner 是与 roy / explore 同层的 sub 类型子代理，
+     * 负责: 用 workflow_* 工具调用 workflow_run 执行 workflow,
+     * 支持 session resume (runId == sessionId) 和 stop。
+     *
+     * Task #2486 强调契约:
+     * - **调用方必须传入 workflow_name**（prompt 中指定具体名字）
+     *   **或 指示 sub-agent 自行 search-first**（调用 workflow_tag_list /
+     *   workflow_search / workflow_list / workflow_get 选定）。
+     * - 不允许绕过 workflow / 盲猜 workflow_name / 跳过 schema 验证。
+     *
+     * 对比 Task #2146 reference:
+     * - reference 用 type=primary 充当 "调度中介"; beta 改为 sub 同层,
+     *   与 #2151 M1/M2 review 一致 (避免中介语义 + hidden from agents list)。
+     * - 显式 `deniedTools: [delegate_task, stop_task]` 防递归委托 (新增)。
+     * - 显式 `systemPromptRef: workflow-runner` 强绑定 prompt (新增)。
+     * - 显式 `maxIterations: 30` 防 #2151 M3 silent removal (新增 + 测试锁住)。
+     * - Task #2486: description 显式强调 workflow_name 必传 + search-first 兜底
+     *   (防 prompt 改了一处 description 没跟上)。
+     *
+     * 通过 allowedTools 限制只能使用 workflow 工具,
+     * 避免 LLM 走捷径直接执行任务而不走 workflow run 路径。
+     */
+    registerWorkflowRunner(): void;
+    /**
+     * 注册内置 task-organizer agent (Task #2348)
+     *
+     * task-organizer 是 Roy 系统的"任务树整理"子智能体 (type=sub)，专门负责
+     * 维护任务树形态健康：
+     *
+     * 1. **根任务收敛**：非归档的根任务维持在 10-20 个
+     * 2. **根任务 longterm 化**：根任务 100% 为 longterm 类型
+     * 3. **重新挂载**：把非 longterm 类型的根任务 re-parent 到语义匹配的 longterm 父任务下
+     * 4. **合并 / 归档 / 删除**：处理重复、过期、纯测试任务
+     *
+     * 工具白名单（15 个任务管理工具）：
+     * - 6 个核心 CRUD：task_create / task_get / task_list / task_update / task_delete / task_complete
+     * - 2 个观察工具：task_tree / task_search
+     * - 2 个批量操作：task_batch_archive / task_batch_delete
+     * - 5 个 operation 工具：task_operation_create / get / list / update / delete
+     *
+     * deniedTools 禁止递归委托（防整理器自己再起子代理导致失控）。
+     *
+     * 使用方式：
+     * - CLI: `roy-agent act "整理任务" --agent task-organizer`
+     * - 父 agent: `delegate_task(subagent_type="task-organizer", ...)`
+     *
+     * 默认 systemPrompt 来自 builtInPrompts['task-organizer']，会被
+     * `~/.local/share/roy-agent/prompts/task-organizer.md` 覆盖。
+     */
+    registerTaskOrganizer(): void;
+    /**
+     * 注册内置 json-extract agent
+     *
+     * json-extract 是 workflow 结构化输出（output.mode=json）专用的子智能体，
+     * 由 workflow-json-output-plugin 在 agent:after.react hook 中调用：
+     *
+     *   agentComponent.run('json-extract', '', {
+     *     sessionId,            // 复用主 session 读 history
+     *     extraTools: [submit], // 动态注入 workflow_submit_output
+     *     persistSession: false, // 不污染 session
+     *     abort,
+     *   })
+     *
+     * 设计要点：
+     * - type='sub'：一次性调用的子 agent
+     * - systemPromptRef='json-extract'：从 builtInPrompts 解析
+     * - allowedTools=['workflow_submit_output']：唯一可用工具
+     * - maxIterations=5：允许最多 5 次 tool call（provider 不支持 toolChoice=required 时多次重试）
+     * - filterHistory=false：必须看到父 session 的全部历史
+     */
+    registerJsonExtractAgent(): void;
+    /**
+     * 注册内置 workflow-extract agent
+     *
+     * workflow-extract 是 task completion 时从对话历史提取 Workflow 的子智能体，
+     * 由 task-tag-plugin 在 task:operation:after.create (completed) hook 中调用：
+     *
+     *   agentComponent.run('workflow-extract', input, {
+     *     sessionId,            // 复用主 session 读 history
+     *     persistSession: false, // 不污染 session
+     *     abort,
+     *   })
+     *
+     * 设计要点：
+     * - type='sub'：一次性调用的子 agent
+     * - systemPromptRef='workflow-extract'：从 builtInPrompts 解析
+     * - allowedTools=['workflow_get','workflow_list','workflow_add','workflow_validate']：
+     *   严格限制为 workflow 工具，避免走捷径
+     * - maxIterations=10：允许 generate→validate→fix→add 的迭代循环
+     * - filterHistory=false：必须看到父 session 的全部历史
+     *
+     * 注：用户原始描述提到 'workflow_nodes'，但该工具目前不存在；
+     * workflow_get 已能查看任意 workflow 的节点结构，故不引入该工具。
+     */
+    registerWorkflowExtractAgent(): void;
+    /**
+     * 注册内置 workflow-creator (Task #2194)
+     *
+     * workflow-creator 是与 workflow-runner / workflow-extract 同层的 sub 类型子代理，
+     * 专门负责与用户**多轮对话式**协作构建 workflow。
+     *
+     * 与 workflow-extract 的差异:
+     * - workflow-extract: 从已完成 task 对话历史**自动**提取 workflow (one-shot)
+     * - workflow-creator: 与用户**多轮对话**，协作设计 + 迭代验证 + 注册 (interactive)
+     *
+     * 设计要点：
+     * - type='sub'：作为 subagent 可被 delegate_task 委托
+     * - systemPromptRef='workflow-creator'：从 builtInPrompts 解析
+     * - allowedTools=6 个：workflow_list / workflow_get / workflow_search /
+     *   workflow_tag_list / workflow_validate / workflow_add
+     *   （比 workflow-extract 多 workflow_search + workflow_tag_list）
+     * - deniedTools=['delegate_task','stop_task']：禁止嵌套委托（与 roy/explore 一致）
+     * - maxIterations=30：支持多轮工具调用（澄清需求→学习→设计→validate→add）
+     *
+     * 调用方：default 接待员 agent 在用户说"帮我建一个 workflow"时 delegate 过来。
+     */
+    registerWorkflowCreator(): void;
+    /**
+     * 注册内置 compact agent
+     *
+     * compact 是 session 压缩专用的子 agent，由 SessionComponent.compact() 调用：
+     *
+     *   agentComponent.run('compact', scenarioHint, {
+     *     sessionId,            // 复用主 session 读 history
+     *     persistSession: false, // 不污染 session
+     *   })
+     *
+     * 设计要点：
+     * - type='sub'：一次性调用的子 agent
+     * - systemPromptRef='compact'：从 builtInPrompts 解析
+     * - allowedTools=['workflow_submit_output']：唯一可用工具
+     * - maxIterations=3：给「首轮没调对 tool」留**一次真正的重试**机会
+     *   （2026-10-16 修复：原为 1，首轮失败即终局）
+     *
+     *   ★ 为什么是 3 而不是 2：max-iteration-reminder 插件在
+     *   `iteration === maxIterations - 1` 注入「已达最大迭代，别再调工具」提醒。
+     *     - maxIterations=1 → 插件防御性跳过（单轮无前置迭代）
+     *     - maxIterations=2 → 在 iteration 1 就注入「别再调工具」，把唯一的重试机会掐死
+     *     - maxIterations=3 → 提醒落在 iteration 2，因此 iteration 2 是干净的一次重试，
+     *       只有 iteration 3 才被提醒压制
+     *   与 json-extract 对齐（它用 5，注释同为「provider 不支持 toolChoice=required 时
+     *   多次重试」）——这是同一个问题的既有先例。
+     * - filterHistory=false：必须看到父 session 的全部历史
+     */
+    registerCompactAgent(): void;
+    /**
+     * 注册内置 compact-hint agent
+     *
+     * compact-hint 是 session 压缩的第一阶段子 agent（Phase 1），
+     * 由 SessionComponent.generateCompactHint() 调用：
+     *
+     *   agentComponent.run('compact-hint', 'Analyze this conversation and generate a compact guidance prompt', {
+     *     sessionId,
+     *     persistSession: false,
+     *   })
+     *
+     * 设计要点：
+     * - type='sub'：一次性调用的子 agent
+     * - systemPromptRef='compact-hint'：从 builtInPrompts 解析
+     * - allowedTools=[]：纯文本 JSON 输出，无需工具
+     * - maxIterations=3：同 compact —— 给首轮没调对 tool 留一次真正的重试机会
+     *   （2026-10-16 修复：原为 1；判定依据详见 registerCompactAgent 的说明）
+     * - filterHistory=false：读取父 session 全部历史
+     */
+    registerCompactHintAgent(): void;
+    /**
+     * 注册内置 roy agent
+     *
+     * roy 是 Roy Intelligent OS 的核心子智能体（type='sub'），
+     * 提供通用 AI 助手能力：编码、研究、规划、执行、工具使用。
+     *
+     * 设计要点：
+     * - type='sub'：作为 subagent 可被 delegate_task(subagent_type="roy") 调用
+     * - systemPromptRef='roy'：从 builtInPrompts['roy'] 解析（bundle-time 内置 prompt）
+     * - deniedTools=['delegate_task','stop_task']：禁止嵌套 delegation（与 general/explore 一致）
+     * - 不设 allowedTools：保留 roy 的通用工具能力
+     * - 不设 maxIterations：使用默认上限
+     *
+     * 用户体验：
+     * - 新装用户无需 `agent add roy` 即可在 `roy-agent agents list` 中看到 roy
+     * - `delegate_task(subagent_type="roy")` 开箱即用
+     * - 用户可在 ~/.local/share/roy-agent/agents/roy.yaml 自定义覆盖（默认配置会被覆盖）
+     *
+     * 实现路径：与 workflow-runner / json-extract / workflow-extract / compact / compact-hint 保持一致
+     * （registry 内置 + systemPromptRef 引用 builtInPrompts）。
+     */
+    registerRoyAgent(): void;
+    /**
+     * 加载配置目录中的所有 agent
+     */
+    load(): Promise<number>;
+    /**
+     * 从目录加载 agent 配置文件
+     */
+    loadFromDirectory(directory: string): Promise<number>;
+    /**
+     * 解析 YAML 配置
+     */
+    private parseAgentConfig;
+    /**
+     * 保存 agent 到配置文件
+     */
+    saveAgent(agent: AgentDefinition): Promise<boolean>;
+    /**
+     * 确保配置目录存在
+     */
+    private ensureConfigDir;
+    /**
+     * 将 agent 转换为 YAML 格式
+     */
+    private agentToYaml;
+    /**
+     * 删除 agent 配置文件
+     */
+    deleteAgent(name: string): Promise<boolean>;
+    /**
+     * 导出所有 agent
+     */
+    exportAgents(options?: ExportOptions): AgentDefinition[];
+    /**
+     * 导出为 JSON 字符串
+     */
+    exportAgentsAsJson(): string;
+    /**
+     * 获取 agent 数量
+     */
+    size(): number;
+    /**
+     * 检查配置目录是否存在
+     */
+    configDirExists(): boolean;
+    /**
+     * 获取 agent 配置文件路径
+     */
+    getAgentFilePath(name: string): string;
+}
+export declare const DEFAULT_SUBAGENT_PROMPT = "You are a subagent created by the main agent to handle a specific task.\n\n## Your Role\n- You were created to handle: {task_description}\n- Complete this task. That's your entire purpose.\n- You are NOT the main agent. Don't try to be.\n\n## Rules\n1. **Stay focused** - Do your assigned task, nothing else\n2. **Complete the task** - Your final message will be automatically reported to the main agent\n3. **Don't initiate** - No heartbeats, no proactive actions, no side quests\n4. **Be ephemeral** - You may be terminated after task completion. That's fine.\n5. **No nested delegation** - Do NOT use delegate_task or stop_task tools. Complete the task yourself.\n\n## Execution\n- Use the available tools to complete the task\n- If you need more information, ask the main agent through the result\n- Return a clear summary of what you did and the results";

package/dist/env/agent/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Agent Component Module
+ *
+ * 导出 AgentComponent 及其相关类型
+ */
+export { AgentComponent, AgentComponentConfigSchema, type AgentComponentConfig } from "./agent-component";
+export { SummaryAgent } from "./summary-agent";
+export * from "./types";
+export type { LLMOutput } from "../llm/types";

package/dist/env/agent/index.js

@@ -2,14 +2,14 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-3tv1q6f2.js";
+} from "../../shared/@ai-setting/roy-agent-core-ytr2w0vb.js";
 import"../../shared/@ai-setting/roy-agent-core-fvs48d38.js";
 import"../../shared/@ai-setting/roy-agent-core-kzg1jwt8.js";
 import"../../shared/@ai-setting/roy-agent-core-rx16h2m1.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-dv714bqh.js";
-import"../../shared/@ai-setting/roy-agent-core-pk1b3kvf.js";
-import"../../shared/@ai-setting/roy-agent-core-zy3hqfwg.js";
+import"../../shared/@ai-setting/roy-agent-core-2b8jtv7m.js";
+import"../../shared/@ai-setting/roy-agent-core-0hq21px2.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";

package/dist/env/agent/summary-agent.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Summary Agent
+ *
+ * 两阶段 session 压缩中的 Phase 1：生成场景化压缩提示 (Compact Hint)
+ *
+ * Phase 1: 分析会话历史 → 生成指导 Phase 2 的场景化提示
+ * Phase 2: 由内置 compact agent 处理（SessionComponent.compact 中调用 AgentComponent.run）
+ */
+import type { SummaryAgentConfig } from "./types";
+import type { LLMComponent } from "../llm/llm";
+/**
+ * Summary Agent
+ *
+ * @deprecated Phase 1 compact hint generation has been migrated to
+ * SessionComponent.generateCompactHint() using AgentComponent.run("compact-hint", ...).
+ *
+ * This class is retained for backward compatibility with existing tests
+ * (summary-agent.role-filter.test.ts, invoke-threshold-check.test.ts).
+ * It no longer contains any active logic.
+ */
+export declare class SummaryAgent {
+    private llmComponent;
+    private config;
+    constructor(_promptComponent: unknown, llmComponent: LLMComponent, config?: Partial<SummaryAgentConfig>);
+}
+/**
+ * 解析 Compact Hint 响应
+ *
+ * 纯函数，可独立测试
+ */
+export declare function parseCompactHintResponse(content: string): string;
+/**
+ * 解析 JSON 响应（用于 Phase 2 compact agent 输出解析）
+ *
+ * 从 SessionComponent.compact() 中解析 compact agent 返回的 JSON。
+ * 纯函数，方便测试。
+ */
+export declare function parseCompactJsonResponse(content: string): {
+    title: string;
+    processKeyPoints: string[];
+    currentState: string;
+    nextSteps: string[];
+    userIntents: string[];
+};