praisonai 1.2.0 → 1.2.2

package/dist/index.js

@@ -14,8 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Chunking = exports.createPromptExpanderAgent = exports.PromptExpanderAgent = exports.createQueryRewriterAgent = exports.QueryRewriterAgent = exports.createDeepResearchAgent = exports.DeepResearchAgent = exports.createImageAgent = exports.ImageAgent = exports.createAutoAgents = exports.AutoAgents = exports.cleanupTelemetry = exports.disableTelemetry = exports.enableTelemetry = exports.getTelemetry = exports.TelemetryCollector = exports.createMemory = exports.Memory = exports.help = exports.version = exports.listProviders = exports.chat = exports.parseSkillFile = exports.createSkillManager = exports.SkillManager = exports.getObservabilityAdapter = exports.setObservabilityAdapter = exports.ConsoleObservabilityAdapter = exports.MemoryObservabilityAdapter = exports.EvalSuite = exports.reliabilityEval = exports.performanceEval = exports.accuracyEval = exports.createKnowledgeBase = exports.KnowledgeBase = exports.createContextAgent = exports.ContextAgent = exports.routeConditions = exports.createRouter = exports.RouterAgent = exports.handoffFilters = exports.handoff = exports.Handoff = exports.getTool = exports.registerTool = exports.getRegistry = exports.ToolRegistry = exports.tool = exports.FunctionTool = exports.BaseTool = void 0;
-exports.BaseProvider = exports.GoogleProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.getAvailableProviders = exports.isProviderAvailable = exports.parseModelString = exports.getDefaultProvider = exports.createProvider = exports.createPlanStorage = exports.createTodoList = exports.createPlan = exports.PlanStorage = exports.TodoItem = exports.TodoList = exports.PlanStep = exports.Plan = exports.createLLMGuardrail = exports.LLMGuardrail = exports.createChunking = void 0;
+exports.createQueryRewriterAgent = exports.QueryRewriterAgent = exports.createDeepResearchAgent = exports.DeepResearchAgent = exports.createImageAgent = exports.ImageAgent = exports.createAutoAgents = exports.AutoAgents = exports.cleanupTelemetry = exports.disableTelemetry = exports.enableTelemetry = exports.getTelemetry = exports.TelemetryCollector = exports.createMemory = exports.Memory = exports.help = exports.version = exports.listProviders = exports.chat = exports.parseSkillFile = exports.createSkillManager = exports.SkillManager = exports.getObservabilityAdapter = exports.setObservabilityAdapter = exports.ConsoleObservabilityAdapter = exports.MemoryObservabilityAdapter = exports.EvalSuite = exports.reliabilityEval = exports.performanceEval = exports.accuracyEval = exports.createKnowledgeBase = exports.KnowledgeBase = exports.createContextAgent = exports.ContextAgent = exports.routeConditions = exports.createRouter = exports.RouterAgent = exports.handoffFilters = exports.handoff = exports.Handoff = exports.getTool = exports.registerTool = exports.getRegistry = exports.ToolRegistry = exports.tool = exports.FunctionTool = exports.createTool = exports.validateTool = exports.ToolValidationError = exports.BaseTool = void 0;
+exports.createQdrantStore = exports.QdrantVectorStore = exports.createWeaviateStore = exports.WeaviateVectorStore = exports.createPineconeStore = exports.PineconeVectorStore = exports.createMemoryVectorStore = exports.MemoryVectorStore = exports.BaseVectorStore = exports.createPostgresSessionStorage = exports.createMemoryPostgres = exports.createNeonPostgres = exports.PostgresSessionStorage = exports.MemoryPostgresAdapter = exports.NeonPostgresAdapter = exports.createMemoryRedis = exports.createUpstashRedis = exports.MemoryRedisAdapter = exports.UpstashRedisAdapter = exports.createSQLiteAdapter = exports.SQLiteAdapter = exports.validateWorkflowDefinition = exports.loadWorkflowFromFile = exports.createWorkflowFromYAML = exports.parseYAMLWorkflow = exports.createPubSub = exports.createEventBus = exports.AgentEvents = exports.AgentEventBus = exports.EventEmitterPubSub = exports.PubSub = exports.createFileCache = exports.createMemoryCache = exports.FileCache = exports.MemoryCache = exports.BaseCache = exports.createPlanStorage = exports.createTodoList = exports.createPlan = exports.PlanStorage = exports.TodoItem = exports.TodoList = exports.PlanStep = exports.Plan = exports.createLLMGuardrail = exports.LLMGuardrail = exports.createChunking = exports.Chunking = exports.createPromptExpanderAgent = exports.PromptExpanderAgent = void 0;
+exports.BaseProvider = exports.GoogleProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.getAvailableProviders = exports.isProviderAvailable = exports.parseModelString = exports.getDefaultProvider = exports.createProvider = exports.createGraphRAG = exports.GraphRAG = exports.GraphStore = exports.createLLMReranker = exports.createCrossEncoderReranker = exports.createCohereReranker = exports.LLMReranker = exports.CrossEncoderReranker = exports.CohereReranker = exports.BaseReranker = exports.createElevenLabsVoice = exports.createOpenAIVoice = exports.ElevenLabsVoiceProvider = exports.OpenAIVoiceProvider = exports.BaseVoiceProvider = exports.createLangfuseObservability = exports.createMemoryObservability = exports.createConsoleObservability = exports.LangfuseObservabilityProvider = exports.MemoryObservabilityProvider = exports.ConsoleObservabilityProvider = exports.BaseObservabilityProvider = exports.createChromaStore = exports.ChromaVectorStore = void 0;
 // Export all public modules
 __exportStar(require("./agent"), exports);
 __exportStar(require("./knowledge"), exports);
