@od-oneapp/ai-platform 0.1.0

package/dist/agents-observability.mjs

@@ -0,0 +1,550 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { logDebug, logInfo, logWarn } from "@od-oneapp/shared/logs";
+
+//#region src/agents/observability/index.ts
+/**
+* Agent Observability Module
+*
+* Decision tracing and debugging for AI agents:
+* - Step-by-step execution traces
+* - Tool decision logging
+* - Token usage tracking
+* - Performance metrics
+* - Structured trace export
+*
+* @module agents/observability
+*/
+var observability_exports = /* @__PURE__ */ __exportAll({
+	AgentTracer: () => AgentTracer,
+	createAgentTracer: () => createAgentTracer,
+	createOTelTracer: () => createOTelTracer,
+	exportTrace: () => exportTrace,
+	getTraceMetrics: () => getTraceMetrics,
+	summarizeTrace: () => summarizeTrace
+});
+/** Default capture setting for tool data. */
+const DEFAULT_CAPTURE_TOOL_DATA = true;
+/** Default maximum tool data size in bytes. */
+const DEFAULT_MAX_TOOL_DATA_SIZE = 1e4;
+/** Default capture setting for messages. */
+const DEFAULT_CAPTURE_MESSAGES = false;
+/** Default console logging setting. */
+const DEFAULT_CONSOLE_LOG = false;
+/** Current trace schema version. */
+const TRACE_SCHEMA_VERSION = 1;
+/**
+* Traces agent execution for debugging and observability.
+*
+* @example
+* ```typescript
+* const tracer = new AgentTracer({
+*   agentId: 'research-agent',
+*   prompt: 'Research quantum computing',
+* });
+*
+* tracer.startStep(1);
+* tracer.recordModelCall({ model: { id: 'claude-sonnet' }, messageCount: 3 });
+* tracer.recordToolCall({ toolName: 'search', toolCallId: 'tc_1', input: { query: 'quantum' } });
+* tracer.recordToolResult({ toolName: 'search', toolCallId: 'tc_1', output: results, success: true });
+* tracer.endStep(1);
+*
+* const trace = tracer.finalize();
+* ```
+*/
+var AgentTracer = class {
+	config;
+	traceId;
+	events = [];
+	startTime;
+	currentStepId = null;
+	stepCount = 0;
+	toolCallCount = 0;
+	usage = {
+		promptTokens: 0,
+		completionTokens: 0,
+		totalTokens: 0,
+		totalCost: 0
+	};
+	constructor(config) {
+		this.traceId = generateTraceId();
+		this.startTime = /* @__PURE__ */ new Date();
+		this.config = {
+			agentId: config.agentId,
+			sessionId: config.sessionId,
+			prompt: config.prompt,
+			captureToolData: config.captureToolData ?? DEFAULT_CAPTURE_TOOL_DATA,
+			maxToolDataSize: config.maxToolDataSize ?? DEFAULT_MAX_TOOL_DATA_SIZE,
+			captureMessages: config.captureMessages ?? DEFAULT_CAPTURE_MESSAGES,
+			onEvent: config.onEvent,
+			consoleLog: config.consoleLog ?? DEFAULT_CONSOLE_LOG
+		};
+	}
+	/**
+	* Get current trace ID.
+	* @returns The trace identifier.
+	*/
+	get id() {
+		return this.traceId;
+	}
+	/**
+	* Get event count.
+	* @returns The number of events recorded.
+	*/
+	get eventCount() {
+		return this.events.length;
+	}
+	/**
+	* Start tracking a new step.
+	* @param stepNumber - The step number to start.
+	* @param metadata - Optional metadata for the step.
+	* @returns The event ID for the step.
+	*/
+	startStep(stepNumber, metadata) {
+		const eventId = this.generateEventId();
+		this.currentStepId = eventId;
+		this.stepCount = Math.max(this.stepCount, stepNumber);
+		this.addEvent({
+			id: eventId,
+			type: "step_start",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "info",
+			detail: { stepNumber },
+			metadata
+		});
+		return eventId;
+	}
+	/**
+	* End the current step.
+	* @param stepNumber - The step number to end.
+	* @param metadata - Optional metadata for the step.
+	*/
+	endStep(stepNumber, metadata) {
+		const startEvent = this.events.find((e) => e.type === "step_start" && e.detail.stepNumber === stepNumber);
+		const durationMs = startEvent ? Date.now() - startEvent.timestamp.getTime() : void 0;
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: this.currentStepId ?? void 0,
+			type: "step_end",
+			timestamp: /* @__PURE__ */ new Date(),
+			durationMs,
+			severity: "info",
+			detail: { stepNumber },
+			metadata
+		});
+		this.currentStepId = null;
+	}
+	/**
+	* Record a model call.
+	* @param detail - Model call details.
+	* @param metadata - Optional metadata.
+	* @returns The event ID.
+	*/
+	recordModelCall(detail, metadata) {
+		const eventId = this.generateEventId();
+		this.addEvent({
+			id: eventId,
+			parentId: this.currentStepId ?? void 0,
+			type: "model_call",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "debug",
+			detail,
+			metadata
+		});
+		if (detail.inputTokens) {
+			this.usage.promptTokens += detail.inputTokens;
+			this.usage.totalTokens += detail.inputTokens;
+		}
+		return eventId;
+	}
+	/**
+	* Record a model response.
+	* @param callEventId - The ID of the model call event.
+	* @param detail - Model response details.
+	* @param metadata - Optional metadata.
+	*/
+	recordModelResponse(callEventId, detail, metadata) {
+		const callEvent = this.events.find((e) => e.id === callEventId);
+		const durationMs = callEvent ? Date.now() - callEvent.timestamp.getTime() : void 0;
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: callEventId,
+			type: "model_response",
+			timestamp: /* @__PURE__ */ new Date(),
+			durationMs,
+			severity: "debug",
+			detail,
+			metadata
+		});
+		if (detail.outputTokens) {
+			this.usage.completionTokens += detail.outputTokens;
+			this.usage.totalTokens += detail.outputTokens;
+		}
+	}
+	/**
+	* Record a tool call.
+	*/
+	recordToolCall(detail, metadata) {
+		const eventId = this.generateEventId();
+		this.toolCallCount++;
+		const capturedDetail = this.config.captureToolData ? {
+			...detail,
+			input: this.truncateData(detail.input),
+			inputSize: this.getDataSize(detail.input)
+		} : {
+			toolName: detail.toolName,
+			toolCallId: detail.toolCallId
+		};
+		this.addEvent({
+			id: eventId,
+			parentId: this.currentStepId ?? void 0,
+			type: "tool_call",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "info",
+			detail: capturedDetail,
+			metadata
+		});
+		return eventId;
+	}
+	/**
+	* Record a tool result.
+	*/
+	recordToolResult(callEventId, detail, metadata) {
+		const callEvent = this.events.find((e) => e.id === callEventId);
+		const durationMs = callEvent ? Date.now() - callEvent.timestamp.getTime() : void 0;
+		const capturedDetail = this.config.captureToolData ? {
+			...detail,
+			output: detail.success ? this.truncateData(detail.output) : void 0,
+			outputSize: this.getDataSize(detail.output)
+		} : {
+			toolName: detail.toolName,
+			toolCallId: detail.toolCallId,
+			success: detail.success,
+			error: detail.error
+		};
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: callEventId,
+			type: "tool_result",
+			timestamp: /* @__PURE__ */ new Date(),
+			durationMs,
+			severity: detail.success ? "info" : "warn",
+			detail: capturedDetail,
+			metadata
+		});
+	}
+	/**
+	* Record a decision point.
+	*/
+	recordDecision(detail, metadata) {
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: this.currentStepId ?? void 0,
+			type: "decision",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "info",
+			detail,
+			metadata
+		});
+		if (this.config.consoleLog) logInfo(`[AgentTracer] Decision: ${detail.type} - ${detail.reason}`);
+	}
+	/**
+	* Record a model escalation.
+	*/
+	recordEscalation(fromModel, toModel, reason, metadata) {
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: this.currentStepId ?? void 0,
+			type: "escalation",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "info",
+			detail: {
+				from: fromModel,
+				to: toModel,
+				reason
+			},
+			metadata
+		});
+		if (this.config.consoleLog) logInfo(`[AgentTracer] Escalation: ${fromModel} -> ${toModel} (${reason})`);
+	}
+	/**
+	* Record a handoff between agents.
+	*/
+	recordHandoff(fromAgent, toAgent, reason, metadata) {
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: this.currentStepId ?? void 0,
+			type: "handoff",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "info",
+			detail: {
+				from: fromAgent,
+				to: toAgent,
+				reason
+			},
+			metadata
+		});
+		if (this.config.consoleLog) logInfo(`[AgentTracer] Handoff: ${fromAgent} -> ${toAgent} (${reason})`);
+	}
+	/**
+	* Record an error.
+	*/
+	recordError(error, metadata) {
+		const detail = error instanceof Error ? {
+			name: error.name,
+			message: error.message,
+			stack: error.stack
+		} : error;
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: this.currentStepId ?? void 0,
+			type: "error",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "error",
+			detail,
+			metadata
+		});
+		if (this.config.consoleLog) logWarn(`[AgentTracer] Error: ${detail.message}`);
+	}
+	/**
+	* Record a checkpoint.
+	*/
+	recordCheckpoint(checkpointId, metadata) {
+		this.addEvent({
+			id: this.generateEventId(),
+			parentId: this.currentStepId ?? void 0,
+			type: "checkpoint",
+			timestamp: /* @__PURE__ */ new Date(),
+			severity: "info",
+			detail: { checkpointId },
+			metadata
+		});
+	}
+	/**
+	* Update token usage.
+	*/
+	updateUsage(usage) {
+		if (usage.promptTokens !== void 0) {
+			this.usage.promptTokens += usage.promptTokens;
+			this.usage.totalTokens += usage.promptTokens;
+		}
+		if (usage.completionTokens !== void 0) {
+			this.usage.completionTokens += usage.completionTokens;
+			this.usage.totalTokens += usage.completionTokens;
+		}
+		if (usage.cost !== void 0) this.usage.totalCost += usage.cost;
+	}
+	/**
+	* Finalize and return the complete trace.
+	* @param result - Optional result information.
+	* @returns The complete agent trace.
+	*/
+	finalize(result) {
+		const endedAt = /* @__PURE__ */ new Date();
+		return {
+			traceId: this.traceId,
+			agentId: this.config.agentId,
+			sessionId: this.config.sessionId,
+			prompt: this.config.prompt,
+			startedAt: this.startTime,
+			endedAt,
+			durationMs: endedAt.getTime() - this.startTime.getTime(),
+			events: [...this.events],
+			totalSteps: this.stepCount,
+			totalToolCalls: this.toolCallCount,
+			usage: { ...this.usage },
+			result,
+			version: TRACE_SCHEMA_VERSION
+		};
+	}
+	/**
+	* Get current trace snapshot without finalizing.
+	* @returns A snapshot of the current trace state.
+	*/
+	snapshot() {
+		return {
+			traceId: this.traceId,
+			agentId: this.config.agentId,
+			sessionId: this.config.sessionId,
+			prompt: this.config.prompt,
+			startedAt: this.startTime,
+			durationMs: Date.now() - this.startTime.getTime(),
+			events: [...this.events],
+			totalSteps: this.stepCount,
+			totalToolCalls: this.toolCallCount,
+			usage: { ...this.usage },
+			version: TRACE_SCHEMA_VERSION
+		};
+	}
+	/**
+	* Get events by type.
+	* @param type - The event type to filter by.
+	* @returns Events matching the specified type.
+	*/
+	getEventsByType(type) {
+		return this.events.filter((e) => e.type === type);
+	}
+	/**
+	* Get events for a specific step.
+	* @param stepNumber - The step number to get events for.
+	* @returns Events for the specified step.
+	*/
+	getStepEvents(stepNumber) {
+		const stepStart = this.events.find((e) => e.type === "step_start" && e.detail.stepNumber === stepNumber);
+		if (!stepStart) return [];
+		return this.events.filter((e) => e.parentId === stepStart.id || e.id === stepStart.id);
+	}
+	/**
+	* Get decision trace (filtered view).
+	* @returns Decision events from the trace.
+	*/
+	getDecisionTrace() {
+		return this.events.filter((e) => e.type === "decision");
+	}
+	/**
+	* Get error events.
+	* @returns Error events from the trace.
+	*/
+	getErrors() {
+		return this.events.filter((e) => e.type === "error");
+	}
+	addEvent(event) {
+		this.events.push(event);
+		if (this.config.onEvent) this.config.onEvent(event);
+		if (this.config.consoleLog) logDebug(`[AgentTracer] ${event.type}: ${JSON.stringify(event.detail)}`);
+	}
+	generateEventId() {
+		return `evt_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+	}
+	truncateData(data) {
+		const str = JSON.stringify(data);
+		if (str.length <= this.config.maxToolDataSize) return data;
+		return `[truncated: ${str.length} bytes]`;
+	}
+	getDataSize(data) {
+		try {
+			return JSON.stringify(data).length;
+		} catch {
+			return 0;
+		}
+	}
+};
+/**
+* Export a trace to various formats.
+*/
+function exportTrace(trace, options) {
+	switch (options.format) {
+		case "json": return options.pretty ? JSON.stringify(trace, null, 2) : JSON.stringify(trace);
+		case "opentelemetry": return exportToOpenTelemetry(trace);
+		case "langsmith": return exportToLangSmith(trace);
+		case "custom": return trace;
+		default: throw new Error(`Unknown export format: ${options.format}`);
+	}
+}
+function exportToOpenTelemetry(trace) {
+	return { resourceSpans: [{
+		resource: { attributes: [{
+			key: "service.name",
+			value: { stringValue: "ai-agent" }
+		}, {
+			key: "agent.id",
+			value: { stringValue: trace.agentId }
+		}] },
+		scopeSpans: [{
+			scope: { name: "@od-oneapp/ai-platform" },
+			spans: trace.events.map((event) => ({
+				traceId: trace.traceId,
+				spanId: event.id,
+				parentSpanId: event.parentId,
+				name: event.type,
+				startTimeUnixNano: event.timestamp.getTime() * 1e6,
+				endTimeUnixNano: event.durationMs ? (event.timestamp.getTime() + event.durationMs) * 1e6 : event.timestamp.getTime() * 1e6,
+				attributes: Object.entries(event.detail).map(([k, v]) => ({
+					key: k,
+					value: { stringValue: String(v) }
+				}))
+			}))
+		}]
+	}] };
+}
+function exportToLangSmith(trace) {
+	return {
+		id: trace.traceId,
+		name: `agent-${trace.agentId}`,
+		run_type: "chain",
+		start_time: trace.startedAt.toISOString(),
+		end_time: trace.endedAt?.toISOString(),
+		inputs: { prompt: trace.prompt },
+		outputs: trace.result,
+		child_runs: trace.events.map((event) => ({
+			id: event.id,
+			parent_run_id: event.parentId ?? trace.traceId,
+			name: event.type,
+			run_type: event.type.includes("tool") ? "tool" : "llm",
+			start_time: event.timestamp.toISOString(),
+			inputs: event.detail,
+			outputs: event.metadata
+		}))
+	};
+}
+/**
+* Create a new agent tracer.
+*/
+function createAgentTracer(config) {
+	return new AgentTracer(config);
+}
+/**
+* Create a tracer with OpenTelemetry integration.
+*/
+function createOTelTracer(config, spanExporter) {
+	return new AgentTracer({
+		...config,
+		onEvent: (event) => {
+			if (spanExporter) spanExporter(event);
+			config.onEvent?.(event);
+		}
+	});
+}
+function generateTraceId() {
+	return `trace_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+/**
+* Summarize a trace for logging.
+*/
+function summarizeTrace(trace) {
+	const lines = [
+		`Trace: ${trace.traceId}`,
+		`Agent: ${trace.agentId}`,
+		`Duration: ${trace.durationMs ?? 0}ms`,
+		`Steps: ${trace.totalSteps}`,
+		`Tool Calls: ${trace.totalToolCalls}`,
+		`Tokens: ${trace.usage.totalTokens} (${trace.usage.promptTokens} prompt, ${trace.usage.completionTokens} completion)`
+	];
+	if (trace.result) {
+		lines.push(`Result: ${trace.result.success ? "Success" : "Failed"}`);
+		if (trace.result.error) lines.push(`Error: ${trace.result.error}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Get trace metrics.
+*/
+function getTraceMetrics(trace) {
+	const stepEndEvents = trace.events.filter((e) => e.type === "step_end");
+	const toolResultEvents = trace.events.filter((e) => e.type === "tool_result");
+	const modelCallEvents = trace.events.filter((e) => e.type === "model_call");
+	const errorEvents = trace.events.filter((e) => e.type === "error");
+	const totalStepDuration = stepEndEvents.reduce((sum, e) => sum + (e.durationMs ?? 0), 0);
+	const totalToolDuration = toolResultEvents.reduce((sum, e) => sum + (e.durationMs ?? 0), 0);
+	return {
+		totalDuration: trace.durationMs ?? 0,
+		avgStepDuration: stepEndEvents.length > 0 ? totalStepDuration / stepEndEvents.length : 0,
+		avgToolDuration: toolResultEvents.length > 0 ? totalToolDuration / toolResultEvents.length : 0,
+		modelCallCount: modelCallEvents.length,
+		errorCount: errorEvents.length,
+		tokensPerStep: trace.totalSteps > 0 ? trace.usage.totalTokens / trace.totalSteps : 0
+	};
+}
+
+//#endregion
+export { AgentTracer, createAgentTracer, createOTelTracer, exportTrace, getTraceMetrics, summarizeTrace, observability_exports as t };
+//# sourceMappingURL=agents-observability.mjs.map

package/dist/agents-observability.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-observability.mjs","names":[],"sources":["../src/agents/observability/index.ts"],"sourcesContent":["/**\n * Agent Observability Module\n *\n * Decision tracing and debugging for AI agents:\n * - Step-by-step execution traces\n * - Tool decision logging\n * - Token usage tracking\n * - Performance metrics\n * - Structured trace export\n *\n * @module agents/observability\n */\n\nimport { logDebug, logInfo, logWarn } from '@repo/shared/logs';\n\n/** Default capture setting for tool data. */\nconst DEFAULT_CAPTURE_TOOL_DATA = true;\n\n/** Default maximum tool data size in bytes. */\nconst DEFAULT_MAX_TOOL_DATA_SIZE = 10000;\n\n/** Default capture setting for messages. */\nconst DEFAULT_CAPTURE_MESSAGES = false;\n\n/** Default console logging setting. */\nconst DEFAULT_CONSOLE_LOG = false;\n\n/** Current trace schema version. */\nconst TRACE_SCHEMA_VERSION = 1;\n\n// -----------------------------------------------------------------------------\n// Types\n// -----------------------------------------------------------------------------\n\n/** Trace event types */\nexport type TraceEventType =\n  | 'step_start'\n  | 'step_end'\n  | 'tool_call'\n  | 'tool_result'\n  | 'model_call'\n  | 'model_response'\n  | 'error'\n  | 'decision'\n  | 'escalation'\n  | 'handoff'\n  | 'checkpoint';\n\n/** Severity levels */\nexport type TraceSeverity = 'debug' | 'info' | 'warn' | 'error';\n\n/** Model information */\nexport interface ModelInfo {\n  readonly id: string;\n  readonly provider?: string;\n  readonly temperature?: number;\n  readonly maxTokens?: number;\n}\n\n/** Tool call details */\nexport interface ToolCallDetail {\n  readonly toolName: string;\n  readonly toolCallId: string;\n  readonly input: unknown;\n  readonly inputSize?: number;\n}\n\n/** Tool result details */\nexport interface ToolResultDetail {\n  readonly toolName: string;\n  readonly toolCallId: string;\n  readonly output: unknown;\n  readonly outputSize?: number;\n  readonly success: boolean;\n  readonly error?: string;\n}\n\n/** Model call details */\nexport interface ModelCallDetail {\n  readonly model: ModelInfo;\n  readonly messageCount: number;\n  readonly inputTokens?: number;\n  readonly systemPromptLength?: number;\n}\n\n/** Model response details */\nexport interface ModelResponseDetail {\n  readonly model: ModelInfo;\n  readonly outputTokens?: number;\n  readonly finishReason?: string;\n  readonly toolCalls?: number;\n  readonly hasText?: boolean;\n}\n\n/** Decision details */\nexport interface DecisionDetail {\n  readonly type: 'tool_choice' | 'model_escalation' | 'context_trim' | 'handoff' | 'custom';\n  readonly reason: string;\n  readonly from?: string;\n  readonly to?: string;\n  readonly context?: Record<string, unknown>;\n}\n\n/** Error details */\nexport interface ErrorDetail {\n  readonly name: string;\n  readonly message: string;\n  readonly code?: string;\n  readonly stack?: string;\n  readonly retryable?: boolean;\n}\n\n/** Generic trace event */\nexport interface TraceEvent<T = unknown> {\n  /** Event ID */\n  readonly id: string;\n  /** Parent event ID */\n  readonly parentId?: string;\n  /** Event type */\n  readonly type: TraceEventType;\n  /** Timestamp */\n  readonly timestamp: Date;\n  /** Duration in milliseconds (for completed events) */\n  readonly durationMs?: number;\n  /** Severity */\n  readonly severity: TraceSeverity;\n  /** Event-specific details */\n  readonly detail: T;\n  /** Arbitrary metadata */\n  readonly metadata?: Record<string, unknown>;\n}\n\n/** Agent execution trace */\nexport interface AgentTrace {\n  /** Trace ID */\n  readonly traceId: string;\n  /** Agent ID */\n  readonly agentId: string;\n  /** Session ID */\n  readonly sessionId?: string;\n  /** User prompt */\n  readonly prompt: string;\n  /** Start time */\n  readonly startedAt: Date;\n  /** End time */\n  readonly endedAt?: Date;\n  /** Total duration */\n  readonly durationMs?: number;\n  /** All events */\n  readonly events: TraceEvent[];\n  /** Total steps */\n  readonly totalSteps: number;\n  /** Total tool calls */\n  readonly totalToolCalls: number;\n  /** Token usage */\n  readonly usage: {\n    readonly promptTokens: number;\n    readonly completionTokens: number;\n    readonly totalTokens: number;\n    readonly totalCost?: number;\n  };\n  /** Final result */\n  readonly result?: {\n    readonly success: boolean;\n    readonly output?: unknown;\n    readonly error?: string;\n  };\n  /** Trace schema version */\n  readonly version: number;\n}\n\n/** Trace export format */\nexport type TraceExportFormat = 'json' | 'opentelemetry' | 'langsmith' | 'custom';\n\n/** Tracer configuration */\nexport interface TracerConfig {\n  /** Agent ID */\n  agentId: string;\n  /** Session ID */\n  sessionId?: string;\n  /** Initial prompt */\n  prompt: string;\n  /** Whether to capture tool inputs/outputs */\n  captureToolData?: boolean;\n  /** Max size for tool data capture */\n  maxToolDataSize?: number;\n  /** Whether to capture model messages */\n  captureMessages?: boolean;\n  /** Custom event handlers */\n  onEvent?: (event: TraceEvent) => void;\n  /** Log events to console */\n  consoleLog?: boolean;\n}\n\n// -----------------------------------------------------------------------------\n// Agent Tracer\n// -----------------------------------------------------------------------------\n\n/**\n * Traces agent execution for debugging and observability.\n *\n * @example\n * ```typescript\n * const tracer = new AgentTracer({\n *   agentId: 'research-agent',\n *   prompt: 'Research quantum computing',\n * });\n *\n * tracer.startStep(1);\n * tracer.recordModelCall({ model: { id: 'claude-sonnet' }, messageCount: 3 });\n * tracer.recordToolCall({ toolName: 'search', toolCallId: 'tc_1', input: { query: 'quantum' } });\n * tracer.recordToolResult({ toolName: 'search', toolCallId: 'tc_1', output: results, success: true });\n * tracer.endStep(1);\n *\n * const trace = tracer.finalize();\n * ```\n */\nexport class AgentTracer {\n  private readonly config: {\n    agentId: string;\n    sessionId?: string;\n    prompt: string;\n    captureToolData: boolean;\n    maxToolDataSize: number;\n    captureMessages: boolean;\n    onEvent?: (event: TraceEvent) => void;\n    consoleLog: boolean;\n  };\n  private readonly traceId: string;\n  private readonly events: TraceEvent[] = [];\n  private readonly startTime: Date;\n  private currentStepId: string | null = null;\n  private stepCount = 0;\n  private toolCallCount = 0;\n  private usage = {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    totalCost: 0,\n  };\n\n  constructor(config: TracerConfig) {\n    this.traceId = generateTraceId();\n    this.startTime = new Date();\n    this.config = {\n      agentId: config.agentId,\n      sessionId: config.sessionId,\n      prompt: config.prompt,\n      captureToolData: config.captureToolData ?? DEFAULT_CAPTURE_TOOL_DATA,\n      maxToolDataSize: config.maxToolDataSize ?? DEFAULT_MAX_TOOL_DATA_SIZE,\n      captureMessages: config.captureMessages ?? DEFAULT_CAPTURE_MESSAGES,\n      onEvent: config.onEvent,\n      consoleLog: config.consoleLog ?? DEFAULT_CONSOLE_LOG,\n    };\n  }\n\n  /**\n   * Get current trace ID.\n   * @returns The trace identifier.\n   */\n  public get id(): string {\n    return this.traceId;\n  }\n\n  /**\n   * Get event count.\n   * @returns The number of events recorded.\n   */\n  public get eventCount(): number {\n    return this.events.length;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Step Tracking\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Start tracking a new step.\n   * @param stepNumber - The step number to start.\n   * @param metadata - Optional metadata for the step.\n   * @returns The event ID for the step.\n   */\n  public startStep(stepNumber: number, metadata?: Record<string, unknown>): string {\n    const eventId = this.generateEventId();\n    this.currentStepId = eventId;\n    this.stepCount = Math.max(this.stepCount, stepNumber);\n\n    this.addEvent({\n      id: eventId,\n      type: 'step_start',\n      timestamp: new Date(),\n      severity: 'info',\n      detail: { stepNumber },\n      metadata,\n    });\n\n    return eventId;\n  }\n\n  /**\n   * End the current step.\n   * @param stepNumber - The step number to end.\n   * @param metadata - Optional metadata for the step.\n   */\n  public endStep(stepNumber: number, metadata?: Record<string, unknown>): void {\n    const startEvent = this.events.find(\n      e =>\n        e.type === 'step_start' && (e.detail as { stepNumber: number }).stepNumber === stepNumber,\n    );\n\n    const durationMs = startEvent ? Date.now() - startEvent.timestamp.getTime() : undefined;\n\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: this.currentStepId ?? undefined,\n      type: 'step_end',\n      timestamp: new Date(),\n      durationMs,\n      severity: 'info',\n      detail: { stepNumber },\n      metadata,\n    });\n\n    this.currentStepId = null;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Model Tracking\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Record a model call.\n   * @param detail - Model call details.\n   * @param metadata - Optional metadata.\n   * @returns The event ID.\n   */\n  public recordModelCall(detail: ModelCallDetail, metadata?: Record<string, unknown>): string {\n    const eventId = this.generateEventId();\n\n    this.addEvent({\n      id: eventId,\n      parentId: this.currentStepId ?? undefined,\n      type: 'model_call',\n      timestamp: new Date(),\n      severity: 'debug',\n      detail,\n      metadata,\n    });\n\n    if (detail.inputTokens) {\n      this.usage.promptTokens += detail.inputTokens;\n      this.usage.totalTokens += detail.inputTokens;\n    }\n\n    return eventId;\n  }\n\n  /**\n   * Record a model response.\n   * @param callEventId - The ID of the model call event.\n   * @param detail - Model response details.\n   * @param metadata - Optional metadata.\n   */\n  public recordModelResponse(\n    callEventId: string,\n    detail: ModelResponseDetail,\n    metadata?: Record<string, unknown>,\n  ): void {\n    const callEvent = this.events.find(e => e.id === callEventId);\n    const durationMs = callEvent ? Date.now() - callEvent.timestamp.getTime() : undefined;\n\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: callEventId,\n      type: 'model_response',\n      timestamp: new Date(),\n      durationMs,\n      severity: 'debug',\n      detail,\n      metadata,\n    });\n\n    if (detail.outputTokens) {\n      this.usage.completionTokens += detail.outputTokens;\n      this.usage.totalTokens += detail.outputTokens;\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Tool Tracking\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Record a tool call.\n   */\n  recordToolCall(detail: ToolCallDetail, metadata?: Record<string, unknown>): string {\n    const eventId = this.generateEventId();\n    this.toolCallCount++;\n\n    const capturedDetail = this.config.captureToolData\n      ? {\n          ...detail,\n          input: this.truncateData(detail.input),\n          inputSize: this.getDataSize(detail.input),\n        }\n      : { toolName: detail.toolName, toolCallId: detail.toolCallId };\n\n    this.addEvent({\n      id: eventId,\n      parentId: this.currentStepId ?? undefined,\n      type: 'tool_call',\n      timestamp: new Date(),\n      severity: 'info',\n      detail: capturedDetail,\n      metadata,\n    });\n\n    return eventId;\n  }\n\n  /**\n   * Record a tool result.\n   */\n  recordToolResult(\n    callEventId: string,\n    detail: ToolResultDetail,\n    metadata?: Record<string, unknown>,\n  ): void {\n    const callEvent = this.events.find(e => e.id === callEventId);\n    const durationMs = callEvent ? Date.now() - callEvent.timestamp.getTime() : undefined;\n\n    const capturedDetail = this.config.captureToolData\n      ? {\n          ...detail,\n          output: detail.success ? this.truncateData(detail.output) : undefined,\n          outputSize: this.getDataSize(detail.output),\n        }\n      : {\n          toolName: detail.toolName,\n          toolCallId: detail.toolCallId,\n          success: detail.success,\n          error: detail.error,\n        };\n\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: callEventId,\n      type: 'tool_result',\n      timestamp: new Date(),\n      durationMs,\n      severity: detail.success ? 'info' : 'warn',\n      detail: capturedDetail,\n      metadata,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Decision Tracking\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Record a decision point.\n   */\n  recordDecision(detail: DecisionDetail, metadata?: Record<string, unknown>): void {\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: this.currentStepId ?? undefined,\n      type: 'decision',\n      timestamp: new Date(),\n      severity: 'info',\n      detail,\n      metadata,\n    });\n\n    if (this.config.consoleLog) {\n      logInfo(`[AgentTracer] Decision: ${detail.type} - ${detail.reason}`);\n    }\n  }\n\n  /**\n   * Record a model escalation.\n   */\n  recordEscalation(\n    fromModel: string,\n    toModel: string,\n    reason: string,\n    metadata?: Record<string, unknown>,\n  ): void {\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: this.currentStepId ?? undefined,\n      type: 'escalation',\n      timestamp: new Date(),\n      severity: 'info',\n      detail: { from: fromModel, to: toModel, reason },\n      metadata,\n    });\n\n    if (this.config.consoleLog) {\n      logInfo(`[AgentTracer] Escalation: ${fromModel} -> ${toModel} (${reason})`);\n    }\n  }\n\n  /**\n   * Record a handoff between agents.\n   */\n  recordHandoff(\n    fromAgent: string,\n    toAgent: string,\n    reason: string,\n    metadata?: Record<string, unknown>,\n  ): void {\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: this.currentStepId ?? undefined,\n      type: 'handoff',\n      timestamp: new Date(),\n      severity: 'info',\n      detail: { from: fromAgent, to: toAgent, reason },\n      metadata,\n    });\n\n    if (this.config.consoleLog) {\n      logInfo(`[AgentTracer] Handoff: ${fromAgent} -> ${toAgent} (${reason})`);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Error Tracking\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Record an error.\n   */\n  recordError(error: Error | ErrorDetail, metadata?: Record<string, unknown>): void {\n    const detail: ErrorDetail =\n      error instanceof Error\n        ? {\n            name: error.name,\n            message: error.message,\n            stack: error.stack,\n          }\n        : error;\n\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: this.currentStepId ?? undefined,\n      type: 'error',\n      timestamp: new Date(),\n      severity: 'error',\n      detail,\n      metadata,\n    });\n\n    if (this.config.consoleLog) {\n      logWarn(`[AgentTracer] Error: ${detail.message}`);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Checkpoint Tracking\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Record a checkpoint.\n   */\n  recordCheckpoint(checkpointId: string, metadata?: Record<string, unknown>): void {\n    this.addEvent({\n      id: this.generateEventId(),\n      parentId: this.currentStepId ?? undefined,\n      type: 'checkpoint',\n      timestamp: new Date(),\n      severity: 'info',\n      detail: { checkpointId },\n      metadata,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Token Usage\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Update token usage.\n   */\n  updateUsage(usage: { promptTokens?: number; completionTokens?: number; cost?: number }): void {\n    if (usage.promptTokens !== undefined) {\n      this.usage.promptTokens += usage.promptTokens;\n      this.usage.totalTokens += usage.promptTokens;\n    }\n    if (usage.completionTokens !== undefined) {\n      this.usage.completionTokens += usage.completionTokens;\n      this.usage.totalTokens += usage.completionTokens;\n    }\n    if (usage.cost !== undefined) {\n      this.usage.totalCost += usage.cost;\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Finalization\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Finalize and return the complete trace.\n   * @param result - Optional result information.\n   * @returns The complete agent trace.\n   */\n  public finalize(result?: { success: boolean; output?: unknown; error?: string }): AgentTrace {\n    const endedAt = new Date();\n\n    return {\n      traceId: this.traceId,\n      agentId: this.config.agentId,\n      sessionId: this.config.sessionId,\n      prompt: this.config.prompt,\n      startedAt: this.startTime,\n      endedAt,\n      durationMs: endedAt.getTime() - this.startTime.getTime(),\n      events: [...this.events],\n      totalSteps: this.stepCount,\n      totalToolCalls: this.toolCallCount,\n      usage: { ...this.usage },\n      result,\n      version: TRACE_SCHEMA_VERSION,\n    };\n  }\n\n  /**\n   * Get current trace snapshot without finalizing.\n   * @returns A snapshot of the current trace state.\n   */\n  public snapshot(): AgentTrace {\n    return {\n      traceId: this.traceId,\n      agentId: this.config.agentId,\n      sessionId: this.config.sessionId,\n      prompt: this.config.prompt,\n      startedAt: this.startTime,\n      durationMs: Date.now() - this.startTime.getTime(),\n      events: [...this.events],\n      totalSteps: this.stepCount,\n      totalToolCalls: this.toolCallCount,\n      usage: { ...this.usage },\n      version: TRACE_SCHEMA_VERSION,\n    };\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Get events by type.\n   * @param type - The event type to filter by.\n   * @returns Events matching the specified type.\n   */\n  public getEventsByType(type: TraceEventType): TraceEvent[] {\n    return this.events.filter(e => e.type === type);\n  }\n\n  /**\n   * Get events for a specific step.\n   * @param stepNumber - The step number to get events for.\n   * @returns Events for the specified step.\n   */\n  public getStepEvents(stepNumber: number): TraceEvent[] {\n    const stepStart = this.events.find(\n      e =>\n        e.type === 'step_start' && (e.detail as { stepNumber: number }).stepNumber === stepNumber,\n    );\n\n    if (!stepStart) return [];\n\n    // Find all events with this step as parent\n    return this.events.filter(e => e.parentId === stepStart.id || e.id === stepStart.id);\n  }\n\n  /**\n   * Get decision trace (filtered view).\n   * @returns Decision events from the trace.\n   */\n  public getDecisionTrace(): TraceEvent<DecisionDetail>[] {\n    return this.events.filter(e => e.type === 'decision') as TraceEvent<DecisionDetail>[];\n  }\n\n  /**\n   * Get error events.\n   * @returns Error events from the trace.\n   */\n  public getErrors(): TraceEvent<ErrorDetail>[] {\n    return this.events.filter(e => e.type === 'error') as TraceEvent<ErrorDetail>[];\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private\n  // ---------------------------------------------------------------------------\n\n  private addEvent(event: TraceEvent): void {\n    this.events.push(event);\n\n    if (this.config.onEvent) {\n      this.config.onEvent(event);\n    }\n\n    if (this.config.consoleLog) {\n      logDebug(`[AgentTracer] ${event.type}: ${JSON.stringify(event.detail)}`);\n    }\n  }\n\n  private generateEventId(): string {\n    return `evt_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;\n  }\n\n  private truncateData(data: unknown): unknown {\n    const str = JSON.stringify(data);\n    if (str.length <= this.config.maxToolDataSize) {\n      return data;\n    }\n    return `[truncated: ${str.length} bytes]`;\n  }\n\n  private getDataSize(data: unknown): number {\n    try {\n      return JSON.stringify(data).length;\n    } catch {\n      return 0;\n    }\n  }\n}\n\n// -----------------------------------------------------------------------------\n// Trace Exporter\n// -----------------------------------------------------------------------------\n\n/** Export options */\nexport interface TraceExportOptions {\n  /** Format to export */\n  format: TraceExportFormat;\n  /** Include full tool data */\n  includeToolData?: boolean;\n  /** Include full messages */\n  includeMessages?: boolean;\n  /** Pretty print JSON */\n  pretty?: boolean;\n}\n\n/**\n * Export a trace to various formats.\n */\nexport function exportTrace(trace: AgentTrace, options: TraceExportOptions): string | object {\n  switch (options.format) {\n    case 'json':\n      return options.pretty ? JSON.stringify(trace, null, 2) : JSON.stringify(trace);\n\n    case 'opentelemetry':\n      return exportToOpenTelemetry(trace);\n\n    case 'langsmith':\n      return exportToLangSmith(trace);\n\n    case 'custom':\n      return trace;\n\n    default:\n      throw new Error(`Unknown export format: ${options.format}`);\n  }\n}\n\nfunction exportToOpenTelemetry(trace: AgentTrace): object {\n  // Convert to OpenTelemetry span format\n  return {\n    resourceSpans: [\n      {\n        resource: {\n          attributes: [\n            { key: 'service.name', value: { stringValue: 'ai-agent' } },\n            { key: 'agent.id', value: { stringValue: trace.agentId } },\n          ],\n        },\n        scopeSpans: [\n          {\n            scope: { name: '@od-oneapp/ai-platform' },\n            spans: trace.events.map(event => ({\n              traceId: trace.traceId,\n              spanId: event.id,\n              parentSpanId: event.parentId,\n              name: event.type,\n              startTimeUnixNano: event.timestamp.getTime() * 1e6,\n              endTimeUnixNano: event.durationMs\n                ? (event.timestamp.getTime() + event.durationMs) * 1e6\n                : event.timestamp.getTime() * 1e6,\n              attributes: Object.entries(event.detail as Record<string, unknown>).map(([k, v]) => ({\n                key: k,\n                value: { stringValue: String(v) },\n              })),\n            })),\n          },\n        ],\n      },\n    ],\n  };\n}\n\nfunction exportToLangSmith(trace: AgentTrace): object {\n  // Convert to LangSmith run format\n  return {\n    id: trace.traceId,\n    name: `agent-${trace.agentId}`,\n    run_type: 'chain',\n    start_time: trace.startedAt.toISOString(),\n    end_time: trace.endedAt?.toISOString(),\n    inputs: { prompt: trace.prompt },\n    outputs: trace.result,\n    child_runs: trace.events.map(event => ({\n      id: event.id,\n      parent_run_id: event.parentId ?? trace.traceId,\n      name: event.type,\n      run_type: event.type.includes('tool') ? 'tool' : 'llm',\n      start_time: event.timestamp.toISOString(),\n      inputs: event.detail,\n      outputs: event.metadata,\n    })),\n  };\n}\n\n// -----------------------------------------------------------------------------\n// Factory Functions\n// -----------------------------------------------------------------------------\n\n/**\n * Create a new agent tracer.\n */\nexport function createAgentTracer(config: TracerConfig): AgentTracer {\n  return new AgentTracer(config);\n}\n\n/**\n * Create a tracer with OpenTelemetry integration.\n */\nexport function createOTelTracer(\n  config: TracerConfig,\n  spanExporter?: (event: TraceEvent) => void,\n): AgentTracer {\n  return new AgentTracer({\n    ...config,\n    onEvent: event => {\n      if (spanExporter) {\n        spanExporter(event);\n      }\n      config.onEvent?.(event);\n    },\n  });\n}\n\n// -----------------------------------------------------------------------------\n// Utilities\n// -----------------------------------------------------------------------------\n\nfunction generateTraceId(): string {\n  return `trace_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/**\n * Summarize a trace for logging.\n */\nexport function summarizeTrace(trace: AgentTrace): string {\n  const lines = [\n    `Trace: ${trace.traceId}`,\n    `Agent: ${trace.agentId}`,\n    `Duration: ${trace.durationMs ?? 0}ms`,\n    `Steps: ${trace.totalSteps}`,\n    `Tool Calls: ${trace.totalToolCalls}`,\n    `Tokens: ${trace.usage.totalTokens} (${trace.usage.promptTokens} prompt, ${trace.usage.completionTokens} completion)`,\n  ];\n\n  if (trace.result) {\n    lines.push(`Result: ${trace.result.success ? 'Success' : 'Failed'}`);\n    if (trace.result.error) {\n      lines.push(`Error: ${trace.result.error}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Get trace metrics.\n */\nexport function getTraceMetrics(trace: AgentTrace): {\n  totalDuration: number;\n  avgStepDuration: number;\n  avgToolDuration: number;\n  modelCallCount: number;\n  errorCount: number;\n  tokensPerStep: number;\n} {\n  const stepEndEvents = trace.events.filter(e => e.type === 'step_end');\n  const toolResultEvents = trace.events.filter(e => e.type === 'tool_result');\n  const modelCallEvents = trace.events.filter(e => e.type === 'model_call');\n  const errorEvents = trace.events.filter(e => e.type === 'error');\n\n  const totalStepDuration = stepEndEvents.reduce((sum, e) => sum + (e.durationMs ?? 0), 0);\n  const totalToolDuration = toolResultEvents.reduce((sum, e) => sum + (e.durationMs ?? 0), 0);\n\n  return {\n    totalDuration: trace.durationMs ?? 0,\n    avgStepDuration: stepEndEvents.length > 0 ? totalStepDuration / stepEndEvents.length : 0,\n    avgToolDuration: toolResultEvents.length > 0 ? totalToolDuration / toolResultEvents.length : 0,\n    modelCallCount: modelCallEvents.length,\n    errorCount: errorEvents.length,\n    tokensPerStep: trace.totalSteps > 0 ? trace.usage.totalTokens / trace.totalSteps : 0,\n  };\n}\n"],"mappings":"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"}

package/dist/agents-patterns.d.mts

@@ -0,0 +1,9 @@
+import { a as PatternEvaluationResult, c as calculateAggregateScore, d as evaluators, f as normalizeScore, i as OptimizedResult, l as createEvaluatorOptimizer, m as runPatternFeedbackLoop, n as EvaluationResult, o as PatternEvaluatorOptimizer, p as runFeedbackLoop, r as EvaluatorOptimizerOptions, s as PatternOptimizedResult, t as EvalContext, u as createPatternEvaluatorOptimizer } from "./evaluator-optimizer-pattern-D1AJrzBD.mjs";
+
+//#region src/agents/patterns/index.d.ts
+declare namespace index_d_exports {
+  export { EvalContext, EvaluationResult, EvaluatorOptimizerOptions, OptimizedResult, PatternEvaluationResult, PatternEvaluatorOptimizer, PatternOptimizedResult, calculateAggregateScore, createEvaluatorOptimizer, createPatternEvaluatorOptimizer, evaluators, normalizeScore, runFeedbackLoop, runPatternFeedbackLoop };
+}
+//#endregion
+export { type EvalContext, type EvaluationResult, type EvaluatorOptimizerOptions, type OptimizedResult, type PatternEvaluationResult, PatternEvaluatorOptimizer, type PatternOptimizedResult, calculateAggregateScore, createEvaluatorOptimizer, createPatternEvaluatorOptimizer, evaluators, normalizeScore, runFeedbackLoop, runPatternFeedbackLoop, index_d_exports as t };
+//# sourceMappingURL=agents-patterns.d.mts.map

package/dist/agents-patterns.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-patterns.d.mts","names":[],"sources":["../src/agents/patterns/index.ts"],"mappings":""}

package/dist/agents-patterns.mjs

@@ -0,0 +1,18 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { a as evaluators, c as runPatternFeedbackLoop, i as createPatternEvaluatorOptimizer, n as calculateAggregateScore, o as normalizeScore, r as createEvaluatorOptimizer, s as runFeedbackLoop, t as PatternEvaluatorOptimizer } from "./evaluator-optimizer-pattern-B5939s2Z.mjs";
+
+//#region src/agents/patterns/index.ts
+var patterns_exports = /* @__PURE__ */ __exportAll({
+	PatternEvaluatorOptimizer: () => PatternEvaluatorOptimizer,
+	calculateAggregateScore: () => calculateAggregateScore,
+	createEvaluatorOptimizer: () => createEvaluatorOptimizer,
+	createPatternEvaluatorOptimizer: () => createPatternEvaluatorOptimizer,
+	evaluators: () => evaluators,
+	normalizeScore: () => normalizeScore,
+	runFeedbackLoop: () => runFeedbackLoop,
+	runPatternFeedbackLoop: () => runPatternFeedbackLoop
+});
+
+//#endregion
+export { PatternEvaluatorOptimizer, calculateAggregateScore, createEvaluatorOptimizer, createPatternEvaluatorOptimizer, evaluators, normalizeScore, runFeedbackLoop, runPatternFeedbackLoop, patterns_exports as t };
+//# sourceMappingURL=agents-patterns.mjs.map

package/dist/agents-patterns.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-patterns.mjs","names":[],"sources":["../src/agents/patterns/index.ts"],"sourcesContent":["/**\n * @fileoverview Reusable agent architecture patterns (evaluator-optimizer, etc.).\n * @module @od-oneapp/ai-platform/agents/patterns\n */\n\nexport {\n  PatternEvaluatorOptimizer,\n  createPatternEvaluatorOptimizer,\n  // Deprecated aliases\n  createEvaluatorOptimizer,\n  runPatternFeedbackLoop,\n  runFeedbackLoop,\n  evaluators,\n  normalizeScore,\n  calculateAggregateScore,\n} from './evaluator-optimizer-pattern';\n\nexport type {\n  PatternEvaluationResult,\n  EvalContext,\n  EvaluatorOptimizerOptions,\n  PatternOptimizedResult,\n  // Deprecated aliases\n  EvaluationResult,\n  OptimizedResult,\n} from './evaluator-optimizer-pattern';\n"],"mappings":""}