@xynehq/jaf 0.1.2

package/dist/adk/sessions/postgres-provider.js

@@ -0,0 +1,293 @@
+/**
+ * Real PostgreSQL Session Provider Implementation
+ *
+ * This provides a production-ready PostgreSQL-based session provider
+ * with proper connection pooling, transactions, and error handling
+ */
+import { throwSessionError } from '../types.js';
+import { createSession } from './index.js';
+// SQL queries as constants for better maintainability
+const SQL_CREATE_TABLE = `
+  CREATE TABLE IF NOT EXISTS $1 (
+    id VARCHAR(255) PRIMARY KEY,
+    app_name VARCHAR(255) NOT NULL,
+    user_id VARCHAR(255) NOT NULL,
+    messages JSONB NOT NULL DEFAULT '[]',
+    artifacts JSONB NOT NULL DEFAULT '{}',
+    metadata JSONB NOT NULL DEFAULT '{}',
+    created_at TIMESTAMP WITH TIME ZONE NOT NULL,
+    last_accessed_at TIMESTAMP WITH TIME ZONE,
+    CONSTRAINT idx_user_sessions UNIQUE (user_id, id)
+  );
+  CREATE INDEX IF NOT EXISTS idx_user_id ON $1 (user_id);
+  CREATE INDEX IF NOT EXISTS idx_created_at ON $1 (created_at DESC);
+`;
+export const createPostgresSessionProvider = (config) => {
+    let pool;
+    const tableName = config.tableName || 'jaf_sessions';
+    // Require real PostgreSQL - no fallback
+    try {
+        // Dynamic import to avoid breaking if pg not installed
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { Pool } = require('pg');
+        pool = new Pool({
+            connectionString: config.connectionString,
+            max: config.poolSize || 10,
+            idleTimeoutMillis: config.idleTimeoutMillis || 30000,
+            connectionTimeoutMillis: config.connectionTimeoutMillis || 2000,
+        });
+        // Handle pool events
+        pool.on('error', (err, client) => {
+            console.error('[ADK:Sessions] PostgreSQL pool error:', err);
+        });
+        pool.on('connect', (client) => {
+            console.log('[ADK:Sessions] New PostgreSQL client connected');
+        });
+        pool.on('acquire', (client) => {
+            console.log('[ADK:Sessions] PostgreSQL client acquired from pool');
+        });
+        pool.on('remove', (client) => {
+            console.log('[ADK:Sessions] PostgreSQL client removed from pool');
+        });
+        // Initialize table
+        initializeTable().catch(err => {
+            console.error('[ADK:Sessions] Failed to initialize PostgreSQL table:', err);
+        });
+    }
+    catch (error) {
+        throw new Error('PostgreSQL session provider requires pg to be installed. ' +
+            'Please install it with: npm install pg');
+    }
+    // Initialize database table
+    async function initializeTable() {
+        const client = await pool.connect();
+        try {
+            // Use dynamic table name safely
+            const createTableQuery = SQL_CREATE_TABLE.replace(/\$1/g, tableName);
+            await client.query(createTableQuery);
+            console.log(`[ADK:Sessions] PostgreSQL table ${tableName} initialized`);
+        }
+        catch (error) {
+            console.error('[ADK:Sessions] Failed to create table:', error);
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    // Helper to serialize/deserialize sessions
+    const sessionToRow = (session) => {
+        return {
+            id: session.id,
+            app_name: session.appName,
+            user_id: session.userId,
+            messages: JSON.stringify(session.messages),
+            artifacts: JSON.stringify(session.artifacts),
+            metadata: JSON.stringify({
+                ...session.metadata,
+                created: undefined, // Store in created_at column
+                lastAccessed: undefined // Store in last_accessed_at column
+            }),
+            created_at: session.metadata.created,
+            last_accessed_at: session.metadata.lastAccessed || null
+        };
+    };
+    const rowToSession = (row) => {
+        const metadata = typeof row.metadata === 'string'
+            ? JSON.parse(row.metadata)
+            : row.metadata;
+        return {
+            id: row.id,
+            appName: row.app_name,
+            userId: row.user_id,
+            messages: typeof row.messages === 'string'
+                ? JSON.parse(row.messages)
+                : row.messages,
+            artifacts: typeof row.artifacts === 'string'
+                ? JSON.parse(row.artifacts)
+                : row.artifacts,
+            metadata: {
+                ...metadata,
+                created: new Date(row.created_at),
+                lastAccessed: row.last_accessed_at ? new Date(row.last_accessed_at) : undefined
+            }
+        };
+    };
+    // Database operation helpers
+    async function executeQuery(query, params) {
+        const client = await pool.connect();
+        try {
+            const result = await client.query(query, params);
+            return result;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async function executeTransaction(operations) {
+        const client = await pool.connect();
+        try {
+            await client.query('BEGIN');
+            for (const op of operations) {
+                await client.query(op.query, op.params);
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    return {
+        createSession: async (context) => {
+            const session = createSession(context.appName, context.userId, context.sessionId);
+            try {
+                const row = sessionToRow(session);
+                const query = `
+          INSERT INTO ${tableName} 
+          (id, app_name, user_id, messages, artifacts, metadata, created_at, last_accessed_at)
+          VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
+          RETURNING *
+        `;
+                const result = await executeQuery(query, [
+                    row.id,
+                    row.app_name,
+                    row.user_id,
+                    row.messages,
+                    row.artifacts,
+                    row.metadata,
+                    row.created_at,
+                    row.last_accessed_at
+                ]);
+                return rowToSession(result.rows[0]);
+            }
+            catch (error) {
+                throwSessionError(`Failed to create session in PostgreSQL: ${error}`, session.id);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        getSession: async (sessionId) => {
+            try {
+                const query = `
+          UPDATE ${tableName}
+          SET last_accessed_at = CURRENT_TIMESTAMP
+          WHERE id = $1
+          RETURNING *
+        `;
+                const result = await executeQuery(query, [sessionId]);
+                if (result.rows.length === 0) {
+                    return null;
+                }
+                return rowToSession(result.rows[0]);
+            }
+            catch (error) {
+                throwSessionError(`Failed to get session from PostgreSQL: ${error}`, sessionId);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        updateSession: async (session) => {
+            try {
+                session.metadata.lastAccessed = new Date();
+                const row = sessionToRow(session);
+                const query = `
+          UPDATE ${tableName}
+          SET 
+            messages = $2,
+            artifacts = $3,
+            metadata = $4,
+            last_accessed_at = $5
+          WHERE id = $1
+          RETURNING *
+        `;
+                const result = await executeQuery(query, [
+                    session.id,
+                    row.messages,
+                    row.artifacts,
+                    row.metadata,
+                    row.last_accessed_at
+                ]);
+                if (result.rows.length === 0) {
+                    throw new Error('Session not found');
+                }
+                return rowToSession(result.rows[0]);
+            }
+            catch (error) {
+                throwSessionError(`Failed to update session in PostgreSQL: ${error}`, session.id);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        listSessions: async (userId) => {
+            try {
+                const query = `
+          SELECT * FROM ${tableName}
+          WHERE user_id = $1
+          ORDER BY created_at DESC
+        `;
+                const result = await executeQuery(query, [userId]);
+                return result.rows.map(rowToSession);
+            }
+            catch (error) {
+                throwSessionError(`Failed to list sessions from PostgreSQL: ${error}`);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        deleteSession: async (sessionId) => {
+            try {
+                const query = `
+          DELETE FROM ${tableName}
+          WHERE id = $1
+        `;
+                const result = await executeQuery(query, [sessionId]);
+                return result.rowCount > 0;
+            }
+            catch (error) {
+                throwSessionError(`Failed to delete session from PostgreSQL: ${error}`, sessionId);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        }
+    };
+};
+// Additional utility functions
+export const closePostgresPool = async (provider) => {
+    // Access the internal pool if available
+    if (provider._pool && typeof provider._pool.end === 'function') {
+        await provider._pool.end();
+    }
+};
+export const getPoolStats = (provider) => {
+    if (provider._pool) {
+        return {
+            totalCount: provider._pool.totalCount,
+            idleCount: provider._pool.idleCount,
+            waitingCount: provider._pool.waitingCount
+        };
+    }
+    return null;
+};
+// Migration helper for existing data
+export const migrateFromRedisToPostgres = async (redisProvider, postgresProvider, userIds) => {
+    let migrated = 0;
+    const errors = [];
+    for (const userId of userIds) {
+        try {
+            const sessions = await redisProvider.listSessions(userId);
+            for (const session of sessions) {
+                try {
+                    await postgresProvider.updateSession(session);
+                    migrated++;
+                }
+                catch (error) {
+                    errors.push(`Failed to migrate session ${session.id}: ${error}`);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`Failed to list sessions for user ${userId}: ${error}`);
+        }
+    }
+    return { migrated, errors };
+};
+//# sourceMappingURL=postgres-provider.js.map

package/dist/adk/sessions/postgres-provider.js.map

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

package/dist/adk/sessions/redis-provider.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Real Redis Session Provider Implementation
+ *
+ * This provides a production-ready Redis-based session provider
+ * with proper error handling and connection management
+ */
+import { SessionProvider } from '../types.js';
+export interface RedisConfig {
+    host: string;
+    port: number;
+    password?: string;
+    database?: number;
+    keyPrefix?: string;
+    ttl?: number;
+}
+export declare const createRedisSessionProvider: (config: RedisConfig) => SessionProvider;
+export declare const closeRedisConnection: (provider: any) => Promise<void>;
+export declare const pingRedis: (provider: any) => Promise<boolean>;
+//# sourceMappingURL=redis-provider.d.ts.map

package/dist/adk/sessions/redis-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-provider.d.ts","sourceRoot":"","sources":["../../../src/adk/sessions/redis-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EAIhB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,0BAA0B,GAAI,QAAQ,WAAW,KAAG,eA4OhE,CAAC;AAIF,eAAO,MAAM,oBAAoB,GAAU,UAAU,GAAG,KAAG,OAAO,CAAC,IAAI,CAKtE,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,UAAU,GAAG,KAAG,OAAO,CAAC,OAAO,CAU9D,CAAC"}

package/dist/adk/sessions/redis-provider.js

@@ -0,0 +1,237 @@
+/**
+ * Real Redis Session Provider Implementation
+ *
+ * This provides a production-ready Redis-based session provider
+ * with proper error handling and connection management
+ */
+import { throwSessionError } from '../types.js';
+import { createSession } from './index.js';
+export const createRedisSessionProvider = (config) => {
+    let redis;
+    // Require real Redis - no fallback
+    try {
+        // Dynamic import to avoid breaking if ioredis not installed
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const Redis = require('ioredis');
+        redis = new Redis({
+            host: config.host,
+            port: config.port,
+            password: config.password,
+            db: config.database || 0,
+            retryStrategy: (times) => {
+                const delay = Math.min(times * 50, 2000);
+                return delay;
+            },
+            enableOfflineQueue: true,
+            maxRetriesPerRequest: 3,
+            lazyConnect: false,
+            connectTimeout: 10000,
+            commandTimeout: 5000
+        });
+        // Handle connection events
+        redis.on('error', (err) => {
+            console.error('[ADK:Sessions] Redis connection error:', err);
+        });
+        redis.on('connect', () => {
+            console.log('[ADK:Sessions] Connected to Redis');
+        });
+        redis.on('ready', () => {
+            console.log('[ADK:Sessions] Redis ready for commands');
+        });
+        redis.on('close', () => {
+            console.log('[ADK:Sessions] Redis connection closed');
+        });
+        redis.on('reconnecting', (delay) => {
+            console.log(`[ADK:Sessions] Reconnecting to Redis in ${delay}ms`);
+        });
+    }
+    catch (error) {
+        throw new Error('Redis session provider requires ioredis to be installed. ' +
+            'Please install it with: npm install ioredis');
+    }
+    const keyPrefix = config.keyPrefix || 'jaf_adk_session:';
+    const sessionTTL = config.ttl || 86400; // Default 24 hours
+    const getKey = (sessionId) => `${keyPrefix}${sessionId}`;
+    const getUserKey = (userId) => `${keyPrefix}user:${userId}`;
+    // Helper to serialize/deserialize sessions
+    const serializeSession = (session) => {
+        return JSON.stringify(session);
+    };
+    const deserializeSession = (sessionData) => {
+        const session = JSON.parse(sessionData);
+        // Restore Date objects from strings
+        if (session.metadata.created && typeof session.metadata.created === 'string') {
+            session.metadata.created = new Date(session.metadata.created);
+        }
+        if (session.metadata.lastAccessed && typeof session.metadata.lastAccessed === 'string') {
+            session.metadata.lastAccessed = new Date(session.metadata.lastAccessed);
+        }
+        return session;
+    };
+    // Redis operation helpers with proper async handling
+    const redisGet = async (key) => {
+        try {
+            return await redis.get(key);
+        }
+        catch (error) {
+            console.error(`[ADK:Sessions] Redis GET error for key ${key}:`, error);
+            throw error;
+        }
+    };
+    const redisSet = async (key, value, ttlSeconds) => {
+        try {
+            if (ttlSeconds) {
+                await redis.setex(key, ttlSeconds, value);
+            }
+            else {
+                await redis.set(key, value);
+            }
+        }
+        catch (error) {
+            console.error(`[ADK:Sessions] Redis SET error for key ${key}:`, error);
+            throw error;
+        }
+    };
+    // Note: redisDelete, redisSAdd, and redisSRem are used in the deleteSession method
+    // which uses the redis.multi() approach for atomic operations
+    const redisSMembers = async (key) => {
+        try {
+            return await redis.smembers(key);
+        }
+        catch (error) {
+            console.error(`[ADK:Sessions] Redis SMEMBERS error for key ${key}:`, error);
+            throw error;
+        }
+    };
+    // Multi/Pipeline operations for performance
+    const redisMulti = () => {
+        return redis.multi();
+    };
+    return {
+        createSession: async (context) => {
+            const session = createSession(context.appName, context.userId, context.sessionId);
+            try {
+                // Use multi for atomic operations
+                const multi = redisMulti();
+                multi.setex(getKey(session.id), sessionTTL, serializeSession(session));
+                multi.sadd(getUserKey(context.userId), session.id);
+                await multi.exec();
+                return session;
+            }
+            catch (error) {
+                throwSessionError(`Failed to create session in Redis: ${error}`, session.id);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        getSession: async (sessionId) => {
+            try {
+                const sessionData = await redisGet(getKey(sessionId));
+                if (!sessionData) {
+                    return null;
+                }
+                const session = deserializeSession(sessionData);
+                // Update last accessed time and refresh TTL
+                session.metadata.lastAccessed = new Date();
+                await redisSet(getKey(sessionId), serializeSession(session), sessionTTL);
+                return session;
+            }
+            catch (error) {
+                throwSessionError(`Failed to get session from Redis: ${error}`, sessionId);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        updateSession: async (session) => {
+            try {
+                session.metadata.lastAccessed = new Date();
+                await redisSet(getKey(session.id), serializeSession(session), sessionTTL);
+                return session;
+            }
+            catch (error) {
+                throwSessionError(`Failed to update session in Redis: ${error}`, session.id);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        listSessions: async (userId) => {
+            try {
+                const userKey = getUserKey(userId);
+                const sessionIds = await redisSMembers(userKey);
+                if (sessionIds.length === 0) {
+                    return [];
+                }
+                const sessions = [];
+                const deadSessionIds = [];
+                // Retrieve all sessions for user
+                for (const sessionId of sessionIds) {
+                    const sessionData = await redisGet(getKey(sessionId));
+                    if (sessionData) {
+                        try {
+                            sessions.push(deserializeSession(sessionData));
+                        }
+                        catch (error) {
+                            // Skip invalid sessions
+                            console.warn(`[ADK:Sessions] Skipping invalid session ${sessionId}:`, error);
+                            deadSessionIds.push(sessionId);
+                        }
+                    }
+                    else {
+                        // Session expired or deleted
+                        deadSessionIds.push(sessionId);
+                    }
+                }
+                // Clean up dead session references
+                if (deadSessionIds.length > 0) {
+                    const multi = redis.multi();
+                    for (const deadId of deadSessionIds) {
+                        multi.srem(userKey, deadId);
+                    }
+                    await multi.exec();
+                }
+                // Sort by creation date (newest first)
+                return sessions.sort((a, b) => b.metadata.created.getTime() - a.metadata.created.getTime());
+            }
+            catch (error) {
+                throwSessionError(`Failed to list sessions from Redis: ${error}`);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        },
+        deleteSession: async (sessionId) => {
+            try {
+                const sessionData = await redisGet(getKey(sessionId));
+                if (!sessionData) {
+                    return false;
+                }
+                const session = deserializeSession(sessionData);
+                // Use multi for atomic deletion
+                const multi = redis.multi();
+                multi.del(getKey(sessionId));
+                multi.srem(getUserKey(session.userId), sessionId);
+                const results = await multi.exec();
+                return results?.[0]?.[1] === 1;
+            }
+            catch (error) {
+                throwSessionError(`Failed to delete session from Redis: ${error}`, sessionId);
+                throw error; // TypeScript needs this even though throwSessionError never returns
+            }
+        }
+    };
+};
+// Additional utility functions
+export const closeRedisConnection = async (provider) => {
+    // Access the internal redis client if available
+    if (provider._redis && typeof provider._redis.disconnect === 'function') {
+        await provider._redis.disconnect();
+    }
+};
+export const pingRedis = async (provider) => {
+    try {
+        if (provider._redis && typeof provider._redis.ping === 'function') {
+            const result = await provider._redis.ping();
+            return result === 'PONG';
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=redis-provider.js.map

package/dist/adk/sessions/redis-provider.js.map

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

package/dist/adk/streaming/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * JAF ADK Layer - Streaming System
+ *
+ * Functional streaming and live interaction utilities
+ */
+import { LiveRequestQueue, Content, AgentEvent, AgentEventType, StreamConfig, ResponseModality, FunctionCall, FunctionResponse } from '../types';
+export declare const createLiveRequestQueue: () => LiveRequestQueue;
+export declare const createAgentEvent: (type: AgentEventType, data?: {
+    content?: Content;
+    functionCall?: FunctionCall;
+    functionResponse?: FunctionResponse;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}) => AgentEvent;
+export declare const createMessageStartEvent: (content?: Content) => AgentEvent;
+export declare const createMessageDeltaEvent: (content: Content) => AgentEvent;
+export declare const createMessageCompleteEvent: (content?: Content) => AgentEvent;
+export declare const createFunctionCallStartEvent: (functionCall: FunctionCall) => AgentEvent;
+export declare const createFunctionCallCompleteEvent: (functionResponse: FunctionResponse) => AgentEvent;
+export declare const createAgentTransferEvent: (targetAgent: string, metadata?: Record<string, unknown>) => AgentEvent;
+export declare const createConversationEndEvent: (metadata?: Record<string, unknown>) => AgentEvent;
+export declare const createErrorEvent: (error: string, metadata?: Record<string, unknown>) => AgentEvent;
+export declare const streamToQueue: (stream: AsyncGenerator<AgentEvent>, queue: LiveRequestQueue) => Promise<void>;
+export declare const queueToStream: (queue: LiveRequestQueue) => AsyncGenerator<AgentEvent>;
+export declare const combineStreams: (...streams: AsyncGenerator<AgentEvent>[]) => AsyncGenerator<AgentEvent>;
+export declare const filterEventStream: (stream: AsyncGenerator<AgentEvent>, predicate: (event: AgentEvent) => boolean) => AsyncGenerator<AgentEvent>;
+export declare const mapEventStream: <T>(stream: AsyncGenerator<AgentEvent>, mapper: (event: AgentEvent) => T) => AsyncGenerator<T>;
+export declare const createStreamConfig: (responseModalities?: ResponseModality[], options?: {
+    bufferSize?: number;
+    timeout?: number;
+}) => StreamConfig;
+export declare const createTextStreamConfig: () => StreamConfig;
+export declare const createAudioStreamConfig: () => StreamConfig;
+export declare const createMultiModalStreamConfig: () => StreamConfig;
+export declare const createBufferedStream: (stream: AsyncGenerator<AgentEvent>, bufferSize?: number) => AsyncGenerator<AgentEvent[]>;
+export declare const createThrottledStream: (stream: AsyncGenerator<AgentEvent>, intervalMs?: number) => AsyncGenerator<AgentEvent>;
+export declare const createDebouncedStream: (stream: AsyncGenerator<AgentEvent>, delayMs?: number) => AsyncGenerator<AgentEvent>;
+export declare const collectEvents: (stream: AsyncGenerator<AgentEvent>, predicate?: (event: AgentEvent) => boolean) => Promise<AgentEvent[]>;
+export declare const findFirstEvent: (stream: AsyncGenerator<AgentEvent>, predicate: (event: AgentEvent) => boolean) => Promise<AgentEvent | null>;
+export declare const waitForEvent: (stream: AsyncGenerator<AgentEvent>, type: AgentEventType, timeout?: number) => Promise<AgentEvent | null>;
+export declare const countEvents: (stream: AsyncGenerator<AgentEvent>, predicate?: (event: AgentEvent) => boolean) => Promise<number>;
+export declare const isMessageEvent: (event: AgentEvent) => boolean;
+export declare const isFunctionEvent: (event: AgentEvent) => boolean;
+export declare const isControlEvent: (event: AgentEvent) => boolean;
+export declare const isErrorEvent: (event: AgentEvent) => boolean;
+export declare const filterMessageEvents: (stream: AsyncGenerator<AgentEvent>) => AsyncGenerator<AgentEvent, any, any>;
+export declare const filterFunctionEvents: (stream: AsyncGenerator<AgentEvent>) => AsyncGenerator<AgentEvent, any, any>;
+export declare const filterControlEvents: (stream: AsyncGenerator<AgentEvent>) => AsyncGenerator<AgentEvent, any, any>;
+export declare const filterErrorEvents: (stream: AsyncGenerator<AgentEvent>) => AsyncGenerator<AgentEvent, any, any>;
+export declare const monitorStream: (stream: AsyncGenerator<AgentEvent>, monitor: (event: AgentEvent) => void) => AsyncGenerator<AgentEvent>;
+export declare const logStream: (prefix?: string) => (event: AgentEvent) => void;
+export declare const metricsMonitor: () => {
+    monitor: (event: AgentEvent) => void;
+    getMetrics: () => {
+        duration: number;
+        eventsPerSecond: number;
+        eventCount: number;
+        eventsByType: Record<AgentEventType, number>;
+        errors: number;
+        startTime: number;
+        firstEventTime: number | null;
+        lastEventTime: number | null;
+    };
+};
+export declare const withStreamErrorHandling: (stream: AsyncGenerator<AgentEvent>, errorHandler?: (error: Error) => AgentEvent | null) => AsyncGenerator<AgentEvent>;
+export declare const retryStream: (streamFactory: () => AsyncGenerator<AgentEvent>, maxRetries?: number, delayMs?: number) => AsyncGenerator<AgentEvent>;
+export interface BidirectionalStream {
+    send: (message: Content) => Promise<void>;
+    receive: () => AsyncGenerator<AgentEvent>;
+    close: () => void;
+}
+export declare const createBidirectionalStream: () => BidirectionalStream;
+export declare const streamToArray: <T>(stream: AsyncGenerator<T>) => Promise<T[]>;
+export declare const takeFromStream: <T>(stream: AsyncGenerator<T>, count: number) => AsyncGenerator<T>;
+export declare const skipFromStream: <T>(stream: AsyncGenerator<T>, count: number) => AsyncGenerator<T>;
+//# sourceMappingURL=index.d.ts.map