@ai-setting/roy-agent-core 1.5.17-beta.1 → 1.5.22

package/dist/env/workflow/engine/index.d.ts

@@ -1,3453 +0,0 @@
-/**
-* @fileoverview Hook 系统统一类型定义
-* 
-* 提供所有 Component 使用的统一 Hook 接口
-*/
-/**
-* Hook 执行阶段
-*/
-type HookPhase = "before" | "after" | "error";
-/**
-* Hook 元信息
-*/
-interface HookMeta {
-	/** Hook 唯一名称 */
-	name: string;
-	/** 执行优先级，默认 0，数值越小越先执行 */
-	priority?: number;
-	/** 描述 */
-	description?: string;
-}
-/**
-* 统一 Hook 上下文
-* 
-* 泛型参数 T 表示该 Component 的上下文数据类型
-*/
-interface HookContext<T = unknown> {
-	/** 当前组件信息 */
-	component: {
-		/** 组件名称 */
-		name: string;
-		/** 组件版本 */
-		version: string;
-	};
-	/** 上下文数据（Component 特定） */
-	data: T;
-	/** 元数据（可用于传递额外信息） */
-	metadata: Record<string, unknown>;
-	/** 执行阶段 */
-	phase: HookPhase;
-	/** 关联的 hook 点名称 */
-	hookPoint: string;
-}
-/**
-* 统一 Hook 接口
-* 
-* 所有 Component 的 Hook 都应实现此接口
-*/
-interface Hook<T = unknown> extends HookMeta {
-	/** 执行 Hook
-	* @param ctx 上下文
-	*/
-	execute(ctx: HookContext<T>): void | Promise<void>;
-}
-/**
-* Hook 函数类型（便捷别名）
-*/
-type HookFn<T = unknown> = (ctx: HookContext<T>) => void | Promise<void>;
-/**
-* Hook 干预动作类型
-*/
-type HookActionType = "stop" | "retry" | "compress" | "extract_memory" | "inject_message" | "skip_tool" | "custom";
-/**
-* Hook 干预动作
-*/
-interface HookAction {
-	/** 动作类型 */
-	type: HookActionType;
-	/** 动作参数 */
-	params?: Record<string, unknown>;
-	/** 动作描述 */
-	description?: string;
-}
-/**
-* Hook 执行结果
-*/
-interface HookResult {
-	/** 是否被停止 */
-	stopped?: boolean;
-	/** 干预动作（如果有） */
-	action?: HookAction;
-	/** 执行结果数据 */
-	results?: unknown[];
-}
-/**
-* HookManager 配置
-*/
-interface HookManagerOptions {
-	/** 组件名称（用于上下文） */
-	componentName?: string;
-	/** 组件版本（用于上下文） */
-	componentVersion?: string;
-	/** 默认优先级 */
-	defaultPriority?: number;
-}
-/**
-* HookManager
-* 
-* 统一管理 Component 的 Hook
-* 
-* @example
-* ```typescript
-* const manager = new HookManager<MyContext>();
-* 
-* // 注册 Hook
-* manager.register("before-action", {
-*   name: "my-hook",
-*   priority: 10,
-*   execute: async (ctx) => { /* ... *\/ }
-* });
-* 
-* // 执行 Hooks
-* await manager.execute("before-action", data);
-* ```
-*/
-declare class HookManager<T = unknown> {
-	private _hooks;
-	private componentName;
-	private componentVersion;
-	private defaultPriority;
-	constructor(options?: HookManagerOptions);
-	/**
-	* 注册 Hook 到指定 hook 点
-	*/
-	register(hookPoint: string, hook: Hook<T>): void;
-	/**
-	* 注册多个 Hook
-	*/
-	registerMany(hookPoint: string, hooks: Hook<T>[]): void;
-	/**
-	* 按名称取消注册 Hook
-	* @returns 是否成功取消注册
-	*/
-	unregister(hookPoint: string, name: string): boolean;
-	/**
-	* 取消注册所有指定 hook 点的 Hook
-	*/
-	unregisterAll(hookPoint: string): void;
-	/**
-	* 执行指定 hook 点的所有 Hook
-	*/
-	execute(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
-	/**
-	* 执行指定 hook 点的所有 Hook 并收集返回值
-	*/
-	executeAndCollect<R>(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<R[]>;
-	/**
-	* 获取指定 hook 点的 Hook 数量
-	*/
-	count(hookPoint: string): number;
-	/**
-	* 清空所有 Hook
-	*/
-	clear(): void;
-	/**
-	* 获取所有已注册的 hook 点
-	*/
-	getHookPoints(): string[];
-	/**
-	* 检查 hook 点是否有任何 Hook
-	*/
-	hasHooks(hookPoint: string): boolean;
-	/**
-	* 设置组件信息
-	*/
-	setComponentInfo(name: string, version: string): void;
-	/**
-	* 获取所有注册的 hooks（只读副本）
-	*/
-	get hooks(): ReadonlyMap<string, Hook<T>[]>;
-	/**
-	* 执行 Hook 并支持干预机制
-	* 
-	* 如果任何一个 Hook 返回 { stop: true }，执行会停止
-	* Hook 可以通过返回 HookResult 来执行干预动作
-	* 
-	* @param hookPoint Hook 点
-	* @param data 数据
-	* @param metadata 元数据
-	* @returns 执行结果
-	*/
-	executeWithIntervention(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<HookResult>;
-	/**
-	* 获取或创建 hook 列表
-	*/
-	private getOrCreateHooks;
-	/**
-	* 按优先级排序 Hook
-	* 
-	* 优先级相同时保持原顺序（稳定排序）
-	*/
-	private sortHooks;
-	/**
-	* 创建 Hook 上下文
-	*/
-	private createContext;
-	/**
-	* 安全执行 Hook（错误隔离）
-	*/
-	private safeExecute;
-	/**
-	* 安全执行 Hook 并返回结果
-	*/
-	private safeExecuteAndReturn;
-}
-import { z as z5 } from "zod";
-import { z as z4 } from "zod";
-import { z } from "zod";
-declare const WorkflowEventSchema: unknown;
-type WorkflowEvent = z.infer<typeof WorkflowEventSchema>;
-type EventHandler = (event: WorkflowEvent) => void | Promise<void>;
-/**
-* EventBus for workflow events.
-* Custom event bus implementation with support for wildcard subscriptions.
-*/
-declare class EventBus {
-	private handlers;
-	private wildcardHandlers;
-	constructor();
-	/**
-	* Subscribe to a specific event type.
-	* @returns Unsubscribe function
-	*/
-	on(eventType: string, handler: EventHandler): () => void;
-	/**
-	* Subscribe to an event type only once (auto-unsubscribe after first call).
-	* @returns Unsubscribe function
-	*/
-	once(eventType: string, handler: EventHandler): () => void;
-	/**
-	* Unsubscribe from an event type.
-	*/
-	off(eventType: string, handler: EventHandler): void;
-	/**
-	* Subscribe to all events (wildcard subscription).
-	* @returns Unsubscribe function
-	*/
-	onAny(handler: EventHandler): () => void;
-	/**
-	* Publish an event to all subscribers.
-	* Handler errors are caught and do not crash the bus.
-	* 
-	* @param event - The event to publish
-	* @param waitForHandlers - If true, waits for all async handlers to complete (default: false)
-	*/
-	publish(event: WorkflowEvent, waitForHandlers?: boolean): Promise<void>;
-	/**
-	* Execute a handler safely, catching any errors.
-	*/
-	private executeHandler;
-	/**
-	* Clear all subscriptions.
-	*/
-	clear(): void;
-	/**
-	* Get statistics about the event bus.
-	*/
-	getStats(): {
-		eventTypes: number;
-		wildcardHandlers: number;
-		totalHandlers: number;
-	};
-}
-import { ZodType as ZodType3, ZodTypeDef as ZodTypeDef2 } from "zod";
-/**
-* @fileoverview Environment types and interfaces
-* 
-* 定义 Environment 的核心类型，包括：
-* - Environment 配置
-* - EnvEvent 事件类型
-*/
-/**
-* Environment Config
-*/
-interface EnvironmentConfig {
-	/** 环境名称 */
-	name: string;
-	/** 环境版本 */
-	version: string;
-	/** 是否启用 */
-	enabled: boolean;
-}
-/**
-* EnvEvent 元信息
-*/
-interface EnvEventMetadata {
-	/** 触发事件的 session ID */
-	trigger_session_id?: string;
-	/** 触发事件的 agent ID */
-	trigger_agent_id?: string;
-	/** Agent 名称 */
-	trigger_agent_name?: string;
-	/** 环境名称 */
-	env_name?: string;
-	/** 事件来源 */
-	source?: string;
-	/** 其他元数据 */
-	[key: string]: unknown;
-}
-/**
-* EnvEvent
-* 
-* 统一的事件机制，用于：
-* - Stream 事件（stream.start, stream.text, stream.completed 等）
-* - 工具调用事件（tool.call, tool.result 等）
-* - 会话事件（session.created, session.updated 等）
-* - Agent 事件（agent.thinking, agent.acting 等）
-*/
-interface EnvEvent<T = unknown> {
-	/** 事件 ID */
-	id: string;
-	/** 事件类型 */
-	type: string;
-	/** 时间戳 */
-	timestamp: number;
-	/** 元信息 */
-	metadata: EnvEventMetadata;
-	/** 事件负载 */
-	payload: T;
-}
-/**
-* EnvEvent Handler
-*/
-type EnvEventHandler = (event: EnvEvent) => void | Promise<void>;
-/**
-* EnvEvent 创建参数（部分属性，可选）
-* 
-* 用于 pushEnvEvent 方法，允许传入部分属性，自动补全必填字段
-*/
-interface EnvEventInput {
-	/** 事件类型（必填） */
-	type: string;
-	/** 事件 ID（可选，自动生成） */
-	id?: string;
-	/** 时间戳（可选，自动生成） */
-	timestamp?: number;
-	/** 元信息（可选，自动创建） */
-	metadata?: EnvEventMetadata;
-	/** 事件负载（可选） */
-	payload?: unknown;
-}
-/**
-* Action 类型
-*/
-interface Action {
-	/** Action 类型 */
-	type: string;
-	/** Action 参数 */
-	params?: Record<string, unknown>;
-}
-/**
-* Tool Result
-*/
-interface ToolResult {
-	/** 是否成功 */
-	success: boolean;
-	/** 输出内容 */
-	output: string | Record<string, unknown>;
-	/** 错误信息 */
-	error?: string;
-}
-/**
-* Context
-*/
-interface Context {
-	/** 会话 ID */
-	sessionId?: string;
-	/** 用户 ID */
-	userId?: string;
-	/** 工作目录 */
-	workdir?: string;
-	/** 中断信号 */
-	abort?: AbortSignal;
-	/** 元数据 */
-	metadata?: Record<string, unknown>;
-}
-import { ModelMessage } from "ai";
-import { z as z2, ZodType, ZodError } from "zod";
-/**
-* 沙箱配置
-*/
-interface SandboxConfig {
-	/** 是否启用沙箱 */
-	enabled: boolean;
-	/** 沙箱类型 */
-	type: "native" | "docker";
-	/** 动作过滤 */
-	actionFilter?: {
-		/** 包含的动作 */
-		include?: string[];
-		/** 排除的动作 */
-		exclude?: string[];
-	};
-	/** 文件系统限制 */
-	filesystem?: {
-		/** 允许读取 */
-		allowRead?: string[];
-		/** 禁止读取 */
-		denyRead?: string[];
-		/** 允许写入 */
-		allowWrite?: string[];
-		/** 禁止写入 */
-		denyWrite?: string[];
-	};
-	/** 网络限制 */
-	network?: {
-		/** 允许的域名 */
-		allowedDomains?: string[];
-		/** 禁止的域名 */
-		deniedDomains?: string[];
-	};
-	/** Docker 配置 */
-	docker?: {
-		/** 镜像 */
-		image?: string;
-		/** 网络模式 */
-		networkMode?: "bridge" | "host" | "none";
-		/** 卷挂载 */
-		volumes?: Record<string, string>;
-	};
-}
-/**
-* 工具执行上下文
-*/
-interface ToolContext {
-	/** 工作目录 */
-	workdir?: string;
-	/** 用户 ID */
-	user_id?: string;
-	/** 会话 ID */
-	session_id?: string;
-	/** 消息 ID */
-	message_id?: string;
-	/** 中断信号 */
-	abort?: AbortSignal;
-	/** 额外元数据 */
-	metadata?: Record<string, unknown>;
-	/** 沙箱配置 */
-	sandbox?: SandboxConfig;
-	/** 沙箱 Provider */
-	sandboxProvider?: unknown | null;
-}
-/**
-* 工具结果元数据
-*/
-interface ToolResultMetadata {
-	/** 执行时间（毫秒） */
-	execution_time_ms: number;
-	/** 输出大小（字节） */
-	output_size?: number;
-	/** 标准输出 */
-	stdout?: string;
-	/** 标准错误 */
-	stderr?: string;
-	/** 退出码 */
-	exit_code?: number;
-	/** Token 使用量 */
-	usage?: {
-		inputTokens: number;
-		outputTokens: number;
-		totalTokens?: number;
-	};
-	/** 额外元数据 */
-	[key: string]: unknown;
-}
-/**
-* 工具执行结果
-*/
-interface ToolResult2 {
-	/** 是否成功 */
-	success: boolean;
-	/** 输出内容 */
-	output: string | Record<string, unknown>;
-	/** 错误信息 */
-	error?: string;
-	/** 结果元数据 */
-	metadata?: ToolResultMetadata;
-}
-/**
-* 工具元数据
-*/
-interface ToolMetadata {
-	/** 分类 */
-	category?: string;
-	/** 标签 */
-	tags?: string[];
-	/** 版本 */
-	version?: string;
-	/** 作者 */
-	author?: string;
-	/** 是否实验性 */
-	experimental?: boolean;
-	/** MCP 工具信息（MCP adapter 使用） */
-	mcpTool?: {
-		originalName: string;
-		originalDescription: string;
-		inputSchema?: unknown;
-	};
-}
-/**
-* 工具沙箱配置
-*/
-interface ToolSandboxConfig {
-	/** 是否启用沙箱 */
-	enabled: boolean;
-	/** 沙箱配置 */
-	config?: Partial<SandboxConfig>;
-}
-/**
-* 工具权限配置
-*/
-interface ToolPermissionConfig {
-	/** 是否需要用户确认 */
-	requireConfirmation?: boolean;
-	/** 权限级别 */
-	level?: "safe" | "dangerous" | "critical";
-}
-/**
-* 工具信息
-*/
-interface ToolInfo<Parameters extends ZodType = ZodType> {
-	/** 工具名称 */
-	name: string;
-	/** 工具描述 */
-	description: string;
-	/** 参数 Schema */
-	parameters: Parameters;
-	/** 初始化函数（可选） */
-	init?: (ctx?: ToolContext) => Promise<void>;
-	/** 执行函数 */
-	execute: (args: z2.infer<Parameters>, ctx: ToolContext) => Promise<ToolResult2>;
-	/** 参数验证错误格式化（可选） */
-	formatValidationError?: (error: ZodError) => string;
-	/** 沙箱配置 */
-	sandbox?: ToolSandboxConfig;
-	/** 权限配置 */
-	permission?: ToolPermissionConfig;
-	/** 工具元数据 */
-	metadata?: ToolMetadata;
-}
-/**
-* 工具类型别名
-*/
-type Tool = ToolInfo;
-type AbortSignalType = AbortSignal;
-interface ProjectSummary {
-	projectPath: string;
-	projectName: string;
-	lastUpdated: number;
-	summary: string;
-	shortSummary: string;
-	draftCount: number;
-	memoryMdPath: string;
-	draftsDir: string;
-	detailsDir: string;
-}
-/**
-* Agent 执行上下文
-*/
-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;
-}
-/**
-* 工具调用（内部使用）
-*/
-interface ToolCall2 {
-	/** 调用 ID */
-	id: string;
-	/** 工具名称 */
-	name: string;
-	/** 调用参数 */
-	arguments: Record<string, unknown>;
-}
-/**
-* 工具调用结果
-*/
-interface ToolCallResult {
-	/** 调用 ID */
-	id: string;
-	/** 工具名称 */
-	name: string;
-	/** 调用结果 */
-	result: ToolResult2;
-	/** 是否成功 */
-	success: boolean;
-}
-/**
-* Hook 点枚举（带 component 前缀）
-*/
-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";
-/**
-* Hook 上下文（Agent 特有版本）
-* 
-* 注意：这是 AgentComponent 使用的 HookContext 扩展版本
-* 包含 iteration, maxIterations, messages 等 Agent 特有字段
-*/
-interface HookContext2 {
-	/** 当前 LLM 输出（after.llm hook 可用） */
-	llmOutput?: AgentLLMOutput;
-	/** 当前工具调用（before.tool/after.tool hook 可用） */
-	currentToolCall?: ToolCall2;
-	/** 工具执行结果（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: HookActionType2;
-		payload?: unknown;
-	};
-	/** 错误列表 */
-	_errors?: Array<{
-		plugin: string;
-		error: string;
-	}>;
-	/** Project Memory Agent 生成的摘要列表（由 Project Agent 写入，Global Agent 读取） */
-	projectSummaries?: ProjectSummary[];
-}
-/**
-* Hook 干预动作
-*/
-type HookActionType2 = "stop" | "retry" | "compress" | "extract_memory" | "inject_message" | "skip_tool";
-/**
-* Hook 返回结果
-*/
-interface HookResult2 {
-	/** 是否继续执行（false = 停止 Agent） */
-	continue: boolean;
-	/** 干预动作（可选） */
-	action?: {
-		type: HookActionType2;
-		payload?: unknown;
-	};
-}
-/**
-* Plugin 定义
-*/
-interface Plugin {
-	/** Plugin 唯一名称 */
-	name: string;
-	/** Plugin 版本 */
-	version: string;
-	/** Plugin 描述 */
-	description?: string;
-	/** 订阅的 Hook 点及优先级 */
-	hooks: Array<{
-		point: HookPoint;
-		/** 优先级，默认 0，数字越大越先执行 */
-		priority?: number;
-	}>;
-	/** 执行函数 */
-	execute: (ctx: HookContext2) => HookResult2 | Promise<HookResult2>;
-}
-/**
-* Agent 类型
-*/
-type AgentType = "primary" | "sub" | "summary";
-/**
-* Agent 状态
-*/
-type AgentStatus = "idle" | "running" | "paused" | "stopped" | "error";
-/**
-* Agent 实例配置
-*/
-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 实例
-*/
-interface AgentInstance {
-	/** Agent 名称 */
-	name: string;
-	/** Agent 配置 */
-	config: Required<AgentInstanceConfig>;
-	/** 当前状态 */
-	status: AgentStatus;
-	/** 注册的 Plugins */
-	plugins: Map<string, Plugin>;
-}
-/**
-* Agent 执行结果
-*/
-interface AgentRunResult {
-	/** 最终文本响应 */
-	finalText?: string;
-	/** 是否被 hook 停止 */
-	stopped?: boolean;
-	/** 停止原因 */
-	stopReason?: string;
-	/** 执行的迭代次数 */
-	iterations: number;
-	/** 工具调用列表 */
-	toolCalls: ToolCall2[];
-	/** 错误信息（如有） */
-	error?: string;
-}
-/**
-* Agent 内部使用的 LLM 输出
-* 独立定义以避免与 LLMOutput 的类型冲突
-*/
-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;
-}
-import { ZodType as ZodType2, ZodTypeDef } from "zod";
-/**
-* ConfigSource 类型
-*/
-type ConfigSourceType = "memory" | "file" | "env" | "remote";
-/**
-* SourceRegistration - Source 注册配置
-*/
-interface SourceRegistration {
-	/** Source 类型 */
-	type: ConfigSourceType;
-	/** 相对路径（file 类型使用，基于 XDG_DATA_HOME） */
-	relativePath?: string;
-	/** 环境变量前缀（env 类型使用） */
-	envPrefix?: string;
-	/** 优先级，默认值：memory=0, file=10, env=20 */
-	priority?: number;
-	/** 是否可选（file 类型使用，文件不存在时不报错） */
-	optional?: boolean;
-	/** 是否启用文件监听（file 类型使用，默认 true） */
-	watch?: boolean;
-}
-/**
-* KeyRegistration - 配置 Key 注册
-*/
-interface KeyRegistration {
-	/** 配置 Key（支持点号嵌套，如 "llm.provider"） */
-	key: string;
-	/** 优先使用的 Source 列表（按优先级从低到高） */
-	sources: ConfigSourceType[];
-	/** 自定义优先级（覆盖默认优先级） */
-	priority?: number;
-	/** 默认值 */
-	default?: unknown;
-}
-/**
-* ComponentRegistration - Component 注册配置
-*/
-interface ComponentRegistration {
-	/** Component 名称 */
-	name: string;
-	/** 声明需要的 Source */
-	sources: SourceRegistration[];
-	/** 声明需要的配置 Key */
-	keys: KeyRegistration[];
-	/** 配置 Schema（用于验证，可选） */
-	schema?: ZodType2<unknown, ZodTypeDef, unknown>;
-	/** 默认值 */
-	defaults?: Record<string, unknown>;
-}
-/**
-* ConfigSource 接口
-*/
-interface ConfigSource {
-	readonly name: ConfigSourceType;
-	readonly priority: number;
-	read(key: string): unknown | undefined;
-	write?(key: string, value: unknown): boolean;
-	delete?(key: string): boolean;
-	list(): Array<{
-		key: string;
-		value: unknown;
-	}>;
-	watch?(callback: (event: ConfigChangeEvent) => void): () => void;
-}
-/**
-* Config 变更事件
-*/
-interface ConfigChangeEvent {
-	type: "change" | "add" | "delete";
-	key: string;
-	oldValue: unknown;
-	newValue: unknown;
-	source: ConfigSourceType;
-	timestamp: number;
-}
-/**
-* ConfigComponent 配置
-*/
-interface ConfigComponentOptions {
-	/** 持久化文件路径 */
-	persistFile?: string;
-	/** 防抖延迟（ms） */
-	debounceMs?: number;
-	/** 最大批量大小 */
-	maxBatchSize?: number;
-}
-/**
-* ConfigComponent
-*/
-declare class ConfigComponent extends BaseComponent {
-	readonly name = "config";
-	readonly version = "1.0.0";
-	private memorySource;
-	private sources;
-	private componentSchemas;
-	private componentPaths;
-	private watchers;
-	/** Source watch unsubscribe 函数 */
-	private sourceUnwatchFns;
-	private persistQueue;
-	private persistFile?;
-	/** Key 注册表：key -> KeyRegistration */
-	private keyRegistry;
-	/** Component 注册表：name -> ComponentRegistration */
-	private componentRegistrations;
-	/** 协议解析器 */
-	private protocolResolver?;
-	/** XDG_DATA_HOME 缓存（用于测试注入） */
-	private __xdgDataHome?;
-	/** Source 注册配置（延迟创建） */
-	private pendingSources;
-	/** Source 唯一标识缓存：type:relativePath -> true */
-	private sourceKeys;
-	/**
-	* 获取 XDG_DATA_HOME（动态获取，支持运行时覆盖）
-	*/
-	getXdgDataHome(): string;
-	/**
-	* 设置 XDG_DATA_HOME（用于测试）
-	*/
-	setXdgDataHome(path: string): void;
-	constructor(options?: ConfigComponentOptions);
-	/**
-	* 注册 Component Schema
-	*/
-	register(schema: ComponentSchema): void;
-	/**
-	* 注销 Component
-	*/
-	unregister(name: string): boolean;
-	/**
-	* 检查是否已注册
-	*/
-	isRegistered(name: string): boolean;
-	/**
-	* 列出所有注册的 Component
-	*/
-	listComponents(): string[];
-	/**
-	* 获取配置值（支持 xxx.yyy.zzz 嵌套访问）
-	* 支持两种模式：
-	* 1. 完整 key：直接查找，如 "component.key" -> 读取 "component.key"
-	* 2. 嵌套对象：查找 component 对象后从中获取属性，如 "component.nested.deep" 
-	*    -> 先找 "component.nested"，再获取其 "deep" 属性
-	*/
-	get(key: string): unknown;
-	/**
-	* 批量获取
-	*/
-	getMany(keys: string[]): Record<string, unknown>;
-	/**
-	* 设置配置值（内存级别 + 异步持久化）
-	*/
-	set(key: string, value: unknown): Promise<void>;
-	/**
-	* 批量设置
-	*/
-	setMany(config: Record<string, unknown>): Promise<void>;
-	/**
-	* 获取 Component 的路径
-	*/
-	getPath(component: string, subPath?: string): string;
-	/**
-	* 手动持久化
-	*/
-	save(key?: string): Promise<void>;
-	/**
-	* 重置到默认值
-	*/
-	reset(key: string): Promise<void>;
-	/**
-	* 监听配置变更
-	*/
-	watch(pattern: string, callback: ComponentWatchCallback): () => void;
-	/**
-	* 添加配置源
-	*/
-	addSource(source: ConfigSource): void;
-	/**
-	* 获取 Source 唯一标识
-	*/
-	private getSourceKey;
-	/**
-	* 移除配置源
-	*/
-	removeSource(name: ConfigSourceType): boolean;
-	/**
-	* 关闭所有配置源的 watcher（用于优雅退出）
-	*/
-	unwatchAll(): void;
-	/**
-	* 获取配置源列表
-	*/
-	getSources(): ConfigSource[];
-	private getNestedValue;
-	private notifyWatchers;
-	private persistToFile;
-	/**
-	* 注册配置 Source
-	* 
-	* Source 会在首次 load() 时被创建
-	* 
-	* @example
-	* config.registerSource({ type: "file", relativePath: "llm-config.jsonc" });
-	* config.registerSource({ type: "env", envPrefix: "LLM" });
-	*/
-	registerSource(registration: SourceRegistration): void;
-	/**
-	* 创建 Source 实例
-	*/
-	private createSource;
-	/**
-	* 确保所有待创建的 Source 已被创建
-	*/
-	private ensureSourcesCreated;
-	/**
-	* 注册配置 Key
-	* 
-	* @example
-	* config.registerKeys([
-	*   { key: "llm.provider", sources: ["file", "memory"], default: "openai" },
-	*   { key: "llm.model", sources: ["file"] },
-	* ]);
-	*/
-	registerKeys(keys: KeyRegistration[]): void;
-	/**
-	* 注册 Component（一次性注册 Source 和 Keys）
-	* 
-	* @example
-	* config.registerComponent({
-	*   name: "llm",
-	*   sources: [
-	*     { type: "file", relativePath: "llm-config.jsonc" },
-	*     { type: "env", envPrefix: "LLM" },
-	*   ],
-	*   keys: [
-	*     { key: "llm.provider", sources: ["file", "env", "memory"] },
-	*   ],
-	* });
-	*/
-	registerComponent(registration: ComponentRegistration): void;
-	/**
-	* 按需加载配置
-	* 
-	* 从注册的 Source 加载已注册 Keys 的配置值到内存中
-	* 
-	* @param componentName - 可选，指定要加载的 Component 名称
-	* 
-	* @example
-	* // 加载所有已注册的 Keys
-	* await config.load();
-	* 
-	* // 只加载指定 Component 的 Keys
-	* await config.load("llm");
-	*/
-	load(componentName?: string): Promise<void>;
-	/**
-	* 获取已注册的 Source 列表
-	*/
-	getRegisteredSources(): ConfigSource[];
-}
-/**
-* 服务配置接口
-*/
-interface ServiceConfig {
-	/** 环境配置 */
-	environment?: {
-		name?: string;
-		version?: string;
-	};
-	/** 组件配置映射 */
-	components?: Record<string, ComponentConfigEntry>;
-}
-/**
-* 组件配置项
-*/
-interface ComponentConfigEntry {
-	/** 配置文件路径（可选） */
-	configPath?: string;
-	/** 环境变量前缀（可选） */
-	envPrefix?: string;
-	/** 直接配置对象（可选） */
-	config?: Record<string, unknown>;
-	/** 是否启用（可选，默认 true） */
-	enabled?: boolean;
-}
-/**
-* 组件初始化选项（由 generateComponentOptions 生成）
-*/
-interface GeneratedComponentOptions {
-	/** ConfigComponent 实例 */
-	configComponent: ConfigComponent;
-	/** 配置文件路径 */
-	configPath?: string;
-	/** 环境变量前缀 */
-	envPrefix?: string;
-	/** 直接配置对象 */
-	config?: Record<string, unknown>;
-	/** 允许的其他属性 */
-	[key: string]: unknown;
-}
-/**
-* Environment 接口
-* 
-* 定义 Agent 运行时的核心能力接口。
-*/
-interface Environment {
-	/** 环境名称 */
-	readonly name: string;
-	/** 环境版本 */
-	readonly version: string;
-	/** 获取环境配置 */
-	getConfig(): EnvironmentConfig;
-	/**
-	* 注册组件
-	*/
-	registerComponent(component: Component): void;
-	/**
-	* 注销组件
-	*/
-	unregisterComponent(name: string): void;
-	/**
-	* 获取组件
-	*/
-	getComponent<T extends Component>(name: string): T | undefined;
-	/**
-	* 列出所有组件
-	*/
-	listComponents(): Component[];
-	/**
-	* 处理自然语言查询（核心入口）
-	* 
-	* @param query 用户查询文本
-	* @param context 执行上下文（可选）
-	* @returns 完整的文本响应
-	*/
-	handle_query(query: string, context?: AgentContext): Promise<string>;
-	/**
-	* 处理动作
-	*/
-	handle_action(action: Action, context: Context): Promise<ToolResult>;
-	/**
-	* 订阅 EnvEvent（返回取消订阅函数）
-	*/
-	subscribe(handler: EnvEventHandler): () => void;
-	/**
-	* 订阅指定类型事件
-	*/
-	subscribeTo(eventType: string | string[], handler: EnvEventHandler): () => void;
-	/**
-	* 订阅所有事件（通配符）
-	*/
-	subscribeAll(handler: EnvEventHandler): () => void;
-	/**
-	* 推送事件
-	* 
-	* @param event EnvEvent 或 EnvEventInput（部分属性）
-	*/
-	pushEnvEvent(event: EnvEvent | EnvEventInput): void;
-	/**
-	* 从配置文件加载服务配置
-	* 
-	* @param configPath 配置文件路径（基于 XDG_DATA_HOME）
-	* @returns 解析后的服务配置对象
-	*/
-	loadServiceConfig(configPath: string): Promise<ServiceConfig>;
-	/**
-	* 生成组件初始化选项
-	* 
-	* 根据组件配置项生成可用于初始化的选项对象。
-	* 
-	* @param componentName 组件名称
-	* @param configEntry 组件配置项
-	* @returns 生成的组件初始化选项
-	*/
-	generateComponentOptions(componentName: string, configEntry: ComponentConfigEntry): GeneratedComponentOptions;
-	/**
-	* 注册组件并用配置初始化
-	* 
-	* 便捷方法：注册组件并通过 ConfigComponent 初始化。
-	* 
-	* @param component 要注册的组件实例
-	* @param configEntry 组件配置项
-	*/
-	registerComponentWithConfig(component: Component, configEntry: ComponentConfigEntry): Promise<void>;
-	/**
-	* 从配置文件初始化整个环境
-	* 
-	* 加载服务配置，注册并初始化所有配置的组件。
-	* 
-	* @param configPath 配置文件路径（基于 XDG_DATA_HOME）
-	*/
-	initFromConfig(configPath: string): Promise<void>;
-}
-/**
-* Component 状态
-*/
-type ComponentStatus = "created" | "initializing" | "running" | "stopping" | "stopped" | "error";
-/**
-* Component 配置
-*/
-interface ComponentConfig {
-	name: string;
-	version: string;
-	enabled: boolean;
-	options?: Record<string, unknown>;
-	/**
-	* Environment 实例（可选）
-	* 
-	* 推荐在 init 时接收 env 实例，以便：
-	* - 通过 env.getComponent() 获取其他组件
-	* - 通过 env.pushEnvEvent() 发布事件
-	* - 通过 env.handle_query() 处理查询
-	* 
-	* 如果未提供，部分 Component 仍可正常工作（如测试场景）
-	* 
-	* @example
-	* ```typescript
-	* async onInit(): Promise<void> {
-	*   if (this.env) {
-	*     const configComp = this.env.getComponent("config");
-	*   }
-	* }
-	* ```
-	*/
-	env?: Environment;
-}
-/**
-* Component 路径声明
-*/
-interface ComponentPaths {
-	base: "config" | "state" | "data" | "cache";
-	subPath: string;
-	isDirectory: boolean;
-}
-/**
-* Component Schema（注册配置）
-*/
-interface ComponentSchema {
-	/** Component 名称 */
-	name: string;
-	/** 配置 Schema（Zod） */
-	schema: ZodType3<unknown, ZodTypeDef2, unknown>;
-	/** 默认值（从 Schema 提取） */
-	defaults: Record<string, unknown>;
-	/** 路径声明 */
-	paths?: Record<string, ComponentPaths>;
-	/** 元信息 */
-	metadata?: {
-		description?: string;
-		version?: string;
-		author?: string;
-	};
-}
-/**
-* Component 配置变更事件
-*/
-interface ComponentConfigChangeEvent {
-	/** Component 名称 */
-	component: string;
-	/** 变更的配置键 */
-	key: string;
-	/** 旧值 */
-	oldValue: unknown;
-	/** 新值 */
-	newValue: unknown;
-	/** 是否持久化 */
-	persisted: boolean;
-	/** 时间戳 */
-	timestamp: number;
-}
-/**
-* Component 配置监听回调
-*/
-type ComponentWatchCallback = (event: ComponentConfigChangeEvent) => void | Promise<void>;
-/**
-* Component 基类接口
-*/
-interface Component {
-	/** Component 名称 */
-	readonly name: string;
-	/** Component 版本 */
-	readonly version: string;
-	/** 获取状态 */
-	getStatus(): ComponentStatus;
-	/** 获取配置 */
-	getConfig(): ComponentConfig;
-	/** 初始化 */
-	init(config: ComponentConfig): Promise<void>;
-	/** 启动 */
-	start(): Promise<void>;
-	/** 停止 */
-	stop(): Promise<void>;
-}
-/**
-* Component 基类实现
-*/
-declare abstract class BaseComponent implements Component {
-	abstract readonly name: string;
-	abstract readonly version: string;
-	protected _status: ComponentStatus;
-	protected _enabled: boolean;
-	protected env: Environment;
-	/** Hook 管理器 - 子类初始化时由构造函数设置 */
-	readonly hookManager: HookManager;
-	constructor();
-	getStatus(): ComponentStatus;
-	getConfig(): ComponentConfig;
-	/**
-	* 检查 Environment 是否已初始化
-	*/
-	protected isEnvInitialized(): boolean;
-	protected setStatus(status: ComponentStatus): void;
-	/**
-	* 获取 Environment 实例
-	*/
-	protected getEnv(): Environment;
-	init(config?: ComponentConfig): Promise<void>;
-	start(): Promise<void>;
-	stop(): Promise<void>;
-	/**
-	* 子类可覆盖的钩子方法
-	*/
-	protected onInit(): Promise<void>;
-	protected onStart(): Promise<void>;
-	protected onStop(): Promise<void>;
-	/**
-	* 注册 Hook
-	* 
-	* @param hookPoint Hook 点名称
-	* @param hook Hook 实例
-	*/
-	protected registerHook<T = unknown>(hookPoint: string, hook: Hook<T>): void;
-	/**
-	* 便捷方法：快速注册 Hook
-	*/
-	protected addHook<T = unknown>(hookPoint: string, name: string, fn: HookFn<T>, priority?: number): void;
-	/**
-	* 便捷方法：按名称取消注册 Hook
-	*/
-	protected removeHook(hookPoint: string, name: string): boolean;
-	/**
-	* 执行 Hook
-	*/
-	protected executeHooks<T = unknown>(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
-	/**
-	* 获取 ConfigComponent 实例
-	* 
-	* 子类可使用此方法获取配置组件，支持热更新
-	*/
-	protected getConfigComponent(): {
-		get(key: string): unknown;
-	} | undefined;
-	/**
-	* 动态获取运行时配置值
-	* 
-	* 优先从 ConfigComponent 获取（支持热更新），否则返回默认值
-	* 适用于运行时可能变化的配置（如 API Keys、模型参数）
-	* 
-	* @param key 配置键（支持点号分隔的路径，如 "llm.temperature"）
-	* @param defaultValue 默认值
-	* @returns 配置值或默认值
-	* 
-	* @example
-	* ```typescript
-	* // 获取 LLM 温度配置（可能支持热更新）
-	* const temperature = this.getRuntimeConfig("llm.temperature", 0.7);
-	* 
-	* // 获取 API Key
-	* const apiKey = this.getRuntimeConfig<string>("llm.providers.openai.apiKey");
-	* ```
-	*/
-	protected getRuntimeConfig<T>(key: string, defaultValue: T): T;
-}
-/**
-* Checkpoint type
-*/
-type CheckpointType = "compact" | "manual";
-/**
-* Checkpoint metadata (stored in Session.metadata)
-*/
-interface CheckpointMeta {
-	id: string;
-	messageIndex: number;
-	title: string;
-	createdAt: number;
-	type: CheckpointType;
-}
-/**
-* User Intent type - represents a user's intent extracted from conversation
-*/
-type UserIntent = string;
-/**
-* Recent message for checkpoint
-* 
-* Stores a simplified version of a message for context preservation
-*/
-interface RecentMessage {
-	role: string;
-	content: string;
-}
-/**
-* Complete checkpoint information (includes generated content)
-*/
-interface SessionCheckpoint extends CheckpointMeta {
-	summary: string;
-	processKeyPoints: string[];
-	currentState: string;
-	nextSteps: string[];
-	messageCountBefore: number;
-	metadata?: Record<string, unknown>;
-	/** User intents extracted from the conversation */
-	userIntents: UserIntent[];
-	/**
-	* Recent messages preserved from the compacted conversation
-	* 
-	* Contains the last N turns of user query + assistant text response
-	* (excluding tool calls and tool results).
-	* This allows the checkpoint to serve as a fresh history context.
-	* 
-	* Format: [user, assistant, user, assistant, ...] from most recent
-	*/
-	recentMessages?: RecentMessage[];
-}
-/**
-* Checkpoints metadata in session
-*/
-interface SessionCheckpointsMeta {
-	latestCheckpointId?: string;
-	checkpoints: CheckpointMeta[];
-}
-/**
-* Session entity
-*/
-interface Session {
-	id: string;
-	title: string;
-	directory: string;
-	parentID?: string;
-	createdAt: number;
-	updatedAt: number;
-	messageCount: number;
-	metadata?: SessionMetadata;
-}
-/**
-* Session metadata
-*/
-interface SessionMetadata extends Record<string, unknown> {
-	/** Total number of messages in the session */
-	messageCount?: number;
-	checkpoints?: SessionCheckpointsMeta;
-	checkpointDetails?: Record<string, SessionCheckpoint>;
-}
-/**
-* Session message
-*/
-interface SessionMessage {
-	id: string;
-	sessionID: string;
-	role: Role;
-	content: string;
-	timestamp: number;
-	parts?: MessagePart[];
-	/** Whether the message has been archived (compacted) */
-	isArchived?: boolean;
-	/** Timestamp when the message was archived */
-	archivedAt?: number;
-	/** Checkpoint ID this message belongs to */
-	checkpointId?: string;
-	/** Message metadata (includes checkpoint info if this is a checkpoint message) */
-	metadata?: MessageMetadata;
-}
-/**
-* Message metadata
-*/
-interface MessageMetadata extends Record<string, unknown> {
-	/** 消息类型标识，用于过滤和分类 */
-	type?: "tool_call" | "tool_result" | "checkpoint" | "user_intent" | "workflow.node.start" | "workflow.node.interrupt" | "workflow.node.end" | "workflow.node.resume";
-	isCheckpoint?: boolean;
-	checkpointId?: string;
-	checkpointMeta?: SessionCheckpoint;
-	/** Workflow node ID (for workflow.node.* messages) */
-	workflowNodeId?: string;
-	/** Workflow node type (for workflow.node.* messages) */
-	workflowNodeType?: string;
-	/** Agent session ID (for agent nodes in workflow) */
-	agentSessionId?: string;
-	/** User response (for workflow.node.resume messages) */
-	response?: string;
-	/** Success flag (for workflow.node.end messages) */
-	success?: boolean;
-}
-/**
-* Message role
-*/
-type Role = "user" | "assistant" | "system" | "tool" | "workflow.node.start" | "workflow.node.interrupt" | "workflow.node.end" | "workflow.node.resume";
-/**
-* Message part
-*/
-type MessagePart = SessionPart;
-/**
-* Text part - plain text content
-*/
-interface TextPart {
-	type: "text";
-	content: string;
-	/** If true, this part was generated by the system (e.g., auto-summary) */
-	synthetic?: boolean;
-	/** If true, this part should be ignored (e.g., replaced by reasoning) */
-	ignored?: boolean;
-}
-/**
-* Tool call part - represents a tool invocation
-*/
-interface ToolCallPart {
-	type: "tool-call";
-	/** AI SDK standard field name */
-	toolCallId: string;
-	toolName: string;
-	/** Tool arguments - can be string (JSON) or object */
-	arguments: string | Record<string, unknown>;
-	state: "pending" | "running";
-}
-/**
-* Tool result part - represents the result of a tool execution
-*/
-interface ToolResultPart {
-	type: "tool-result";
-	toolCallId: string;
-	toolName: string;
-	output: string;
-	error?: string;
-	state: "completed" | "error";
-}
-/**
-* Reasoning part - AI thinking/thought content
-*/
-interface ReasoningPart {
-	type: "reasoning";
-	/** Reasoning content */
-	content: string;
-	/** Reasoning type (for different models) */
-	reasoningType?: "core" | "effort" | "summary";
-	/** State */
-	state?: "thinking" | "completed";
-	/** Whether to collapse by default (like AI SDK default) */
-	isCollapsed?: boolean;
-	/** Metadata */
-	metadata?: {
-		tokenCount?: number;
-		time?: {
-			start: number;
-			end?: number;
-		};
-	};
-}
-/**
-* File part - file attachment
-*/
-interface FilePart {
-	type: "file";
-	mime: string;
-	url: string;
-	filename?: string;
-}
-/**
-* Checkpoint part - compaction checkpoint marker
-* 
-* Represents a checkpoint message in the conversation history.
-* This is stored as a user role message with markdown content summarizing
-* the compacted conversation segment.
-*/
-interface CheckpointPart {
-	type: "checkpoint";
-	/** Checkpoint ID reference */
-	checkpointId: string;
-	/** Markdown content summarizing the checkpoint */
-	content: string;
-	/** Title of the checkpoint */
-	title?: string;
-	/** Process key points */
-	processKeyPoints?: string[];
-	/** Current state description */
-	currentState?: string;
-	/** Next steps */
-	nextSteps?: string[];
-	/** Number of messages that were compacted */
-	messageCountBefore?: number;
-	/** Creation timestamp */
-	createdAt?: number;
-}
-/**
-* Union type for all Session Part types
-*/
-type SessionPart = TextPart | ToolCallPart | ToolResultPart | ReasoningPart | FilePart | CheckpointPart | WorkflowNodeStartPart | WorkflowNodeInterruptPart | WorkflowNodeEndPart | WorkflowNodeResumePart;
-/**
-* workflow.node.start 消息 part (对应 tool-call)
-*/
-interface WorkflowNodeStartPart {
-	type: "workflow-node-start";
-	nodeId: string;
-	nodeType: string;
-	input?: unknown;
-	startTime: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.interrupt 消息 part
-*/
-interface WorkflowNodeInterruptPart {
-	type: "workflow-node-interrupt";
-	nodeId: string;
-	nodeType: string;
-	query: string;
-	options?: string[];
-	timestamp: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.end 消息 part (对应 tool-result)
-*/
-interface WorkflowNodeEndPart {
-	type: "workflow-node-end";
-	nodeId: string;
-	nodeType: string;
-	output?: unknown;
-	error?: string;
-	durationMs: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.resume 消息 part
-*/
-interface WorkflowNodeResumePart {
-	type: "workflow-node-resume";
-	nodeId: string;
-	response: string;
-	timestamp: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* Options for creating a session
-*/
-interface CreateSessionOptions {
-	/** Custom session ID (optional, will be generated if not provided) */
-	id?: string;
-	title?: string;
-	directory?: string;
-	parentID?: string;
-	metadata?: Record<string, unknown>;
-	hooks?: SessionHooksConfig;
-}
-/**
-* Options for updating a session
-*/
-interface UpdateSessionOptions {
-	title?: string;
-	metadata?: Record<string, unknown>;
-}
-/**
-* Options for listing sessions
-*/
-interface ListSessionsOptions {
-	filter?: {
-		metadata?: Record<string, unknown>;
-		startTime?: number;
-		endTime?: number;
-	};
-	sort?: {
-		field: "updatedAt" | "createdAt" | "title";
-		order: "asc" | "desc";
-	};
-	offset?: number;
-	limit?: number;
-}
-/**
-* Options for adding a message
-*/
-interface AddMessageOptions {
-	role: Role;
-	content: string;
-	parts?: MessagePart[];
-	metadata?: MessageMetadata;
-}
-/**
-* Options for compact operation
-*/
-interface CompactOptions {
-	/** User-provided summary hint for checkpoint generation */
-	summary?: string;
-	/** User-provided process key points hint */
-	processKeyPoints?: string[];
-	/** User-provided current state hint */
-	currentState?: string;
-	/** User-provided next steps hint */
-	nextSteps?: string[];
-	/** Whether this is auto-triggered compact */
-	auto?: boolean;
-	/** 
-	* Scenario hint for guiding checkpoint generation
-	* 
-	* A natural language description that provides context about the current scenario.
-	* This helps the SummaryAgent generate more relevant checkpoints based on the specific
-	* situation. Examples:
-	* - "Task execution in progress: implementing feature X, current working directory is /path/to/project"
-	* - "Bug investigation: analyzing crash dump, current hypothesis is memory corruption"
-	* - "Code review session: reviewing PR #123, focus on security implications"
-	* 
-	* When provided, this will be prepended to the system prompt to guide the checkpoint
-	* generation with scenario-specific emphasis.
-	*/
-	scenarioHint?: string;
-}
-/**
-* Result of compact operation
-*/
-interface CompactResult {
-	checkpoint: SessionCheckpoint;
-	deletedMessageCount: number;
-	remainingMessageCount: number;
-	checkpointCount: number;
-}
-/**
-* Preview of compact operation
-*/
-interface CompactPreview {
-	messageCountToCompact: number;
-	estimatedCheckpointTokens: number;
-	wouldTrigger: boolean;
-}
-/**
-* Options for getting session context
-*/
-interface GetContextOptions {
-	/** Start from specified checkpoint */
-	fromCheckpoint?: string;
-	/** Start from latest checkpoint (default: true) */
-	fromLatestCheckpoint?: boolean;
-	/** Read full history (ignore checkpoints) */
-	fullHistory?: boolean;
-	/** Message limit */
-	messageLimit?: number;
-	/** Minimum user messages to include (ensures starting from user message boundary) */
-	minUserMessages?: number;
-	/** Include checkpoint details */
-	includeCheckpoints?: boolean;
-}
-/**
-* Result of getting session context
-*/
-interface GetContextResult {
-	session: Session;
-	checkpoints: SessionCheckpoint[];
-	startCheckpoint?: SessionCheckpoint;
-	messages: SessionMessage[];
-	totalMessageCount: number;
-	activeMessageCount: number;
-	archivedMessageCount: number;
-	estimatedTokens: number;
-}
-/**
-* Session hook callback
-*/
-type SessionHookCallback = (context?: any) => Promise<void>;
-/**
-* Session hook definition
-*/
-interface SessionHook {
-	name: string;
-	before?: SessionHookCallback;
-	after?: SessionHookCallback;
-}
-/**
-* Session hooks configuration
-*/
-interface SessionHooksConfig {
-	[key: string]: SessionHook[];
-}
-/**
-* Options for searching messages
-*/
-interface SearchMessagesOptions {
-	/** Search query (supports AND/OR/NOT syntax) */
-	query: string;
-	/** Limit search to specific session ID */
-	sessionId?: string;
-	/** Maximum number of results per session */
-	limit?: number;
-	/** Maximum total results */
-	maxResults?: number;
-	/** Only search messages before this timestamp */
-	beforeTime?: number;
-	/** Only search messages after this timestamp */
-	afterTime?: number;
-	/** Include archived messages */
-	includeArchived?: boolean;
-	/** Include context (messages before/after matches) */
-	includeContext?: boolean;
-	/** Number of context lines before/after */
-	contextLines?: number;
-}
-/**
-* A single message match
-*/
-interface MessageMatch {
-	/** Message ID */
-	messageId: string;
-	/** Session ID */
-	sessionId: string;
-	/** Message role */
-	role: Role;
-	/** Message content */
-	content: string;
-	/** Message timestamp */
-	timestamp: number;
-	/** Context before the match (if enabled) */
-	contextBefore?: string;
-	/** Context after the match (if enabled) */
-	contextAfter?: string;
-	/** Match score (relevance) */
-	score?: number;
-}
-/**
-* Search result aggregated by session
-*/
-interface SearchResult {
-	/** Session ID */
-	sessionId: string;
-	/** Session title */
-	sessionTitle: string;
-	/** Session directory */
-	sessionDirectory: string;
-	/** Session update timestamp */
-	updatedAt: number;
-	/** Total message count in session */
-	messageCount: number;
-	/** Matching messages in this session */
-	matches: MessageMatch[];
-}
-/**
-* SessionComponent
-* 
-* Manages session lifecycle including:
-* - Session CRUD operations
-* - Message management
-* - Active session tracking
-*/
-declare class SessionComponent extends BaseComponent {
-	readonly name = "session";
-	readonly version = "1.1.0";
-	private config?;
-	private store?;
-	private activeSessionId?;
-	private hooksConfig;
-	/** ConfigComponent 用于配置管理 */
-	private configComponent?;
-	/** 配置变更 watcher 清理函数 */
-	private configWatcher?;
-	/** Summary Agent for checkpoint generation [new] */
-	private summaryAgent?;
-	/** PromptComponent reference for SummaryAgent */
-	private promptComponent?;
-	/** LLMComponent reference for SummaryAgent */
-	private llmComponent?;
-	constructor();
-	/**
-	* Initialize the component
-	* 
-	* 配置加载优先级（从高到低）：
-	* 1. Object - 直接传入的 config 对象
-	* 2. Env - 环境变量（通过 envPrefix 配置前缀）
-	* 3. File - 配置文件（通过 configPath 指定）
-	*/
-	init(config?: ComponentConfig): Promise<void>;
-	/**
-	* 获取默认 session 数据库路径
-	*/
-	private getDefaultSessionDbPath;
-	/**
-	* 注册配置到 ConfigComponent
-	* 
-	* 配置加载顺序（优先级从低到高）：
-	* 1. Defaults - 默认值（最低）
-	* 2. FileSource - 从配置文件加载
-	* 3. EnvSource - 从环境变量加载
-	* 4. config 对象 - 直接传入的配置（最高）
-	*/
-	private registerConfig;
-	/**
-	* 构建最终配置对象
-	*/
-	private buildConfig;
-	/**
-	* 将配置对象展平为点号路径
-	*/
-	private flattenConfig;
-	/**
-	* 注册配置热更新监听
-	*/
-	private registerConfigWatcher;
-	/**
-	* 处理配置变更
-	*/
-	protected onConfigChange(event: {
-		key: string;
-		oldValue?: unknown;
-		newValue?: unknown;
-	}): void;
-	/**
-	* Start the component
-	*/
-	onStart(): Promise<void>;
-	/**
-	* Stop the component
-	*/
-	onStop(): Promise<void>;
-	/**
-	* Create a new session
-	*/
-	create(options?: CreateSessionOptions): Promise<Session>;
-	/**
-	* Get a session by ID
-	*/
-	get(id: string): Promise<Session | undefined>;
-	/**
-	* Get a session with full context (for Memory Agent)
-	*/
-	getSession(id: string): Promise<{
-		sessionId: string;
-		title: string;
-		messages: any[];
-	} | null>;
-	/**
-	* Search sessions by query (for Memory Agent)
-	* 
-	* Simple implementation: list all sessions and return them for the agent to filter
-	*/
-	searchSessions(query: string, options?: {
-		session_id?: string;
-		limit?: number;
-	}): Promise<Array<{
-		sessionId: string;
-		title: string;
-		preview: string;
-		timestamp: number;
-	}>>;
-	/**
-	* List all sessions
-	*/
-	list(options?: ListSessionsOptions): Promise<Session[]>;
-	/**
-	* Get total session count
-	*/
-	getCount(): Promise<number>;
-	/**
-	* Update a session
-	*/
-	update(id: string, updates: UpdateSessionOptions): Promise<boolean>;
-	/**
-	* Delete a session
-	*/
-	delete(id: string): Promise<boolean>;
-	/**
-	* Get the current active session
-	*/
-	getActiveSession(): Session | undefined;
-	/**
-	* Get the active session ID
-	*/
-	getActiveSessionId(): string | undefined;
-	/**
-	* Set the active session
-	*/
-	setActiveSession(id: string): Promise<boolean>;
-	/**
-	* Add a message to a session
-	*/
-	addMessage(sessionId: string, message: AddMessageOptions): Promise<string | undefined>;
-	/**
-	* Get messages from a session
-	*/
-	getMessages(sessionId: string, options?: {
-		offset?: number;
-		limit?: number;
-	}): Promise<SessionMessage[]>;
-	/**
-	* Get message count for a session
-	*/
-	getMessageCount(sessionId: string, includeArchived?: boolean): Promise<number>;
-	/**
-	* Get indexes of all messages with the specified role
-	* @param sessionId - Session ID
-	* @param role - Role to filter by (e.g., "user", "assistant")
-	* @returns Array of message indexes (0-indexed, in chronological order)
-	*/
-	getMessageIndexes(sessionId: string, role: string): Promise<number[]>;
-	private executeBeforeHooks;
-	private executeAfterHooks;
-	private generateTitle;
-	/**
-	* Set components for SummaryAgent
-	* 
-	* Call this after initialization if you need compact functionality
-	*/
-	setSummaryComponents(promptComponent: any, llmComponent: any): void;
-	/**
-	* 初始化 SummaryAgent（如未初始化）
-	*/
-	private ensureSummaryAgent;
-	/**
-	* 生成场景化压缩提示 (Compact Hint)
-	* 
-	* 两阶段自动压缩的第一阶段：
-	* 根据会话历史生成场景化的压缩提示
-	* 
-	* @param sessionId 会话 ID
-	* @returns 生成的场景化提示
-	*/
-	generateCompactHint(sessionId: string): Promise<string>;
-	/**
-	* Compact a session
-	* 
-	* 1. Get messages from latest checkpoint to current
-	* 2. Call Summary Agent to generate checkpoint
-	* 3. Save checkpoint and archive messages
-	* 
-	* 支持 scenarioHint 参数，用于指导不同场景下的压缩重点提取
-	*/
-	compact(sessionId: string, options?: CompactOptions): Promise<CompactResult>;
-	/**
-	* Extract recent messages from the conversation for checkpoint context
-	* 
-	* Extracts the last N turns of user query + assistant text response,
-	* excluding tool calls and tool results.
-	* 
-	* @param messages - All messages in the conversation
-	* @param turnCount - Number of turns to extract (default: 2)
-	* @returns Array of recent messages formatted as { role, content }
-	*/
-	private extractRecentMessages;
-	/**
-	* Preview compact operation
-	*/
-	previewCompact(sessionId: string): Promise<CompactPreview>;
-	/**
-	* Get all checkpoints for a session
-	*/
-	getCheckpoints(sessionId: string): Promise<SessionCheckpoint[]>;
-	/**
-	* Get a specific checkpoint
-	*/
-	getCheckpoint(sessionId: string, checkpointId: string): Promise<SessionCheckpoint | undefined>;
-	/**
-	* Delete a checkpoint and restore archived messages
-	*/
-	deleteCheckpoint(sessionId: string, checkpointId: string): Promise<boolean>;
-	/**
-	* Get session context
-	* 
-	* Returns messages starting from the latest checkpoint by default
-	*/
-	getContext(sessionId: string, options?: GetContextOptions): Promise<GetContextResult>;
-	/**
-	* Check if session needs compaction
-	*/
-	shouldCompact(sessionId: string): Promise<boolean>;
-	/**
-	* Search messages across sessions
-	* 
-	* Searches all messages matching the query, aggregated by session.
-	* Supports SQLite FTS5 for fast full-text search.
-	*/
-	searchMessages(options: SearchMessagesOptions): Promise<SearchResult[]>;
-	/**
-	* Get latest checkpoint from session
-	*/
-	private getLatestCheckpoint;
-	/**
-	* Create checkpoint message (user role)
-	* 
-	* Generates a markdown-formatted checkpoint summary as a user message,
-	* allowing it to appear in the message list and provide context for
-	* subsequent LLM calls.
-	*/
-	private createCheckpointMessage;
-}
-declare const RunStatusSchema: unknown;
-type RunStatus = z4.infer<typeof RunStatusSchema>;
-declare const NodeStatusSchema: unknown;
-type NodeStatus = z4.infer<typeof NodeStatusSchema>;
-interface RunOptions {
-	input?: Record<string, any>;
-	debug?: boolean;
-	parallelLimit?: number | null;
-	timeout?: number | null;
-	/** @deprecated No-op: workflow always waits for completion */
-	sync?: boolean;
-}
-interface RunResult {
-	runId: string;
-	/** Session ID (workflow_{runId} format) - useful for CLI resume */
-	sessionId?: string;
-	status: RunStatus;
-	output?: Record<string, any>;
-	error?: string;
-	durationMs?: number;
-	/** Pending node ID (when status is 'paused') */
-	pendingNodeId?: string;
-	/** Query from ask_user (when status is 'paused') */
-	query?: string;
-	/** Agent sub-session ID (for resuming agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* 节点执行上下文
-* 
-* 扩展后包含：
-* - sessionId: Session ID，用于消息持久化
-* - askUser(): 方法，让节点可以请求用户输入
-*/
-interface NodeExecutionContext {
-	runId: string;
-	sessionId: string;
-	workflowName: string;
-	nodeId: string;
-	input: unknown;
-	previousOutputs: Map<string, unknown>;
-	nodeOutputs: Map<string, unknown>;
-	config: Record<string, unknown>;
-	debug: boolean;
-	eventBus: EventBus;
-	workflowHistory?: Array<{
-		role: "user" | "assistant" | "tool";
-		content: string;
-		toolCallId?: string;
-		toolName?: string;
-		nodeId?: string;
-	}>;
-	sessionComponent?: SessionComponent;
-	agentSessionId?: string;
-	workflowInput?: Record<string, unknown>;
-	/**
-	* 请求用户输入
-	* 
-	* 调用此方法会抛出 AskUserError，引擎捕获后会暂停 workflow
-	* 
-	* @param query - 向用户询问的问题
-	* @throws AskUserError - 总是抛出此异常
-	*/
-	askUser(query: string): never;
-}
-interface NodeExecutionResult {
-	success?: boolean;
-	output?: any;
-	error?: string | Error;
-	duration?: number;
-	durationMs?: number;
-	metadata?: Record<string, unknown>;
-}
-declare const RetryConfigSchema: unknown;
-type RetryConfig = z5.infer<typeof RetryConfigSchema>;
-declare const NodeDefinitionSchema: unknown;
-type NodeDefinition = z5.infer<typeof NodeDefinitionSchema>;
-/**
-* Node interface - base interface for all workflow nodes
-*/
-interface Node {
-	/** Node type identifier */
-	readonly type: string;
-	/** Node unique identifier */
-	readonly id: string;
-	/** Execute the node with the given context */
-	execute(context: NodeExecutionContext): Promise<NodeExecutionResult>;
-}
-declare const WorkflowConfigSchema: unknown;
-type WorkflowConfig = z5.infer<typeof WorkflowConfigSchema>;
-declare const WorkflowMetadataSchema: unknown;
-type WorkflowMetadata = z5.infer<typeof WorkflowMetadataSchema>;
-declare const WorkflowDefinitionSchema: unknown;
-type WorkflowDefinition = z5.infer<typeof WorkflowDefinitionSchema>;
-interface WorkflowDefinitionExtended extends WorkflowDefinition {
-	computedEntry: string[];
-	nodeMap: Map<string, NodeDefinition>;
-	topologicalOrder: string[];
-}
-interface Workflow {
-	id: string;
-	name: string;
-	version: string;
-	description?: string;
-	definition: WorkflowDefinition;
-	config: WorkflowConfig;
-	metadata: WorkflowMetadata;
-	tags: string[];
-	createdAt: Date;
-	updatedAt: Date;
-}
-/**
-* DAG Analysis Result
-*/
-interface DAGAnalysis {
-	/** 入口节点（无依赖） */
-	entryNodes: string[];
-	/** 出口节点（无下游） */
-	exitNodes: string[];
-	/** 按层级组织的节点，用于并行执行 */
-	levels: string[][];
-	/** 每个节点的依赖 */
-	dependencies: Map<string, string[]>;
-	/** 每个节点的下游 */
-	dependents: Map<string, string[]>;
-	/** 关键路径 */
-	criticalPath: string[];
-}
-/**
-* DAG Manager
-* 
-* Manages Directed Acyclic Graph (DAG) operations for workflow execution.
-* Provides analysis, topological sorting, and validation of workflow structures.
-*/
-declare class DAGManager {
-	private workflow;
-	private nodeMap;
-	private extendedDefinition;
-	private cachedAnalysis;
-	constructor(workflow: WorkflowDefinition);
-	/**
-	* Get extended workflow definition with computed properties
-	*/
-	getExtendedDefinition(): WorkflowDefinitionExtended;
-	/**
-	* Analyze the DAG structure
-	*/
-	analyze(): DAGAnalysis;
-	/**
-	* Build a map of node dependencies
-	*/
-	private buildDependenciesMap;
-	/**
-	* Build a map of node dependents (reverse of dependencies)
-	*/
-	private buildDependentsMap;
-	/**
-	* Find entry nodes (nodes with no dependencies)
-	*/
-	private findEntryNodes;
-	/**
-	* Find exit nodes (nodes with no dependents)
-	*/
-	private findExitNodes;
-	/**
-	* Compute levels for parallel execution
-	* Nodes at the same level can be executed in parallel
-	*/
-	private computeLevels;
-	/**
-	* Find critical path (longest path through the DAG)
-	*/
-	private findCriticalPath;
-	/**
-	* Get topological order using Kahn's algorithm
-	*/
-	getTopologicalOrder(): string[];
-	/**
-	* Get nodes that are ready to execute (dependencies met and not completed)
-	*/
-	getReadyNodes(completedNodes: Set<string>): string[];
-	/**
-	* Check if all dependencies for a node are completed
-	*/
-	areDependenciesMet(nodeId: string, completedNodes: Set<string>): boolean;
-	/**
-	* Check if the workflow contains a cycle
-	*/
-	isCyclic(): boolean;
-	/**
-	* Internal topological sort that detects cycles
-	*/
-	private getTopologicalOrderInternal;
-	/**
-	* Validate the workflow
-	*/
-	validate(): {
-		valid: boolean;
-		errors: string[];
-	};
-	/**
-	* Add a new node to the workflow dynamically
-	* 
-	* @param node - The node definition to add
-	* @throws Error if a node with the same ID already exists
-	* @throws Error if the node depends on a non-existent node
-	* @throws Error if adding this node would create a cycle
-	*/
-	addNode(node: NodeDefinition): void;
-	/**
-	* Remove a node from the workflow dynamically
-	* 
-	* @param nodeId - The ID of the node to remove
-	* @throws Error if the node doesn't exist
-	* @throws Error if other nodes depend on this node
-	*/
-	removeNode(nodeId: string): void;
-	/**
-	* Get direct dependents of a node (nodes that depend on this node)
-	*/
-	getDependents(nodeId: string): string[];
-	/**
-	* Get the workflow definition (current state)
-	*/
-	getDefinition(): WorkflowDefinition;
-	/**
-	* Get a node by ID
-	*/
-	getNode(nodeId: string): NodeDefinition | undefined;
-	/**
-	* Get all node IDs
-	*/
-	getNodeIds(): string[];
-	/**
-	* Get the number of nodes in the workflow
-	*/
-	getNodeCount(): number;
-}
-/**
-* Scheduler Options
-*/
-interface SchedulerOptions {
-	/** Maximum number of nodes that can run in parallel. null = unlimited */
-	parallelLimit: number | null;
-}
-/**
-* Scheduler State
-*/
-interface SchedulerState {
-	/** Nodes that have not been started yet */
-	pending: string[];
-	/** Nodes that are ready to execute (dependencies met, not started) */
-	ready: string[];
-	/** Nodes that are currently running */
-	running: string[];
-	/** Nodes that have completed successfully */
-	completed: string[];
-	/** Nodes that have failed */
-	failed: string[];
-	/** Nodes that were skipped (not executed) */
-	skipped: string[];
-}
-/**
-* Scheduler
-* 
-* Determines which nodes are ready to execute based on:
-* - DAG dependencies
-* - Parallel execution limit
-* - Node completion status
-* 
-* The scheduler tracks the state of all nodes and manages the execution queue.
-*/
-declare class Scheduler {
-	private dagManager;
-	private options;
-	private pending;
-	private ready;
-	private running;
-	private completed;
-	private failed;
-	private skipped;
-	/**
-	* Create a new Scheduler
-	* @param dagManager - The DAG manager for the workflow
-	* @param options - Scheduler options
-	*/
-	constructor(dagManager: DAGManager, options?: Partial<SchedulerOptions>);
-	/**
-	* Get nodes that are ready to execute
-	* Ready nodes are those whose dependencies are met and are not already running/completed/failed
-	* @param completedNodes - Set of completed node IDs (external tracking)
-	*/
-	getReadyNodes(completedNodes: Set<string>): string[];
-	/**
-	* Get the number of currently running nodes
-	*/
-	getRunningCount(): number;
-	/**
-	* Check if more nodes can be started based on the parallel limit
-	*/
-	canStartMore(): boolean;
-	/**
-	* Mark a node as started
-	* @param nodeId - The node ID
-	*/
-	markStarted(nodeId: string): void;
-	/**
-	* Check if a node is currently running
-	* @param nodeId - The node ID
-	*/
-	isRunning(nodeId: string): boolean;
-	/**
-	* Check if a node has completed
-	* @param nodeId - The node ID
-	*/
-	isCompleted(nodeId: string): boolean;
-	/**
-	* Check if a node has failed
-	* @param nodeId - The node ID
-	*/
-	isFailed(nodeId: string): boolean;
-	/**
-	* Check if a node is in pending state
-	* @param nodeId - The node ID
-	*/
-	isPending(nodeId: string): boolean;
-	/**
-	* Check if a node is ready to execute
-	* @param nodeId - The node ID
-	*/
-	isReady(nodeId: string): boolean;
-	/**
-	* Mark a node as completed successfully
-	* @param nodeId - The node ID
-	*/
-	markCompleted(nodeId: string): void;
-	/**
-	* Mark a node as failed
-	* @param nodeId - The node ID
-	*/
-	markFailed(nodeId: string): void;
-	/**
-	* Mark a node as skipped (not executed)
-	* @param nodeId - The node ID
-	*/
-	markSkipped(nodeId: string): void;
-	/**
-	* Reset the scheduler state
-	* Clears all running, completed, failed, and skipped nodes
-	*/
-	reset(): void;
-	/**
-	* Get the current state of the scheduler
-	*/
-	getState(): SchedulerState;
-	/**
-	* Update the ready set based on completed nodes
-	*/
-	private updateReadyNodes;
-	/**
-	* Get the parallel limit
-	*/
-	getParallelLimit(): number | null;
-	/**
-	* Update the parallel limit
-	* @param limit - New parallel limit (null for unlimited)
-	*/
-	setParallelLimit(limit: number | null): void;
-}
-/**
-* Tool Registry interface for looking up tools
-* Supports both the full ToolRegistration and simplified Tool interface
-*/
-interface ToolRegistry {
-	getTool?(name: string): ToolRegistration2 | undefined;
-	getToolByName?(name: string): Tool2 | undefined;
-	hasTool?(name: string): boolean;
-}
-/**
-* Tool Registration interface (from ToolComponent)
-*/
-interface ToolRegistration2 {
-	tool: Tool2;
-	enabled: boolean;
-	source?: string;
-}
-/**
-* Tool interface for execution
-*/
-interface Tool2 {
-	name: string;
-	execute(input: any, context?: any): Promise<any>;
-}
-/**
-* Skill Registry interface for looking up skills
-*/
-interface SkillRegistry {
-	getSkill(name: string): Skill | undefined;
-	hasSkill(name: string): boolean;
-}
-/**
-* Skill interface for invocation
-*/
-interface Skill {
-	name: string;
-	invoke(input: any, context: any): Promise<any>;
-}
-/**
-* Agent 注册配置
-*/
-interface AgentRegistrationConfig {
-	/** Agent 类型 */
-	type?: string;
-	/** 系统提示词 */
-	systemPrompt?: string;
-	/** 模型名称 */
-	model?: string;
-	/** 最大迭代次数 */
-	maxIterations?: number;
-	/** 允许的工具列表 */
-	allowedTools?: string[];
-	/** 禁止的工具列表 */
-	deniedTools?: string[];
-}
-/**
-* AgentRunner 接口
-* 
-* 用于运行 AI Agent 的接口
-*/
-interface AgentRunner {
-	/**
-	* 运行 Agent
-	* @param config Agent 配置
-	* @param resumeOptions 可选的恢复选项（用于恢复暂停的 agent）
-	* @returns Agent 执行结果
-	*/
-	run(config: AgentConfig, resumeOptions?: {
-		userQuery?: string;
-		agentSessionId?: string;
-	}): Promise<AgentResult>;
-	/**
-	* 恢复暂停的 Agent
-	* 
-	* @param agentSessionId Agent session ID
-	* @param userQuery 用户的响应
-	* @param config 原始的 agent 配置
-	* @returns Agent 执行结果
-	*/
-	resumeAgent?(agentSessionId: string, userQuery: string, config: AgentConfig): Promise<AgentResult>;
-	/**
-	* 获取当前 agent session ID
-	*/
-	getCurrentAgentSessionId?(): string | undefined;
-	/**
-	* 设置 SessionComponent
-	*/
-	setSessionComponent?(sessionComponent: SessionComponent): void;
-	/**
-	* 获取待恢复的 session 信息
-	*/
-	getPendingSession?(agentSessionId: string): {
-		agentSessionId: string;
-		nodeId: string;
-		runId: string;
-		createdAt: number;
-	} | undefined;
-	/**
-	* 注册 Agent（如果不存在）
-	*/
-	registerAgent?(name: string, config: AgentRegistrationConfig): void;
-	/**
-	* 检查 Agent 是否已注册
-	*/
-	hasAgent?(name: string): boolean;
-}
-/**
-* Agent 配置
-*/
-interface AgentConfig {
-	/** Agent 类型 */
-	type: string;
-	/** Prompt（任务描述） */
-	prompt: string;
-	/** 可选配置 */
-	options?: {
-		/** 超时时间（毫秒） */
-		timeout?: number;
-		/** 模型名称 */
-		model?: string;
-		/** 允许的工具列表（用于限制 agent 可用的工具） */
-		allowedTools?: string[];
-		/** 拒绝的工具列表 */
-		deniedTools?: string[];
-	};
-	/** Workflow 历史消息（来自前置 agent 节点） */
-	workflowHistory?: Array<{
-		role: "user" | "assistant" | "tool";
-		content: string;
-		toolCallId?: string;
-		toolName?: string;
-		nodeId?: string;
-	}>;
-	/** 节点 ID（用于 history 标记） */
-	nodeId?: string;
-	/** Agent sub-session ID（用于 HiL resume） */
-	agentSessionId?: string;
-}
-/**
-* Agent 执行结果
-*/
-interface AgentResult {
-	/** Agent 输出 */
-	output: unknown;
-	/** 执行元数据 */
-	metadata?: {
-		/** 消耗的 token 数量 */
-		tokens?: number;
-		/** 执行耗时（毫秒） */
-		duration?: number;
-		/** 其他元数据 */
-		[key: string]: unknown;
-	};
-	/** 生成的消息列表（用于 workflow history 累积） */
-	messages?: Array<{
-		role: "user" | "assistant" | "tool";
-		content: string;
-		toolCallId?: string;
-		toolName?: string;
-		nodeId?: string;
-	}>;
-}
-import { ModelMessage as ModelMessage2 } from "ai";
-import { z as z7 } from "zod";
-/**
-* AgentComponent 配置 Schema
-*/
-declare const AgentComponentConfigSchema: unknown;
-type AgentComponentConfig = z7.infer<typeof AgentComponentConfigSchema>;
-/**
-* AgentComponent
-* 
-* 提供 Agent 执行能力和 Hook 扩展机制
-*/
-declare class AgentComponent extends BaseComponent {
-	readonly name = "agent";
-	readonly version = "1.0.0";
-	private agents;
-	private config;
-	private llmComponent;
-	private toolComponent;
-	private aborted;
-	private abortControllers;
-	private defaultTools;
-	private doomLoopCaches;
-	/** ConfigComponent 用于配置管理 */
-	private configComponent?;
-	/** 配置变更 watcher 清理函数 */
-	private configWatcher?;
-	/** Session 消息转换器 */
-	private messageConverter;
-	/** 构造函数传入的配置（最高优先级） */
-	private _constructorConfig?;
-	/** Run ID 计数器（用于生成唯一的 runId） */
-	private runCounter;
-	constructor(options?: {
-		config?: Partial<AgentComponentConfig>;
-	});
-	/**
-	* 初始化组件
-	* 
-	* 配置加载优先级（从高到低）：
-	* 1. Object - 直接传入的 config 对象
-	* 2. Env - 环境变量（通过 envPrefix 配置前缀）
-	* 3. File - 配置文件（通过 configPath 指定）
-	*/
-	init(config: ComponentConfig): Promise<void>;
-	/**
-	* 注册配置到 ConfigComponent
-	* 
-	* 配置加载顺序（优先级从低到高）：
-	* 1. Defaults - 默认值（最低）
-	* 2. FileSource - 从配置文件加载
-	* 3. EnvSource - 从环境变量加载
-	* 4. config 对象 - 直接传入的配置（最高）
-	*/
-	private registerConfig;
-	/**
-	* 将配置对象展平为点号路径
-	*/
-	private flattenConfig;
-	/**
-	* 注册配置热更新监听
-	*/
-	private registerConfigWatcher;
-	/**
-	* 处理配置变更
-	*/
-	protected onConfigChange(event: {
-		key: string;
-		oldValue?: unknown;
-		newValue?: unknown;
-	}): void;
-	/**
-	* 组件停止时的清理逻辑
-	* 
-	* 清理内容：
-	* 1. 终止所有正在运行的 Agent（调用 abort() 以中断 LLM 调用）
-	* 2. 清空 AbortController 注册表
-	* 3. 清空 Doom Loop 缓存
-	* 4. 取消配置变更监听
-	* 5. 清空 Agent 注册表
-	*/
-	protected onStop(): Promise<void>;
-	/**
-	* 刷新依赖组件引用
-	* 
-	* 当组件被添加到 Environment 后调用，以确保获取到最新的组件引用
-	*/
-	refreshDependencies(): void;
-	/**
-	* 获取 Agent 实例
-	*/
-	getAgent(agentName: string): AgentInstance | undefined;
-	/**
-	* 获取所有 Agent 实例
-	*/
-	listAgents(): AgentInstance[];
-	/**
-	* Add placeholder tool results for remaining unprocessed tool calls
-	* 
-	* This ensures that the message history maintains a 1:1 correspondence
-	* between tool-calls and tool-results, which is required by AI SDK v6.
-	* 
-	* @param ctx - Hook context containing messages
-	* @param allToolCalls - All tool calls from the LLM response
-	* @param processedCount - Number of tool calls that have been processed
-	* @param reason - Reason for the abort/interruption
-	*/
-	private addRemainingToolResults;
-	/**
-	* 注册 Agent
-	* 
-	* 配置优先级（从高到低）：
-	* 1. registerAgent 传入的 config（来自 PromptComponent）
-	* 2. defaultAgent 配置（来自 ConfigComponent，作为 fallback）
-	*/
-	registerAgent(name: string, config: Partial<AgentInstanceConfig>): AgentInstance;
-	/**
-	* 注销 Agent
-	*/
-	unregisterAgent(name: string): boolean;
-	/**
-	* 注册 Plugin 到指定 Agent
-	*/
-	registerPlugin(agentName: string, plugin: Plugin): void;
-	/**
-	* 注销 Plugin
-	*/
-	unregisterPlugin(agentName: string, pluginName: string): boolean;
-	/**
-	* 设置默认工具列表
-	*/
-	setDefaultTools(tools: Tool[]): void;
-	/**
-	* 获取可用工具
-	*/
-	getAvailableTools(agent: AgentInstance, context?: AgentContext): Tool[];
-	/**
-	* 执行 Agent
-	* 
-	* @param agentName Agent 名称
-	* @param query 用户查询
-	* @param context 执行上下文
-	* @returns Agent 执行结果
-	*/
-	run(agentName: string, query: string, context?: AgentContext): Promise<AgentRunResult>;
-	private pushMessage;
-	/**
-	* 执行 Agent（核心方法，内部实现）
-	*/
-	private _run;
-	/**
-	* 中止 Agent
-	* 
-	* 调用此方法会：
-	* 1. 设置 aborted 标志（用于 ReAct 循环检查）
-	* 2. 触发 AbortController.abort()（用于中断正在进行的 LLM 调用）
-	* 
-	* 注意：不直接修改 agent.status，由 _run() 的 finally 统一处理
-	*/
-	abort(agentName: string): void;
-	/**
-	* 构建消息列表
-	* 
-	* 注意：ctx.messages 已经包含了历史消息（包括 system prompt 和 user query）
-	* 这里只需要构建当前请求的消息，不重复添加
-	*/
-	private buildMessages;
-	/**
-	* 调用 LLM
-	* 
-	* 流式事件由 LLMComponent 通过 env.pushEnvEvent() 发布
-	*/
-	private invokeLLM;
-	/**
-	* 执行工具
-	*/
-	private executeTool;
-	/**
-	* 执行 Plugin Hooks (Agent 特有的 Hook 执行机制)
-	*/
-	private executePluginHooks;
-	/**
-	* 处理 Hook 动作
-	*/
-	private handleHookAction;
-	/**
-	* 通知消息添加（扩展点）
-	*/
-	protected notifyMessageAdded(message: ModelMessage2): void;
-	/**
-	* 结束结果
-	*/
-	private finalizeResult;
-	/**
-	* Record messages to session
-	* 
-	* 存储策略：
-	* 1. 存储 allMessages 中的所有 user、assistant、tool 消息
-	* 2. 跳过 system 消息
-	* 3. 跳过空内容的 assistant/tool 消息
-	*/
-	private recordSessionMessages;
-	/**
-	* 检查消息内容是否为空
-	* 
-	* 空内容定义：
-	* - 空字符串 ""
-	* - 空数组 []
-	* - null
-	* - undefined
-	* 
-	* @param content - 消息内容
-	* @returns 是否为空
-	*/
-	private isEmptyMessage;
-	/**
-	* 通过 Environment 发送事件
-	*/
-	private pushEnvEvent;
-	/**
-	* 获取会话对话历史
-	* 
-	* 核心逻辑：
-	* 1. 使用 sessionComponent.getContext() 获取消息（自动从 checkpoint 开始）
-	* 2. 根据 messageLimit 限制消息数量（向后兼容 minUserMessages）
-	* 3. 过滤掉 tool_call/tool_result 消息（如果 filterHistory=true）
-	* 
-	* 关键改进：利用 checkpoint 概念，避免重复获取已压缩的历史消息，
-	* 从而减少重复触发压缩的问题。
-	* 
-	* @param sessionComponent - SessionComponent 实例
-	* @param sessionId - 会话 ID
-	* @param options - 配置选项
-	* @param options.minUserMessages - 最少包含的 user 消息数量（默认 100）
-	* @param options.filterHistory - 是否过滤 tool 消息（默认 true）
-	* @returns 过滤后的会话消息列表
-	*/
-	private getConversationHistory;
-}
-/**
-* Pending Agent Session - Stores info needed to resume an agent after user input
-*/
-interface PendingAgentSession {
-	agentSessionId: string;
-	nodeId: string;
-	runId: string;
-	createdAt: number;
-}
-/**
-* AgentComponentAdapter
-* 
-* Adapts AgentComponent to the AgentRunner interface expected by Workflow's AgentNode.
-* Provides session isolation for agent execution within workflow context.
-* 
-* Features:
-* - Creates dedicated agent sessions for each workflow agent node execution
-* - Tracks pending sessions for resume after user input
-* - Supports mapping agent sessions to workflow run session messages
-*/
-declare class AgentComponentAdapter implements AgentRunner {
-	private agentComponent;
-	private options;
-	private _sessionComponent?;
-	/** Session prefix for agent sessions */
-	private agentSessionPrefix;
-	/** Current agent session ID */
-	private _currentAgentSessionId?;
-	/** Pending agent sessions (waiting for user input) */
-	private pendingSessions;
-	/** Map from workflow run session to agent sessions */
-	private runSessionToAgentSessions;
-	constructor(agentComponent: AgentComponent, options?: AgentComponentAdapterOptions, _sessionComponent?: SessionComponent);
-	/**
-	* Set the SessionComponent for agent session management
-	*/
-	setSessionComponent(sessionComponent: SessionComponent): void;
-	/**
-	* Get the current agent session ID
-	*/
-	getCurrentAgentSessionId(): string | undefined;
-	/**
-	* Register an agent that can be used in workflows
-	* 
-	* @param name - Agent name (used as agent_type in workflow definition)
-	* @param config - Agent configuration
-	*/
-	registerAgent(name: string, config: AgentRegistrationConfig2): void;
-	/**
-	* Run an agent
-	* 
-	* Implements AgentRunner interface.
-	* Creates a dedicated agent session for each execution within workflow context.
-	* 
-	* @param config - Agent configuration
-	* @param resumeOptions - Optional options for resuming a paused agent
-	* @returns Agent execution result
-	*/
-	run(config: AgentConfig, resumeOptions?: {
-		userQuery?: string;
-		agentSessionId?: string;
-	}): Promise<AgentResult>;
-	/**
-	* Resume a paused agent with user response
-	* 
-	* This method is called when workflow resumes after user input.
-	* It retrieves the pending agent session and continues execution.
-	* 
-	* @param agentSessionId - The agent session ID to resume
-	* @param userQuery - User's response to the ask_user query
-	* @param config - Original agent config
-	* @returns Agent execution result
-	*/
-	resumeAgent(agentSessionId: string, userQuery: string, config: AgentConfig): Promise<AgentResult>;
-	/**
-	* Get pending agent session by agent session ID
-	*/
-	getPendingSession(agentSessionId: string): PendingAgentSession | undefined;
-	/**
-	* Get pending agent sessions for a workflow run
-	*/
-	getPendingSessionsForRun(runId: string): PendingAgentSession[];
-	/**
-	* Get all agent session IDs associated with a workflow session
-	*/
-	getAgentSessionsForWorkflowSession(workflowSessionId: string): string[];
-	/**
-	* Check if an agent is registered
-	*/
-	hasAgent(name: string): boolean;
-	/**
-	* List all registered agents
-	*/
-	listAgents(): string[];
-	/**
-	* Get the underlying AgentComponent
-	*/
-	getAgentComponent(): AgentComponent;
-	private agentSessionPrefixes;
-}
-/**
-* Options for AgentComponentAdapter
-*/
-interface AgentComponentAdapterOptions {
-	/** Default timeout for agent execution (ms) */
-	defaultTimeout?: number;
-	/** Default session ID prefix */
-	defaultSessionPrefix?: string;
-}
-/**
-* Configuration for registering an agent
-*/
-interface AgentRegistrationConfig2 {
-	/** Agent type */
-	type?: "general" | "research" | "coder" | "critic";
-	/** Model to use */
-	model?: string;
-	/** System prompt */
-	systemPrompt?: string;
-	/** Max iterations */
-	maxIterations?: number;
-	/** Allowed tools */
-	allowedTools?: string[];
-	/** Denied tools */
-	deniedTools?: string[];
-	/** Timeout (ms) */
-	timeout?: number;
-	/** Max error retries */
-	maxErrorRetries?: number;
-	/** Session ID prefix for workflow isolation */
-	sessionIdPrefix?: string;
-}
-/**
-* WorkflowRunner interface for running sub-workflows
-*/
-interface WorkflowRunner {
-	/**
-	* Run a workflow by name
-	* @param workflowName - Name of the workflow to run
-	* @param input - Optional input to pass to the workflow
-	* @returns Promise resolving to the workflow run result
-	*/
-	run(workflowName: string, input?: any): Promise<WorkflowRunResult>;
-	/**
-	* Get the status of a workflow run
-	* @param runId - The run ID to check
-	* @returns Promise resolving to the run result or null if not found
-	*/
-	getRun(runId: string): Promise<WorkflowRunResult | null>;
-}
-/**
-* Result from a workflow run
-*/
-interface WorkflowRunResult {
-	/** Unique run ID */
-	runId: string;
-	/** Final status of the run */
-	status: "completed" | "failed" | "stopped";
-	/** Output from the workflow (if completed) */
-	output?: any;
-	/** Error message (if failed or stopped) */
-	error?: string;
-}
-/**
-* NodeRegistry initialization options
-*/
-interface NodeRegistryOptions {
-	/** Registry for looking up tools */
-	toolRegistry?: ToolRegistry;
-	/** Registry for looking up skills */
-	skillRegistry?: SkillRegistry;
-	/** AgentComponent for executing agent nodes (auto-creates adapter) */
-	agentComponent?: AgentComponent;
-	/** Explicit AgentRunner (takes precedence over agentComponent) */
-	agentRunner?: AgentRunner;
-	/** Runner for executing workflow nodes */
-	workflowRunner?: WorkflowRunner;
-	/** Session component for agent session management */
-	sessionComponent?: SessionComponent;
-	/** @deprecated Use agentRunner instead */
-	agentRunner2?: AgentRunner;
-}
-/**
-* NodeContext for node creation
-* 
-* Context information passed to node factories when creating nodes.
-*/
-interface NodeContext {
-	/** Run ID for this workflow execution */
-	runId: string;
-	/** Workflow name */
-	workflowName: string;
-	/** Event bus for workflow events */
-	eventBus: EventBus;
-	/** Debug mode flag */
-	debug: boolean;
-}
-/**
-* NodeFactory function type
-* 
-* Factory function that creates a Node instance from a NodeDefinition.
-*/
-type NodeFactory = (definition: NodeDefinition, context: NodeContext) => Node;
-/**
-* NodeRegistry
-* 
-* Registry for creating Node instances from NodeDefinition.
-* 
-* Features:
-* - Built-in node types: tool, skill, agent, workflow
-* - Custom node type registration via factory functions
-* - Node creation based on node type
-* 
-* @example
-* ```typescript
-* const registry = new NodeRegistry(
-*   toolRegistry,
-*   skillRegistry,
-*   agentRunner,
-*   workflowRunner
-* );
-* 
-* // Register custom node type
-* registry.register('custom', (definition, context) => {
-*   return new CustomNode(definition);
-* });
-* 
-* // Create node from definition
-* const node = registry.createNode(definition);
-* ```
-*/
-declare class NodeRegistry {
-	/** Map of registered node factories by type */
-	private factories;
-	/** Tool registry for looking up tools */
-	private toolRegistry?;
-	/** Skill registry for looking up skills */
-	private skillRegistry?;
-	/** Agent runner for executing agent nodes */
-	private agentRunner?;
-	/** Workflow runner for executing workflow nodes */
-	private workflowRunner?;
-	/** AgentComponent adapter (auto-created if agentComponent is provided) */
-	private agentComponentAdapter?;
-	/** Session component for agent session management */
-	private sessionComponent?;
-	/**
-	* Create a new NodeRegistry
-	* 
-	* @param options - Registry options
-	* @param options.toolRegistry - Registry for looking up tools (optional)
-	* @param options.skillRegistry - Registry for looking up skills (optional)
-	* @param options.agentComponent - AgentComponent for executing agent nodes (optional, auto-creates adapter)
-	* @param options.agentRunner - Explicit AgentRunner (takes precedence over agentComponent)
-	* @param options.workflowRunner - Runner for executing workflow nodes (optional)
-	* @param options.sessionComponent - Session component for agent session management (optional)
-	*/
-	constructor(options?: NodeRegistryOptions);
-	/**
-	* Get the AgentComponentAdapter if available
-	*/
-	getAgentAdapter(): AgentComponentAdapter | undefined;
-	/**
-	* Get the AgentRunner
-	*/
-	getAgentRunner(): AgentRunner | undefined;
-	/**
-	* Get the SessionComponent
-	*/
-	getSessionComponent(): SessionComponent | undefined;
-	/**
-	* Register built-in node types
-	*/
-	private registerBuiltInTypes;
-	/**
-	* Register a custom node factory
-	* 
-	* @param type - Node type identifier
-	* @param factory - Factory function to create nodes of this type
-	*/
-	register(type: string, factory: NodeFactory): void;
-	/**
-	* Check if a node type is registered
-	* 
-	* @param type - Node type identifier
-	* @returns True if the type is registered
-	*/
-	has(type: string): boolean;
-	/**
-	* List all registered node types
-	* 
-	* @returns Array of registered type names
-	*/
-	list(): string[];
-	/**
-	* Create a Node instance from a NodeDefinition
-	* 
-	* @param definition - Node definition
-	* @param context - Node context (optional, for future use)
-	* @returns Node instance
-	* @throws Error if the node type is not registered
-	*/
-	createNode(definition: NodeDefinition, context?: NodeContext): Node;
-}
-/**
-* Executor Options
-*/
-interface ExecutorOptions {
-	/** Global timeout for node execution (ms). null = no timeout */
-	globalTimeout: number | null;
-	/** Global retry configuration */
-	globalRetry: RetryConfig | null;
-	/** Debug mode */
-	debug: boolean;
-}
-/**
-* Executor
-* 
-* Executes nodes in a workflow with support for:
-* - Timeout handling
-* - Retry with configurable backoff
-* - Error propagation
-* - Session message writing
-* - AskUserError handling
-* 
-* @example
-* ```typescript
-* const executor = new Executor(nodeRegistry, eventBus, {
-*   globalTimeout: 60000,
-*   globalRetry: { max_attempts: 3, backoff: 'exponential', initial_delay: 1000 },
-*   debug: false
-* });
-* 
-* const result = await executor.executeNode(nodeDefinition, context);
-* ```
-*/
-declare class Executor {
-	private nodeRegistry;
-	private eventBus;
-	private options;
-	private sessionComponent?;
-	private abortControllers;
-	constructor(nodeRegistry: NodeRegistry, eventBus: EventBus, options: ExecutorOptions, sessionComponent?: SessionComponent);
-	/**
-	* Execute a node with timeout and retry handling
-	*/
-	executeNode(definition: NodeDefinition, context: NodeExecutionContext): Promise<NodeExecutionResult>;
-	/**
-	* Execute node with timeout handling
-	*/
-	private executeWithTimeout;
-	/**
-	* Execute node with retry handling
-	*/
-	private executeWithRetry;
-	/**
-	* Cancel execution of a specific node
-	*/
-	cancelNode(nodeId: string): void;
-	/**
-	* Cancel all running nodes
-	*/
-	cancelAll(): void;
-	/**
-	* Combine two abort signals
-	*/
-	private combineAbortSignals;
-	/**
-	* Sleep for specified milliseconds
-	*/
-	private sleep;
-	/**
-	* Write workflow.node.start message
-	* 对应 tool-call，节点开始执行
-	*/
-	writeNodeStart(sessionId: string, nodeId: string, nodeType: string, input: unknown, agentSessionId?: string): Promise<void>;
-	/**
-	* Create a meaningful content summary for call message
-	*/
-	private summarizeCall;
-	/**
-	* Write workflow.node.interrupt message
-	*/
-	writeNodeInterrupt(sessionId: string, nodeId: string, nodeType: string, query: string, agentSessionId?: string): Promise<void>;
-	/**
-	* Write workflow.node.end message (对应 tool-result)
-	*/
-	writeNodeEnd(sessionId: string, nodeId: string, nodeType: string, output: unknown, error: string | undefined, durationMs: number, agentSessionId?: string): Promise<void>;
-	/**
-	* Create a meaningful content summary for result display
-	*/
-	private summarizeResult;
-	/**
-	* Write workflow.node.resume message
-	*/
-	writeNodeResume(sessionId: string, nodeId: string, response: string, agentSessionId?: string): Promise<void>;
-}
-import { EventEmitter } from "events";
-/**
-* Options for creating WorkflowEngine via static factory
-*/
-interface WorkflowEngineCreateOptions {
-	env?: {
-		getComponent<T>(name: string): T | undefined;
-	};
-	toolRegistry?: any;
-	skillRegistry?: any;
-	workflowRunner?: any;
-	sessionComponent?: SessionComponent;
-	/** Repository for loading workflow definitions during resume */
-	workflowRepository?: WorkflowRepository;
-}
-/**
-* Workflow Repository interface (abstraction)
-*/
-interface WorkflowRepository {
-	getById(id: string): Workflow | null;
-	getByName(name: string): Workflow | null;
-}
-/**
-* WorkflowEngine Configuration
-*/
-interface WorkflowEngineConfig {
-	parallelLimit: number | null;
-	timeout: number | null;
-	debug: boolean;
-}
-/**
-* WorkflowEngine
-* 
-* Session-based workflow execution engine.
-* Uses Session to manage workflow run state and node execution history.
-*/
-declare class WorkflowEngine extends EventEmitter {
-	/** 活跃的 session 状态，key 为 sessionId */
-	private activeSessions;
-	/** Session ID 计数器 */
-	private sessionIdCounter;
-	/** Session component */
-	private sessionComponent?;
-	/** Node registry */
-	private nodeRegistry;
-	/** Workflow repository for loading definitions during resume */
-	private workflowRepository?;
-	/**
-	* Create a new WorkflowEngine
-	*/
-	constructor(nodeRegistry: NodeRegistry, sessionComponent?: SessionComponent, workflowRepository?: WorkflowRepository);
-	/**
-	* Create a WorkflowEngine with automatic AgentComponent integration
-	*/
-	static create(options: WorkflowEngineCreateOptions): Promise<WorkflowEngine>;
-	/**
-	* Generate a unique run ID
-	*/
-	private generateRunId;
-	/**
-	* Extract runId from sessionId
-	* sessionId format: workflow_{runId}
-	*/
-	private getRunIdFromSessionId;
-	/**
-	* Get session ID for a run
-	*/
-	getSessionId(runId: string): string;
-	/**
-	* Create a new workflow session
-	* 
-	* @param workflow - Workflow definition or entity
-	* @param options - Optional configuration
-	* @returns Promise resolving to sessionId (format: workflow_{runId})
-	*/
-	createSession(workflow: Workflow | WorkflowDefinition, options?: RunOptions): Promise<string>;
-	/**
-	* Run a workflow by sessionId (unified entry point)
-	* 
-	* This method supports both:
-	* 1. First run: session doesn't exist → create session, start from entry node
-	* 2. Resume: session exists with messages → infer next node from messages
-	* 
-	* @param sessionId - Session ID (format: workflow_{runId} or any string)
-	* @param options - Optional configuration
-	* @returns Promise resolving to RunResult
-	*/
-	run(sessionId: string, options?: RunOptions & {
-		workflowId?: string;
-	}): Promise<RunResult>;
-	/**
-	* Initialize session state
-	*/
-	private initializeSessionState;
-	/**
-	* Run with resume point
-	* 
-	* Simplified logic:
-	* - input is passed directly to execution (string or object)
-	* - For resume with ask_user, the input should contain userQuery
-	* - agentSessionId comes from session messages via resumePoint
-	*/
-	private runWithResume;
-	/**
-	* Convenience method to run a workflow directly
-	*/
-	runWorkflow(workflow: Workflow | WorkflowDefinition, options?: RunOptions): Promise<RunResult>;
-	/**
-	* Pause a running workflow
-	*/
-	pause(sessionId: string): Promise<void>;
-	/**
-	* Stop a running or paused workflow
-	*/
-	stop(sessionId: string, reason?: string): Promise<void>;
-	/**
-	* Get session status
-	*/
-	getSessionStatus(sessionId: string): RunStatus | null;
-	/**
-	* Check if session is active
-	*/
-	isSessionActive(sessionId: string): boolean;
-	/**
-	* Setup event handlers for a run
-	*/
-	private setupEventHandlers;
-	/**
-	* Write node interrupt message
-	*/
-	private writeNodeInterrupt;
-	/**
-	* Main scheduling loop
-	*/
-	private scheduleAndExecute;
-	/**
-	* Wait for next node event
-	*/
-	private waitForNextNodeEvent;
-	/**
-	* Start execution of a single node
-	*/
-	private startNode;
-	/**
-	* Write workflow.node.start message
-	*/
-	private writeNodeStart;
-	/**
-	* Write node resume message with user response
-	*/
-	private writeNodeResume;
-	/**
-	* Resume execution of a paused node
-	* 
-	* Simplified logic:
-	* - Load agent session from agentSessionId
-	* - Pass userQuery from input to agentNode
-	* - No complex userResponse distinction
-	*/
-	private resumeNode;
-	/**
-	* Create execution context for a node
-	* 
-	* @param sessionState - Active session state
-	* @param nodeId - Node ID to create context for
-	* @param globalInput - Global workflow input (for entry nodes or resume)
-	* @param forceGlobalInput - Force merge globalInput even for non-entry nodes (for resume)
-	*/
-	private createExecutionContext;
-	/**
-	* Check if workflow is complete and finalize
-	*/
-	private checkAndFinalize;
-	/**
-	* Complete a workflow successfully
-	*/
-	private completeWorkflow;
-	/**
-	* Fail a workflow
-	*/
-	private failWorkflow;
-	/**
-	* Cleanup session resources
-	*/
-	private cleanupSession;
-	/**
-	* Wait for a run to complete
-	*/
-	private waitForCompletion;
-	/**
-	* Get session metadata
-	*/
-	private getSessionMetadata;
-	/**
-	* Find workflow definition from repository
-	*/
-	private findDefinitionForWorkflow;
-}
-export { WorkflowRepository, WorkflowEngineCreateOptions, WorkflowEngineConfig, WorkflowEngine, SchedulerState, SchedulerOptions, Scheduler, RunStatus, RunResult, RunOptions, NodeStatus, NodeRegistry, NodeFactory, NodeExecutionContext, NodeContext, ExecutorOptions, Executor, EventBus, DAGManager, DAGAnalysis };