chore(release): 1.2.6 [skip ci]

### Updates

* Bump version to 1.2.6 in package-lock.json
* Enhance logging in NovelAI class to include sizes of included images and masks
* Implement default handling for director reference fields in metadata processing
* Add new DirectorReferenceDescription interface to types

Author: Yukimi Kazari

package-lock.json

@@ -141,8 +141,14 @@ export class NovelAI {
 
 
     if (this.verbose) {
-      console.debug(`[Headers] for image generation:`, headers);
-      console.debug(`[Payload] for image generation:`, jsonPayload);
+      let cleanPlayload = { ...payload };
+      cleanPlayload.parameters = {
+        ...cleanPlayload.parameters,
+        image: !!cleanPlayload?.parameters?.image ? ("included with " + cleanPlayload.parameters.image.length + " bytes") : undefined,
+        mask: !!cleanPlayload?.parameters?.mask ? ("included with " + cleanPlayload.parameters.mask.length + " bytes") : undefined,
+      }
+      console.log(`[Headers] for image generation:`, headers);
+      console.info(`[Payload] for image generation:`, JSON.stringify(cleanPlayload));
     }
 
     // process.exit(-1);

src/client.ts

@@ -92,6 +92,10 @@ export class MetadataProcessor {
     metadata.normalize_reference_strength_multiple ?? true;
     metadata.reference_image_multiple = metadata.reference_image_multiple ?? undefined;
     metadata.reference_strength_multiple = metadata.reference_strength_multiple ?? undefined;
+
+    // Handle director reference defaults
+    this.applyDirectorReferenceDefaults(metadata);
+
     metadata.stream = undefined;
   }
 
@@ -461,6 +465,62 @@ export class MetadataProcessor {
     };
   }
 
+  /**
+   * Apply default values for director reference fields
+   * Ensures arrays have consistent lengths when director_reference_images is provided
+   * Removes all director reference parameters if no images are provided
+   *
+   * @param metadata - Metadata to update
+   * @private
+   */
+  private applyDirectorReferenceDefaults(metadata: Metadata): void {
+    // If no director reference images provided, remove all director reference parameters
+    if (!metadata.director_reference_images?.length) {
+      delete metadata.director_reference_descriptions;
+      delete metadata.director_reference_images;
+      delete metadata.director_reference_information_extracted;
+      delete metadata.director_reference_strength_values;
+      return;
+    }
+
+    const imageCount = metadata.director_reference_images.length;
+
+    // Initialize arrays if not provided
+    metadata.director_reference_descriptions = metadata.director_reference_descriptions ?? [];
+    metadata.director_reference_information_extracted = metadata.director_reference_information_extracted ?? [];
+    metadata.director_reference_strength_values = metadata.director_reference_strength_values ?? [];
+
+    // Ensure all arrays have the same length as director_reference_images
+    while (metadata.director_reference_descriptions.length < imageCount) {
+      metadata.director_reference_descriptions.push({
+        caption: {
+          base_caption: "character",
+          char_captions: []
+        },
+        legacy_uc: false
+      });
+    }
+
+    while (metadata.director_reference_information_extracted.length < imageCount) {
+      metadata.director_reference_information_extracted.push(1);
+    }
+
+    while (metadata.director_reference_strength_values.length < imageCount) {
+      metadata.director_reference_strength_values.push(1);
+    }
+
+    // Trim arrays if they're longer than the image count
+    if (metadata.director_reference_descriptions.length > imageCount) {
+      metadata.director_reference_descriptions = metadata.director_reference_descriptions.slice(0, imageCount);
+    }
+    if (metadata.director_reference_information_extracted.length > imageCount) {
+      metadata.director_reference_information_extracted = metadata.director_reference_information_extracted.slice(0, imageCount);
+    }
+    if (metadata.director_reference_strength_values.length > imageCount) {
+      metadata.director_reference_strength_values = metadata.director_reference_strength_values.slice(0, imageCount);
+    }
+  }
+
   /**
    * Get width and height from a resolution preset
    *

src/metadata.ts

@@ -134,6 +134,14 @@ export interface V4Img2Img {
   color_correct: boolean;
 }
 
+/**
+ * Director reference description format
+ */
+export interface DirectorReferenceDescription {
+  caption: V4CaptionFormat;
+  legacy_uc: boolean;
+}
+
 // Core metadata
 export interface Metadata {
   // General parameters
@@ -182,6 +190,12 @@ export interface Metadata {
   reference_information_extracted_multiple?: number[]; // Will be converted to reference_information_extracted_multiple
   reference_strength_multiple?: number[]; // Will be converted to reference_strength_multiple
 
+  // Director reference settings
+  director_reference_descriptions?: DirectorReferenceDescription[]; // Will be converted to director_reference_descriptions
+  director_reference_images?: string[]; // Will be converted to director_reference_images
+  director_reference_information_extracted?: number[]; // Will be converted to director_reference_information_extracted
+  director_reference_strength_values?: number[]; // Will be converted to director_reference_strength_values
+
   // V4/V4.5 specific settings
   params_version?: 1 | 2 | 3; // Will be converted to params_version
   autoSmea?: boolean;