agentic-flow 1.10.1 → 1.10.2

package/dist/federation/SecurityManager.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Security Manager - Authentication, encryption, and access control
+ *
+ * Features:
+ * - JWT token generation and validation
+ * - AES-256 encryption for data at rest
+ * - Tenant isolation
+ * - mTLS certificate management
+ */
+export interface AgentTokenPayload {
+    agentId: string;
+    tenantId: string;
+    expiresAt: number;
+}
+export interface EncryptionKeys {
+    encryptionKey: Buffer;
+    iv: Buffer;
+}
+export declare class SecurityManager {
+    private readonly algorithm;
+    private readonly jwtSecret;
+    private encryptionCache;
+    constructor();
+    /**
+     * Create JWT token for agent authentication
+     */
+    createAgentToken(payload: AgentTokenPayload): Promise<string>;
+    /**
+     * Verify JWT token
+     */
+    verifyAgentToken(token: string): Promise<AgentTokenPayload>;
+    /**
+     * Get or create encryption keys for a tenant
+     */
+    getEncryptionKeys(tenantId: string): Promise<EncryptionKeys>;
+    /**
+     * Encrypt data with AES-256-GCM
+     */
+    encrypt(data: string, tenantId: string): Promise<{
+        encrypted: string;
+        authTag: string;
+    }>;
+    /**
+     * Decrypt data with AES-256-GCM
+     */
+    decrypt(encrypted: string, authTag: string, tenantId: string): Promise<string>;
+    /**
+     * Generate mTLS certificates for agent-to-hub communication
+     */
+    generateMTLSCertificates(agentId: string): Promise<{
+        cert: string;
+        key: string;
+        ca: string;
+    }>;
+    /**
+     * Validate tenant access to data
+     */
+    validateTenantAccess(requestTenantId: string, dataTenantId: string): boolean;
+    /**
+     * Hash sensitive data for storage (one-way)
+     */
+    hashData(data: string): string;
+    /**
+     * Generate secure random ID
+     */
+    generateSecureId(): string;
+    /**
+     * Base64 URL-safe encoding
+     */
+    private base64UrlEncode;
+    /**
+     * Base64 URL-safe decoding
+     */
+    private base64UrlDecode;
+    /**
+     * Clear cached keys (for testing or security refresh)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=SecurityManager.d.ts.map

package/dist/federation/SecurityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityManager.d.ts","sourceRoot":"","sources":["../../src/federation/SecurityManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,eAAe,CAA0C;;IAOjE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmCnE;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkCjE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBlE;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB9F;;OAEG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAiBlB;;OAEG;IACG,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QACvD,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IAaF;;OAEG;IACH,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAW5E;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/dist/federation/SecurityManager.js

@@ -189,3 +189,4 @@ export class SecurityManager {
         logger.info('Encryption cache cleared');
     }
 }
+//# sourceMappingURL=SecurityManager.js.map

package/dist/federation/SecurityManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityManager.js","sourceRoot":"","sources":["../../src/federation/SecurityManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Security Manager - Authentication, encryption, and access control\n *\n * Features:\n * - JWT token generation and validation\n * - AES-256 encryption for data at rest\n * - Tenant isolation\n * - mTLS certificate management\n */\n\nimport crypto from 'crypto';\nimport { logger } from '../utils/logger.js';\n\nexport interface AgentTokenPayload {\n  agentId: string;\n  tenantId: string;\n  expiresAt: number;\n}\n\nexport interface EncryptionKeys {\n  encryptionKey: Buffer;\n  iv: Buffer;\n}\n\nexport class SecurityManager {\n  private readonly algorithm = 'aes-256-gcm';\n  private readonly jwtSecret: string;\n  private encryptionCache: Map<string, EncryptionKeys> = new Map();\n\n  constructor() {\n    // In production, load from secure vault (AWS Secrets Manager, HashiCorp Vault, etc.)\n    this.jwtSecret = process.env.JWT_SECRET || crypto.randomBytes(32).toString('hex');\n  }\n\n  /**\n   * Create JWT token for agent authentication\n   */\n  async createAgentToken(payload: AgentTokenPayload): Promise<string> {\n    const header = {\n      alg: 'HS256',\n      typ: 'JWT'\n    };\n\n    const now = Date.now();\n    const tokenPayload = {\n      ...payload,\n      iat: now,\n      exp: payload.expiresAt,\n      iss: 'agentic-flow-federation'\n    };\n\n    // Encode header and payload\n    const encodedHeader = this.base64UrlEncode(JSON.stringify(header));\n    const encodedPayload = this.base64UrlEncode(JSON.stringify(tokenPayload));\n\n    // Create signature\n    const signature = crypto\n      .createHmac('sha256', this.jwtSecret)\n      .update(`${encodedHeader}.${encodedPayload}`)\n      .digest('base64url');\n\n    const token = `${encodedHeader}.${encodedPayload}.${signature}`;\n\n    logger.info('Created agent token', {\n      agentId: payload.agentId,\n      tenantId: payload.tenantId,\n      expiresAt: new Date(payload.expiresAt).toISOString()\n    });\n\n    return token;\n  }\n\n  /**\n   * Verify JWT token\n   */\n  async verifyAgentToken(token: string): Promise<AgentTokenPayload> {\n    const parts = token.split('.');\n    if (parts.length !== 3) {\n      throw new Error('Invalid token format');\n    }\n\n    const [encodedHeader, encodedPayload, signature] = parts;\n\n    // Verify signature\n    const expectedSignature = crypto\n      .createHmac('sha256', this.jwtSecret)\n      .update(`${encodedHeader}.${encodedPayload}`)\n      .digest('base64url');\n\n    if (signature !== expectedSignature) {\n      throw new Error('Invalid token signature');\n    }\n\n    // Decode payload\n    const payload = JSON.parse(this.base64UrlDecode(encodedPayload));\n\n    // Check expiration\n    if (Date.now() >= payload.exp) {\n      throw new Error('Token expired');\n    }\n\n    logger.debug('Token verified', {\n      agentId: payload.agentId,\n      tenantId: payload.tenantId\n    });\n\n    return payload;\n  }\n\n  /**\n   * Get or create encryption keys for a tenant\n   */\n  async getEncryptionKeys(tenantId: string): Promise<EncryptionKeys> {\n    // Check cache\n    if (this.encryptionCache.has(tenantId)) {\n      return this.encryptionCache.get(tenantId)!;\n    }\n\n    // Generate new keys for tenant\n    // In production, these would be stored in a secure key management service\n    const encryptionKey = crypto.randomBytes(32); // 256-bit key\n    const iv = crypto.randomBytes(16); // 128-bit IV\n\n    const keys: EncryptionKeys = { encryptionKey, iv };\n\n    // Cache keys\n    this.encryptionCache.set(tenantId, keys);\n\n    logger.info('Generated encryption keys for tenant', { tenantId });\n\n    return keys;\n  }\n\n  /**\n   * Encrypt data with AES-256-GCM\n   */\n  async encrypt(data: string, tenantId: string): Promise<{ encrypted: string; authTag: string }> {\n    const keys = await this.getEncryptionKeys(tenantId);\n\n    const cipher = crypto.createCipheriv(this.algorithm, keys.encryptionKey, keys.iv);\n\n    let encrypted = cipher.update(data, 'utf8', 'base64');\n    encrypted += cipher.final('base64');\n\n    const authTag = cipher.getAuthTag().toString('base64');\n\n    logger.debug('Data encrypted', {\n      tenantId,\n      originalLength: data.length,\n      encryptedLength: encrypted.length\n    });\n\n    return { encrypted, authTag };\n  }\n\n  /**\n   * Decrypt data with AES-256-GCM\n   */\n  async decrypt(\n    encrypted: string,\n    authTag: string,\n    tenantId: string\n  ): Promise<string> {\n    const keys = await this.getEncryptionKeys(tenantId);\n\n    const decipher = crypto.createDecipheriv(this.algorithm, keys.encryptionKey, keys.iv);\n    decipher.setAuthTag(Buffer.from(authTag, 'base64'));\n\n    let decrypted = decipher.update(encrypted, 'base64', 'utf8');\n    decrypted += decipher.final('utf8');\n\n    logger.debug('Data decrypted', {\n      tenantId,\n      decryptedLength: decrypted.length\n    });\n\n    return decrypted;\n  }\n\n  /**\n   * Generate mTLS certificates for agent-to-hub communication\n   */\n  async generateMTLSCertificates(agentId: string): Promise<{\n    cert: string;\n    key: string;\n    ca: string;\n  }> {\n    // Placeholder: Actual implementation would use OpenSSL or similar\n    // to generate X.509 certificates with proper CA chain\n\n    logger.info('Generating mTLS certificates', { agentId });\n\n    return {\n      cert: 'PLACEHOLDER_CERT',\n      key: 'PLACEHOLDER_KEY',\n      ca: 'PLACEHOLDER_CA'\n    };\n  }\n\n  /**\n   * Validate tenant access to data\n   */\n  validateTenantAccess(requestTenantId: string, dataTenantId: string): boolean {\n    if (requestTenantId !== dataTenantId) {\n      logger.warn('Tenant access violation detected', {\n        requestTenantId,\n        dataTenantId\n      });\n      return false;\n    }\n    return true;\n  }\n\n  /**\n   * Hash sensitive data for storage (one-way)\n   */\n  hashData(data: string): string {\n    return crypto.createHash('sha256').update(data).digest('hex');\n  }\n\n  /**\n   * Generate secure random ID\n   */\n  generateSecureId(): string {\n    return crypto.randomBytes(16).toString('hex');\n  }\n\n  /**\n   * Base64 URL-safe encoding\n   */\n  private base64UrlEncode(str: string): string {\n    return Buffer.from(str)\n      .toString('base64')\n      .replace(/\\+/g, '-')\n      .replace(/\\//g, '_')\n      .replace(/=/g, '');\n  }\n\n  /**\n   * Base64 URL-safe decoding\n   */\n  private base64UrlDecode(str: string): string {\n    const base64 = str.replace(/-/g, '+').replace(/_/g, '/');\n    return Buffer.from(base64, 'base64').toString('utf8');\n  }\n\n  /**\n   * Clear cached keys (for testing or security refresh)\n   */\n  clearCache(): void {\n    this.encryptionCache.clear();\n    logger.info('Encryption cache cleared');\n  }\n}\n"]}

package/dist/federation/debug/agent-debug-stream.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Single Agent Debug Streaming
+ *
+ * Provides detailed visibility into a single agent's operations,
+ * lifecycle, and internal state changes.
+ *
+ * Features:
+ * - Agent lifecycle tracking (spawn → work → shutdown)
+ * - Task execution tracing
+ * - Memory operations
+ * - Communication events
+ * - Decision logging
+ * - State transitions
+ * - Performance metrics
+ * - Timeline visualization
+ */
+import { EventEmitter } from 'events';
+import { DebugLevel } from './debug-stream.js';
+export { DebugLevel } from './debug-stream.js';
+export interface AgentDebugConfig {
+    agentId: string;
+    tenantId?: string;
+    level?: DebugLevel;
+    format?: 'human' | 'json' | 'compact' | 'timeline';
+    output?: 'console' | 'file' | 'both';
+    outputFile?: string;
+    colorize?: boolean;
+    trackState?: boolean;
+    trackDecisions?: boolean;
+    trackCommunication?: boolean;
+    timeline?: boolean;
+}
+export interface AgentState {
+    phase: 'spawning' | 'initializing' | 'ready' | 'working' | 'idle' | 'shutting_down' | 'dead';
+    task?: string;
+    taskId?: string;
+    startTime: string;
+    lastActivity?: string;
+    metadata?: Record<string, any>;
+}
+export interface AgentDecision {
+    timestamp: string;
+    context: string;
+    options: any[];
+    selected: any;
+    reasoning?: string;
+    confidence?: number;
+}
+export interface AgentTask {
+    taskId: string;
+    description: string;
+    startTime: string;
+    endTime?: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    steps: AgentTaskStep[];
+    result?: any;
+    error?: Error;
+}
+export interface AgentTaskStep {
+    step: number;
+    operation: string;
+    startTime: string;
+    endTime?: string;
+    duration?: number;
+    data?: any;
+    error?: Error;
+}
+export declare class AgentDebugStream extends EventEmitter {
+    private config;
+    private debug;
+    private state;
+    private decisions;
+    private tasks;
+    private communications;
+    private timeline;
+    private performanceMetrics;
+    constructor(config: AgentDebugConfig);
+    /**
+     * Log agent lifecycle phase change
+     */
+    logAgentPhase(phase: AgentState['phase'], data?: any): void;
+    /**
+     * Log agent initialization
+     */
+    logInitialization(config: any): void;
+    /**
+     * Log agent ready
+     */
+    logReady(capabilities?: any): void;
+    /**
+     * Start tracking a task
+     */
+    startTask(taskId: string, description: string, data?: any): void;
+    /**
+     * Log task step
+     */
+    logTaskStep(taskId: string, step: number, operation: string, data?: any): void;
+    /**
+     * Complete task step
+     */
+    completeTaskStep(taskId: string, step: number, duration: number, data?: any): void;
+    /**
+     * Complete task
+     */
+    completeTask(taskId: string, result?: any): void;
+    /**
+     * Fail task
+     */
+    failTask(taskId: string, error: Error): void;
+    /**
+     * Log a decision
+     */
+    logDecision(context: string, options: any[], selected: any, reasoning?: string, confidence?: number): void;
+    /**
+     * Log communication
+     */
+    logCommunication(type: 'send' | 'receive', target: string, message: any): void;
+    /**
+     * Log memory operation
+     */
+    logMemoryOperation(operation: 'store' | 'retrieve' | 'search', data: any, duration?: number): void;
+    /**
+     * Log thought/reasoning
+     */
+    logThought(thought: string, context?: any): void;
+    /**
+     * Log agent shutdown
+     */
+    logShutdown(reason?: string): void;
+    /**
+     * Track performance metric
+     */
+    private trackPerformance;
+    /**
+     * Print agent summary
+     */
+    printSummary(): void;
+    /**
+     * Print timeline
+     */
+    printTimeline(): void;
+    /**
+     * Get current state
+     */
+    getState(): AgentState;
+    /**
+     * Get task history
+     */
+    getTasks(): AgentTask[];
+    /**
+     * Get decisions
+     */
+    getDecisions(): AgentDecision[];
+    /**
+     * Get communications
+     */
+    getCommunications(): any[];
+    /**
+     * Close debug stream
+     */
+    close(): void;
+}
+/**
+ * Create agent debug stream
+ */
+export declare function createAgentDebugStream(config: AgentDebugConfig): AgentDebugStream;
+/**
+ * Create from environment variables
+ */
+export declare function createAgentDebugStreamFromEnv(agentId: string, tenantId?: string): AgentDebugStream;
+//# sourceMappingURL=agent-debug-stream.d.ts.map

package/dist/federation/debug/agent-debug-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-debug-stream.d.ts","sourceRoot":"","sources":["../../../src/federation/debug/agent-debug-stream.ts"],"names":[],"mappings":"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"}

package/dist/federation/debug/agent-debug-stream.js

@@ -472,3 +472,4 @@ export function createAgentDebugStreamFromEnv(agentId, tenantId) {
         timeline: process.env.DEBUG_TIMELINE === 'true',
     });
 }
+//# sourceMappingURL=agent-debug-stream.js.map

package/dist/federation/debug/agent-debug-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-debug-stream.js","sourceRoot":"","sources":["../../../src/federation/debug/agent-debug-stream.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Single Agent Debug Streaming\n *\n * Provides detailed visibility into a single agent's operations,\n * lifecycle, and internal state changes.\n *\n * Features:\n * - Agent lifecycle tracking (spawn → work → shutdown)\n * - Task execution tracing\n * - Memory operations\n * - Communication events\n * - Decision logging\n * - State transitions\n * - Performance metrics\n * - Timeline visualization\n */\n\nimport { EventEmitter } from 'events';\nimport { DebugStream, DebugLevel, createDebugStream } from './debug-stream.js';\n\n// Re-export DebugLevel for convenience\nexport { DebugLevel } from './debug-stream.js';\n\nexport interface AgentDebugConfig {\n  agentId: string;\n  tenantId?: string;\n  level?: DebugLevel;\n  format?: 'human' | 'json' | 'compact' | 'timeline';\n  output?: 'console' | 'file' | 'both';\n  outputFile?: string;\n  colorize?: boolean;\n  trackState?: boolean;\n  trackDecisions?: boolean;\n  trackCommunication?: boolean;\n  timeline?: boolean;\n}\n\nexport interface AgentState {\n  phase: 'spawning' | 'initializing' | 'ready' | 'working' | 'idle' | 'shutting_down' | 'dead';\n  task?: string;\n  taskId?: string;\n  startTime: string;\n  lastActivity?: string;\n  metadata?: Record<string, any>;\n}\n\nexport interface AgentDecision {\n  timestamp: string;\n  context: string;\n  options: any[];\n  selected: any;\n  reasoning?: string;\n  confidence?: number;\n}\n\nexport interface AgentTask {\n  taskId: string;\n  description: string;\n  startTime: string;\n  endTime?: string;\n  status: 'pending' | 'running' | 'completed' | 'failed';\n  steps: AgentTaskStep[];\n  result?: any;\n  error?: Error;\n}\n\nexport interface AgentTaskStep {\n  step: number;\n  operation: string;\n  startTime: string;\n  endTime?: string;\n  duration?: number;\n  data?: any;\n  error?: Error;\n}\n\nexport class AgentDebugStream extends EventEmitter {\n  private config: AgentDebugConfig;\n  private debug: DebugStream;\n  private state: AgentState;\n  private decisions: AgentDecision[] = [];\n  private tasks: Map<string, AgentTask> = new Map();\n  private communications: any[] = [];\n  private timeline: any[] = [];\n  private performanceMetrics: Map<string, number[]> = new Map();\n\n  constructor(config: AgentDebugConfig) {\n    super();\n    this.config = config;\n\n    // Initialize base debug stream\n    this.debug = createDebugStream({\n      level: config.level ?? DebugLevel.VERBOSE,\n      format: config.format === 'timeline' ? 'human' : config.format,\n      output: config.output ?? 'console',\n      outputFile: config.outputFile,\n      colorize: config.colorize ?? true,\n    });\n\n    // Initialize state\n    this.state = {\n      phase: 'spawning',\n      startTime: new Date().toISOString(),\n      metadata: {},\n    };\n\n    this.logAgentPhase('spawning', { agentId: config.agentId });\n  }\n\n  /**\n   * Log agent lifecycle phase change\n   */\n  logAgentPhase(phase: AgentState['phase'], data?: any): void {\n    const oldPhase = this.state.phase;\n    this.state.phase = phase;\n    this.state.lastActivity = new Date().toISOString();\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'agent_lifecycle',\n      operation: `phase_${phase}`,\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        old_phase: oldPhase,\n        new_phase: phase,\n        ...data,\n      },\n    });\n\n    if (this.config.timeline) {\n      this.timeline.push({\n        timestamp: new Date().toISOString(),\n        type: 'phase_change',\n        from: oldPhase,\n        to: phase,\n        data,\n      });\n    }\n\n    this.emit('phase_change', { from: oldPhase, to: phase, data });\n  }\n\n  /**\n   * Log agent initialization\n   */\n  logInitialization(config: any): void {\n    this.logAgentPhase('initializing', { config });\n\n    this.debug.log({\n      level: DebugLevel.DETAILED,\n      category: 'agent_lifecycle',\n      operation: 'initialize',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: config,\n    });\n  }\n\n  /**\n   * Log agent ready\n   */\n  logReady(capabilities?: any): void {\n    this.logAgentPhase('ready', { capabilities });\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'agent_lifecycle',\n      operation: 'ready',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: { capabilities },\n    });\n  }\n\n  /**\n   * Start tracking a task\n   */\n  startTask(taskId: string, description: string, data?: any): void {\n    const task: AgentTask = {\n      taskId,\n      description,\n      startTime: new Date().toISOString(),\n      status: 'running',\n      steps: [],\n    };\n\n    this.tasks.set(taskId, task);\n    this.state.task = description;\n    this.state.taskId = taskId;\n\n    this.logAgentPhase('working', { taskId, description });\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task',\n      operation: 'task_start',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: { taskId, description, ...data },\n    });\n\n    if (this.config.timeline) {\n      this.timeline.push({\n        timestamp: new Date().toISOString(),\n        type: 'task_start',\n        taskId,\n        description,\n      });\n    }\n  }\n\n  /**\n   * Log task step\n   */\n  logTaskStep(taskId: string, step: number, operation: string, data?: any): void {\n    const task = this.tasks.get(taskId);\n    if (!task) return;\n\n    const stepData: AgentTaskStep = {\n      step,\n      operation,\n      startTime: new Date().toISOString(),\n      data,\n    };\n\n    task.steps.push(stepData);\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task_step',\n      operation,\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        step,\n        operation,\n        ...data,\n      },\n    });\n  }\n\n  /**\n   * Complete task step\n   */\n  completeTaskStep(taskId: string, step: number, duration: number, data?: any): void {\n    const task = this.tasks.get(taskId);\n    if (!task || !task.steps[step]) return;\n\n    task.steps[step].endTime = new Date().toISOString();\n    task.steps[step].duration = duration;\n    task.steps[step].data = { ...task.steps[step].data, ...data };\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task_step',\n      operation: 'step_complete',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        step,\n        duration,\n        ...data,\n      },\n    });\n\n    // Track performance\n    this.trackPerformance(`step_${task.steps[step].operation}`, duration);\n  }\n\n  /**\n   * Complete task\n   */\n  completeTask(taskId: string, result?: any): void {\n    const task = this.tasks.get(taskId);\n    if (!task) return;\n\n    task.endTime = new Date().toISOString();\n    task.status = 'completed';\n    task.result = result;\n\n    const duration = new Date(task.endTime).getTime() - new Date(task.startTime).getTime();\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task',\n      operation: 'task_complete',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        duration,\n        steps: task.steps.length,\n        result,\n      },\n    });\n\n    if (this.config.timeline) {\n      this.timeline.push({\n        timestamp: new Date().toISOString(),\n        type: 'task_complete',\n        taskId,\n        duration,\n      });\n    }\n\n    this.trackPerformance('task_completion', duration);\n    this.state.task = undefined;\n    this.state.taskId = undefined;\n    this.logAgentPhase('idle');\n  }\n\n  /**\n   * Fail task\n   */\n  failTask(taskId: string, error: Error): void {\n    const task = this.tasks.get(taskId);\n    if (!task) return;\n\n    task.endTime = new Date().toISOString();\n    task.status = 'failed';\n    task.error = error;\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'task',\n      operation: 'task_failed',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        taskId,\n        error: error.message,\n      },\n      error,\n    });\n\n    this.state.task = undefined;\n    this.state.taskId = undefined;\n    this.logAgentPhase('idle');\n  }\n\n  /**\n   * Log a decision\n   */\n  logDecision(context: string, options: any[], selected: any, reasoning?: string, confidence?: number): void {\n    if (!this.config.trackDecisions) return;\n\n    const decision: AgentDecision = {\n      timestamp: new Date().toISOString(),\n      context,\n      options,\n      selected,\n      reasoning,\n      confidence,\n    };\n\n    this.decisions.push(decision);\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'decision',\n      operation: 'decision_made',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        context,\n        options_count: options.length,\n        selected,\n        reasoning,\n        confidence,\n      },\n    });\n\n    this.emit('decision', decision);\n  }\n\n  /**\n   * Log communication\n   */\n  logCommunication(type: 'send' | 'receive', target: string, message: any): void {\n    if (!this.config.trackCommunication) return;\n\n    const comm = {\n      timestamp: new Date().toISOString(),\n      type,\n      target,\n      message,\n    };\n\n    this.communications.push(comm);\n\n    this.debug.log({\n      level: DebugLevel.VERBOSE,\n      category: 'communication',\n      operation: type === 'send' ? 'message_sent' : 'message_received',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        target,\n        message_type: typeof message === 'object' ? message.type : 'unknown',\n        size: JSON.stringify(message).length,\n      },\n    });\n\n    this.emit('communication', comm);\n  }\n\n  /**\n   * Log memory operation\n   */\n  logMemoryOperation(operation: 'store' | 'retrieve' | 'search', data: any, duration?: number): void {\n    this.debug.logMemory(\n      operation,\n      this.config.agentId,\n      this.config.tenantId,\n      data,\n      duration\n    );\n\n    if (duration) {\n      this.trackPerformance(`memory_${operation}`, duration);\n    }\n  }\n\n  /**\n   * Log thought/reasoning\n   */\n  logThought(thought: string, context?: any): void {\n    this.debug.log({\n      level: DebugLevel.TRACE,\n      category: 'reasoning',\n      operation: 'thought',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        thought,\n        context,\n      },\n    });\n  }\n\n  /**\n   * Log agent shutdown\n   */\n  logShutdown(reason?: string): void {\n    this.logAgentPhase('shutting_down', { reason });\n\n    const uptime = new Date().getTime() - new Date(this.state.startTime).getTime();\n\n    this.debug.log({\n      level: DebugLevel.BASIC,\n      category: 'agent_lifecycle',\n      operation: 'shutdown',\n      agentId: this.config.agentId,\n      tenantId: this.config.tenantId,\n      data: {\n        reason,\n        uptime_ms: uptime,\n        total_tasks: this.tasks.size,\n        total_decisions: this.decisions.length,\n        total_communications: this.communications.length,\n      },\n    });\n\n    // Print final summary\n    this.printSummary();\n\n    this.logAgentPhase('dead');\n  }\n\n  /**\n   * Track performance metric\n   */\n  private trackPerformance(operation: string, duration: number): void {\n    if (!this.performanceMetrics.has(operation)) {\n      this.performanceMetrics.set(operation, []);\n    }\n    this.performanceMetrics.get(operation)!.push(duration);\n  }\n\n  /**\n   * Print agent summary\n   */\n  printSummary(): void {\n    const uptime = new Date().getTime() - new Date(this.state.startTime).getTime();\n\n    console.log('\\n' + '='.repeat(60));\n    console.log(`📊 Agent Summary: ${this.config.agentId}`);\n    console.log('='.repeat(60));\n    console.log('');\n    console.log(`Uptime:          ${(uptime / 1000).toFixed(2)}s`);\n    console.log(`Tasks Completed: ${Array.from(this.tasks.values()).filter(t => t.status === 'completed').length}`);\n    console.log(`Tasks Failed:    ${Array.from(this.tasks.values()).filter(t => t.status === 'failed').length}`);\n    console.log(`Decisions Made:  ${this.decisions.length}`);\n    console.log(`Messages Sent:   ${this.communications.filter(c => c.type === 'send').length}`);\n    console.log(`Messages Recv:   ${this.communications.filter(c => c.type === 'receive').length}`);\n    console.log('');\n\n    // Performance metrics\n    if (this.performanceMetrics.size > 0) {\n      console.log('Performance Metrics:');\n      console.log('-'.repeat(60));\n\n      for (const [operation, durations] of this.performanceMetrics.entries()) {\n        const avg = durations.reduce((a, b) => a + b, 0) / durations.length;\n        const min = Math.min(...durations);\n        const max = Math.max(...durations);\n\n        console.log(`  ${operation.padEnd(30)} ${durations.length}x  avg: ${avg.toFixed(1)}ms  min: ${min.toFixed(1)}ms  max: ${max.toFixed(1)}ms`);\n      }\n      console.log('');\n    }\n\n    console.log('='.repeat(60) + '\\n');\n  }\n\n  /**\n   * Print timeline\n   */\n  printTimeline(): void {\n    if (!this.config.timeline || this.timeline.length === 0) return;\n\n    console.log('\\n' + '='.repeat(60));\n    console.log('📅 Agent Timeline');\n    console.log('='.repeat(60) + '\\n');\n\n    const startTime = new Date(this.timeline[0].timestamp).getTime();\n\n    for (const event of this.timeline) {\n      const elapsed = new Date(event.timestamp).getTime() - startTime;\n      const time = `+${(elapsed / 1000).toFixed(3)}s`;\n\n      console.log(`${time.padStart(10)} | ${event.type.padEnd(20)} | ${JSON.stringify(event.data || event)}`);\n    }\n\n    console.log('\\n' + '='.repeat(60) + '\\n');\n  }\n\n  /**\n   * Get current state\n   */\n  getState(): AgentState {\n    return { ...this.state };\n  }\n\n  /**\n   * Get task history\n   */\n  getTasks(): AgentTask[] {\n    return Array.from(this.tasks.values());\n  }\n\n  /**\n   * Get decisions\n   */\n  getDecisions(): AgentDecision[] {\n    return [...this.decisions];\n  }\n\n  /**\n   * Get communications\n   */\n  getCommunications(): any[] {\n    return [...this.communications];\n  }\n\n  /**\n   * Close debug stream\n   */\n  close(): void {\n    this.debug.close();\n  }\n}\n\n/**\n * Create agent debug stream\n */\nexport function createAgentDebugStream(config: AgentDebugConfig): AgentDebugStream {\n  return new AgentDebugStream(config);\n}\n\n/**\n * Create from environment variables\n */\nexport function createAgentDebugStreamFromEnv(agentId: string, tenantId?: string): AgentDebugStream {\n  const debugLevel = process.env.DEBUG_LEVEL?.toUpperCase() as keyof typeof DebugLevel || 'VERBOSE';\n\n  return new AgentDebugStream({\n    agentId,\n    tenantId: tenantId || process.env.FEDERATION_TENANT_ID,\n    level: DebugLevel[debugLevel] || DebugLevel.VERBOSE,\n    format: (process.env.DEBUG_FORMAT as any) || 'human',\n    output: (process.env.DEBUG_OUTPUT as any) || 'console',\n    outputFile: process.env.DEBUG_OUTPUT_FILE,\n    colorize: process.env.DEBUG_COLORIZE !== 'false',\n    trackState: process.env.DEBUG_TRACK_STATE !== 'false',\n    trackDecisions: process.env.DEBUG_TRACK_DECISIONS !== 'false',\n    trackCommunication: process.env.DEBUG_TRACK_COMMUNICATION !== 'false',\n    timeline: process.env.DEBUG_TIMELINE === 'true',\n  });\n}\n"]}

