@ai-setting/roy-agent-core 1.5.15-test → 1.5.16-test

package/dist/env/log-trace/index.d.ts

@@ -0,0 +1,1574 @@
+/**
+* @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;
+}
+/**
+* @fileoverview Log & Trace Component 类型定义
+*/
+/**
+* Span 上下文
+*/
+interface SpanContext {
+	traceId: string;
+	spanId: string;
+	parentSpanId?: string;
+}
+/**
+* Span 属性
+*/
+interface SpanAttributes {
+	[key: string]: string | number | boolean | undefined | Record<string, unknown>;
+}
+/**
+* Span
+*/
+interface Span {
+	traceId: string;
+	spanId: string;
+	parentSpanId?: string;
+	name: string;
+	kind: SpanKind;
+	status: SpanStatus;
+	startTime: number;
+	endTime?: number;
+	attributes: SpanAttributes;
+	result?: unknown;
+	error?: string;
+	children?: Span[];
+}
+/**
+* Span 类型
+*/
+declare enum SpanKind {
+	CLIENT = "client",
+	SERVER = "server",
+	INTERNAL = "internal"
+}
+/**
+* Span 状态
+*/
+declare enum SpanStatus {
+	OK = "ok",
+	ERROR = "error"
+}
+/**
+* Trace 信息
+*/
+interface TraceInfo {
+	traceId: string;
+	rootSpanName: string;
+	startTime: number;
+	endTime?: number;
+	duration?: number;
+	spanCount: number;
+	status: "ok" | "error" | "mixed";
+}
+/**
+* SpanStorage 接口
+*/
+interface SpanStorage {
+	initialize(): Promise<void>;
+	save(span: Span): void;
+	saveBatch(spans: Span[]): void;
+	findByTraceId(traceId: string): Span[];
+	findBySpanId(spanId: string): Span | undefined;
+	listTraces(limit?: number): TraceInfo[];
+	deleteByTraceId(traceId: string): void;
+	close(): void;
+}
+/**
+* TraceContext 选项
+*/
+interface TraceContextOptions {
+	/** 追踪器实现类型 */
+	impl?: "lightweight" | "opentelemetry";
+}
+/**
+* ITraceContext 接口
+*/
+interface ITraceContext {
+	/** 获取当前请求的 requestId */
+	getRequestId(): string | undefined;
+	/** 获取当前 Span 上下文 */
+	getSpanContext(): SpanContext | undefined;
+	/** 更新当前 Span 上下文（用于设置子 span 的 parentSpanId） */
+	setSpanContext(spanContext: SpanContext): void;
+	/** 在已存在的追踪上下文中执行函数 */
+	runWithContext<T>(fn: () => T): T;
+	/** 在新追踪上下文中执行函数（同步） */
+	runWithNewContext<T>(requestId: string, sessionId: string | undefined, fn: () => T): T;
+	/** 在已存在的追踪上下文中执行异步函数 */
+	runWithContextAsync<T>(fn: () => Promise<T>): Promise<T>;
+	/** 在新追踪上下文中执行函数（异步） */
+	runWithNewContextAsync<T>(requestId: string, sessionId: string | undefined, fn: () => Promise<T>): Promise<T>;
+	/** 生成新的 requestId */
+	generateRequestId(): string;
+	/** 初始化追踪上下文（请求入口调用） */
+	initContext(requestId: string, sessionId?: string): void;
+	/** 创建并进入新的追踪上下文（请求入口使用，返回清理函数） */
+	startNewContext(requestId: string, sessionId?: string): () => void;
+}
+/**
+* 日志级别
+*/
+type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+* Logger 配置
+*/
+interface LoggerConfig {
+	level?: LogLevel;
+	prefix?: string;
+	filename?: string;
+}
+/**
+* Logger 接口
+*/
+interface ILogger {
+	debug(message: string, data?: unknown): void;
+	info(message: string, data?: unknown): void;
+	warn(message: string, data?: unknown): void;
+	error(message: string, data?: unknown): void;
+}
+/**
+* SQLite 存储实现
+* 
+* 根据运行时环境使用 bun:sqlite 或 better-sqlite3
+* 
+* 注意：此实现仅支持 SQLite 文件存储，不支持 :memory: 模式
+* WAL 模式默认启用以支持跨进程并发访问
+*/
+declare class SQLiteSpanStorage implements SpanStorage {
+	private db;
+	private dbPath;
+	private initialized;
+	/**
+	* 创建 SQLiteSpanStorage 实例
+	* 
+	* @param dbPath SQLite 数据库文件路径（必填）
+	* @throws Error 如果 dbPath 为空或为 :memory:
+	*/
+	constructor(dbPath: string);
+	initialize(): Promise<void>;
+	save(span: Span): void;
+	saveBatch(spans: Span[]): void;
+	findByTraceId(traceId: string): Span[];
+	findBySpanId(spanId: string): Span | undefined;
+	listTraces(limit?: number): TraceInfo[];
+	deleteByTraceId(traceId: string): void;
+	close(): void;
+	private rowToSpan;
+	private buildTree;
+}
+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>;
+}
+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;
+}
+import { z as z2 } from "zod";
+/**
+* 简化 Bun file: 协议的编码路径
+* 例如: packages+core/node_modules/.bun/@roy-agent+core@file+packages+core/node_modules/@roy-agent/core/src/env/agent/agent-component.ts
+* 转换为: packages/core/src/env/agent/agent-component.ts
+*/
+declare function simplifyFilePath(fullPath: string): string;
+declare function isQuietMode(): boolean;
+declare function setQuietMode(enabled: boolean): void;
+/**
+* 设置 ConfigComponent 实例（用于实时配置读取）
+*/
+declare function setConfigComponent(component: any): void;
+/**
+* 获取日志级别（支持热更新）
+*/
+declare function getLogLevel(): LogLevel;
+/**
+* 获取日志文件名
+* 实时从 ConfigComponent 读取（支持 env/file/memory 多 source）
+*/
+declare function getLogFile(): string;
+declare function getLogDir(): string;
+/**
+* 获取日志输出最大长度配置
+* 实时从 ConfigComponent 读取
+* 
+* @returns 配置的值（0 表示不限制），如果未配置则返回 undefined
+*/
+declare function getMaxOutput(): number | undefined;
+declare function setLogDirOverride(dir: string): void;
+declare function getLogDirOverride(): string | undefined;
+declare class Logger implements ILogger {
+	private prefix;
+	constructor(prefix: string);
+	private shouldLog;
+	private ensureLogDirectory;
+	private getCallerLocation;
+	private getRelativePath;
+	private formatMessage;
+	private writeToFile;
+	private log;
+	debug(message: string, data?: unknown): void;
+	info(message: string, data?: unknown): void;
+	warn(message: string, data?: unknown): void;
+	error(message: string, data?: unknown): void;
+}
+/**
+* 创建或获取 Logger 实例
+* @param prefix Logger 前缀
+* 
+* 日志文件名通过 ConfigComponent 实时读取（log-trace.logging.file）
+*/
+declare function createLogger(prefix: string): Logger;
+/**
+* 获取所有日志级别
+*/
+declare function getLogLevels(): LogLevel[];
+/**
+* Span 选项
+*/
+interface SpanOptions {
+	/** 父 Span 上下文（可选） */
+	parent?: SpanContext;
+	/** Span 属性 */
+	attributes?: SpanAttributes;
+	/** Span 类型 */
+	kind?: string;
+	/** 指定 traceId（可选，如果不提供则自动生成） */
+	traceId?: string;
+}
+/**
+* OTel Span 接口
+*/
+interface OTelSpan {
+	readonly name: string;
+	readonly kind: string;
+	readonly spanContext: SpanContext;
+	readonly attributes: SpanAttributes;
+	startTime?: number;
+	endTime?: number;
+	error?: string;
+	setAttribute(key: string, value: unknown): void;
+	addEvent(name: string, attributes?: Record<string, unknown>): void;
+	end(result?: unknown, error?: Error): void;
+}
+/**
+* OTel Tracer 接口
+*/
+interface OTelTracer {
+	readonly name: string;
+	readonly version?: string;
+	startSpan(name: string, options?: SpanOptions): OTelSpan;
+	/**
+	* 结束指定 span 并恢复父上下文
+	* @param span 要结束的 span
+	* @returns 结束后的父上下文（用于恢复之前的上下文）
+	*/
+	endSpan(span: OTelSpan): SpanContext | undefined;
+	injectToEnv(env: Record<string, string | undefined>): void;
+	getCurrentContext(): SpanContext | undefined;
+	setCurrentContext(context: SpanContext | undefined): void;
+	/**
+	* 生成符合 OTel 格式的 traceId（32 字符 16 进制）
+	*/
+	generateTraceId(): string;
+	/**
+	* 生成符合 OTel 格式的 spanId（16 字符 16 进制）
+	*/
+	generateSpanId(): string;
+}
+/**
+* OpenTelemetry TracerProvider
+* 
+* 全局 Tracer 管理器，负责：
+* - 维护 Tracer 缓存
+* - 管理存储
+* - 处理上下文初始化
+* - 提供全局 context 供所有 tracer 共享
+*/
+declare class OTelTracerProvider {
+	private tracers;
+	private storage;
+	private initialized;
+	private globalContext;
+	constructor(storage?: SpanStorage, dbPath?: string);
+	/**
+	* 初始化 Provider
+	* 
+	* 从环境变量恢复上下文（如 TRACEPARENT）
+	*/
+	initialize(): Promise<void>;
+	/**
+	* 检查是否已初始化
+	*/
+	isInitialized(): boolean;
+	/**
+	* 获取全局 context（所有 tracer 共享）
+	*/
+	getGlobalContext(): SpanContext | undefined;
+	/**
+	* 设置全局 context（所有 tracer 共享）
+	*/
+	setGlobalContext(context: SpanContext | undefined): void;
+	/**
+	* 获取 Tracer
+	*/
+	getTracer(name: string, version?: string): OTelTracer;
+	/**
+	* 从环境变量恢复上下文
+	*/
+	private restoreFromEnv;
+	/**
+	* 关闭 Provider
+	*/
+	shutdown(): void;
+	/**
+	* 获取存储
+	*/
+	getStorage(): SpanStorage;
+}
+/**
+* 获取 TracerProvider 单例
+*/
+declare function getTracerProvider(): OTelTracerProvider;
+/**
+* 重置 TracerProvider（用于测试）
+*/
+declare function resetTracerProvider(): void;
+/**
+* 获取默认日志目录（基于 XDG 标准）
+* 存储在 XDG_DATA_HOME/roy-agent/logs/
+*/
+declare function getDefaultLogDir(): string;
+/**
+* 获取默认的 span 数据库路径（基于 XDG 标准）
+* 存储在 XDG_DATA_HOME/roy-agent/traces.db
+*/
+declare function getDefaultSpanDbPath(): string;
+/**
+* Log & Trace Component 配置 Schema
+*/
+declare const LogTraceConfigSchema: unknown;
+type LogTraceConfig = z2.infer<typeof LogTraceConfigSchema>;
+/**
+* LogTraceComponent 配置选项（通过 options 传递）
+* 
+* 配置加载顺序（优先级从低到高）：
+* 1. File - 配置文件（通过 configPath 指定）
+* 2. Env - 环境变量（通过 envPrefix 配置前缀）
+* 3. Object - 直接传入的 config 对象（最高优先级）
+*/
+interface LogTraceComponentOptions {
+	/** ConfigComponent 实例（必填） */
+	configComponent: ConfigComponent;
+	/** 配置文件相对路径（可选，基于 XDG_DATA_HOME） */
+	configPath?: string;
+	/** 环境变量前缀（可选，默认 "LOG"） */
+	envPrefix?: string;
+	/** 回调函数 */
+	callbacks?: {
+		onLogLevelChange?: (level: LogLevel) => void;
+	};
+	/** 直接传入的配置对象（可选，优先级最高） */
+	config?: Partial<LogTraceConfig>;
+}
+/**
+* Log & Trace Component
+* 
+* 提供统一的日志和追踪能力
+* 配置通过 ConfigComponent 实时获取，支持配置热更新
+* 
+* @example
+* // 通过 ConfigComponent 初始化
+* const configComponent = new ConfigComponent();
+* const component = new LogTraceComponent();
+* await component.init({
+*   env,  // Environment 实例（必填）
+*   options: { configComponent }
+* });
+* 
+* // 配置更新后，日志级别会自动热更新
+* configComponent.set("log-trace.logging.level", "debug");
+* 
+* // 初始化追踪上下文
+* component.initContext("request-123", "session-456");
+* 
+* // 使用日志
+* component.getLogger().info("Hello, world!");
+* 
+* // 使用追踪
+* const span = component.getTracer().startSpan("my-span");
+* component.getTracer().endSpan(span);
+*/
+declare class LogTraceComponent extends BaseComponent {
+	readonly name = "log-trace";
+	readonly version = "1.0.0";
+	private config?;
+	private configComponent?;
+	private tracer?;
+	private traceContext?;
+	/** 配置变更 watcher 清理函数 */
+	private configWatcher?;
+	constructor();
+	/**
+	* 初始化组件
+	* 
+	* 配置加载优先级（从高到低）：
+	* 1. Object - 直接传入的 config 对象
+	* 2. Env - 环境变量（通过 envPrefix 配置前缀）
+	* 3. File - 配置文件（通过 configPath 指定）
+	*/
+	init(config: ComponentConfig): Promise<void>;
+	/**
+	* 注册配置到 ConfigComponent
+	* 
+	* 遵循 SessionComponent 模式：
+	* 1. 使用 registerComponent 注册配置结构
+	* 2. 使用 load 加载配置
+	* 3. 设置默认值
+	* 4. 处理环境变量后备方案
+	* 5. 处理 config 对象
+	* 
+	* 配置加载顺序（优先级从低到高）：
+	* 1. FileSource - 从配置文件加载（最低）
+	* 2. EnvSource - 从环境变量加载（中等）
+	* 3. MemorySource - 直接配置对象（最高）
+	*/
+	private registerConfig;
+	/**
+	* 将配置对象展平为点号路径
+	*/
+	private flattenConfig;
+	/**
+	* 注册配置热更新监听
+	*/
+	private registerConfigWatcher;
+	/**
+	* 处理配置变更
+	*/
+	protected onConfigChange(event: {
+		key: string;
+		oldValue?: unknown;
+		newValue?: unknown;
+	}): void;
+	/**
+	* 创建存储实例
+	* 
+	* @throws Error 如果未配置 dbPath
+	*/
+	private createStorage;
+	/**
+	* 配置日志系统
+	*/
+	private configureLogging;
+	/**
+	* 初始化追踪上下文
+	* 
+	* @param requestId 请求 ID
+	* @param sessionId 会话 ID（可选）
+	*/
+	initContext(requestId: string, sessionId?: string): void;
+	/**
+	* 创建新的追踪上下文（返回清理函数）
+	* 
+	* @param requestId 请求 ID
+	* @param sessionId 会话 ID（可选）
+	*/
+	startContext(requestId: string, sessionId?: string): () => void;
+	/**
+	* 获取 Logger
+	* 
+	* @param prefix 日志前缀
+	*/
+	getLogger(prefix?: string): ReturnType<typeof createLogger>;
+	/**
+	* 获取 Tracer
+	*/
+	getTracer(): OTelTracer;
+	/**
+	* 获取 Trace Context
+	*/
+	getTraceContext(): ITraceContext | undefined;
+	/**
+	* 获取当前 requestId
+	*/
+	getRequestId(): string | undefined;
+	/**
+	* 停止组件
+	*/
+	onStop(): Promise<void>;
+}
+/**
+* 将 SpanContext 序列化为 traceparent 字符串
+* 
+* W3C TraceContext 语义：
+* - traceparent 中的 spanId 是"发送方 span"的 ID
+* - 接收方会将其作为新 span 的 parentSpanId
+* - 所以应该使用 context.spanId，而非 parentSpanId
+* 
+* @param context SpanContext
+* @returns traceparent 格式字符串
+*/
+declare function serialize(context: SpanContext): string;
+/**
+* 提取的 Trace Context
+* 
+* W3C TraceContext 格式: 00-{traceId}-{spanId}-{flags}
+* - {spanId} 是发送方 span 的 ID
+* - 接收方应将其作为新 span 的 parentSpanId
+*/
+interface ExtractedContext {
+	traceId: string;
+	/** 发送方 span 的 ID，接收方应作为新 span 的 parentSpanId */
+	spanId: string;
+}
+/**
+* 将 traceparent 字符串反序列化为 ExtractedContext
+* 
+* W3C TraceContext 语义：
+* - traceparent 中的 "span-id" 是发送方 span 的 ID
+* - 接收方应该：
+*   - 使用提取的 traceId
+*   - 将提取的 spanId 作为 parentSpanId
+*   - 生成自己的新 spanId
+* 
+* @param traceparent traceparent 格式字符串
+* @returns 接收方 ExtractedContext 或 undefined（格式无效）
+*/
+declare function parse(traceparent: string): ExtractedContext | undefined;
+/**
+* W3C TraceContext Propagation 实现
+* 
+* 用于在进程间传递 trace 上下文：
+* - inject: 将 SpanContext 注入到 carrier（环境变量）
+* - extract: 从 carrier（环境变量）提取 SpanContext
+*/
+declare const propagation: {
+	/**
+	* 将 SpanContext 注入到 carrier
+	* 
+	* @param carrier 载体对象（通常是环境变量对象）
+	* @param context Span 上下文
+	*/
+	inject(carrier: Record<string, string | undefined>, context: SpanContext): void;
+	/**
+	* 从 carrier 提取 SpanContext
+	* 
+	* @param carrier 载体对象（通常是环境变量对象）
+	* @returns ExtractedContext 或 undefined
+	*/
+	extract(carrier: Record<string, string | undefined>): ExtractedContext | undefined;
+	/**
+	* 获取 traceparent 字段名
+	*/
+	getTraceparentHeader(): string;
+};
+/**
+* 环境变量对象类型
+*/
+type EnvCarrier = Record<string, string | undefined>;
+/**
+* 从当前 OTelTracerProvider 获取上下文并注入到环境变量
+* 
+* 这是一个便捷函数，封装了常见的注入模式：
+* 1. 从全局 TracerProvider 获取当前 Tracer
+* 2. 获取当前 span context
+* 3. 注入到目标环境变量
+* 
+* @param env 目标环境变量对象（默认：{}）
+* @returns 注入了 TRACEPARENT 的环境变量对象
+* 
+* @example
+* ```typescript
+* const env = injectToEnv({ PATH: '/usr/bin' });
+* // env.TRACEPARENT = '00-{traceId}-{spanId}-01'
+* // env.PATH = '/usr/bin'
+* ```
+*/
+declare function injectToEnv2(env?: EnvCarrier): EnvCarrier;
+/**
+* 将指定的 SpanContext 直接注入到环境变量
+* 
+* 与 injectToEnv 不同，这个函数不需要访问全局 TracerProvider，
+* 直接使用传入的 SpanContext 进行注入。
+* 
+* @param env 目标环境变量对象
+* @param context 要注入的 SpanContext
+* @returns 注入了 TRACEPARENT 的环境变量对象
+* 
+* @example
+* ```typescript
+* const span = tracer.startSpan('my-span');
+* const env = injectToEnvWithContext({}, span.spanContext);
+* ```
+*/
+declare function injectToEnvWithContext(env: EnvCarrier, context: SpanContext): EnvCarrier;
+/**
+* 从源环境变量 carrier 复制 TRACEPARENT 到目标 carrier
+* 
+* 用于将一个环境变量对象中的 trace context 传递到另一个：
+* - 从 process.env 复制到子进程的环境变量
+* - 从父进程环境变量复制到子进程环境变量
+* 
+* @param target 目标 carrier（将被修改）
+* @param source 源 carrier
+* @returns 目标 carrier
+* 
+* @example
+* ```typescript
+* // 在 fork 子进程时继承父进程的 trace context
+* const childEnv = injectToEnvFromCarrier({}, process.env);
+* ```
+*/
+declare function injectToEnvFromCarrier(target: EnvCarrier, source: EnvCarrier): EnvCarrier;
+/**
+* 获取 TRACEPARENT 字段名
+*/
+declare function getTraceparentHeader2(): string;
+interface TracedOptions {
+	name?: string;
+	recordParams?: boolean;
+	recordResult?: boolean;
+	recordError?: boolean;
+	log?: boolean;
+	maxLogSize?: number;
+	paramFilter?: (args: any[], argNames?: string[]) => Record<string, any>;
+}
+/**
+* @Traced 装饰器工厂
+*/
+declare function Traced(options?: TracedOptions): unknown;
+/**
+* @TracedAs 装饰器工厂 - 使用自定义名称
+*/
+declare function TracedAs(name: string, options?: Omit<TracedOptions, "name">);
+/**
+* @TracedLightweight 装饰器工厂 - 轻量级追踪
+*/
+declare function TracedLightweight(options?: {
+	log?: boolean;
+	maxLogSize?: number;
+});
+/**
+* 包装函数以自动创建 Span
+* 
+* 同时支持 async 函数和非 async 函数：
+* - async 函数：自动检测 Promise 并正确处理
+* - 非 async 函数：同步执行，直接返回结果
+*/
+declare function wrapFunction<T extends (...args: any[]) => any>(fn: T, name: string, options?: {
+	recordParams?: boolean;
+	recordResult?: boolean;
+	recordError?: boolean;
+	log?: boolean;
+	maxLogSize?: number;
+	paramFilter?: (args: any[], argNames?: string[]) => Record<string, any>;
+}): T;
+export { wrapFunction, simplifyFilePath, setQuietMode, setConfigComponent as setLoggerConfigComponent, setLogDirOverride, serialize, resetTracerProvider, propagation, parse, isQuietMode, injectToEnvWithContext, injectToEnvFromCarrier, injectToEnv2 as injectToEnv, getTracerProvider, getTraceparentHeader2 as getTraceparentHeader, getMaxOutput, getLogLevels, getLogLevel, getLogFile, getLogDirOverride, getLogDir, getDefaultSpanDbPath, getDefaultLogDir, createLogger, TracedOptions, TracedLightweight, TracedAs, Traced, TraceInfo, TraceContextOptions, SpanStorage, SpanStatus, SpanOptions, SpanKind, SpanContext, SpanAttributes, Span, SQLiteSpanStorage, OTelTracerProvider, OTelTracer, OTelSpan, LoggerConfig, LogTraceConfigSchema, LogTraceConfig, LogTraceComponentOptions, LogTraceComponent, LogLevel, ITraceContext, ILogger, ExtractedContext, EnvCarrier };