interface EntityStoreSetupContract {
  registerEntityMaintainer: (config: RegisterEntityMaintainerConfig) => void;
}

interface EntityStoreStartContract {
  createCRUDClient: (
    esClient: ElasticsearchClient, 
    namespace: string, 
    getWorkflowsClient?: () => Promise<{
      emitEvent: (triggerId: string, payload: Record<string, unknown>) => Promise<void>;
    }>
  ) => EntityStoreCRUDClient; // Exposes create + update only
  createResolutionClient: (esClient: ElasticsearchClient, namespace: string) => ResolutionClient;
}

interface EntityStoreApiRequestHandlerContext {
  core: CoreRequestHandlerContext;
  logger: Logger;
  assetManagerClient: AssetManagerClient;         // Engine lifecycle
  entityMaintainersClient: EntityMaintainersClient; // Maintainer management
  crudClient: CRUDClient;                         // Entity CRUD operations
  resolutionClient: ResolutionClient;             // Link/unlink/group
  ccsLogsExtractionClient: CcsLogsExtractionClient; // Cross-cluster extraction
  logsExtractionClient: LogsExtractionClient;     // Standard logs extraction
  historySnapshotClient: HistorySnapshotClient;   // History snapshots
  featureFlags: FeatureFlags;
  security: SecurityPluginStart;
  namespace: string;
}