package/dist/federation/debug/debug-stream.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Debug Streaming System for Federation
+ *
+ * Provides detailed, real-time visibility into agent operations
+ * with multiple verbosity levels and customizable output formats.
+ *
+ * Features:
+ * - Multiple debug levels (SILENT, BASIC, DETAILED, VERBOSE, TRACE)
+ * - Real-time event streaming
+ * - Performance metrics and timing
+ * - Stack traces and context
+ * - Customizable formatters
+ * - File and console output
+ * - JSON and human-readable formats
+ */
+import { EventEmitter } from 'events';
+import { WriteStream } from 'fs';
+export declare enum DebugLevel {
+    SILENT = 0,// No output
+    BASIC = 1,// Major events only (init, shutdown, errors)
+    DETAILED = 2,// Include operations (queries, inserts, updates)
+    VERBOSE = 3,// Include all events (presence, messages, tasks)
+    TRACE = 4
+}
+export interface DebugEvent {
+    timestamp: string;
+    level: DebugLevel;
+    category: string;
+    operation: string;
+    agentId?: string;
+    tenantId?: string;
+    duration?: number;
+    data?: any;
+    error?: Error;
+    stackTrace?: string;
+    metadata?: Record<string, any>;
+}
+export interface DebugStreamConfig {
+    level: DebugLevel;
+    output: 'console' | 'file' | 'both' | 'stream';
+    format: 'human' | 'json' | 'compact';
+    outputFile?: string;
+    includeTimestamps?: boolean;
+    includeStackTraces?: boolean;
+    includeMetadata?: boolean;
+    colorize?: boolean;
+    filterCategories?: string[];
+    filterAgents?: string[];
+    customStream?: WriteStream;
+}
+export declare class DebugStream extends EventEmitter {
+    private config;
+    private fileStream?;
+    private eventBuffer;
+    private metrics;
+    constructor(config?: Partial<DebugStreamConfig>);
+    /**
+     * Log a debug event
+     */
+    log(event: Omit<DebugEvent, 'timestamp'>): void;
+    /**
+     * Log connection events
+     */
+    logConnection(operation: string, data?: any, error?: Error): void;
+    /**
+     * Log database operations
+     */
+    logDatabase(operation: string, data?: any, duration?: number, error?: Error): void;
+    /**
+     * Log realtime events
+     */
+    logRealtime(operation: string, agentId?: string, data?: any, duration?: number): void;
+    /**
+     * Log memory operations
+     */
+    logMemory(operation: string, agentId?: string, tenantId?: string, data?: any, duration?: number): void;
+    /**
+     * Log task operations
+     */
+    logTask(operation: string, agentId?: string, tenantId?: string, data?: any, duration?: number): void;
+    /**
+     * Log internal state changes
+     */
+    logTrace(operation: string, data?: any): void;
+    /**
+     * Output event to configured destinations
+     */
+    private outputEvent;
+    /**
+     * Format event for output
+     */
+    private formatEvent;
+    /**
+     * Format event in human-readable format
+     */
+    private formatHuman;
+    /**
+     * Format event in compact format
+     */
+    private formatCompact;
+    /**
+     * Get level string
+     */
+    private getLevelString;
+    /**
+     * Get color for level
+     */
+    private getLevelColor;
+    /**
+     * Colorize text
+     */
+    private colorize;
+    /**
+     * Capture stack trace
+     */
+    private captureStackTrace;
+    /**
+     * Get metrics summary
+     */
+    getMetrics(): Record<string, {
+        count: number;
+        avgDuration: number;
+    }>;
+    /**
+     * Print metrics summary
+     */
+    printMetrics(): void;
+    /**
+     * Get event buffer
+     */
+    getEvents(filter?: {
+        category?: string;
+        agentId?: string;
+        since?: Date;
+    }): DebugEvent[];
+    /**
+     * Clear event buffer
+     */
+    clearEvents(): void;
+    /**
+     * Clear metrics
+     */
+    clearMetrics(): void;
+    /**
+     * Close file stream
+     */
+    close(): void;
+}
+/**
+ * Create debug stream with sensible defaults
+ */
+export declare function createDebugStream(config?: Partial<DebugStreamConfig>): DebugStream;
+/**
+ * Get debug level from environment variable
+ */
+export declare function getDebugLevelFromEnv(): DebugLevel;
+//# sourceMappingURL=debug-stream.d.ts.map

