fix(higgsfield): address review findings

- Split training image URLs on line breaks only so URLs containing commas stay intact
- Limit the Soul ID skill to v1 characters, the version Generate SOUL Image accepts
- Let the canvas noun name the object in Get and Delete Character sentences
- Mark outputs that can be null as nullable

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: myxamediyar

apps/sim/blocks/blocks/higgsfield.ts

@@ -50,11 +50,9 @@ export const HiggsfieldBlock: BlockConfig = {
           { text: 'Train character', field: 'name', core: true },
           { text: 'from', field: 'imageUrls' },
         ],
-        higgsfield_get_character: [{ text: 'Read character', field: 'characterId', core: true }],
+        higgsfield_get_character: [{ text: 'Read', field: 'characterId', core: true }],
         higgsfield_list_characters: ['List Soul ID characters'],
-        higgsfield_delete_character: [
-          { text: 'Delete character', field: 'characterId', core: true },
-        ],
+        higgsfield_delete_character: [{ text: 'Delete', field: 'characterId', core: true }],
       },
     },
   },
@@ -470,7 +468,7 @@ export const HiggsfieldBlockMeta = {
       name: 'train-higgsfield-soul-id-character',
       description: 'Train a reusable Soul ID character and use it for consistent SOUL images.',
       content:
-        '# Train a Higgsfield Soul ID Character\n\nKeep the same person or mascot consistent across generated images.\n\n## Steps\n1. Collect 1 to 100 public URLs of clear reference photos with varied angles and lighting.\n2. Create the character with the SOUL version it will be used with (v1, v2, or cinema).\n3. Check the character with Get Character until its status is completed or failed.\n4. Pass the completed character ID to Generate SOUL Image; adjust character strength if the likeness is too weak or too strong.\n5. Delete characters that are no longer needed.\n\n## Output\nThe character ID and status, plus any generated image URLs.\n\nReference: https://docs.higgsfield.ai/docs/models/soul-id/create-character',
+        '# Train a Higgsfield Soul ID Character\n\nKeep the same person or mascot consistent across generated images.\n\n## Steps\n1. Collect 1 to 100 public URLs of clear reference photos with varied angles and lighting.\n2. Create the character with SOUL version v1, the version Generate SOUL Image accepts.\n3. Check the character with Get Character until its status is completed or failed.\n4. Pass the completed character ID to Generate SOUL Image; adjust character strength if the likeness is too weak or too strong.\n5. Delete characters that are no longer needed.\n\n## Output\nThe character ID and status, plus any generated image URLs.\n\nReference: https://docs.higgsfield.ai/docs/models/soul-id/create-character',
     },
     {
       name: 'manage-higgsfield-requests',

apps/sim/tools/generated/tool-outputs.ts

@@ -14,7 +14,7 @@ import type { ToolConfig } from '@/tools/types'
 
 const MAX_TRAINING_IMAGES = 100
 
-/** Accepts a JSON array or a newline/comma-separated list of image URLs. */
+/** Accepts a JSON array or one image URL per line; URLs may themselves contain commas. */
 function parseImageUrls(value: HiggsfieldCreateCharacterParams['imageUrls']): string[] {
   let items: unknown = value
   if (typeof value === 'string') {
@@ -26,7 +26,7 @@ function parseImageUrls(value: HiggsfieldCreateCharacterParams['imageUrls']): st
         throw new Error('Image URLs must be a JSON array or a list of URLs')
       }
     } else {
-      items = trimmed.split(/[\n,]/)
+      items = trimmed.split('\n')
     }
   }
   if (!Array.isArray(items)) throw new Error('Image URLs must be a list of URLs')

apps/sim/tools/higgsfield/create_character.ts

@@ -70,9 +70,9 @@ export const higgsfieldListCharactersTool: ToolConfig<
       description: 'Character references on this page',
       items: { type: 'object', properties: HIGGSFIELD_CHARACTER_PROPERTIES },
     },
-    total: { type: 'number', description: 'Total number of characters', optional: true },
-    page: { type: 'number', description: 'Current page number', optional: true },
-    pageSize: { type: 'number', description: 'Characters per page', optional: true },
-    totalPages: { type: 'number', description: 'Total number of pages', optional: true },
+    total: { type: 'number', description: 'Total number of characters', nullable: true },
+    page: { type: 'number', description: 'Current page number', nullable: true },
+    pageSize: { type: 'number', description: 'Characters per page', nullable: true },
+    totalPages: { type: 'number', description: 'Total number of pages', nullable: true },
   },
 }

apps/sim/tools/higgsfield/list_characters.ts

@@ -109,42 +109,43 @@ export const HIGGSFIELD_REQUEST_OUTPUTS = {
     type: 'string',
     description: 'Request status: queued, in_progress, completed, failed, nsfw, or canceled',
   },
-  error: { type: 'string', description: 'Failure reason, when provided', optional: true },
+  error: { type: 'string', description: 'Failure reason, when provided', nullable: true },
   imageUrls: {
     type: 'array',
     description: 'Generated image URLs (image models)',
     items: { type: 'string', description: 'Image URL' },
   },
-  videoUrl: { type: 'string', description: 'Generated video URL (video models)', optional: true },
-  audioUrl: { type: 'string', description: 'Generated audio URL (audio output)', optional: true },
+  videoUrl: { type: 'string', description: 'Generated video URL (video models)', nullable: true },
+  audioUrl: { type: 'string', description: 'Generated audio URL (audio output)', nullable: true },
   audioUrls: {
     type: 'array',
     description: 'Generated audio URLs (audio output)',
     items: { type: 'string', description: 'Audio URL' },
   },
-  statusUrl: { type: 'string', description: 'URL for checking the request status', optional: true },
+  statusUrl: { type: 'string', description: 'URL for checking the request status', nullable: true },
   cancelUrl: {
     type: 'string',
     description: 'URL for canceling the queued request',
-    optional: true,
+    nullable: true,
   },
   expiresAt: {
     type: 'string',
     description: 'When the output files are deleted and their URLs stop working',
-    optional: true,
+    nullable: true,
   },
 } as const satisfies Record<string, ToolOutputProperty>
 
 export const HIGGSFIELD_CHARACTER_PROPERTIES = {
   id: { type: 'string', description: 'Character (Soul ID) reference ID' },
-  name: { type: 'string', description: 'Character name' },
-  modelVersion: { type: 'string', description: 'SOUL family: v1, v2, or cinema' },
+  name: { type: 'string', description: 'Character name', nullable: true },
+  modelVersion: { type: 'string', description: 'SOUL family: v1, v2, or cinema', nullable: true },
   status: {
     type: 'string',
     description: 'Training status: not_ready, queued, in_progress, completed, or failed',
+    nullable: true,
   },
-  thumbnailUrl: { type: 'string', description: 'Thumbnail image URL', optional: true },
-  createdAt: { type: 'string', description: 'Creation timestamp', optional: true },
-  inProgressAt: { type: 'string', description: 'Training start timestamp', optional: true },
-  failReason: { type: 'string', description: 'Training failure reason', optional: true },
+  thumbnailUrl: { type: 'string', description: 'Thumbnail image URL', nullable: true },
+  createdAt: { type: 'string', description: 'Creation timestamp', nullable: true },
+  inProgressAt: { type: 'string', description: 'Training start timestamp', nullable: true },
+  failReason: { type: 'string', description: 'Training failure reason', nullable: true },
 } as const satisfies Record<string, ToolOutputProperty>