@lleverage-ai/agent-sdk 0.0.1

package/dist/observability/events.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Observability event types and exporters for MCP and tool registry lifecycle events.
+ *
+ * @packageDocumentation
+ */
+import type { MCPConnectionFailedInput, MCPConnectionRestoredInput, PostCompactInput, PreCompactInput, ToolLoadErrorInput, ToolRegisteredInput } from "../types.js";
+/**
+ * Union type of all observability events.
+ * @category Observability
+ */
+export type ObservabilityEvent = MCPConnectionFailedInput | MCPConnectionRestoredInput | ToolRegisteredInput | ToolLoadErrorInput | PreCompactInput | PostCompactInput;
+/**
+ * Event severity levels for alerting.
+ * @category Observability
+ */
+export type EventSeverity = "info" | "warning" | "error" | "critical";
+/**
+ * Structured event for export with standardized fields.
+ * @category Observability
+ */
+export interface StructuredEvent {
+    /** Timestamp in ISO format */
+    timestamp: string;
+    /** Event type */
+    event_type: string;
+    /** Severity level */
+    severity: EventSeverity;
+    /** Human-readable message */
+    message: string;
+    /** Structured metadata */
+    metadata: Record<string, unknown>;
+    /** Session ID (if available) */
+    session_id?: string;
+}
+/**
+ * Options for event exporters.
+ * @category Observability
+ */
+export interface EventExporterOptions {
+    /** Minimum severity to export */
+    minSeverity?: EventSeverity;
+    /** Whether to include full error stack traces */
+    includeStackTraces?: boolean;
+}
+/**
+ * Convert an observability event to a structured event.
+ *
+ * @param event - The hook input event
+ * @returns Structured event ready for export
+ *
+ * @category Observability
+ */
+export declare function toStructuredEvent(event: ObservabilityEvent): StructuredEvent;
+/**
+ * Export events as JSON Lines format for log aggregation tools.
+ *
+ * @param events - Array of observability events
+ * @param options - Export options
+ * @returns JSON Lines string (one JSON object per line)
+ *
+ * @example
+ * ```typescript
+ * const events = [mcpFailedEvent, toolRegisteredEvent];
+ * const jsonl = exportEventsJSONLines(events);
+ * await fs.writeFile("events.jsonl", jsonl);
+ * ```
+ *
+ * @category Observability
+ */
+export declare function exportEventsJSONLines(events: ObservabilityEvent[], options?: EventExporterOptions): string;
+/**
+ * Export events in a format suitable for Prometheus/OpenMetrics.
+ *
+ * @param events - Array of observability events
+ * @returns Metrics in Prometheus text format
+ *
+ * @example
+ * ```typescript
+ * const events = [mcpFailedEvent, mcpRestoredEvent];
+ * const metrics = exportEventsPrometheus(events);
+ * // Send to Pushgateway or expose via /metrics endpoint
+ * ```
+ *
+ * @category Observability
+ */
+export declare function exportEventsPrometheus(events: ObservabilityEvent[]): string;
+/**
+ * In-memory store for collecting observability events.
+ *
+ * @example
+ * ```typescript
+ * const store = createObservabilityEventStore({ maxSize: 1000 });
+ *
+ * // Add events
+ * store.add(mcpFailedEvent);
+ * store.add(toolRegisteredEvent);
+ *
+ * // Export periodically
+ * setInterval(() => {
+ *   const jsonl = exportEventsJSONLines(store.getAll());
+ *   await sendToLogAggregator(jsonl);
+ *   store.clear();
+ * }, 60000);
+ * ```
+ *
+ * @category Observability
+ */
+export interface ObservabilityEventStore {
+    /** Add an event to the store */
+    add: (event: ObservabilityEvent) => void;
+    /** Get all events */
+    getAll: () => ObservabilityEvent[];
+    /** Get events by type */
+    getByType: (type: ObservabilityEvent["hook_event_name"]) => ObservabilityEvent[];
+    /** Clear all events */
+    clear: () => void;
+    /** Get current event count */
+    size: () => number;
+}
+/**
+ * Options for creating an observability event store.
+ * @category Observability
+ */
+export interface ObservabilityEventStoreOptions {
+    /** Maximum number of events to store (LRU eviction) */
+    maxSize?: number;
+}
+/**
+ * Create an in-memory observability event store.
+ *
+ * @param options - Store configuration
+ * @returns Event store instance
+ *
+ * @category Observability
+ */
+export declare function createObservabilityEventStore(options?: ObservabilityEventStoreOptions): ObservabilityEventStore;
+/**
+ * Create hooks for collecting observability events.
+ *
+ * @param store - Event store to collect events in
+ * @returns Hook callbacks for all observability event types
+ *
+ * @example
+ * ```typescript
+ * const store = createObservabilityEventStore();
+ * const hooks = createObservabilityEventHooks(store);
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     MCPConnectionFailed: hooks.MCPConnectionFailed,
+ *     MCPConnectionRestored: hooks.MCPConnectionRestored,
+ *     ToolRegistered: hooks.ToolRegistered,
+ *     ToolLoadError: hooks.ToolLoadError,
+ *     PreCompact: hooks.PreCompact,
+ *     PostCompact: hooks.PostCompact,
+ *   },
+ * });
+ * ```
+ *
+ * @category Observability
+ */
+export declare function createObservabilityEventHooks(store: ObservabilityEventStore): {
+    MCPConnectionFailed: ((input: MCPConnectionFailedInput) => Promise<{
+        continue: boolean;
+    }>)[];
+    MCPConnectionRestored: ((input: MCPConnectionRestoredInput) => Promise<{
+        continue: boolean;
+    }>)[];
+    ToolRegistered: ((input: ToolRegisteredInput) => Promise<{
+        continue: boolean;
+    }>)[];
+    ToolLoadError: ((input: ToolLoadErrorInput) => Promise<{
+        continue: boolean;
+    }>)[];
+    PreCompact: ((input: PreCompactInput) => Promise<{
+        continue: boolean;
+    }>)[];
+    PostCompact: ((input: PostCompactInput) => Promise<{
+        continue: boolean;
+    }>)[];
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/observability/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/observability/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,0BAA0B,GAC1B,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IAExB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,CAqG5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAAE,EAC5B,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAmBR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAqE3E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,GAAG,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAEzC,qBAAqB;IACrB,MAAM,EAAE,MAAM,kBAAkB,EAAE,CAAC;IAEnC,yBAAyB;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,KAAK,kBAAkB,EAAE,CAAC;IAEjF,uBAAuB;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAwBzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,uBAAuB;kCAGxD,wBAAwB,KAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;oCAOzD,0BAA0B,KAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;6BAO3D,mBAAmB,KAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;4BAOpD,kBAAkB,KAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;yBAOnD,eAAe,KAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;0BAOhD,gBAAgB,KAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;EAMpE"}

package/dist/observability/events.js

@@ -0,0 +1,305 @@
+/**
+ * Observability event types and exporters for MCP and tool registry lifecycle events.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Convert an observability event to a structured event.
+ *
+ * @param event - The hook input event
+ * @returns Structured event ready for export
+ *
+ * @category Observability
+ */
+export function toStructuredEvent(event) {
+    const timestamp = new Date().toISOString();
+    switch (event.hook_event_name) {
+        case "MCPConnectionFailed": {
+            return {
+                timestamp,
+                event_type: "mcp_connection_failed",
+                severity: "error",
+                message: `MCP server '${event.server_name}' failed to connect: ${event.error.message}`,
+                metadata: {
+                    server_name: event.server_name,
+                    config_type: event.config.type,
+                    error_name: event.error.name,
+                    error_message: event.error.message,
+                },
+                session_id: event.session_id,
+            };
+        }
+        case "MCPConnectionRestored": {
+            return {
+                timestamp,
+                event_type: "mcp_connection_restored",
+                severity: "info",
+                message: `MCP server '${event.server_name}' connected successfully with ${event.tool_count} tools`,
+                metadata: {
+                    server_name: event.server_name,
+                    tool_count: event.tool_count,
+                },
+                session_id: event.session_id,
+            };
+        }
+        case "ToolRegistered": {
+            return {
+                timestamp,
+                event_type: "tool_registered",
+                severity: "info",
+                message: `Tool '${event.tool_name}' registered${event.source ? ` from ${event.source}` : ""}`,
+                metadata: {
+                    tool_name: event.tool_name,
+                    description: event.description,
+                    source: event.source,
+                },
+                session_id: event.session_id,
+            };
+        }
+        case "ToolLoadError": {
+            return {
+                timestamp,
+                event_type: "tool_load_error",
+                severity: "warning",
+                message: `Failed to load tool '${event.tool_name}': ${event.error.message}`,
+                metadata: {
+                    tool_name: event.tool_name,
+                    error_name: event.error.name,
+                    error_message: event.error.message,
+                    source: event.source,
+                },
+                session_id: event.session_id,
+            };
+        }
+        case "PreCompact": {
+            return {
+                timestamp,
+                event_type: "context_compaction_started",
+                severity: "info",
+                message: `Context compaction started: ${event.message_count} messages, ${event.tokens_before} tokens`,
+                metadata: {
+                    message_count: event.message_count,
+                    tokens_before: event.tokens_before,
+                },
+                session_id: event.session_id,
+            };
+        }
+        case "PostCompact": {
+            const reductionPercent = event.tokens_before > 0
+                ? ((event.tokens_saved / event.tokens_before) * 100).toFixed(1)
+                : "0.0";
+            return {
+                timestamp,
+                event_type: "context_compaction_completed",
+                severity: "info",
+                message: `Context compaction completed: ${event.messages_before} → ${event.messages_after} messages, saved ${event.tokens_saved} tokens (${reductionPercent}%)`,
+                metadata: {
+                    messages_before: event.messages_before,
+                    messages_after: event.messages_after,
+                    tokens_before: event.tokens_before,
+                    tokens_after: event.tokens_after,
+                    tokens_saved: event.tokens_saved,
+                    reduction_percent: Number.parseFloat(reductionPercent),
+                },
+                session_id: event.session_id,
+            };
+        }
+    }
+}
+/**
+ * Export events as JSON Lines format for log aggregation tools.
+ *
+ * @param events - Array of observability events
+ * @param options - Export options
+ * @returns JSON Lines string (one JSON object per line)
+ *
+ * @example
+ * ```typescript
+ * const events = [mcpFailedEvent, toolRegisteredEvent];
+ * const jsonl = exportEventsJSONLines(events);
+ * await fs.writeFile("events.jsonl", jsonl);
+ * ```
+ *
+ * @category Observability
+ */
+export function exportEventsJSONLines(events, options = {}) {
+    const { minSeverity = "info" } = options;
+    const severityLevels = ["info", "warning", "error", "critical"];
+    const minLevel = severityLevels.indexOf(minSeverity);
+    return events
+        .map((event) => {
+        const structured = toStructuredEvent(event);
+        // Filter by severity
+        const eventLevel = severityLevels.indexOf(structured.severity);
+        if (eventLevel < minLevel) {
+            return null;
+        }
+        return JSON.stringify(structured);
+    })
+        .filter((line) => line !== null)
+        .join("\n");
+}
+/**
+ * Export events in a format suitable for Prometheus/OpenMetrics.
+ *
+ * @param events - Array of observability events
+ * @returns Metrics in Prometheus text format
+ *
+ * @example
+ * ```typescript
+ * const events = [mcpFailedEvent, mcpRestoredEvent];
+ * const metrics = exportEventsPrometheus(events);
+ * // Send to Pushgateway or expose via /metrics endpoint
+ * ```
+ *
+ * @category Observability
+ */
+export function exportEventsPrometheus(events) {
+    const metrics = new Map();
+    for (const event of events) {
+        switch (event.hook_event_name) {
+            case "MCPConnectionFailed": {
+                const key = `mcp_connection_failures_total{server="${event.server_name}"}`;
+                metrics.set(key, (metrics.get(key) ?? 0) + 1);
+                break;
+            }
+            case "MCPConnectionRestored": {
+                const key = `mcp_connections_total{server="${event.server_name}"}`;
+                metrics.set(key, (metrics.get(key) ?? 0) + 1);
+                const toolKey = `mcp_tools_available{server="${event.server_name}"}`;
+                metrics.set(toolKey, event.tool_count);
+                break;
+            }
+            case "ToolRegistered": {
+                const source = event.source ?? "unknown";
+                const key = `tools_registered_total{source="${source}"}`;
+                metrics.set(key, (metrics.get(key) ?? 0) + 1);
+                break;
+            }
+            case "ToolLoadError": {
+                const source = event.source ?? "unknown";
+                const key = `tool_load_errors_total{source="${source}"}`;
+                metrics.set(key, (metrics.get(key) ?? 0) + 1);
+                break;
+            }
+            case "PreCompact": {
+                // Track compaction starts (for in-progress monitoring)
+                const key = `context_compactions_started_total`;
+                metrics.set(key, (metrics.get(key) ?? 0) + 1);
+                break;
+            }
+            case "PostCompact": {
+                // Track completed compactions
+                const compactKey = `context_compactions_total`;
+                metrics.set(compactKey, (metrics.get(compactKey) ?? 0) + 1);
+                // Track tokens saved
+                const tokensSavedKey = `context_compaction_tokens_saved_total`;
+                metrics.set(tokensSavedKey, (metrics.get(tokensSavedKey) ?? 0) + event.tokens_saved);
+                // Track messages compacted
+                const messagesCompactedKey = `context_compaction_messages_removed_total`;
+                const messagesRemoved = event.messages_before - event.messages_after;
+                metrics.set(messagesCompactedKey, (metrics.get(messagesCompactedKey) ?? 0) + messagesRemoved);
+                break;
+            }
+        }
+    }
+    const lines = [];
+    for (const [metric, value] of metrics) {
+        lines.push(`${metric} ${value}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Create an in-memory observability event store.
+ *
+ * @param options - Store configuration
+ * @returns Event store instance
+ *
+ * @category Observability
+ */
+export function createObservabilityEventStore(options = {}) {
+    const { maxSize = 10000 } = options;
+    const events = [];
+    return {
+        add: (event) => {
+            events.push(event);
+            // LRU eviction
+            if (events.length > maxSize) {
+                events.shift();
+            }
+        },
+        getAll: () => [...events],
+        getByType: (type) => events.filter((e) => e.hook_event_name === type),
+        clear: () => {
+            events.length = 0;
+        },
+        size: () => events.length,
+    };
+}
+/**
+ * Create hooks for collecting observability events.
+ *
+ * @param store - Event store to collect events in
+ * @returns Hook callbacks for all observability event types
+ *
+ * @example
+ * ```typescript
+ * const store = createObservabilityEventStore();
+ * const hooks = createObservabilityEventHooks(store);
+ *
+ * const agent = createAgent({
+ *   model,
+ *   hooks: {
+ *     MCPConnectionFailed: hooks.MCPConnectionFailed,
+ *     MCPConnectionRestored: hooks.MCPConnectionRestored,
+ *     ToolRegistered: hooks.ToolRegistered,
+ *     ToolLoadError: hooks.ToolLoadError,
+ *     PreCompact: hooks.PreCompact,
+ *     PostCompact: hooks.PostCompact,
+ *   },
+ * });
+ * ```
+ *
+ * @category Observability
+ */
+export function createObservabilityEventHooks(store) {
+    return {
+        MCPConnectionFailed: [
+            async (input) => {
+                store.add(input);
+                return { continue: true };
+            },
+        ],
+        MCPConnectionRestored: [
+            async (input) => {
+                store.add(input);
+                return { continue: true };
+            },
+        ],
+        ToolRegistered: [
+            async (input) => {
+                store.add(input);
+                return { continue: true };
+            },
+        ],
+        ToolLoadError: [
+            async (input) => {
+                store.add(input);
+                return { continue: true };
+            },
+        ],
+        PreCompact: [
+            async (input) => {
+                store.add(input);
+                return { continue: true };
+            },
+        ],
+        PostCompact: [
+            async (input) => {
+                store.add(input);
+                return { continue: true };
+            },
+        ],
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/observability/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/observability/events.ts"],"names":[],"mappings":"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"}

package/dist/observability/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Observability Module.
+ *
+ * Provides comprehensive observability features for the agent SDK:
+ * - **Logging**: Structured logging with levels, formatters, and transports
+ * - **Metrics**: Counters, gauges, histograms for performance tracking
+ * - **Tracing**: OpenTelemetry-compatible distributed tracing
+ * - **Hooks**: Pre-built hooks for integrating observability with agents
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createLogger,
+ *   createMetricsRegistry,
+ *   createAgentMetrics,
+ *   createTracer,
+ *   createObservabilityHooks,
+ *   registerObservabilityHooks,
+ * } from "@lleverage-ai/agent-sdk";
+ *
+ * // Set up observability
+ * const logger = createLogger({ name: "my-agent", level: "info" });
+ * const registry = createMetricsRegistry();
+ * const metrics = createAgentMetrics(registry);
+ * const tracer = createTracer({
+ *   name: "my-agent",
+ *   exporters: [createConsoleSpanExporter()],
+ * });
+ *
+ * // Create and register hooks
+ * const observabilityHooks = createObservabilityHooks({
+ *   logger,
+ *   metrics,
+ *   tracer,
+ * });
+ *
+ * const hookManager = createHookManager();
+ * registerObservabilityHooks(hookManager, observabilityHooks);
+ *
+ * // Create agent with observability
+ * const agent = createAgent({
+ *   model,
+ *   hooks: hookManager,
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createObservabilityEventHooks, createObservabilityEventStore, type EventExporterOptions, type EventSeverity, exportEventsJSONLines, exportEventsPrometheus, type ObservabilityEvent, type ObservabilityEventStore, type ObservabilityEventStoreOptions, type StructuredEvent, toStructuredEvent, } from "./events.js";
+export { createCallbackTransport, createConsoleTransport, createFilteredTransport, createJsonFormatter, createLogger, createMemoryTransport, createPrettyFormatter, defaultLogger, LOG_LEVEL_VALUES, type LogEntry, type LogFormatter, type Logger, type LoggerOptions, type LogLevel, type LogTimer, type LogTransport, setDefaultLogger, } from "./logger.js";
+export { type AgentMetrics, type Counter, createAgentMetrics, createCallbackMetricsExporter, createConsoleMetricsExporter, createMemoryMetricsExporter, createMetricsRegistry, DEFAULT_LATENCY_BUCKETS, DEFAULT_TOKEN_BUCKETS, defaultMetricsRegistry, type Gauge, type Histogram, type HistogramBucket, type HistogramData, type MetricLabels, type MetricPoint, type MetricsExporter, type MetricsRegistry, type MetricsRegistryOptions, type MetricType, setDefaultMetricsRegistry, } from "./metrics.js";
+export { createObservabilityPreset, type ObservabilityPreset, type ObservabilityPresetOptions, } from "./preset.js";
+export { createStreamingLogTransport, createStreamingObservability, type StreamingLogTransportOptions, type StreamingObservabilityOptions, } from "./streaming.js";
+export { createCallbackSpanExporter, createConsoleSpanExporter, createMemorySpanExporter, createOTLPSpanExporter, createTracer, defaultTracer, SemanticAttributes, type Span, type SpanAttributes, type SpanContext, type SpanData, type SpanEvent, type SpanExporter, type SpanKind, type SpanLink, type SpanStatus, type SpanStatusCode, type StartSpanOptions, setDefaultTracer, type Tracer, type TracerOptions, } from "./tracing.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,qBAAqB,EACrB,sBAAsB,EAEtB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,eAAe,EAEpB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EAEvB,sBAAsB,EACtB,uBAAuB,EAEvB,mBAAmB,EAEnB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,aAAa,EAElB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,OAAO,EAEZ,kBAAkB,EAClB,6BAA6B,EAE7B,4BAA4B,EAC5B,2BAA2B,EAE3B,qBAAqB,EAErB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAE3B,KAAK,UAAU,EACf,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,2BAA2B,EAC3B,4BAA4B,EAE5B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,GACnC,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,0BAA0B,EAE1B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EAEtB,YAAY,EAEZ,aAAa,EAEb,kBAAkB,EAClB,KAAK,IAAI,EACT,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EAEf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,KAAK,MAAM,EACX,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,87 @@
+/**
+ * Observability Module.
+ *
+ * Provides comprehensive observability features for the agent SDK:
+ * - **Logging**: Structured logging with levels, formatters, and transports
+ * - **Metrics**: Counters, gauges, histograms for performance tracking
+ * - **Tracing**: OpenTelemetry-compatible distributed tracing
+ * - **Hooks**: Pre-built hooks for integrating observability with agents
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createLogger,
+ *   createMetricsRegistry,
+ *   createAgentMetrics,
+ *   createTracer,
+ *   createObservabilityHooks,
+ *   registerObservabilityHooks,
+ * } from "@lleverage-ai/agent-sdk";
+ *
+ * // Set up observability
+ * const logger = createLogger({ name: "my-agent", level: "info" });
+ * const registry = createMetricsRegistry();
+ * const metrics = createAgentMetrics(registry);
+ * const tracer = createTracer({
+ *   name: "my-agent",
+ *   exporters: [createConsoleSpanExporter()],
+ * });
+ *
+ * // Create and register hooks
+ * const observabilityHooks = createObservabilityHooks({
+ *   logger,
+ *   metrics,
+ *   tracer,
+ * });
+ *
+ * const hookManager = createHookManager();
+ * registerObservabilityHooks(hookManager, observabilityHooks);
+ *
+ * // Create agent with observability
+ * const agent = createAgent({
+ *   model,
+ *   hooks: hookManager,
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Events
+export { createObservabilityEventHooks, createObservabilityEventStore, exportEventsJSONLines, exportEventsPrometheus, 
+// Functions
+toStructuredEvent, } from "./events.js";
+// Logger
+export { createCallbackTransport, 
+// Transports
+createConsoleTransport, createFilteredTransport, 
+// Formatters
+createJsonFormatter, 
+// Logger
+createLogger, createMemoryTransport, createPrettyFormatter, defaultLogger, LOG_LEVEL_VALUES, setDefaultLogger, } from "./logger.js";
+// Metrics
+export { 
+// Agent Metrics
+createAgentMetrics, createCallbackMetricsExporter, 
+// Exporters
+createConsoleMetricsExporter, createMemoryMetricsExporter, 
+// Registry
+createMetricsRegistry, 
+// Constants
+DEFAULT_LATENCY_BUCKETS, DEFAULT_TOKEN_BUCKETS, defaultMetricsRegistry, setDefaultMetricsRegistry, } from "./metrics.js";
+// Preset
+export { createObservabilityPreset, } from "./preset.js";
+// Streaming
+export { 
+// Factories
+createStreamingLogTransport, createStreamingObservability, } from "./streaming.js";
+// Tracing
+export { createCallbackSpanExporter, 
+// Exporters
+createConsoleSpanExporter, createMemorySpanExporter, createOTLPSpanExporter, 
+// Tracer
+createTracer, 
+// Default
+defaultTracer, 
+// Semantic Conventions
+SemanticAttributes, setDefaultTracer, } from "./tracing.js";
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,SAAS;AACT,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAG7B,qBAAqB,EACrB,sBAAsB;AAMtB,YAAY;AACZ,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,SAAS;AACT,OAAO,EACL,uBAAuB;AACvB,aAAa;AACb,sBAAsB,EACtB,uBAAuB;AACvB,aAAa;AACb,mBAAmB;AACnB,SAAS;AACT,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAShB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,UAAU;AACV,OAAO;AAGL,gBAAgB;AAChB,kBAAkB,EAClB,6BAA6B;AAC7B,YAAY;AACZ,4BAA4B,EAC5B,2BAA2B;AAC3B,WAAW;AACX,qBAAqB;AACrB,YAAY;AACZ,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EAYtB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,SAAS;AACT,OAAO,EACL,yBAAyB,GAG1B,MAAM,aAAa,CAAC;AAErB,YAAY;AACZ,OAAO;AACL,YAAY;AACZ,2BAA2B,EAC3B,4BAA4B,GAI7B,MAAM,gBAAgB,CAAC;AAExB,UAAU;AACV,OAAO,EACL,0BAA0B;AAC1B,YAAY;AACZ,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB;AACtB,SAAS;AACT,YAAY;AACZ,UAAU;AACV,aAAa;AACb,uBAAuB;AACvB,kBAAkB,EAalB,gBAAgB,GAGjB,MAAM,cAAc,CAAC"}