package/dist/federation/debug/debug-stream.d.ts.map

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

package/dist/federation/debug/debug-stream.js

@@ -417,3 +417,4 @@ export function getDebugLevelFromEnv() {
         default: return DebugLevel.BASIC;
     }
 }
+//# sourceMappingURL=debug-stream.js.map

package/dist/federation/debug/debug-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-stream.js","sourceRoot":"","sources":["../../../src/federation/debug/debug-stream.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Debug Streaming System for Federation\n *\n * Provides detailed, real-time visibility into agent operations\n * with multiple verbosity levels and customizable output formats.\n *\n * Features:\n * - Multiple debug levels (SILENT, BASIC, DETAILED, VERBOSE, TRACE)\n * - Real-time event streaming\n * - Performance metrics and timing\n * - Stack traces and context\n * - Customizable formatters\n * - File and console output\n * - JSON and human-readable formats\n */\n\nimport { EventEmitter } from 'events';\nimport { WriteStream, createWriteStream } from 'fs';\n\nexport enum DebugLevel {\n  SILENT = 0,   // No output\n  BASIC = 1,    // Major events only (init, shutdown, errors)\n  DETAILED = 2, // Include operations (queries, inserts, updates)\n  VERBOSE = 3,  // Include all events (presence, messages, tasks)\n  TRACE = 4,    // Everything including internal state changes\n}\n\nexport interface DebugEvent {\n  timestamp: string;\n  level: DebugLevel;\n  category: string;\n  operation: string;\n  agentId?: string;\n  tenantId?: string;\n  duration?: number;\n  data?: any;\n  error?: Error;\n  stackTrace?: string;\n  metadata?: Record<string, any>;\n}\n\nexport interface DebugStreamConfig {\n  level: DebugLevel;\n  output: 'console' | 'file' | 'both' | 'stream';\n  format: 'human' | 'json' | 'compact';\n  outputFile?: string;\n  includeTimestamps?: boolean;\n  includeStackTraces?: boolean;\n  includeMetadata?: boolean;\n  colorize?: boolean;\n  filterCategories?: string[];\n  filterAgents?: string[];\n  customStream?: WriteStream;\n}\n\nexport class DebugStream extends EventEmitter {\n  private config: DebugStreamConfig;\n  private fileStream?: WriteStream;\n  private eventBuffer: DebugEvent[] = [];\n  private metrics: Map<string, { count: number; totalDuration: number }> = new Map();\n\n  constructor(config: Partial<DebugStreamConfig> = {}) {\n    super();\n\n    this.config = {\n      level: config.level ?? DebugLevel.BASIC,\n      output: config.output ?? 'console',\n      format: config.format ?? 'human',\n      includeTimestamps: config.includeTimestamps ?? true,\n      includeStackTraces: config.includeStackTraces ?? false,\n      includeMetadata: config.includeMetadata ?? true,\n      colorize: config.colorize ?? true,\n      filterCategories: config.filterCategories,\n      filterAgents: config.filterAgents,\n      outputFile: config.outputFile,\n      customStream: config.customStream,\n    };\n\n    if (this.config.outputFile && (this.config.output === 'file' || this.config.output === 'both')) {\n      this.fileStream = createWriteStream(this.config.outputFile, { flags: 'a' });\n    }\n  }\n\n  /**\n   * Log a debug event\n   */\n  log(event: Omit<DebugEvent, 'timestamp'>): void {\n    // Check if event should be logged based on level\n    if (event.level > this.config.level) {\n      return;\n    }\n\n    // Apply filters\n    if (this.config.filterCategories && !this.config.filterCategories.includes(event.category)) {\n      return;\n    }\n\n    if (this.config.filterAgents && event.agentId && !this.config.filterAgents.includes(event.agentId)) {\n      return;\n    }\n\n    const fullEvent: DebugEvent = {\n      ...event,\n      timestamp: new Date().toISOString(),\n      stackTrace: this.config.includeStackTraces ? this.captureStackTrace() : undefined,\n    };\n\n    // Buffer event\n    this.eventBuffer.push(fullEvent);\n\n    // Update metrics\n    if (event.duration !== undefined) {\n      const key = `${event.category}:${event.operation}`;\n      const existing = this.metrics.get(key) || { count: 0, totalDuration: 0 };\n      this.metrics.set(key, {\n        count: existing.count + 1,\n        totalDuration: existing.totalDuration + event.duration,\n      });\n    }\n\n    // Output event\n    this.outputEvent(fullEvent);\n\n    // Emit for external listeners\n    this.emit('event', fullEvent);\n  }\n\n  /**\n   * Log connection events\n   */\n  logConnection(operation: string, data?: any, error?: Error): void {\n    this.log({\n      level: DebugLevel.BASIC,\n      category: 'connection',\n      operation,\n      data,\n      error,\n    });\n  }\n\n  /**\n   * Log database operations\n   */\n  logDatabase(operation: string, data?: any, duration?: number, error?: Error): void {\n    this.log({\n      level: DebugLevel.DETAILED,\n      category: 'database',\n      operation,\n      data,\n      duration,\n      error,\n    });\n  }\n\n  /**\n   * Log realtime events\n   */\n  logRealtime(operation: string, agentId?: string, data?: any, duration?: number): void {\n    this.log({\n      level: DebugLevel.VERBOSE,\n      category: 'realtime',\n      operation,\n      agentId,\n      data,\n      duration,\n    });\n  }\n\n  /**\n   * Log memory operations\n   */\n  logMemory(operation: string, agentId?: string, tenantId?: string, data?: any, duration?: number): void {\n    this.log({\n      level: DebugLevel.DETAILED,\n      category: 'memory',\n      operation,\n      agentId,\n      tenantId,\n      data,\n      duration,\n    });\n  }\n\n  /**\n   * Log task operations\n   */\n  logTask(operation: string, agentId?: string, tenantId?: string, data?: any, duration?: number): void {\n    this.log({\n      level: DebugLevel.VERBOSE,\n      category: 'task',\n      operation,\n      agentId,\n      tenantId,\n      data,\n      duration,\n    });\n  }\n\n  /**\n   * Log internal state changes\n   */\n  logTrace(operation: string, data?: any): void {\n    this.log({\n      level: DebugLevel.TRACE,\n      category: 'trace',\n      operation,\n      data,\n    });\n  }\n\n  /**\n   * Output event to configured destinations\n   */\n  private outputEvent(event: DebugEvent): void {\n    const formatted = this.formatEvent(event);\n\n    if (this.config.output === 'console' || this.config.output === 'both') {\n      console.log(formatted);\n    }\n\n    if (this.config.output === 'file' || this.config.output === 'both') {\n      if (this.fileStream) {\n        this.fileStream.write(formatted + '\\n');\n      }\n    }\n\n    if (this.config.output === 'stream' && this.config.customStream) {\n      this.config.customStream.write(formatted + '\\n');\n    }\n  }\n\n  /**\n   * Format event for output\n   */\n  private formatEvent(event: DebugEvent): string {\n    if (this.config.format === 'json') {\n      return JSON.stringify(event);\n    }\n\n    if (this.config.format === 'compact') {\n      return this.formatCompact(event);\n    }\n\n    return this.formatHuman(event);\n  }\n\n  /**\n   * Format event in human-readable format\n   */\n  private formatHuman(event: DebugEvent): string {\n    const parts: string[] = [];\n\n    // Timestamp\n    if (this.config.includeTimestamps) {\n      const timestamp = this.colorize(event.timestamp, 'gray');\n      parts.push(`[${timestamp}]`);\n    }\n\n    // Level\n    const levelStr = this.getLevelString(event.level);\n    parts.push(this.colorize(levelStr, this.getLevelColor(event.level)));\n\n    // Category\n    parts.push(this.colorize(event.category.toUpperCase(), 'cyan'));\n\n    // Agent/Tenant\n    if (event.agentId) {\n      parts.push(this.colorize(`agent=${event.agentId}`, 'blue'));\n    }\n    if (event.tenantId) {\n      parts.push(this.colorize(`tenant=${event.tenantId}`, 'blue'));\n    }\n\n    // Operation\n    parts.push(this.colorize(event.operation, 'white'));\n\n    // Duration\n    if (event.duration !== undefined) {\n      const durationStr = `${event.duration.toFixed(2)}ms`;\n      parts.push(this.colorize(durationStr, 'yellow'));\n    }\n\n    let output = parts.join(' ');\n\n    // Data\n    if (event.data && this.config.includeMetadata) {\n      const dataStr = typeof event.data === 'string'\n        ? event.data\n        : JSON.stringify(event.data, null, 2);\n      output += '\\n  ' + this.colorize('Data:', 'gray') + ' ' + dataStr;\n    }\n\n    // Metadata\n    if (event.metadata && this.config.includeMetadata) {\n      output += '\\n  ' + this.colorize('Metadata:', 'gray') + ' ' + JSON.stringify(event.metadata);\n    }\n\n    // Error\n    if (event.error) {\n      output += '\\n  ' + this.colorize('Error:', 'red') + ' ' + event.error.message;\n      if (event.error.stack) {\n        output += '\\n  ' + this.colorize('Stack:', 'red') + '\\n' + event.error.stack\n          .split('\\n')\n          .map(line => '    ' + line)\n          .join('\\n');\n      }\n    }\n\n    // Stack trace\n    if (event.stackTrace && this.config.includeStackTraces) {\n      output += '\\n  ' + this.colorize('Trace:', 'gray') + '\\n' + event.stackTrace\n        .split('\\n')\n        .slice(0, 5)\n        .map(line => '    ' + line)\n        .join('\\n');\n    }\n\n    return output;\n  }\n\n  /**\n   * Format event in compact format\n   */\n  private formatCompact(event: DebugEvent): string {\n    const parts: string[] = [];\n\n    if (this.config.includeTimestamps) {\n      parts.push(event.timestamp);\n    }\n\n    parts.push(this.getLevelString(event.level));\n    parts.push(event.category);\n\n    if (event.agentId) parts.push(`a=${event.agentId}`);\n    if (event.tenantId) parts.push(`t=${event.tenantId}`);\n\n    parts.push(event.operation);\n\n    if (event.duration !== undefined) {\n      parts.push(`${event.duration.toFixed(0)}ms`);\n    }\n\n    if (event.error) {\n      parts.push(`ERROR: ${event.error.message}`);\n    }\n\n    return parts.join(' | ');\n  }\n\n  /**\n   * Get level string\n   */\n  private getLevelString(level: DebugLevel): string {\n    switch (level) {\n      case DebugLevel.SILENT: return 'SILENT';\n      case DebugLevel.BASIC: return 'BASIC ';\n      case DebugLevel.DETAILED: return 'DETAIL';\n      case DebugLevel.VERBOSE: return 'VERBOS';\n      case DebugLevel.TRACE: return 'TRACE ';\n      default: return 'UNKNOWN';\n    }\n  }\n\n  /**\n   * Get color for level\n   */\n  private getLevelColor(level: DebugLevel): string {\n    switch (level) {\n      case DebugLevel.BASIC: return 'green';\n      case DebugLevel.DETAILED: return 'blue';\n      case DebugLevel.VERBOSE: return 'magenta';\n      case DebugLevel.TRACE: return 'gray';\n      default: return 'white';\n    }\n  }\n\n  /**\n   * Colorize text\n   */\n  private colorize(text: string, color: string): string {\n    if (!this.config.colorize) return text;\n\n    const colors: Record<string, string> = {\n      gray: '\\x1b[90m',\n      red: '\\x1b[31m',\n      green: '\\x1b[32m',\n      yellow: '\\x1b[33m',\n      blue: '\\x1b[34m',\n      magenta: '\\x1b[35m',\n      cyan: '\\x1b[36m',\n      white: '\\x1b[37m',\n    };\n\n    const reset = '\\x1b[0m';\n    return (colors[color] || '') + text + reset;\n  }\n\n  /**\n   * Capture stack trace\n   */\n  private captureStackTrace(): string {\n    const stack = new Error().stack || '';\n    return stack\n      .split('\\n')\n      .slice(3) // Skip DebugStream internal frames\n      .join('\\n');\n  }\n\n  /**\n   * Get metrics summary\n   */\n  getMetrics(): Record<string, { count: number; avgDuration: number }> {\n    const summary: Record<string, { count: number; avgDuration: number }> = {};\n\n    for (const [key, value] of this.metrics.entries()) {\n      summary[key] = {\n        count: value.count,\n        avgDuration: value.totalDuration / value.count,\n      };\n    }\n\n    return summary;\n  }\n\n  /**\n   * Print metrics summary\n   */\n  printMetrics(): void {\n    console.log('\\n' + this.colorize('='.repeat(60), 'cyan'));\n    console.log(this.colorize('Performance Metrics Summary', 'cyan'));\n    console.log(this.colorize('='.repeat(60), 'cyan') + '\\n');\n\n    const metrics = this.getMetrics();\n    const sorted = Object.entries(metrics).sort((a, b) => b[1].count - a[1].count);\n\n    console.log(this.colorize('Operation'.padEnd(40) + 'Count'.padEnd(10) + 'Avg Duration', 'white'));\n    console.log(this.colorize('-'.repeat(60), 'gray'));\n\n    for (const [key, value] of sorted) {\n      const countStr = value.count.toString().padEnd(10);\n      const durationStr = value.avgDuration.toFixed(2) + 'ms';\n      console.log(\n        key.padEnd(40) +\n        this.colorize(countStr, 'yellow') +\n        this.colorize(durationStr, 'green')\n      );\n    }\n\n    console.log('\\n' + this.colorize('='.repeat(60), 'cyan') + '\\n');\n  }\n\n  /**\n   * Get event buffer\n   */\n  getEvents(filter?: { category?: string; agentId?: string; since?: Date }): DebugEvent[] {\n    let events = [...this.eventBuffer];\n\n    if (filter?.category) {\n      events = events.filter(e => e.category === filter.category);\n    }\n\n    if (filter?.agentId) {\n      events = events.filter(e => e.agentId === filter.agentId);\n    }\n\n    if (filter?.since) {\n      events = events.filter(e => new Date(e.timestamp) >= filter.since!);\n    }\n\n    return events;\n  }\n\n  /**\n   * Clear event buffer\n   */\n  clearEvents(): void {\n    this.eventBuffer = [];\n  }\n\n  /**\n   * Clear metrics\n   */\n  clearMetrics(): void {\n    this.metrics.clear();\n  }\n\n  /**\n   * Close file stream\n   */\n  close(): void {\n    if (this.fileStream) {\n      this.fileStream.end();\n    }\n  }\n}\n\n/**\n * Create debug stream with sensible defaults\n */\nexport function createDebugStream(config?: Partial<DebugStreamConfig>): DebugStream {\n  return new DebugStream(config);\n}\n\n/**\n * Get debug level from environment variable\n */\nexport function getDebugLevelFromEnv(): DebugLevel {\n  const level = process.env.DEBUG_LEVEL?.toUpperCase();\n\n  switch (level) {\n    case 'SILENT': return DebugLevel.SILENT;\n    case 'BASIC': return DebugLevel.BASIC;\n    case 'DETAILED': return DebugLevel.DETAILED;\n    case 'VERBOSE': return DebugLevel.VERBOSE;\n    case 'TRACE': return DebugLevel.TRACE;\n    default: return DebugLevel.BASIC;\n  }\n}\n"]}

package/dist/federation/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Federated AgentDB - Main exports
+ *
+ * Provides secure federated memory for ephemeral agents with:
+ * - QUIC-based synchronization
+ * - Zero-trust security (mTLS + JWT + AES-256)
+ * - Tenant isolation
+ * - Vector clock conflict resolution
+ */
+export { EphemeralAgent, type EphemeralAgentConfig, type AgentContext } from './EphemeralAgent.js';
+export { FederationHub, type FederationHubConfig, type SyncMessage } from './FederationHub.js';
+export { SecurityManager, type AgentTokenPayload, type EncryptionKeys } from './SecurityManager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/federation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/federation/index.js

@@ -10,3 +10,4 @@
 export { EphemeralAgent } from './EphemeralAgent.js';
 export { FederationHub } from './FederationHub.js';
 export { SecurityManager } from './SecurityManager.js';
+//# sourceMappingURL=index.js.map

package/dist/federation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/federation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAgD,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,aAAa,EAA8C,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAA+C,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * Federated AgentDB - Main exports\n *\n * Provides secure federated memory for ephemeral agents with:\n * - QUIC-based synchronization\n * - Zero-trust security (mTLS + JWT + AES-256)\n * - Tenant isolation\n * - Vector clock conflict resolution\n */\n\nexport { EphemeralAgent, type EphemeralAgentConfig, type AgentContext } from './EphemeralAgent.js';\nexport { FederationHub, type FederationHubConfig, type SyncMessage } from './FederationHub.js';\nexport { SecurityManager, type AgentTokenPayload, type EncryptionKeys } from './SecurityManager.js';\n"]}