@@ -25,6 +26,9 @@ __exportStar(require("./process"), exports);
 // Export tools (excluding conflicting types)
 var tools_1 = require("./tools");
 Object.defineProperty(exports, "BaseTool", { enumerable: true, get: function () { return tools_1.BaseTool; } });
+Object.defineProperty(exports, "ToolValidationError", { enumerable: true, get: function () { return tools_1.ToolValidationError; } });
+Object.defineProperty(exports, "validateTool", { enumerable: true, get: function () { return tools_1.validateTool; } });
+Object.defineProperty(exports, "createTool", { enumerable: true, get: function () { return tools_1.createTool; } });
 Object.defineProperty(exports, "FunctionTool", { enumerable: true, get: function () { return tools_1.FunctionTool; } });
 Object.defineProperty(exports, "tool", { enumerable: true, get: function () { return tools_1.tool; } });
 Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return tools_1.ToolRegistry; } });
@@ -131,6 +135,88 @@ Object.defineProperty(exports, "PlanStorage", { enumerable: true, get: function
 Object.defineProperty(exports, "createPlan", { enumerable: true, get: function () { return planning_1.createPlan; } });
 Object.defineProperty(exports, "createTodoList", { enumerable: true, get: function () { return planning_1.createTodoList; } });
 Object.defineProperty(exports, "createPlanStorage", { enumerable: true, get: function () { return planning_1.createPlanStorage; } });
+// Export Cache
+var cache_1 = require("./cache");
+Object.defineProperty(exports, "BaseCache", { enumerable: true, get: function () { return cache_1.BaseCache; } });
+Object.defineProperty(exports, "MemoryCache", { enumerable: true, get: function () { return cache_1.MemoryCache; } });
+Object.defineProperty(exports, "FileCache", { enumerable: true, get: function () { return cache_1.FileCache; } });
+Object.defineProperty(exports, "createMemoryCache", { enumerable: true, get: function () { return cache_1.createMemoryCache; } });
+Object.defineProperty(exports, "createFileCache", { enumerable: true, get: function () { return cache_1.createFileCache; } });
+// Export Events
+var events_1 = require("./events");
+Object.defineProperty(exports, "PubSub", { enumerable: true, get: function () { return events_1.PubSub; } });
+Object.defineProperty(exports, "EventEmitterPubSub", { enumerable: true, get: function () { return events_1.EventEmitterPubSub; } });
+Object.defineProperty(exports, "AgentEventBus", { enumerable: true, get: function () { return events_1.AgentEventBus; } });
+Object.defineProperty(exports, "AgentEvents", { enumerable: true, get: function () { return events_1.AgentEvents; } });
+Object.defineProperty(exports, "createEventBus", { enumerable: true, get: function () { return events_1.createEventBus; } });
+Object.defineProperty(exports, "createPubSub", { enumerable: true, get: function () { return events_1.createPubSub; } });
+// Export YAML Workflow Parser
+var yaml_parser_1 = require("./workflows/yaml-parser");
+Object.defineProperty(exports, "parseYAMLWorkflow", { enumerable: true, get: function () { return yaml_parser_1.parseYAMLWorkflow; } });
+Object.defineProperty(exports, "createWorkflowFromYAML", { enumerable: true, get: function () { return yaml_parser_1.createWorkflowFromYAML; } });
+Object.defineProperty(exports, "loadWorkflowFromFile", { enumerable: true, get: function () { return yaml_parser_1.loadWorkflowFromFile; } });
+Object.defineProperty(exports, "validateWorkflowDefinition", { enumerable: true, get: function () { return yaml_parser_1.validateWorkflowDefinition; } });
+// Export SQLite Adapter
+var sqlite_1 = require("./db/sqlite");
+Object.defineProperty(exports, "SQLiteAdapter", { enumerable: true, get: function () { return sqlite_1.SQLiteAdapter; } });
+Object.defineProperty(exports, "createSQLiteAdapter", { enumerable: true, get: function () { return sqlite_1.createSQLiteAdapter; } });
+// Export Redis Adapter
+var redis_1 = require("./db/redis");
+Object.defineProperty(exports, "UpstashRedisAdapter", { enumerable: true, get: function () { return redis_1.UpstashRedisAdapter; } });
+Object.defineProperty(exports, "MemoryRedisAdapter", { enumerable: true, get: function () { return redis_1.MemoryRedisAdapter; } });
+Object.defineProperty(exports, "createUpstashRedis", { enumerable: true, get: function () { return redis_1.createUpstashRedis; } });
+Object.defineProperty(exports, "createMemoryRedis", { enumerable: true, get: function () { return redis_1.createMemoryRedis; } });
+// Export PostgreSQL Adapter
+var postgres_1 = require("./db/postgres");
+Object.defineProperty(exports, "NeonPostgresAdapter", { enumerable: true, get: function () { return postgres_1.NeonPostgresAdapter; } });
+Object.defineProperty(exports, "MemoryPostgresAdapter", { enumerable: true, get: function () { return postgres_1.MemoryPostgresAdapter; } });
+Object.defineProperty(exports, "PostgresSessionStorage", { enumerable: true, get: function () { return postgres_1.PostgresSessionStorage; } });
+Object.defineProperty(exports, "createNeonPostgres", { enumerable: true, get: function () { return postgres_1.createNeonPostgres; } });
+Object.defineProperty(exports, "createMemoryPostgres", { enumerable: true, get: function () { return postgres_1.createMemoryPostgres; } });
+Object.defineProperty(exports, "createPostgresSessionStorage", { enumerable: true, get: function () { return postgres_1.createPostgresSessionStorage; } });
+// Export Integrations - Vector Stores
+var vector_1 = require("./integrations/vector");
+Object.defineProperty(exports, "BaseVectorStore", { enumerable: true, get: function () { return vector_1.BaseVectorStore; } });
+Object.defineProperty(exports, "MemoryVectorStore", { enumerable: true, get: function () { return vector_1.MemoryVectorStore; } });
+Object.defineProperty(exports, "createMemoryVectorStore", { enumerable: true, get: function () { return vector_1.createMemoryVectorStore; } });
+Object.defineProperty(exports, "PineconeVectorStore", { enumerable: true, get: function () { return vector_1.PineconeVectorStore; } });
+Object.defineProperty(exports, "createPineconeStore", { enumerable: true, get: function () { return vector_1.createPineconeStore; } });
+Object.defineProperty(exports, "WeaviateVectorStore", { enumerable: true, get: function () { return vector_1.WeaviateVectorStore; } });
+Object.defineProperty(exports, "createWeaviateStore", { enumerable: true, get: function () { return vector_1.createWeaviateStore; } });
+Object.defineProperty(exports, "QdrantVectorStore", { enumerable: true, get: function () { return vector_1.QdrantVectorStore; } });
+Object.defineProperty(exports, "createQdrantStore", { enumerable: true, get: function () { return vector_1.createQdrantStore; } });
+Object.defineProperty(exports, "ChromaVectorStore", { enumerable: true, get: function () { return vector_1.ChromaVectorStore; } });
+Object.defineProperty(exports, "createChromaStore", { enumerable: true, get: function () { return vector_1.createChromaStore; } });
+// Export Integrations - Observability
+var observability_2 = require("./integrations/observability");
+Object.defineProperty(exports, "BaseObservabilityProvider", { enumerable: true, get: function () { return observability_2.BaseObservabilityProvider; } });
+Object.defineProperty(exports, "ConsoleObservabilityProvider", { enumerable: true, get: function () { return observability_2.ConsoleObservabilityProvider; } });
+Object.defineProperty(exports, "MemoryObservabilityProvider", { enumerable: true, get: function () { return observability_2.MemoryObservabilityProvider; } });
+Object.defineProperty(exports, "LangfuseObservabilityProvider", { enumerable: true, get: function () { return observability_2.LangfuseObservabilityProvider; } });
+Object.defineProperty(exports, "createConsoleObservability", { enumerable: true, get: function () { return observability_2.createConsoleObservability; } });
+Object.defineProperty(exports, "createMemoryObservability", { enumerable: true, get: function () { return observability_2.createMemoryObservability; } });
+Object.defineProperty(exports, "createLangfuseObservability", { enumerable: true, get: function () { return observability_2.createLangfuseObservability; } });
+// Export Integrations - Voice
+var voice_1 = require("./integrations/voice");
+Object.defineProperty(exports, "BaseVoiceProvider", { enumerable: true, get: function () { return voice_1.BaseVoiceProvider; } });
+Object.defineProperty(exports, "OpenAIVoiceProvider", { enumerable: true, get: function () { return voice_1.OpenAIVoiceProvider; } });
+Object.defineProperty(exports, "ElevenLabsVoiceProvider", { enumerable: true, get: function () { return voice_1.ElevenLabsVoiceProvider; } });
+Object.defineProperty(exports, "createOpenAIVoice", { enumerable: true, get: function () { return voice_1.createOpenAIVoice; } });
+Object.defineProperty(exports, "createElevenLabsVoice", { enumerable: true, get: function () { return voice_1.createElevenLabsVoice; } });
+// Export Reranker
+var reranker_1 = require("./knowledge/reranker");
+Object.defineProperty(exports, "BaseReranker", { enumerable: true, get: function () { return reranker_1.BaseReranker; } });
+Object.defineProperty(exports, "CohereReranker", { enumerable: true, get: function () { return reranker_1.CohereReranker; } });
+Object.defineProperty(exports, "CrossEncoderReranker", { enumerable: true, get: function () { return reranker_1.CrossEncoderReranker; } });
+Object.defineProperty(exports, "LLMReranker", { enumerable: true, get: function () { return reranker_1.LLMReranker; } });
+Object.defineProperty(exports, "createCohereReranker", { enumerable: true, get: function () { return reranker_1.createCohereReranker; } });
+Object.defineProperty(exports, "createCrossEncoderReranker", { enumerable: true, get: function () { return reranker_1.createCrossEncoderReranker; } });
+Object.defineProperty(exports, "createLLMReranker", { enumerable: true, get: function () { return reranker_1.createLLMReranker; } });
+// Export Graph RAG
+var graph_rag_1 = require("./knowledge/graph-rag");
+Object.defineProperty(exports, "GraphStore", { enumerable: true, get: function () { return graph_rag_1.GraphStore; } });
+Object.defineProperty(exports, "GraphRAG", { enumerable: true, get: function () { return graph_rag_1.GraphRAG; } });
+Object.defineProperty(exports, "createGraphRAG", { enumerable: true, get: function () { return graph_rag_1.createGraphRAG; } });
 // Export providers with explicit names to avoid conflicts
 var providers_1 = require("./llm/providers");
 Object.defineProperty(exports, "createProvider", { enumerable: true, get: function () { return providers_1.createProvider; } });

package/dist/integrations/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * PraisonAI Integrations
+ * Extensions for vector stores, observability, and voice
+ */
+export * from './vector';
+export * from './observability';
+export * from './voice';

package/dist/integrations/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * PraisonAI Integrations
+ * Extensions for vector stores, observability, and voice
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Vector Store Integrations
+__exportStar(require("./vector"), exports);
+// Observability Integrations
+__exportStar(require("./observability"), exports);
+// Voice Integrations
+__exportStar(require("./voice"), exports);

package/dist/integrations/observability/base.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Base Observability - Abstract class for observability integrations
+ * Supports tracing, logging, and metrics
+ */
+export interface Span {
+    id: string;
+    traceId: string;
+    parentId?: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    status: 'ok' | 'error' | 'unset';
+    attributes: Record<string, any>;
+    events: SpanEvent[];
+}
+export interface SpanEvent {
+    name: string;
+    timestamp: number;
+    attributes?: Record<string, any>;
+}
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+}
+export interface LogEntry {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    timestamp: number;
+    traceId?: string;
+    spanId?: string;
+    attributes?: Record<string, any>;
+}
+export interface Metric {
+    name: string;
+    value: number;
+    type: 'counter' | 'gauge' | 'histogram';
+    timestamp: number;
+    tags?: Record<string, string>;
+}
+/**
+ * Abstract base class for observability providers
+ */
+export declare abstract class BaseObservabilityProvider {
+    readonly name: string;
+    constructor(name: string);
+    /**
+     * Start a new span
+     */
+    abstract startSpan(name: string, attributes?: Record<string, any>, parentContext?: TraceContext): Span;
+    /**
+     * End a span
+     */
+    abstract endSpan(span: Span, status?: 'ok' | 'error', error?: Error): void;
+    /**
+     * Add event to span
+     */
+    abstract addSpanEvent(span: Span, name: string, attributes?: Record<string, any>): void;
+    /**
+     * Log a message
+     */
+    abstract log(entry: LogEntry): void;
+    /**
+     * Record a metric
+     */
+    abstract recordMetric(metric: Metric): void;
+    /**
+     * Flush all pending data
+     */
+    abstract flush(): Promise<void>;
+    /**
+     * Shutdown the provider
+     */
+    abstract shutdown(): Promise<void>;
+    /**
+     * Helper to create trace context
+     */
+    protected createTraceContext(span: Span): TraceContext;
+    /**
+     * Generate unique ID
+     */
+    protected generateId(): string;
+}
+/**
+ * Console-based observability provider for development
+ */
+export declare class ConsoleObservabilityProvider extends BaseObservabilityProvider {
+    private spans;
+    private verbose;
+    constructor(config?: {
+        verbose?: boolean;
+    });
+    startSpan(name: string, attributes?: Record<string, any>, parentContext?: TraceContext): Span;
+    endSpan(span: Span, status?: 'ok' | 'error', error?: Error): void;
+    addSpanEvent(span: Span, name: string, attributes?: Record<string, any>): void;
+    log(entry: LogEntry): void;
+    recordMetric(metric: Metric): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Memory-based observability provider for testing
+ */
+export declare class MemoryObservabilityProvider extends BaseObservabilityProvider {
+    spans: Span[];
+    logs: LogEntry[];
+    metrics: Metric[];
+    constructor();
+    startSpan(name: string, attributes?: Record<string, any>, parentContext?: TraceContext): Span;
+    endSpan(span: Span, status?: 'ok' | 'error', error?: Error): void;
+    addSpanEvent(span: Span, name: string, attributes?: Record<string, any>): void;
+    log(entry: LogEntry): void;
+    recordMetric(metric: Metric): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    getSpansByName(name: string): Span[];
+    getLogsByLevel(level: LogEntry['level']): LogEntry[];
+    getMetricsByName(name: string): Metric[];
+}
+export declare function createConsoleObservability(config?: {
+    verbose?: boolean;
+}): ConsoleObservabilityProvider;
+export declare function createMemoryObservability(): MemoryObservabilityProvider;

package/dist/integrations/observability/base.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Base Observability - Abstract class for observability integrations
+ * Supports tracing, logging, and metrics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryObservabilityProvider = exports.ConsoleObservabilityProvider = exports.BaseObservabilityProvider = void 0;
+exports.createConsoleObservability = createConsoleObservability;
+exports.createMemoryObservability = createMemoryObservability;
+/**
+ * Abstract base class for observability providers
+ */
+class BaseObservabilityProvider {
+    constructor(name) {
+        this.name = name;
+    }
+    /**
+     * Helper to create trace context
+     */
+    createTraceContext(span) {
+        return {
+            traceId: span.traceId,
+            spanId: span.id,
+            parentSpanId: span.parentId
+        };
+    }
+    /**
+     * Generate unique ID
+     */
+    generateId() {
+        return crypto.randomUUID().replace(/-/g, '');
+    }
+}
+exports.BaseObservabilityProvider = BaseObservabilityProvider;
+/**
+ * Console-based observability provider for development
+ */
+class ConsoleObservabilityProvider extends BaseObservabilityProvider {
+    constructor(config = {}) {
+        super('ConsoleObservability');
+        this.spans = new Map();
+        this.verbose = config.verbose ?? false;
+    }
+    startSpan(name, attributes, parentContext) {
+        const span = {
+            id: this.generateId(),
+            traceId: parentContext?.traceId || this.generateId(),
+            parentId: parentContext?.spanId,
+            name,
+            startTime: Date.now(),
+            status: 'unset',
+            attributes: attributes || {},
+            events: []
+        };
+        this.spans.set(span.id, span);
+        if (this.verbose) {
+            console.log(`[SPAN START] ${name}`, { traceId: span.traceId, spanId: span.id });
+        }
+        return span;
+    }
+    endSpan(span, status = 'ok', error) {
+        span.endTime = Date.now();
+        span.status = status;
+        if (error) {
+            span.attributes.error = error.message;
+            span.attributes.errorStack = error.stack;
+        }
+        const duration = span.endTime - span.startTime;
+        if (this.verbose) {
+            console.log(`[SPAN END] ${span.name}`, {
+                duration: `${duration}ms`,
+                status,
+                ...(error && { error: error.message })
+            });
+        }
+        this.spans.delete(span.id);
+    }
+    addSpanEvent(span, name, attributes) {
+        span.events.push({
+            name,
+            timestamp: Date.now(),
+            attributes
+        });
+        if (this.verbose) {
+            console.log(`[SPAN EVENT] ${span.name} -> ${name}`, attributes);
+        }
+    }
+    log(entry) {
+        const prefix = `[${entry.level.toUpperCase()}]`;
+        const context = entry.traceId ? ` [trace:${entry.traceId.slice(0, 8)}]` : '';
+        switch (entry.level) {
+            case 'debug':
+                console.debug(`${prefix}${context} ${entry.message}`, entry.attributes);
+                break;
+            case 'info':
+                console.info(`${prefix}${context} ${entry.message}`, entry.attributes);
+                break;
+            case 'warn':
+                console.warn(`${prefix}${context} ${entry.message}`, entry.attributes);
+                break;
+            case 'error':
+                console.error(`${prefix}${context} ${entry.message}`, entry.attributes);
+                break;
+        }
+    }
+    recordMetric(metric) {
+        if (this.verbose) {
+            console.log(`[METRIC] ${metric.name}: ${metric.value} (${metric.type})`, metric.tags);
+        }
+    }
+    async flush() {
+        // Console provider doesn't need flushing
+    }
+    async shutdown() {
+        this.spans.clear();
+    }
+}
+exports.ConsoleObservabilityProvider = ConsoleObservabilityProvider;
+/**
+ * Memory-based observability provider for testing
+ */
+class MemoryObservabilityProvider extends BaseObservabilityProvider {
+    constructor() {
+        super('MemoryObservability');
+        this.spans = [];
+        this.logs = [];
+        this.metrics = [];
+    }
+    startSpan(name, attributes, parentContext) {
+        const span = {
+            id: this.generateId(),
+            traceId: parentContext?.traceId || this.generateId(),
+            parentId: parentContext?.spanId,
+            name,
+            startTime: Date.now(),
+            status: 'unset',
+            attributes: attributes || {},
+            events: []
+        };
+        this.spans.push(span);
+        return span;
+    }
+    endSpan(span, status = 'ok', error) {
+        span.endTime = Date.now();
+        span.status = status;
+        if (error) {
+            span.attributes.error = error.message;
+        }
+    }
+    addSpanEvent(span, name, attributes) {
+        span.events.push({ name, timestamp: Date.now(), attributes });
+    }
+    log(entry) {
+        this.logs.push(entry);
+    }
+    recordMetric(metric) {
+        this.metrics.push(metric);
+    }
+    async flush() { }
+    async shutdown() {
+        this.spans = [];
+        this.logs = [];
+        this.metrics = [];
+    }
+    // Helper methods for testing
+    getSpansByName(name) {
+        return this.spans.filter(s => s.name === name);
+    }
+    getLogsByLevel(level) {
+        return this.logs.filter(l => l.level === level);
+    }
+    getMetricsByName(name) {
+        return this.metrics.filter(m => m.name === name);
+    }
+}
+exports.MemoryObservabilityProvider = MemoryObservabilityProvider;
+// Factory functions
+function createConsoleObservability(config) {
+    return new ConsoleObservabilityProvider(config);
+}
+function createMemoryObservability() {
+    return new MemoryObservabilityProvider();
+}

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

@@ -0,0 +1,8 @@
+/**
+ * Observability Integrations
+ * Provides adapters for various observability platforms
+ */
+export * from './base';
+export * from './langfuse';
+export { createConsoleObservability, createMemoryObservability } from './base';
+export { createLangfuseObservability } from './langfuse';

package/dist/integrations/observability/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Observability Integrations
+ * Provides adapters for various observability platforms
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLangfuseObservability = exports.createMemoryObservability = exports.createConsoleObservability = void 0;
+__exportStar(require("./base"), exports);
+__exportStar(require("./langfuse"), exports);
+// Re-export factory functions
+var base_1 = require("./base");
+Object.defineProperty(exports, "createConsoleObservability", { enumerable: true, get: function () { return base_1.createConsoleObservability; } });
+Object.defineProperty(exports, "createMemoryObservability", { enumerable: true, get: function () { return base_1.createMemoryObservability; } });
+var langfuse_1 = require("./langfuse");
+Object.defineProperty(exports, "createLangfuseObservability", { enumerable: true, get: function () { return langfuse_1.createLangfuseObservability; } });

package/dist/integrations/observability/langfuse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Langfuse Observability Integration
+ */
+import { BaseObservabilityProvider, Span, TraceContext, LogEntry, Metric } from './base';
+export interface LangfuseConfig {
+    publicKey: string;
+    secretKey: string;
+    baseUrl?: string;
+    flushAt?: number;
+    flushInterval?: number;
+}
+export declare class LangfuseObservabilityProvider extends BaseObservabilityProvider {
+    private publicKey;
+    private secretKey;
+    private baseUrl;
+    private queue;
+    private flushAt;
+    private flushInterval;
+    private flushTimer?;
+    constructor(config: LangfuseConfig);
+    private startFlushTimer;
+    private request;
+    private enqueue;
+    startSpan(name: string, attributes?: Record<string, any>, parentContext?: TraceContext): Span;
+    endSpan(span: Span, status?: 'ok' | 'error', error?: Error): void;
+    addSpanEvent(span: Span, name: string, attributes?: Record<string, any>): void;
+    log(entry: LogEntry): void;
+    recordMetric(metric: Metric): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export declare function createLangfuseObservability(config: LangfuseConfig): LangfuseObservabilityProvider;