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

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

@@ -1,3546 +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 BaseEventSchema: unknown;
-type BaseEvent = z.infer<typeof BaseEventSchema>;
-declare const WorkflowStartedEventSchema: unknown;
-declare const WorkflowPausedEventSchema: unknown;
-declare const WorkflowResumedEventSchema: unknown;
-declare const WorkflowStoppedEventSchema: unknown;
-declare const WorkflowCompletedEventSchema: unknown;
-declare const WorkflowFailedEventSchema: unknown;
-declare const WorkflowOutputEventSchema: unknown;
-declare const NodeScheduledEventSchema: unknown;
-declare const NodeStartedEventSchema: unknown;
-declare const NodeProgressEventSchema: unknown;
-declare const NodeCompletedEventSchema: unknown;
-declare const NodeFailedEventSchema: unknown;
-declare const NodeSkippedEventSchema: unknown;
-declare const NodeDataEventSchema: unknown;
-declare const NodeAddedEventSchema: unknown;
-declare const NodeRemovedEventSchema: unknown;
-declare const ControlPauseEventSchema: unknown;
-declare const ControlResumeEventSchema: unknown;
-declare const ControlStopEventSchema: unknown;
-declare const NodeInterruptEventSchema: unknown;
-declare const WorkflowAskUserEventSchema: unknown;
-declare const WorkflowEventSchema: unknown;
-type WorkflowEvent = z.infer<typeof WorkflowEventSchema>;
-declare function createWorkflowEvent<T extends WorkflowEvent["type"]>(type: T, runId: string, data: Omit<Extract<WorkflowEvent, {
-	type: T;
-}>, "type" | "run_id" | "timestamp">): any;
-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 { 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 ToolSource = "built-in" | "plugin" | "dynamic";
-/**
-* 工具注册信息
-*/
-interface ToolRegistration {
-	/** 工具实例 */
-	tool: Tool;
-	/** 注册时间 */
-	registeredAt: number;
-	/** 注册来源 */
-	source: ToolSource;
-	/** 是否启用 */
-	enabled: boolean;
-}
-/**
-* 工具执行请求
-*/
-interface ToolExecuteRequest {
-	/** 工具名称 */
-	name: string;
-	/** 参数 */
-	args: Record<string, unknown>;
-	/** 上下文 */
-	context: ToolContext;
-	/** 是否跳过 Hook */
-	skipHooks?: boolean;
-}
-/**
-* 工具列表过滤器
-*/
-interface ToolListFilter {
-	/** 按名称过滤（支持 glob） */
-	name?: string | string[];
-	/** 按分类过滤 */
-	category?: string;
-	/** 按标签过滤 */
-	tags?: string[];
-	/** 按来源过滤 */
-	source?: ToolSource;
-	/** 只返回启用的工具 */
-	enabledOnly?: boolean;
-	/** 排除的工具 */
-	exclude?: string[];
-}
-/**
-* LLM Message
-*/
-interface LLMMessage {
-	/** 消息角色 */
-	role: "system" | "user" | "assistant" | "tool";
-	/** 消息内容 */
-	content: string;
-	/** 工具调用（仅 assistant 角色） */
-	toolCalls?: ToolCall[];
-	/** 工具调用 ID（仅 tool 角色） */
-	toolCallId?: string;
-	/** 名称（用于 function 调用） */
-	name?: string;
-}
-/**
-* Tool Call (OpenAI format)
-*/
-interface ToolCall {
-	/** 工具调用 ID */
-	id: string;
-	/** 工具名称 */
-	name: string;
-	/** 工具参数（JSON 字符串） */
-	arguments: string;
-	/** OpenAI 格式的 function 对象 */
-	function?: {
-		/** 函数名称 */
-		name: string;
-		/** 函数参数（JSON 字符串） */
-		arguments: string;
-	};
-}
-/**
-* Usage Information
-*/
-interface UsageInfo {
-	/** Prompt Token 数 */
-	promptTokens: number;
-	/** Completion Token 数 */
-	completionTokens: number;
-	/** 总 Token 数 */
-	totalTokens: number;
-}
-/**
-* LLM Output
-*/
-interface LLMOutput {
-	/** 生成的内容 */
-	content: string;
-	/** 推理/思考内容（支持 reasoning 模型的输出） */
-	reasoning?: string;
-	/** 完成原因 */
-	finishReason: "stop" | "length" | "content-filter" | "tool-calls" | "function-call";
-	/** 工具调用 */
-	toolCalls?: ToolCall[];
-	/** Usage 信息 */
-	usage?: UsageInfo;
-	/** 生成模型 */
-	model?: string;
-}
-/**
-* 模型限制配置
-*/
-interface ModelLimits {
-	/** 上下文窗口大小（Token 数） */
-	contextWindow: number;
-	/** 压缩阈值（0-1），超过此比例触发上下文压缩 */
-	compactionThreshold?: number;
-	/** 最大输出 Token 数 */
-	maxOutputTokens?: number;
-}
-/**
-* LLM Invoke 请求
-*/
-interface LLMInvokeRequest {
-	/** 消息列表 */
-	messages: LLMMessage[];
-	/** Provider ID（可选，默认使用配置的默认 Provider） */
-	providerId?: string;
-	/** 模型（可选，默认使用配置的默认模型） */
-	model?: string;
-	/** 工具列表 */
-	tools?: ToolInfo2[];
-	/** 温度参数 */
-	temperature?: number;
-	/** 最大 Token 数 */
-	maxTokens?: number;
-	/** Top P */
-	topP?: number;
-	/** 工具选择策略 */
-	toolChoice?: "auto" | "none" | {
-		type: "function";
-		function: {
-			name: string;
-		};
-	};
-	/** 停止序列 */
-	stopSequences?: string[];
-	/** Abort Signal */
-	abortSignal?: AbortSignal;
-	/** 调用上下文（用于事件元数据） */
-	context?: LLMInvokeContext;
-	/** 跳过上下文阈值检查（用于 SummaryAgent 等内部调用，避免循环触发压缩） */
-	skipThresholdCheck?: boolean;
-}
-/**
-* LLM Invoke 结果
-*/
-interface LLMInvokeResult {
-	/** LLM 输出 */
-	output: LLMOutput;
-	/** 使用的 Provider ID */
-	providerId: string;
-	/** 使用的模型 */
-	model: string;
-	/** 调用延迟（毫秒） */
-	latencyMs: number;
-}
-/**
-* Tool Info（用于 LLM 工具调用）
-*/
-interface ToolInfo2 {
-	/** 工具名称 */
-	name: string;
-	/** 工具描述 */
-	description?: string;
-	/** 工具参数 Schema */
-	parameters: Record<string, unknown>;
-}
-/**
-* LLM 调用上下文（用于事件元数据）
-*/
-interface LLMInvokeContext {
-	/** Session ID */
-	sessionId?: string;
-	/** Message ID */
-	messageId?: string;
-}
-type AbortSignalType = AbortSignal;
-/**
-* 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;
-}
-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 WorkflowRun {
-	id: string;
-	workflowId: string;
-	workflowName: string;
-	status: RunStatus;
-	input?: Record<string, any>;
-	output?: Record<string, any>;
-	error?: string;
-	startedAt?: Date;
-	pausedAt?: Date;
-	resumedAt?: Date;
-	stoppedAt?: Date;
-	completedAt?: Date;
-	durationMs?: number;
-	debugMode: boolean;
-	parentRunId?: string;
-}
-interface NodeRun {
-	id: string;
-	runId: string;
-	nodeId: string;
-	nodeType: string;
-	status: NodeStatus;
-	input?: any;
-	output?: any;
-	error?: string;
-	startedAt?: Date;
-	completedAt?: Date;
-	durationMs?: number;
-	retryCount: number;
-}
-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>;
-}
-/**
-* 创建 NodeExecutionContext
-*/
-declare function createNodeExecutionContext(params: {
-	runId: string;
-	workflowName: string;
-	nodeId: string;
-	input: unknown;
-	previousOutputs: Map<string, unknown>;
-	nodeOutputs: Map<string, unknown>;
-	config: Record<string, unknown>;
-	debug: boolean;
-	eventBus: EventBus;
-	sessionId: string;
-	workflowHistory?: NodeExecutionContext["workflowHistory"];
-}): NodeExecutionContext;
-declare const DependsOnSchema: unknown;
-type DependsOn = z5.infer<typeof DependsOnSchema>;
-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 OutputDefinitionSchema: unknown;
-type OutputDefinition = z5.infer<typeof OutputDefinitionSchema>;
-/**
-* Single input parameter definition
-*/
-declare const InputParameterSchema: unknown;
-type InputParameter = z5.infer<typeof InputParameterSchema>;
-/**
-* Input parameters schema for workflow definition
-* Maps parameter names to their definitions
-*/
-declare const WorkflowInputsSchema: unknown;
-type WorkflowInputs = z5.infer<typeof WorkflowInputsSchema>;
-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;
-}
-interface ParsedWorkflow {
-	format: "yaml" | "json";
-	definition: WorkflowDefinition;
-}
-/**
-* 解析 Workflow 文件
-* @param content 文件内容
-* @param filename 文件名，用于自动检测格式
-*/
-declare function parseWorkflowFile(content: string, filename: string): Promise<ParsedWorkflow>;
-/**
-* Synchronous version of parseWorkflowFile
-* Uses JSON parsing only for auto-detection
-*/
-declare function parseWorkflowFileSync(content: string, filename: string): ParsedWorkflow;
-import { z as z6 } from "zod";
-/**
-* Node 中断事件 - 节点等待用户输入
-*/
-interface NodeInterruptEvent extends BaseEvent {
-	type: "node.interrupt";
-	node_id: string;
-	node_type: string;
-	query: string;
-	/** Agent sub-session ID (for agent nodes that need resume) */
-	agent_session_id?: string;
-}
-/**
-* Workflow Ask User 事件 - Workflow 等待用户输入
-*/
-interface WorkflowAskUserEvent extends BaseEvent {
-	type: "workflow.ask-user";
-	session_id: string;
-	node_id: string;
-	node_type: string;
-	query: string;
-}
-/**
-* 创建 NodeInterruptEvent
-*/
-declare function createNodeInterruptEvent(runId: string, nodeId: string, nodeType: string, query: string, agentSessionId?: string): NodeInterruptEvent;
-/**
-* 创建 WorkflowAskUserEvent
-*/
-declare function createWorkflowAskUserEvent(runId: string, sessionId: string, nodeId: string, nodeType: string, query: string): WorkflowAskUserEvent;
-/**
-* AskUserError - 当节点调用 askUser() 时抛出
-*/
-declare class AskUserError extends Error {
-	readonly runId: string;
-	readonly sessionId: string;
-	readonly nodeId: string;
-	readonly nodeType: string;
-	readonly query: string;
-	readonly agentSessionId?: string | undefined;
-	readonly timestamp: number;
-	readonly type = "ask-user";
-	readonly name = "AskUserError";
-	constructor(runId: string, sessionId: string, nodeId: string, nodeType: string, query: string, agentSessionId?: string | undefined, timestamp?: number);
-	/**
-	* 转换为 WorkflowAskUserEvent
-	*/
-	toEvent(): WorkflowAskUserEvent;
-}
-/**
-* Workflow 节点执行消息角色类型
-* 
-* 设计原则：
-* - workflow.node.start: 对应 tool-call，节点开始执行
-* - workflow.node.interrupt: 节点中断等待用户输入
-* - workflow.node.end: 对应 tool-result，节点执行结束
-* - workflow.node.resume: 用户响应后恢复节点执行
-*/
-declare const WorkflowMessageRoleSchema: unknown;
-type WorkflowMessageRole = z6.infer<typeof WorkflowMessageRoleSchema>;
-/**
-* workflow.node.start 消息 part
-* 对应 tool-call，节点开始执行
-*/
-interface WorkflowNodeStartPart2 {
-	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 WorkflowNodeInterruptPart2 {
-	type: "workflow-node-interrupt";
-	nodeId: string;
-	nodeType: string;
-	query: string;
-	timestamp: number;
-	/** Agent session ID (only for agent nodes) - 用于恢复 agent 子会话 */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.end 消息 part
-* 对应 tool-result，节点执行结束
-*/
-interface WorkflowNodeEndPart2 {
-	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 WorkflowNodeResumePart2 {
-	type: "workflow-node-resume";
-	nodeId: string;
-	response: string;
-	timestamp: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow 消息 part 联合类型
-*/
-type WorkflowMessagePart = WorkflowNodeStartPart2 | WorkflowNodeInterruptPart2 | WorkflowNodeEndPart2 | WorkflowNodeResumePart2;
-/**
-* Workflow Session 元数据（简化版）
-* 
-* 简化原则：只保留必要字段，其他信息从 messages 推断
-* 
-* 设计原则：
-* - sessionId 直接作为 runId 使用
-* - Session.metadata.status 跟踪运行状态
-* - Session.messages 按时间顺序记录节点执行状态
-* - Next node 从 messages 推断（最后一条消息决定恢复点）
-*/
-interface WorkflowSessionMetadata2 {
-	type: "workflow";
-	/** Used to load workflow definition */
-	workflowId: string;
-	/** Display name */
-	workflowName: string;
-	/** Workflow 版本 (可选) */
-	workflowVersion?: string;
-	/** Execution status */
-	status: "running" | "paused" | "completed" | "failed" | "stopped";
-	/** Allow additional properties for metadata extension */
-	[key: string]: unknown;
-}
-/**
-* Agent Session 引用（存储在 workflow session metadata 中）
-*/
-interface AgentSessionRef2 {
-	nodeId: string;
-	sessionId: string;
-	status: "active" | "paused" | "completed";
-	createdAt?: number;
-}
-/**
-* workflow.node.start 消息元数据
-* 对应 tool-call
-*/
-interface WorkflowNodeStartMetadata {
-	type: "workflow.node.start";
-	workflowNodeId: string;
-	workflowNodeType: string;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.interrupt 消息元数据
-*/
-interface WorkflowNodeInterruptMetadata {
-	type: "workflow.node.interrupt";
-	workflowNodeId: string;
-	workflowNodeType: string;
-	query: string;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.end 消息元数据
-* 对应 tool-result
-*/
-interface WorkflowNodeEndMetadata {
-	type: "workflow.node.end";
-	workflowNodeId: string;
-	workflowNodeType: string;
-	success: boolean;
-}
-/**
-* workflow.node.resume 消息元数据
-*/
-interface WorkflowNodeResumeMetadata {
-	type: "workflow.node.resume";
-	workflowNodeId: string;
-	response: string;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow 消息元数据联合类型
-*/
-type WorkflowMessageMetadata = WorkflowNodeStartMetadata | WorkflowNodeInterruptMetadata | WorkflowNodeEndMetadata | WorkflowNodeResumeMetadata;
-/**
-* Agent Session 信息（存储在 workflow message metadata 中）
-*/
-interface AgentSessionInfo {
-	/** Agent session ID */
-	sessionId: string;
-	/** Node ID */
-	nodeId: string;
-	/** 创建时间 */
-	createdAt: number;
-}
-/**
-* 检查 SessionMetadata 是否为 Workflow 类型
-* 
-* 简化验证：只检查必要字段存在性
-* - type === 'workflow'
-* - workflowId 存在
-* - workflowName 存在
-* - status 存在且为有效值
-*/
-declare function isWorkflowSessionMetadata(metadata: unknown): metadata is WorkflowSessionMetadata2;
-/**
-* 获取 workflow session 的状态
-*/
-declare function getWorkflowSessionStatus(metadata: WorkflowSessionMetadata2): "running" | "paused" | "completed" | "failed" | "stopped";
-/**
-* askUser 选项
-*/
-interface AskUserOptions {
-	options?: string[];
-	required_confirm?: boolean;
-}
-/**
-* 从 Session 恢复的运行时状态
-*/
-interface RuntimeState {
-	sessionId: string;
-	nodeOutputs: Map<string, unknown>;
-	pendingNodeId: string | null;
-	waitingForUser: boolean;
-	agentSessionId?: string;
-}
-/**
-* Template resolution options
-*/
-interface TemplateResolverOptions {
-	/** Input passed to the workflow/node */
-	input?: Record<string, unknown>;
-	/** Map of previous node outputs */
-	previousOutputs?: Map<string, unknown>;
-}
-/**
-* TemplateResolver
-* 
-* Resolves template strings that reference workflow inputs and node outputs.
-*/
-declare class TemplateResolver {
-	private input;
-	private previousOutputs;
-	constructor(options?: TemplateResolverOptions);
-	/**
-	* Create a TemplateResolver from NodeExecutionContext
-	* 
-	* @param context - Node execution context
-	* @returns TemplateResolver instance
-	*/
-	static fromContext(context: NodeExecutionContext): TemplateResolver;
-	/**
-	* Resolve template references in an input value.
-	* 
-	* Handles:
-	* - Primitive values (returned as-is)
-	* - Objects (recursively resolved)
-	* - Arrays (recursively resolved)
-	* - Strings (template resolution)
-	* 
-	* Key behavior for template strings:
-	* - If the string is a pure template reference (e.g., "{{nodes.fetch}}"), 
-	*   the resolved value is returned as-is (preserving objects/arrays)
-	* - If the string contains text + templates (e.g., "Hello {{name}}"),
-	*   returns a string with interpolated values
-	* 
-	* @param input - Input value that may contain template strings
-	* @returns Input with template references resolved
-	*/
-	resolveValue(input: unknown): unknown;
-	/**
-	* Check if a string is a pure template reference (starts with {{ and ends with }})
-	* @param str - String to check
-	* @returns The template content if pure, null otherwise
-	*/
-	private extractPureTemplate;
-	/**
-	* Resolve a pure template reference and return the value as-is.
-	* @param templateContent - Content between {{ and }}
-	* @returns The resolved value (may be object, array, or primitive)
-	*/
-	private resolvePureTemplate;
-	/**
-	* Resolve template content (the part inside {{ }}) and return the value.
-	* @param templateContent - The path to resolve (e.g., "input.key", "nodes.fetch.data")
-	* @returns The resolved value
-	*/
-	private resolveTemplateContent;
-	/**
-	* Resolve a single template string.
-	* 
-	* Supports patterns:
-	* - {{input.key}} - Input variable
-	* - {{nodeId}} - Node's entire output
-	* - {{nodeId.output}} - Node's output property
-	* - {{nodeId.output.path}} - Node's nested output property
-	* - {{nodes.nodeId}} - Node's entire output (with prefix)
-	* - {{nodes.nodeId.output.path}} - Node's nested property (with prefix)
-	* 
-	* @param template - Template string to resolve
-	* @returns Resolved string
-	*/
-	resolveString(template: string): string;
-	/**
-	* Resolve a node output path.
-	* 
-	* @param path - Path like "nodeId" or "nodeId.output" or "nodeId.output.path"
-	* @returns The resolved value or undefined
-	*/
-	private resolveNodePath;
-	/**
-	* Get a nested value from an object using dot notation.
-	* 
-	* @param obj - Object to traverse
-	* @param path - Dot-separated path
-	* @returns The nested value or undefined
-	*/
-	private getNestedValue;
-	/**
-	* Convert a value to string, or return the original template if value is undefined.
-	*/
-	private stringify;
-	/**
-	* Check if a string contains template references.
-	* 
-	* @param str - String to check
-	* @returns True if the string contains template references
-	*/
-	containsTemplates(str: string): boolean;
-	/**
-	* Extract all template references from a string.
-	* 
-	* @param str - String to extract from
-	* @returns Array of template references
-	*/
-	extractTemplates(str: string): string[];
-}
-interface WorkflowRepository {
-	create(workflow: Omit<Workflow, "id" | "createdAt" | "updatedAt">): Workflow;
-	getById(id: string): Workflow | null;
-	getByName(name: string): Workflow | null;
-	list(options?: ListOptions): Workflow[];
-	update(id: string, updates: Partial<Workflow>): Workflow | null;
-	delete(id: string): boolean;
-}
-interface CreateOptions {
-	tags?: string[];
-	metadata?: WorkflowMetadata;
-	taskId?: number;
-	force?: boolean;
-}
-interface ListOptions {
-	tag?: string;
-	taskId?: number;
-	search?: string;
-	limit?: number;
-	offset?: number;
-}
-interface WorkflowUpdates {
-	definition?: WorkflowDefinition;
-	config?: WorkflowConfig;
-	tags?: string[];
-	metadata?: WorkflowMetadata;
-}
-interface WorkflowEngine {
-	createSession(workflowId: string, options?: {
-		input?: Record<string, any>;
-		workflowName?: string;
-		workflowVersion?: string;
-	}): Promise<string>;
-	run(sessionId: string, options?: RunOptions): Promise<RunResult>;
-	runWorkflow(workflow: Workflow | WorkflowDefinition, options?: RunOptions): Promise<RunResult>;
-	stop(sessionId: string, reason?: string): Promise<void>;
-	addNode(sessionId: string, nodeDefinition: NodeDefinition): Promise<void>;
-	removeNode(sessionId: string, nodeId: string): Promise<void>;
-}
-type WorkflowEngineFactory = (workflow: Workflow, options?: RunOptions) => Pick<WorkflowEngine, "run" | "stop" | "runWorkflow">;
-interface SessionInfo {
-	id: string;
-	title: string;
-	metadata: WorkflowSessionMetadata3;
-	createdAt: Date;
-	updatedAt: Date;
-}
-interface WorkflowSessionMetadata3 {
-	type: "workflow";
-	runId?: string;
-	workflowId?: string;
-	workflowName: string;
-	workflowVersion?: string;
-	status: "running" | "paused" | "completed" | "failed";
-	input?: any;
-	rootNodeId?: string;
-	agentSessions?: AgentSessionRef3[];
-}
-interface AgentSessionRef3 {
-	nodeId: string;
-	sessionId: string;
-	status: "active" | "paused" | "completed";
-}
-declare class WorkflowService {
-	private workflowRepository;
-	private engineFactory;
-	private sessionComponent?;
-	constructor(workflowRepository: WorkflowRepository, engineFactory: WorkflowEngineFactory, sessionComponent?: {
-		create(options: {
-			id?: string;
-			title: string;
-			metadata: any;
-		}): Promise<{
-			id: string;
-		}>;
-		get(id: string): Promise<SessionInfo | null | undefined>;
-		list?(options?: {
-			limit?: number;
-			offset?: number;
-		}): Promise<SessionInfo[]>;
-		update(id: string, updates: {
-			metadata?: any;
-		}): Promise<boolean>;
-		addMessage(sessionId: string, message: any): Promise<string>;
-		getMessages(sessionId: string): Promise<any[]>;
-	} | undefined);
-	/**
-	* Create a new workflow from definition
-	*/
-	createWorkflow(definition: WorkflowDefinition, options?: CreateOptions): Promise<Workflow>;
-	/**
-	* Get workflow by id or name
-	*/
-	getWorkflow(idOrName: string): Workflow | null;
-	/**
-	* Get workflow by id
-	*/
-	getWorkflowById(id: string): Workflow | null;
-	/**
-	* Get workflow by name
-	*/
-	getWorkflowByName(name: string): Workflow | null;
-	/**
-	* List workflows with optional filters
-	*/
-	listWorkflows(options?: ListOptions): Workflow[];
-	/**
-	* Update an existing workflow
-	*/
-	updateWorkflow(idOrName: string, updates: WorkflowUpdates, options?: {
-		tags?: string[];
-	}): Promise<Workflow>;
-	/**
-	* Delete a workflow by name or id
-	*/
-	deleteWorkflow(idOrName: string): Promise<boolean>;
-	/**
-	* Run a workflow by definition or name
-	* 
-	* This creates a Session that represents the workflow run.
-	* The Session ID is used as the run identifier for pause/resume.
-	*/
-	runWorkflow(idOrNameOrDefinition: string | WorkflowDefinition, input?: Record<string, any>, options?: RunOptions): Promise<RunResult>;
-	/**
-	* Run workflow by name (convenience method)
-	*/
-	runWorkflowByName(name: string, input?: Record<string, any>, options?: RunOptions): Promise<RunResult>;
-	/**
-	* Stop a running workflow session
-	*/
-	stopRun(sessionId: string, reason?: string): Promise<void>;
-	/**
-	* Get workflow session by ID
-	*/
-	getSession(sessionId: string): Promise<SessionInfo | null>;
-	/**
-	* List workflow sessions
-	*/
-	listSessions(options?: {
-		limit?: number;
-		offset?: number;
-	}): Promise<SessionInfo[]>;
-	/**
-	* Get messages from a workflow session
-	*/
-	getSessionMessages(sessionId: string): Promise<any[]>;
-}
-/**
-* @fileoverview 统一错误类型体系
-* 
-* 提供 AgentError, ToolError, LLMError, ComponentError, ContextError 等错误类型
-* 每个错误包含 code（错误码）和 details（额外信息）
-*/
-/**
-* 错误码枚举
-*/
-declare const ErrorCodes: {
-	readonly AGENT_NOT_FOUND: "AGENT_001";
-	readonly AGENT_RUN_FAILED: "AGENT_002";
-	readonly AGENT_TIMEOUT: "AGENT_003";
-	readonly AGENT_CONFIG_INVALID: "AGENT_004";
-	readonly TOOL_NOT_FOUND: "TOOL_001";
-	readonly TOOL_DISABLED: "TOOL_002";
-	readonly TOOL_EXECUTION_FAILED: "TOOL_003";
-	readonly TOOL_VALIDATION_FAILED: "TOOL_004";
-	readonly LLM_PROVIDER_NOT_FOUND: "LLM_001";
-	readonly LLM_INVOCATION_FAILED: "LLM_002";
-	readonly LLM_TIMEOUT: "LLM_003";
-	readonly LLM_CONFIG_INVALID: "LLM_004";
-	readonly COMPONENT_NOT_FOUND: "COMP_001";
-	readonly COMPONENT_INIT_FAILED: "COMP_002";
-	readonly COMPONENT_NOT_RUNNING: "COMP_003";
-	readonly CONFIG_NOT_FOUND: "CONFIG_001";
-	readonly CONFIG_INVALID: "CONFIG_002";
-	readonly CONFIG_SOURCE_ERROR: "CONFIG_003";
-	readonly CONTEXT_THRESHOLD_EXCEEDED: "CTX_001";
-	readonly CONTEXT_COMPACTION_FAILED: "CTX_002";
-	readonly MCP_INIT_FAILED: "MCP_001";
-	readonly MCP_SERVER_ERROR: "MCP_002";
-	readonly MCP_TOOL_ERROR: "MCP_003";
-};
-type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
-/**
-* RoyError 基类
-*/
-declare class RoyError extends Error {
-	readonly code: ErrorCode;
-	readonly details?: unknown;
-	constructor(message: string, code: ErrorCode, details?: unknown);
-}
-/**
-* LLM Output 结构（用于 ContextError 携带 assistant message）
-* 
-* 这是简化版本，仅包含保存到 session 所需的最少字段。
-* 与 llm/types.ts 中的 LLMOutput 不同，那个版本包含完整的 LLM 调用结果。
-*/
-interface LLMOutput2 {
-	content?: string;
-	reasoning?: string;
-	toolCalls?: Array<{
-		id: string;
-		function?: {
-			name: string;
-			arguments: string;
-		};
-		name?: string;
-		arguments?: unknown;
-	}>;
-	usage?: {
-		promptTokens: number;
-		completionTokens: number;
-		totalTokens: number;
-	};
-}
-/**
-* Context 相关错误
-*/
-declare class ContextError extends RoyError {
-	readonly sessionId?: string | undefined;
-	readonly usage?: {
-		promptTokens: number;
-		completionTokens: number;
-		totalTokens: number;
-	} | undefined;
-	readonly contextWindow?: number | undefined;
-	readonly llmOutput?: LLMOutput2;
-	constructor(message: string, code?: ErrorCode, sessionId?: string | undefined, usage?: {
-		promptTokens: number;
-		completionTokens: number;
-		totalTokens: number;
-	} | undefined, contextWindow?: number | undefined, llmOutput?: LLMOutput2, details?: unknown);
-}
-/**
-* LLMComponent
-* 管理 LLM 调用，使用 AI SDK 进行实际调用
-* 
-* 配置通过 ConfigComponent 实时获取，支持配置热更新
-* 
-* @example
-* // 通过 ConfigComponent 加载配置
-* const configComponent = new ConfigComponent();
-* configComponent.setXdgDataHome(__dirname);
-* 
-* const llmComponent = new LLMComponent();
-* await llmComponent.init({
-*   env,  // Environment 实例（必填）
-*   options: {
-*     configComponent,  // ConfigComponent 实例
-*     configPath: "config.jsonc"  // 配置文件路径
-*   }
-* });
-* 
-* // 配置更新后，下次调用会自动获取最新配置
-* configComponent.set("llm.temperature", 0.5);
-*/
-declare class LLMComponent extends BaseComponent {
-	readonly name = "llm";
-	readonly version = "2.0.0";
-	private configComponent?;
-	/** 配置变更 watcher 清理函数 */
-	private configWatcher?;
-	constructor();
-	/**
-	* 初始化组件
-	* 
-	* 配置加载优先级（从高到低）：
-	* 1. Object - 直接传入的 config 对象
-	* 2. Env - 环境变量（通过 envPrefix 配置前缀）
-	* 3. File - 配置文件（通过 configPath 指定）
-	*/
-	init(config: ComponentConfig): Promise<void>;
-	/**
-	* 注册配置到 ConfigComponent
-	* 
-	* 配置加载顺序（优先级从低到高）：
-	* 1. FileSource - 从配置文件加载（最低）
-	* 2. EnvSource - 从环境变量加载（中等）
-	* 3. MemorySource - 直接配置对象（最高）
-	*/
-	private registerConfig;
-	/**
-	* 将配置对象展平为点号路径
-	* 
-	* @example
-	* flattenConfig({ providers: { openai: { apiKey: "xxx" } } })
-	* -> { "llm.providers.openai.apiKey": "xxx" }
-	*/
-	private flattenConfig;
-	/**
-	* 注册配置热更新监听
-	*/
-	private registerConfigWatcher;
-	/**
-	* 处理配置变更（支持热更新）
-	*/
-	protected onConfigChange(event: {
-		key: string;
-		oldValue?: unknown;
-		newValue?: unknown;
-	}): void;
-	/**
-	* 启动组件
-	*/
-	onStart(): Promise<void>;
-	/**
-	* 停止组件
-	*/
-	onStop(): Promise<void>;
-	/**
-	* 从配置源获取配置值
-	* 优先从 ConfigComponent 获取（支持热更新），否则返回默认值
-	*/
-	private getLLMConfig;
-	/**
-	* 解析请求，构建调用上下文（invoke 和 invokeStream 共享）
-	*/
-	private resolveRequest;
-	/**
-	* 调用 LLM
-	* 
-	* 流式事件通过 env.pushEnvEvent() 发布
-	*/
-	invoke(request: LLMInvokeRequest): Promise<LLMInvokeResult>;
-	/**
-	* 获取 Provider API Key
-	*/
-	private getApiKey;
-	/**
-	* 获取 Provider
-	*/
-	getProvider(id: string);
-	/**
-	* 列出所有 Provider
-	*/
-	listProviders();
-	/**
-	* 获取模型的限制配置
-	* 
-	* @param providerId - Provider ID
-	* @param modelId - 模型 ID（可选，默认使用 provider 的 defaultModel）
-	* @returns 模型限制配置，如果没有配置则返回 undefined
-	*/
-	getModelLimits(providerId: string, modelId?: string): ModelLimits | undefined;
-	/**
-	* 获取上下文窗口阈值配置
-	* 
-	* @param providerId - Provider ID
-	* @param modelId - 模型 ID
-	* @returns 包含 contextWindow 和 thresholdRatio 的对象
-	*/
-	getContextThresholdConfig(providerId: string, modelId?: string): {
-		contextWindow: number;
-		thresholdRatio: number;
-	};
-	/**
-	* 检测上下文阈值是否超过
-	* 
-	* @param usage - LLM 使用量信息
-	* @param providerId - Provider ID
-	* @param modelId - 模型 ID
-	* @param sessionId - Session ID（用于错误信息）
-	* @returns 如果超过阈值，返回 ContextError；否则返回 undefined
-	*/
-	checkContextThreshold(usage: {
-		totalTokens: number;
-		promptTokens?: number;
-		completionTokens?: number;
-	} | undefined, providerId: string, modelId: string | undefined, sessionId?: string): ContextError | undefined;
-}
-/**
-* @Workflow 装饰器选项
-*/
-interface WorkflowOptions {
-	/** Workflow 名称 */
-	name: string;
-	/** 版本号，默认 "1.0" */
-	version?: string;
-	/** 描述 */
-	description?: string;
-	/** 入口节点 ID */
-	entry?: string | string[];
-	/** 全局配置 */
-	config?: {
-		parallel_limit?: number | null;
-		timeout?: number | null;
-		retry?: {
-			max_attempts: number;
-			backoff: "fixed" | "exponential";
-			initial_delay: number;
-		};
-		debug?: boolean;
-	};
-	/** 标签 */
-	tags?: string[];
-	/** 作者 */
-	author?: string;
-}
-/**
-* @NodeAs 装饰器选项
-*/
-interface NodeAsOptions {
-	/** 节点 ID，默认使用方法名 */
-	nodeId?: string;
-	/** 节点类型 */
-	nodeType?: "tool" | "skill" | "agent" | "workflow";
-	/** 显示名称 */
-	name?: string;
-	/** 依赖的节点 ID 列表 */
-	dependsOn?: string | string[];
-	/** 执行条件 */
-	condition?: string;
-	/** 重试配置 */
-	retry?: {
-		max_attempts: number;
-		backoff: "fixed" | "exponential";
-		initial_delay: number;
-	};
-	/** 超时时间（毫秒） */
-	timeout?: number;
-	/** 节点配置 */
-	config?: Record<string, unknown>;
-}
-/**
-* @Edge 装饰器选项
-*/
-interface EdgeOptions {
-	from: string;
-	to: string;
-	/** 条件表达式 */
-	condition?: string;
-}
-/**
-* Workflow 元数据（存储在类的 Reflect Metadata 中）
-*/
-interface WorkflowMetadata2 {
-	name: string;
-	version: string;
-	description?: string;
-	entry?: string | string[];
-	config?: {
-		parallel_limit?: number | null;
-		timeout?: number | null;
-		retry?: {
-			max_attempts: number;
-			backoff: "fixed" | "exponential";
-			initial_delay: number;
-		};
-		debug?: boolean;
-	};
-	tags?: string[];
-	author?: string;
-	/** 类实例引用 */
-	instance?: any;
-}
-/**
-* Node 元数据（存储在类的 Reflect Metadata 中）
-*/
-interface NodeMetadata {
-	nodeId: string;
-	nodeType: string;
-	name?: string;
-	dependsOn: string[];
-	condition?: string;
-	retry?: {
-		max_attempts: number;
-		backoff: "fixed" | "exponential";
-		initial_delay: number;
-	};
-	timeout?: number;
-	config: Record<string, unknown>;
-	methodName: string;
-	method: Function;
-}
-/**
-* Edge 元数据（存储在类的 Reflect Metadata 中）
-*/
-interface EdgeMetadata {
-	from: string;
-	to: string;
-	condition?: string;
-}
-/**
-* Workflow 验证结果
-*/
-interface ValidationResult2 {
-	valid: boolean;
-	errors: string[];
-	warnings: string[];
-}
-/**
-* 转换为 workflow 包中的 NodeDefinition
-* 这是最终输出给 WorkflowEngine 使用的格式
-*/
-interface ConvertedNodeDefinition {
-	id: string;
-	type: string;
-	name?: string;
-	config: Record<string, unknown>;
-	depends_on: string[];
-	condition?: string;
-	retry?: {
-		max_attempts: number;
-		backoff: "fixed" | "exponential";
-		initial_delay: number;
-	};
-	timeout?: number;
-}
-/**
-* 转换为标准的 WorkflowDefinition
-* 这是最终输出给 WorkflowEngine 使用的格式
-*/
-interface ConvertedWorkflowDefinition {
-	name: string;
-	version: string;
-	description?: string;
-	config: {
-		parallel_limit?: number | null;
-		timeout?: number | null;
-		retry?: {
-			max_attempts: number;
-			backoff: "fixed" | "exponential";
-			initial_delay: number;
-		};
-		debug?: boolean;
-	};
-	nodes: ConvertedNodeDefinition[];
-	entry: string | string[];
-	outputs: Array<{
-		name: string;
-		source: string;
-		path: string;
-	}>;
-	metadata: {
-		tags?: string[];
-		author?: string;
-	};
-}
-/**
-* 声明一个类为 Workflow 类
-* 
-* @param options - Workflow 配置选项
-* 
-* @example
-* ```typescript
-* @Workflow({
-*   name: 'my-workflow',
-*   version: '1.0',
-*   entry: 'start'
-* })
-* class MyWorkflow {
-*   @NodeAs({ nodeId: 'start' })
-*   async start() { }
-* }
-* ```
-*/
-declare function Workflow2(options: WorkflowOptions): ClassDecorator;
-/**
-* 将方法声明为 Workflow 的 Node
-* 
-* @param options - Node 配置选项
-* 
-* @example
-* ```typescript
-* @Workflow({ name: 'my-workflow', entry: 'fetch' })
-* class MyWorkflow {
-*   @NodeAs({
-*     nodeId: 'fetch',
-*     nodeType: 'tool',
-*     config: { tool: 'web_search' }
-*   })
-*   async fetch(input: { query: string }) {
-*     return { data: [] };
-*   }
-* 
-*   @NodeAs({
-*     nodeId: 'process',
-*     dependsOn: 'fetch'
-*   })
-*   async process(input: { data: any }) {
-*     return { result: {} };
-*   }
-* }
-* ```
-*/
-declare function NodeAs(options?: NodeAsOptions): MethodDecorator;
-/**
-* 声明一条边 (from -> to)
-* 
-* 这是一个方法装饰器，用于在方法上声明边关系
-* 
-* @param from - 起始节点 ID
-* @param to - 目标节点 ID
-* 
-* @example
-* ```typescript
-* @Edge('nodeA', 'nodeB')
-* static __edge_nodeA_to_nodeB__ = null;
-* ```
-*/
-declare function Edge(from: string, to: string): MethodDecorator;
-/**
-* 类级别装饰器，声明多条边
-* 
-* @param edges - 边数组
-* 
-* @example
-* ```typescript
-* @WorkflowEdges([
-*   { from: 'A', to: 'B' },
-*   { from: 'B', to: 'C' }
-* ])
-* @Workflow({ name: 'test' })
-* class TestWorkflow { }
-* ```
-*/
-declare function WorkflowEdges(edges: EdgeOptions[]): ClassDecorator;
-/**
-* DecoratorNode - 执行装饰器类方法的节点
-* 
-* 用于执行使用 @Workflow/@NodeAs 装饰器定义的类方法
-* 
-* @example
-* ```typescript
-* const definition: DecoratorNodeConfig = {
-*   id: 'myNode',
-*   type: 'decorator',
-*   config: {
-*     _methodName: 'myMethod',
-*     _instance: myWorkflowInstance,
-*   }
-* };
-* 
-* const node = new DecoratorNode(definition);
-* const result = await node.execute(context);
-* ```
-*/
-declare class DecoratorNode implements Node {
-	readonly type = "decorator";
-	readonly id: string;
-	private readonly methodName;
-	private readonly instance;
-	private readonly dependsOn;
-	private readonly timeout?;
-	private readonly retryConfig?;
-	constructor(definition: NodeDefinition);
-	/**
-	* 执行装饰器方法
-	*/
-	execute(context: NodeExecutionContext): Promise<NodeExecutionResult>;
-	/**
-	* 准备输入参数
-	* 
-	* 根据依赖的节点 ID，从 nodeOutputs 中提取对应的输出
-	* 返回格式: { [depNodeId]: depOutput }
-	*/
-	private prepareInput;
-	/**
-	* 带重试的执行
-	*/
-	private executeWithRetry;
-	/**
-	* 带超时的执行
-	*/
-	private executeWithTimeout;
-	/**
-	* 计算退避延迟
-	*/
-	private calculateBackoff;
-	/**
-	* 睡眠
-	*/
-	private sleep;
-}
-/**
-* Workflow 转换器
-* 
-* 负责将使用装饰器定义的类转换为标准的 WorkflowDefinition
-*/
-declare class WorkflowConverter {
-	/**
-	* 从装饰器类提取 Workflow 元数据
-	*/
-	static extractWorkflowMetadata(targetClass: Function): WorkflowMetadata2 | undefined;
-	/**
-	* 从装饰器类提取所有 Node 元数据
-	*/
-	static extractNodeMetadatas(targetClass: Function): NodeMetadata[];
-	/**
-	* 从装饰器类提取所有 Edge 元数据
-	*/
-	static extractEdgeMetadatas(targetClass: Function): EdgeMetadata[];
-	/**
-	* 将装饰器类转换为 WorkflowDefinition
-	*/
-	static fromClass(targetClass: new (...args: any[]) => any, instance: any): ConvertedWorkflowDefinition;
-	/**
-	* 构建节点映射，并合并边依赖
-	*/
-	private static buildNodeMap;
-	/**
-	* 验证装饰器类的有效性
-	*/
-	static validateWorkflowClass(targetClass: Function): ValidationResult2;
-	/**
-	* 检测是否存在循环依赖
-	* 
-	* dependsOn 语义：A 依赖 B 表示 A.dependsOn = [B]
-	* 这意味着 B 执行完成后才能执行 A，所以边是 B → A
-	* 
-	* 检测方法：构建反向邻接表（谁依赖我），然后 DFS 检测环
-	*/
-	private static hasCycle;
-	/**
-	* 执行装饰器方法（用于 WorkflowEngine 调用）
-	*/
-	static executeNode(nodeDef: ConvertedNodeDefinition, context: {
-		input: any;
-		previousOutputs: Map<string, any>;
-	}): Promise<{
-		output: any;
-		error?: Error;
-	}>;
-}
-/**
-* 从装饰器类创建 WorkflowDefinition
-* 
-* 这是最常用的便捷函数，自动处理实例创建和转换
-* 
-* @param targetClass - 使用 @Workflow 装饰的类
-* @param options - 可选配置
-* @returns WorkflowDefinition
-* 
-* @example
-* ```typescript
-* @Workflow({ name: 'my-workflow', entry: 'start' })
-* class MyWorkflow {
-*   @NodeAs({ nodeId: 'start' })
-*   async start() { return { done: true }; }
-* }
-* 
-* // 方式一：自动创建实例
-* const workflow = createWorkflowFromClass(MyWorkflow);
-* 
-* // 方式二：传入自定义实例
-* const myInstance = new MyWorkflow(customDep);
-* const workflow = createWorkflowFromClass(MyWorkflow, { instance: myInstance });
-* ```
-*/
-declare function createWorkflowFromClass(targetClass: new (...args: any[]) => any, options?: {
-	/** 自定义实例，不传则自动创建 */
-	instance?: any;
-	/** 构造函数参数 */
-	constructorArgs?: any[];
-}): ConvertedWorkflowDefinition;
-/**
-* ToolComponent
-* 工具管理核心组件
-*/
-declare class ToolComponent extends BaseComponent {
-	readonly name = "tool";
-	readonly version = "1.0.0";
-	private registry;
-	private validator;
-	private config?;
-	/** ConfigComponent 用于配置管理 */
-	private configComponent?;
-	/** 配置变更 watcher 清理函数 */
-	private configWatcher?;
-	constructor();
-	/**
-	* 初始化组件
-	* 
-	* 配置加载优先级（从高到低）：
-	* 1. Object - 直接传入的 config 对象
-	* 2. Env - 环境变量（通过 envPrefix 配置前缀）
-	* 3. File - 配置文件（通过 configPath 指定）
-	*/
-	init(config?: ComponentConfig): Promise<void>;
-	/**
-	* 注册配置到 ConfigComponent
-	* 
-	* 配置加载顺序（优先级从低到高）：
-	* 1. FileSource - 从配置文件加载（最低）
-	* 2. EnvSource - 从环境变量加载（中等）
-	* 3. MemorySource - 直接配置对象（最高）
-	* 
-	* 实现步骤：
-	* 1. 使用 registerComponent(TOOL_CONFIG_REGISTRATION) 注册配置
-	* 2. 使用 load("tool") 加载已注册的配置
-	* 3. 设置 TOOL_DEFAULTS 默认值
-	* 4. 处理环境变量后备方案
-	* 5. 处理 config 对象（最高优先级）
-	*/
-	private registerConfig;
-	/**
-	* 将配置对象展平为点号路径
-	*/
-	private flattenConfig;
-	/**
-	* 注册配置热更新监听
-	*/
-	private registerConfigWatcher;
-	/**
-	* 处理配置变更
-	*/
-	protected onConfigChange(event: {
-		key: string;
-		oldValue?: unknown;
-		newValue?: unknown;
-	}): void;
-	/**
-	* 停止组件
-	*/
-	onStop(): Promise<void>;
-	/**
-	* 注册工具
-	*/
-	register(tool: Tool, source?: ToolRegistration["source"]): void;
-	/**
-	* 批量注册工具
-	*/
-	registerMany(tools: Tool[], source?: ToolRegistration["source"]): void;
-	/**
-	* 注销工具
-	*/
-	unregister(name: string): boolean;
-	/**
-	* 获取工具
-	*/
-	getTool(name: string): Tool | undefined;
-	/**
-	* 列出工具
-	*/
-	listTools(filter?: ToolListFilter): Tool[];
-	/**
-	* 获取工具数量
-	*/
-	getToolCount(): number;
-	/**
-	* 检查工具是否存在
-	*/
-	hasTool(name: string): boolean;
-	/**
-	* 按分类获取工具
-	*/
-	getToolsByCategory(category: string): Tool[];
-	/**
-	* 执行工具
-	*/
-	execute(request: ToolExecuteRequest): Promise<ToolResult2>;
-	/**
-	* 加载内置工具
-	*/
-	loadBuiltInTools(): Promise<void>;
-	/**
-	* 获取 Tool Hook 点列表
-	*/
-	getHookPoints(): string[];
-}
-declare class WorkflowComponent extends BaseComponent {
-	readonly name = "workflow";
-	readonly version = "1.0.0";
-	workflowService: WorkflowService | null;
-	sessionComponent: any;
-	private nodeRegistry;
-	private decoratorsRegistered;
-	/**
-	* 获取 WorkflowService 实例
-	*/
-	getService(): WorkflowService | null;
-	private toolComponent?;
-	private llmComponent?;
-	private logTraceComponent?;
-	private _workflowEnv?;
-	private skillRegistry?;
-	private agentRunner?;
-	/**
-	* 初始化 WorkflowComponent
-	*/
-	init(options: any): Promise<void>;
-	/**
-	* 注册 decorator 节点类型
-	*/
-	private registerDecorators;
-	/**
-	* 创建 WorkflowService（需要外部传入依赖）
-	* 
-	* Note: After session-based refactoring, runRepository is no longer needed.
-	* Workflow runs are managed via SessionComponent.
-	*/
-	createService(options: {
-		workflowRepository: any;
-		toolComponent?: ToolComponent;
-		llmComponent?: LLMComponent;
-		env?: Environment;
-		skillRegistry?: {
-			getSkill(name: string): any;
-			hasSkill(name: string): boolean;
-		};
-		sessionComponent?: any;
-	}): WorkflowService;
-	/**
-	* 运行工作流定义
-	*/
-	runWorkflow(definition: WorkflowDefinition, input?: Record<string, any>, options?: RunOptions): Promise<RunResult>;
-	/**
-	* 停止组件并清理资源
-	* 
-	* 遵循 Component 接口契约，通过 onStop 钩子实现
-	*/
-	protected onStop(): Promise<void>;
-	/**
-	* 启动组件 - 初始化持久化的 SQLite WorkflowService
-	*/
-	start(): Promise<void>;
-	/**
-	* 注册 ask_user 工具到 ToolComponent
-	* 
-	* 这样 Workflow 中的 AgentNode 执行时，Agent 能够找到并调用 ask_user 工具。
-	* ask_user 工具会抛出 AskUserError，触发 workflow pause。
-	*/
-	private registerAskUserTool;
-	/**
-	* 初始化 SQLite 持久化的 WorkflowService
-	* 
-	* Note: After session-based refactoring, runRepository is no longer needed.
-	* Workflow runs are managed via SessionComponent.
-	*/
-	private initSqliteService;
-	/**
-	* 创建内存中的 WorkflowService（用于快速运行或降级）
-	*/
-	private createInMemoryService;
-	/**
-	* 停止组件
-	*/
-	stop(): Promise<void>;
-}
-export { parseWorkflowFileSync, parseWorkflowFile, isWorkflowSessionMetadata, getWorkflowSessionStatus, createWorkflowFromClass, createWorkflowEvent, createWorkflowAskUserEvent, createNodeInterruptEvent, createNodeExecutionContext, WorkflowStoppedEventSchema, WorkflowStartedEventSchema, WorkflowSessionMetadata2 as WorkflowSessionMetadata, WorkflowRun, WorkflowResumedEventSchema, WorkflowPausedEventSchema, WorkflowOutputEventSchema, WorkflowNodeStartPart2 as WorkflowNodeStartPart, WorkflowNodeStartMetadata, WorkflowNodeResumePart2 as WorkflowNodeResumePart, WorkflowNodeResumeMetadata, WorkflowNodeInterruptPart2 as WorkflowNodeInterruptPart, WorkflowNodeInterruptMetadata, WorkflowNodeEndPart2 as WorkflowNodeEndPart, WorkflowNodeEndMetadata, WorkflowMetadataSchema, WorkflowMetadata, WorkflowMessageRoleSchema, WorkflowMessageRole, WorkflowMessagePart, WorkflowMessageMetadata, WorkflowInputsSchema, WorkflowInputs, WorkflowFailedEventSchema, WorkflowEventSchema, WorkflowEvent, WorkflowEdges, WorkflowDefinitionSchema, WorkflowDefinitionExtended, WorkflowDefinition, WorkflowConverter, WorkflowConfigSchema, WorkflowConfig, WorkflowComponent, WorkflowCompletedEventSchema, WorkflowAskUserEventSchema, WorkflowAskUserEvent, Workflow2 as Workflow, TemplateResolver, RuntimeState, RunStatusSchema, RunStatus, RunResult, RunOptions, RetryConfigSchema, RetryConfig, ParsedWorkflow, OutputDefinitionSchema, OutputDefinition, NodeStatusSchema, NodeStatus, NodeStartedEventSchema, NodeSkippedEventSchema, NodeScheduledEventSchema, NodeRun, NodeRemovedEventSchema, NodeProgressEventSchema, NodeInterruptEventSchema, NodeInterruptEvent, NodeFailedEventSchema, NodeExecutionResult, NodeExecutionContext, NodeDefinitionSchema, NodeDefinition, NodeDataEventSchema, NodeCompletedEventSchema, NodeAs, NodeAddedEventSchema, Node, InputParameterSchema, InputParameter, Edge, DependsOnSchema, DependsOn, DecoratorNode, ControlStopEventSchema, ControlResumeEventSchema, ControlPauseEventSchema, BaseEventSchema, BaseEvent, AskUserOptions, AskUserError, AgentSessionRef2 as AgentSessionRef, AgentSessionInfo };