@weavelogic/knowledge-graph-agent 0.4.0 → 0.6.0

package/dist/server/types.d.ts

@@ -0,0 +1,320 @@
+/**
+ * Server Infrastructure Types
+ *
+ * Type definitions for the unified server system that coordinates
+ * MCP, GraphQL, and Dashboard servers in a single process.
+ *
+ * @module server/types
+ */
+import type { EventEmitter } from 'events';
+import type { Server as HTTPServer } from 'http';
+import type { KnowledgeGraphDatabase } from '../core/database.js';
+import type { ShadowCache } from '../core/cache.js';
+import type { AgentRegistry } from '../agents/registry.js';
+import type { WorkflowRegistry } from '../workflows/registry.js';
+import type { KnowledgeGraphMCPServer } from '../mcp-server/server.js';
+/**
+ * MCP server configuration
+ */
+export interface MCPServerConfig {
+    /** Enable MCP server */
+    enabled: boolean;
+    /** Server name */
+    name?: string;
+    /** Server version */
+    version?: string;
+}
+/**
+ * GraphQL server configuration
+ */
+export interface GraphQLServerConfig {
+    /** Enable GraphQL server */
+    enabled: boolean;
+    /** Port to listen on */
+    port: number;
+    /** Enable GraphQL Playground */
+    playground?: boolean;
+    /** Enable introspection */
+    introspection?: boolean;
+    /** CORS configuration */
+    cors?: {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+}
+/**
+ * Dashboard server configuration
+ */
+export interface DashboardServerConfig {
+    /** Enable dashboard server */
+    enabled: boolean;
+    /** Port to listen on */
+    port: number;
+    /** Enable hot reload for development */
+    hotReload?: boolean;
+    /** Path to static assets */
+    staticPath?: string;
+}
+/**
+ * Database configuration
+ */
+export interface DatabaseServerConfig {
+    /** Path to SQLite database */
+    path: string;
+    /** Enable WAL mode */
+    wal?: boolean;
+    /** Busy timeout in milliseconds */
+    busyTimeout?: number;
+}
+/**
+ * Cache configuration
+ */
+export interface CacheServerConfig {
+    /** Enable caching */
+    enabled: boolean;
+    /** Default TTL in milliseconds */
+    defaultTTL?: number;
+    /** Maximum entries */
+    maxEntries?: number;
+}
+/**
+ * Complete server configuration
+ */
+export interface ServerConfig {
+    /** Project root directory */
+    projectRoot: string;
+    /** MCP server configuration */
+    mcp: MCPServerConfig;
+    /** GraphQL server configuration */
+    graphql: GraphQLServerConfig;
+    /** Dashboard server configuration */
+    dashboard: DashboardServerConfig;
+    /** Database configuration */
+    database: DatabaseServerConfig;
+    /** Cache configuration */
+    cache: CacheServerConfig;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Server status enumeration
+ */
+export type ServerStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'error';
+/**
+ * Individual server state
+ */
+export interface ServerState {
+    /** Current status */
+    status: ServerStatus;
+    /** When the server started */
+    startedAt?: Date;
+    /** Port the server is listening on (if applicable) */
+    port?: number;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Request count */
+    requestCount: number;
+}
+/**
+ * Overall server manager state
+ */
+export interface ServerManagerState {
+    /** MCP server state */
+    mcp: ServerState;
+    /** GraphQL server state */
+    graphql: ServerState;
+    /** Dashboard server state */
+    dashboard: ServerState;
+    /** Overall system status */
+    overall: ServerStatus;
+    /** When the manager was initialized */
+    initializedAt?: Date;
+}
+/**
+ * Component health status
+ */
+export interface ComponentHealth {
+    /** Component name */
+    name: string;
+    /** Is the component healthy */
+    healthy: boolean;
+    /** Status message */
+    message?: string;
+    /** Additional metrics */
+    metrics?: Record<string, number | string>;
+    /** Last check timestamp */
+    lastCheck: Date;
+}
+/**
+ * Overall health status
+ */
+export interface HealthStatus {
+    /** Overall health status */
+    healthy: boolean;
+    /** Overall status string */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /** Component health details */
+    components: ComponentHealth[];
+    /** System uptime in milliseconds */
+    uptime: number;
+    /** Total requests across all servers */
+    totalRequests: number;
+    /** Memory usage */
+    memory: {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+    };
+}
+/**
+ * Server event types
+ */
+export type ServerEventType = 'server:starting' | 'server:started' | 'server:stopping' | 'server:stopped' | 'server:error' | 'request:received' | 'request:completed' | 'request:error' | 'health:check' | 'config:changed';
+/**
+ * Server event payload
+ */
+export interface ServerEvent {
+    /** Event type */
+    type: ServerEventType;
+    /** Which server (mcp, graphql, dashboard) */
+    server?: 'mcp' | 'graphql' | 'dashboard';
+    /** Event timestamp */
+    timestamp: Date;
+    /** Event data */
+    data?: Record<string, unknown>;
+    /** Error if applicable */
+    error?: Error;
+}
+/**
+ * Server event listener
+ */
+export type ServerEventListener = (event: ServerEvent) => void | Promise<void>;
+/**
+ * Shared services available to all server components
+ */
+export interface ISharedServices {
+    /** Knowledge graph database */
+    database: KnowledgeGraphDatabase;
+    /** File metadata cache */
+    cache: ShadowCache;
+    /** Agent registry */
+    agentRegistry: AgentRegistry;
+    /** Workflow registry */
+    workflowRegistry: WorkflowRegistry;
+    /** Cross-service event bus */
+    eventBus: EventEmitter;
+    /** Project root directory */
+    projectRoot: string;
+    /** Configuration */
+    config: ServerConfig;
+    /** Initialize all services */
+    initialize(): Promise<void>;
+    /** Shutdown all services */
+    shutdown(): Promise<void>;
+    /** Check if services are initialized */
+    isInitialized(): boolean;
+    /** Get service health status */
+    getHealth(): HealthStatus;
+}
+/**
+ * Server manager interface
+ */
+export interface IServerManager {
+    /** Start MCP server */
+    startMCP(): Promise<void>;
+    /** Start GraphQL server */
+    startGraphQL(port?: number): Promise<void>;
+    /** Start Dashboard server */
+    startDashboard(port?: number): Promise<void>;
+    /** Start all enabled servers */
+    startAll(): Promise<void>;
+    /** Stop a specific server */
+    stop(server: 'mcp' | 'graphql' | 'dashboard'): Promise<void>;
+    /** Graceful shutdown of all servers */
+    gracefulShutdown(): Promise<void>;
+    /** Get current state */
+    getState(): ServerManagerState;
+    /** Get health status */
+    getHealth(): HealthStatus;
+    /** Subscribe to events */
+    on(event: ServerEventType, listener: ServerEventListener): void;
+    /** Unsubscribe from events */
+    off(event: ServerEventType, listener: ServerEventListener): void;
+}
+/**
+ * HTTP server instance with metadata
+ */
+export interface HTTPServerInstance {
+    /** HTTP server */
+    server: HTTPServer;
+    /** Port listening on */
+    port: number;
+    /** Server type */
+    type: 'graphql' | 'dashboard';
+    /** Start time */
+    startedAt: Date;
+}
+/**
+ * MCP server instance wrapper
+ */
+export interface MCPServerInstance {
+    /** MCP server */
+    server: KnowledgeGraphMCPServer;
+    /** Start time */
+    startedAt: Date;
+}
+/**
+ * CLI serve command options
+ */
+export interface ServeCommandOptions {
+    /** Enable MCP server */
+    mcp?: boolean;
+    /** Enable GraphQL server */
+    graphql?: boolean;
+    /** Enable Dashboard server */
+    dashboard?: boolean;
+    /** GraphQL port */
+    portGraphql?: string | number;
+    /** Dashboard port */
+    portDashboard?: string | number;
+    /** Enable all servers */
+    all?: boolean;
+    /** Database path */
+    db?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Parsed serve options with defaults applied
+ */
+export interface ParsedServeOptions {
+    mcp: boolean;
+    graphql: boolean;
+    dashboard: boolean;
+    graphqlPort: number;
+    dashboardPort: number;
+    databasePath: string;
+    verbose: boolean;
+}
+/**
+ * Default port for GraphQL server
+ */
+export declare const DEFAULT_GRAPHQL_PORT = 4000;
+/**
+ * Default port for Dashboard server
+ */
+export declare const DEFAULT_DASHBOARD_PORT = 3000;
+/**
+ * Default database path
+ */
+export declare const DEFAULT_DATABASE_PATH = ".kg/knowledge.db";
+/**
+ * Shutdown timeout in milliseconds
+ */
+export declare const SHUTDOWN_TIMEOUT = 10000;
+/**
+ * Health check interval in milliseconds
+ */
+export declare const HEALTH_CHECK_INTERVAL = 30000;
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

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

package/dist/server/types.js

@@ -0,0 +1,13 @@
+const DEFAULT_GRAPHQL_PORT = 4e3;
+const DEFAULT_DASHBOARD_PORT = 3e3;
+const DEFAULT_DATABASE_PATH = ".kg/knowledge.db";
+const SHUTDOWN_TIMEOUT = 1e4;
+const HEALTH_CHECK_INTERVAL = 3e4;
+export {
+  DEFAULT_DASHBOARD_PORT,
+  DEFAULT_DATABASE_PATH,
+  DEFAULT_GRAPHQL_PORT,
+  HEALTH_CHECK_INTERVAL,
+  SHUTDOWN_TIMEOUT
+};
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/server/types.ts"],"sourcesContent":["/**\n * Server Infrastructure Types\n *\n * Type definitions for the unified server system that coordinates\n * MCP, GraphQL, and Dashboard servers in a single process.\n *\n * @module server/types\n */\n\nimport type { EventEmitter } from 'events';\nimport type { Server as HTTPServer } from 'http';\nimport type { KnowledgeGraphDatabase } from '../core/database.js';\nimport type { ShadowCache } from '../core/cache.js';\nimport type { AgentRegistry } from '../agents/registry.js';\nimport type { WorkflowRegistry } from '../workflows/registry.js';\nimport type { KnowledgeGraphMCPServer } from '../mcp-server/server.js';\n\n// ============================================================================\n// Server Configuration Types\n// ============================================================================\n\n/**\n * MCP server configuration\n */\nexport interface MCPServerConfig {\n  /** Enable MCP server */\n  enabled: boolean;\n  /** Server name */\n  name?: string;\n  /** Server version */\n  version?: string;\n}\n\n/**\n * GraphQL server configuration\n */\nexport interface GraphQLServerConfig {\n  /** Enable GraphQL server */\n  enabled: boolean;\n  /** Port to listen on */\n  port: number;\n  /** Enable GraphQL Playground */\n  playground?: boolean;\n  /** Enable introspection */\n  introspection?: boolean;\n  /** CORS configuration */\n  cors?: {\n    origin?: string | string[];\n    credentials?: boolean;\n  };\n}\n\n/**\n * Dashboard server configuration\n */\nexport interface DashboardServerConfig {\n  /** Enable dashboard server */\n  enabled: boolean;\n  /** Port to listen on */\n  port: number;\n  /** Enable hot reload for development */\n  hotReload?: boolean;\n  /** Path to static assets */\n  staticPath?: string;\n}\n\n/**\n * Database configuration\n */\nexport interface DatabaseServerConfig {\n  /** Path to SQLite database */\n  path: string;\n  /** Enable WAL mode */\n  wal?: boolean;\n  /** Busy timeout in milliseconds */\n  busyTimeout?: number;\n}\n\n/**\n * Cache configuration\n */\nexport interface CacheServerConfig {\n  /** Enable caching */\n  enabled: boolean;\n  /** Default TTL in milliseconds */\n  defaultTTL?: number;\n  /** Maximum entries */\n  maxEntries?: number;\n}\n\n/**\n * Complete server configuration\n */\nexport interface ServerConfig {\n  /** Project root directory */\n  projectRoot: string;\n  /** MCP server configuration */\n  mcp: MCPServerConfig;\n  /** GraphQL server configuration */\n  graphql: GraphQLServerConfig;\n  /** Dashboard server configuration */\n  dashboard: DashboardServerConfig;\n  /** Database configuration */\n  database: DatabaseServerConfig;\n  /** Cache configuration */\n  cache: CacheServerConfig;\n  /** Enable verbose logging */\n  verbose?: boolean;\n}\n\n// ============================================================================\n// Server State Types\n// ============================================================================\n\n/**\n * Server status enumeration\n */\nexport type ServerStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'error';\n\n/**\n * Individual server state\n */\nexport interface ServerState {\n  /** Current status */\n  status: ServerStatus;\n  /** When the server started */\n  startedAt?: Date;\n  /** Port the server is listening on (if applicable) */\n  port?: number;\n  /** Error message if status is 'error' */\n  error?: string;\n  /** Request count */\n  requestCount: number;\n}\n\n/**\n * Overall server manager state\n */\nexport interface ServerManagerState {\n  /** MCP server state */\n  mcp: ServerState;\n  /** GraphQL server state */\n  graphql: ServerState;\n  /** Dashboard server state */\n  dashboard: ServerState;\n  /** Overall system status */\n  overall: ServerStatus;\n  /** When the manager was initialized */\n  initializedAt?: Date;\n}\n\n// ============================================================================\n// Health Check Types\n// ============================================================================\n\n/**\n * Component health status\n */\nexport interface ComponentHealth {\n  /** Component name */\n  name: string;\n  /** Is the component healthy */\n  healthy: boolean;\n  /** Status message */\n  message?: string;\n  /** Additional metrics */\n  metrics?: Record<string, number | string>;\n  /** Last check timestamp */\n  lastCheck: Date;\n}\n\n/**\n * Overall health status\n */\nexport interface HealthStatus {\n  /** Overall health status */\n  healthy: boolean;\n  /** Overall status string */\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  /** Component health details */\n  components: ComponentHealth[];\n  /** System uptime in milliseconds */\n  uptime: number;\n  /** Total requests across all servers */\n  totalRequests: number;\n  /** Memory usage */\n  memory: {\n    heapUsed: number;\n    heapTotal: number;\n    external: number;\n    rss: number;\n  };\n}\n\n// ============================================================================\n// Event Types\n// ============================================================================\n\n/**\n * Server event types\n */\nexport type ServerEventType =\n  | 'server:starting'\n  | 'server:started'\n  | 'server:stopping'\n  | 'server:stopped'\n  | 'server:error'\n  | 'request:received'\n  | 'request:completed'\n  | 'request:error'\n  | 'health:check'\n  | 'config:changed';\n\n/**\n * Server event payload\n */\nexport interface ServerEvent {\n  /** Event type */\n  type: ServerEventType;\n  /** Which server (mcp, graphql, dashboard) */\n  server?: 'mcp' | 'graphql' | 'dashboard';\n  /** Event timestamp */\n  timestamp: Date;\n  /** Event data */\n  data?: Record<string, unknown>;\n  /** Error if applicable */\n  error?: Error;\n}\n\n/**\n * Server event listener\n */\nexport type ServerEventListener = (event: ServerEvent) => void | Promise<void>;\n\n// ============================================================================\n// Shared Services Interface\n// ============================================================================\n\n/**\n * Shared services available to all server components\n */\nexport interface ISharedServices {\n  /** Knowledge graph database */\n  database: KnowledgeGraphDatabase;\n  /** File metadata cache */\n  cache: ShadowCache;\n  /** Agent registry */\n  agentRegistry: AgentRegistry;\n  /** Workflow registry */\n  workflowRegistry: WorkflowRegistry;\n  /** Cross-service event bus */\n  eventBus: EventEmitter;\n  /** Project root directory */\n  projectRoot: string;\n  /** Configuration */\n  config: ServerConfig;\n\n  /** Initialize all services */\n  initialize(): Promise<void>;\n  /** Shutdown all services */\n  shutdown(): Promise<void>;\n  /** Check if services are initialized */\n  isInitialized(): boolean;\n  /** Get service health status */\n  getHealth(): HealthStatus;\n}\n\n// ============================================================================\n// Server Manager Interface\n// ============================================================================\n\n/**\n * Server manager interface\n */\nexport interface IServerManager {\n  /** Start MCP server */\n  startMCP(): Promise<void>;\n  /** Start GraphQL server */\n  startGraphQL(port?: number): Promise<void>;\n  /** Start Dashboard server */\n  startDashboard(port?: number): Promise<void>;\n  /** Start all enabled servers */\n  startAll(): Promise<void>;\n  /** Stop a specific server */\n  stop(server: 'mcp' | 'graphql' | 'dashboard'): Promise<void>;\n  /** Graceful shutdown of all servers */\n  gracefulShutdown(): Promise<void>;\n  /** Get current state */\n  getState(): ServerManagerState;\n  /** Get health status */\n  getHealth(): HealthStatus;\n  /** Subscribe to events */\n  on(event: ServerEventType, listener: ServerEventListener): void;\n  /** Unsubscribe from events */\n  off(event: ServerEventType, listener: ServerEventListener): void;\n}\n\n// ============================================================================\n// Server Instance Types\n// ============================================================================\n\n/**\n * HTTP server instance with metadata\n */\nexport interface HTTPServerInstance {\n  /** HTTP server */\n  server: HTTPServer;\n  /** Port listening on */\n  port: number;\n  /** Server type */\n  type: 'graphql' | 'dashboard';\n  /** Start time */\n  startedAt: Date;\n}\n\n/**\n * MCP server instance wrapper\n */\nexport interface MCPServerInstance {\n  /** MCP server */\n  server: KnowledgeGraphMCPServer;\n  /** Start time */\n  startedAt: Date;\n}\n\n// ============================================================================\n// CLI Options Types\n// ============================================================================\n\n/**\n * CLI serve command options\n */\nexport interface ServeCommandOptions {\n  /** Enable MCP server */\n  mcp?: boolean;\n  /** Enable GraphQL server */\n  graphql?: boolean;\n  /** Enable Dashboard server */\n  dashboard?: boolean;\n  /** GraphQL port */\n  portGraphql?: string | number;\n  /** Dashboard port */\n  portDashboard?: string | number;\n  /** Enable all servers */\n  all?: boolean;\n  /** Database path */\n  db?: string;\n  /** Enable verbose logging */\n  verbose?: boolean;\n}\n\n/**\n * Parsed serve options with defaults applied\n */\nexport interface ParsedServeOptions {\n  mcp: boolean;\n  graphql: boolean;\n  dashboard: boolean;\n  graphqlPort: number;\n  dashboardPort: number;\n  databasePath: string;\n  verbose: boolean;\n}\n\n// ============================================================================\n// Default Values\n// ============================================================================\n\n/**\n * Default port for GraphQL server\n */\nexport const DEFAULT_GRAPHQL_PORT = 4000;\n\n/**\n * Default port for Dashboard server\n */\nexport const DEFAULT_DASHBOARD_PORT = 3000;\n\n/**\n * Default database path\n */\nexport const DEFAULT_DATABASE_PATH = '.kg/knowledge.db';\n\n/**\n * Shutdown timeout in milliseconds\n */\nexport const SHUTDOWN_TIMEOUT = 10000;\n\n/**\n * Health check interval in milliseconds\n */\nexport const HEALTH_CHECK_INTERVAL = 30000;\n"],"names":[],"mappings":"AAmXO,MAAM,uBAAuB;AAK7B,MAAM,yBAAyB;AAK/B,MAAM,wBAAwB;AAK9B,MAAM,mBAAmB;AAKzB,MAAM,wBAAwB;"}

package/dist/services/manager.js

@@ -0,0 +1,328 @@
+import { EventEmitter } from "events";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("service-manager");
+class ServiceManager extends EventEmitter {
+  services = /* @__PURE__ */ new Map();
+  handlers = /* @__PURE__ */ new Map();
+  configs = /* @__PURE__ */ new Map();
+  healthCheckTimers = /* @__PURE__ */ new Map();
+  isShuttingDown = false;
+  constructor() {
+    super();
+    logger.info("ServiceManager initialized");
+  }
+  /**
+   * Register a new service with the manager.
+   *
+   * @param config - Service configuration
+   * @param handler - Service implementation
+   * @throws Error if service ID is already registered
+   */
+  async register(config, handler) {
+    if (this.services.has(config.id)) {
+      throw new Error(`Service ${config.id} already registered`);
+    }
+    const state = {
+      id: config.id,
+      name: config.name,
+      type: config.type,
+      status: "stopped",
+      restarts: 0,
+      metrics: {
+        uptime: 0,
+        requests: 0,
+        errors: 0,
+        healthStatus: "healthy"
+      }
+    };
+    this.services.set(config.id, state);
+    this.handlers.set(config.id, handler);
+    this.configs.set(config.id, config);
+    logger.info(`Service registered: ${config.name}`, {
+      id: config.id,
+      type: config.type,
+      autoStart: config.autoStart
+    });
+    this.emit("registered", state);
+    if (config.autoStart) {
+      await this.start(config.id);
+    }
+    if (config.healthCheckInterval && config.healthCheckInterval > 0) {
+      this.startHealthCheck(config.id, config.healthCheckInterval);
+    }
+  }
+  /**
+   * Start a registered service.
+   *
+   * @param id - Service identifier
+   * @throws Error if service is not found
+   */
+  async start(id) {
+    const state = this.services.get(id);
+    const handler = this.handlers.get(id);
+    if (!state || !handler) {
+      throw new Error(`Service ${id} not found`);
+    }
+    if (state.status === "running" || state.status === "starting") {
+      logger.debug(`Service ${state.name} already ${state.status}`);
+      return;
+    }
+    state.status = "starting";
+    this.emit("starting", state);
+    try {
+      await handler.start();
+      state.status = "running";
+      state.startTime = /* @__PURE__ */ new Date();
+      state.lastError = void 0;
+      logger.info(`Service started: ${state.name}`);
+      this.emit("started", state);
+    } catch (error) {
+      state.status = "failed";
+      state.lastError = error instanceof Error ? error.message : String(error);
+      state.metrics.errors++;
+      logger.error(`Service failed to start: ${state.name}`, void 0, { error: state.lastError });
+      this.emit("failed", state);
+      await this.handleFailure(id);
+    }
+  }
+  /**
+   * Stop a running service.
+   *
+   * @param id - Service identifier
+   * @throws Error if service is not found
+   */
+  async stop(id) {
+    const state = this.services.get(id);
+    const handler = this.handlers.get(id);
+    if (!state || !handler) {
+      throw new Error(`Service ${id} not found`);
+    }
+    if (state.status === "stopped" || state.status === "stopping") {
+      logger.debug(`Service ${state.name} already ${state.status}`);
+      return;
+    }
+    state.status = "stopping";
+    this.emit("stopping", state);
+    try {
+      await handler.stop();
+      state.status = "stopped";
+      if (state.startTime) {
+        state.metrics.uptime += Date.now() - state.startTime.getTime();
+      }
+      logger.info(`Service stopped: ${state.name}`);
+      this.emit("stopped", state);
+    } catch (error) {
+      state.status = "failed";
+      state.lastError = error instanceof Error ? error.message : String(error);
+      state.metrics.errors++;
+      logger.error(`Service failed to stop: ${state.name}`, void 0, { error: state.lastError });
+      this.emit("failed", state);
+    }
+  }
+  /**
+   * Restart a service.
+   *
+   * @param id - Service identifier
+   * @throws Error if service is not found
+   */
+  async restart(id) {
+    const state = this.services.get(id);
+    if (!state) {
+      throw new Error(`Service ${id} not found`);
+    }
+    logger.info(`Restarting service: ${state.name}`);
+    state.restarts++;
+    await this.stop(id);
+    await this.start(id);
+    this.emit("restarted", state);
+  }
+  /**
+   * Handle service failure with optional auto-restart.
+   */
+  async handleFailure(id) {
+    const state = this.services.get(id);
+    const config = this.configs.get(id);
+    if (!state || !config) return;
+    if (!config.restartOnFailure) return;
+    const maxRestarts = config.maxRestarts ?? 3;
+    if (state.restarts >= maxRestarts) {
+      logger.error(`Service ${state.name} exceeded max restarts (${maxRestarts})`);
+      return;
+    }
+    const delay = config.restartDelay ?? 1e3;
+    logger.info(`Scheduling restart for ${state.name} in ${delay}ms`);
+    await new Promise((resolve) => setTimeout(resolve, delay));
+    if (!this.isShuttingDown && state.status === "failed") {
+      state.restarts++;
+      await this.start(id);
+    }
+  }
+  /**
+   * Get the current state of a service.
+   *
+   * @param id - Service identifier
+   * @returns Service state or undefined if not found
+   */
+  getStatus(id) {
+    const state = this.services.get(id);
+    if (!state) return void 0;
+    const handler = this.handlers.get(id);
+    if (handler && state.status === "running") {
+      const metrics = handler.getMetrics();
+      state.metrics = { ...state.metrics, ...metrics };
+    }
+    return { ...state };
+  }
+  /**
+   * List all registered services.
+   *
+   * @returns Array of service states
+   */
+  listServices() {
+    return Array.from(this.services.values()).map((state) => ({ ...state }));
+  }
+  /**
+   * Get services by type.
+   *
+   * @param type - Service type to filter by
+   * @returns Array of matching service states
+   */
+  getServicesByType(type) {
+    return this.listServices().filter((s) => s.type === type);
+  }
+  /**
+   * Get services by status.
+   *
+   * @param status - Service status to filter by
+   * @returns Array of matching service states
+   */
+  getServicesByStatus(status) {
+    return this.listServices().filter((s) => s.status === status);
+  }
+  /**
+   * Start periodic health checks for a service.
+   */
+  startHealthCheck(id, interval) {
+    const existingTimer = this.healthCheckTimers.get(id);
+    if (existingTimer) {
+      clearInterval(existingTimer);
+    }
+    const timer = setInterval(async () => {
+      if (this.isShuttingDown) return;
+      const handler = this.handlers.get(id);
+      const state = this.services.get(id);
+      if (!handler || !state || state.status !== "running") return;
+      try {
+        const healthy = await handler.healthCheck();
+        state.metrics.lastHealthCheck = /* @__PURE__ */ new Date();
+        if (healthy) {
+          state.metrics.healthStatus = "healthy";
+        } else {
+          state.metrics.healthStatus = "degraded";
+          logger.warn(`Service ${state.name} health check returned unhealthy`);
+        }
+        this.emit("healthCheck", { id, healthy });
+      } catch (error) {
+        state.metrics.healthStatus = "unhealthy";
+        state.metrics.errors++;
+        logger.error(
+          `Service ${state.name} health check failed`,
+          error instanceof Error ? error : void 0
+        );
+        this.emit("healthCheck", { id, healthy: false });
+      }
+    }, interval);
+    this.healthCheckTimers.set(id, timer);
+    logger.debug(`Started health checks for ${id} every ${interval}ms`);
+  }
+  /**
+   * Stop health checks for a service.
+   */
+  stopHealthCheck(id) {
+    const timer = this.healthCheckTimers.get(id);
+    if (timer) {
+      clearInterval(timer);
+      this.healthCheckTimers.delete(id);
+    }
+  }
+  /**
+   * Unregister a service.
+   *
+   * @param id - Service identifier
+   */
+  async unregister(id) {
+    const state = this.services.get(id);
+    if (!state) return;
+    if (state.status === "running" || state.status === "starting") {
+      await this.stop(id);
+    }
+    this.stopHealthCheck(id);
+    this.services.delete(id);
+    this.handlers.delete(id);
+    this.configs.delete(id);
+    logger.info(`Service unregistered: ${state.name}`);
+  }
+  /**
+   * Check if manager is shutting down.
+   */
+  get shuttingDown() {
+    return this.isShuttingDown;
+  }
+  /**
+   * Gracefully shutdown all services.
+   */
+  async shutdown() {
+    if (this.isShuttingDown) {
+      logger.debug("Shutdown already in progress");
+      return;
+    }
+    this.isShuttingDown = true;
+    logger.info("Shutting down all services...");
+    const timerEntries = Array.from(this.healthCheckTimers.entries());
+    for (const [id, timer] of timerEntries) {
+      clearInterval(timer);
+      logger.debug(`Cleared health check timer for ${id}`);
+    }
+    this.healthCheckTimers.clear();
+    const serviceIds = Array.from(this.services.keys());
+    const stopPromises = serviceIds.map(async (id) => {
+      try {
+        await this.stop(id);
+      } catch (error) {
+        logger.error(
+          `Error stopping service ${id}`,
+          error instanceof Error ? error : void 0
+        );
+      }
+    });
+    await Promise.allSettled(stopPromises);
+    this.services.clear();
+    this.handlers.clear();
+    this.configs.clear();
+    logger.info("All services stopped");
+    this.emit("shutdown");
+  }
+  /**
+   * Get aggregate metrics for all services.
+   */
+  getAggregateMetrics() {
+    const services = this.listServices();
+    return {
+      totalServices: services.length,
+      running: services.filter((s) => s.status === "running").length,
+      stopped: services.filter((s) => s.status === "stopped").length,
+      failed: services.filter((s) => s.status === "failed").length,
+      totalRequests: services.reduce((sum, s) => sum + s.metrics.requests, 0),
+      totalErrors: services.reduce((sum, s) => sum + s.metrics.errors, 0),
+      healthyCount: services.filter((s) => s.metrics.healthStatus === "healthy").length
+    };
+  }
+}
+function createServiceManager() {
+  return new ServiceManager();
+}
+export {
+  ServiceManager,
+  createServiceManager
+};
+//# sourceMappingURL=manager.js.map