Implement {{charFirstMessage}} / {{greeting}} macro with alternate greeting indexing and substitution (#5220) * Initial plan * Implement {{firstMessage}} / {{greeting}} macro for character's first message Co-authored-by: Cohee1207 <18619528+Cohee1207@users.noreply.github.com> * Simplify firstMessage resolver to use || instead of ?? for consistency Co-authored-by: Cohee1207 <18619528+Cohee1207@users.noreply.github.com> * Remove {{firstMessage}} alias, add 0-based greeting index for alternate greetings Co-authored-by: Cohee1207 <18619528+Cohee1207@users.noreply.github.com> * Add alternateGreetings to env, apply substitution to greetings Co-authored-by: Cohee1207 <18619528+Cohee1207@users.noreply.github.com> * Remove legacy greeting macro, keep only new engine implementation Co-authored-by: Cohee1207 <18619528+Cohee1207@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: Cohee1207 <18619528+Cohee1207@users.noreply.github.com> Co-authored-by: anthropic-code-agent[bot] <242468646+Claude@users.noreply.github.com>

b5a1d227fde1f0ca2b0e7947fa993b4010f5c31a

Copilot <198982749+Copilot@users.noreply.github.com>

Signed

public/script.js+15 -0 Viewed

  * @property {string} version Character version
  * @property {string} charDepthPrompt Character depth note
  * @property {string} creatorNotes Character creator notes
+ * @property {string} firstMessage Character first message / greeting
+ * @property {string[]} alternateGreetings Character alternate greetings
  */
 /**

             const exampleDialog = chat_metadata.mes_example || character.mes_example || '';
             return baseChatReplace(exampleDialog.trim());
         },
+        firstMessage: () => {
+            if (!character) return '';
+            const firstMes = character.first_mes?.trim() || '';
+            return baseChatReplace(firstMes);
+        },
+        alternateGreetings: () => {
+            if (!character) return [];
+            const altGreetings = character.data?.alternate_greetings;
+            if (!Array.isArray(altGreetings)) return [];
+            return altGreetings.map(greeting => baseChatReplace(greeting?.trim()));
+        },
     };
     return createLazyFields(resolvers);

         version: lazy.version,
         charDepthPrompt: lazy.charDepthPrompt,
         creatorNotes: lazy.creatorNotes,
+        firstMessage: lazy.firstMessage,
+        alternateGreetings: lazy.alternateGreetings,
     };
+}

public/scripts/macros/definitions/env-macros.js+24 -0 Viewed

         handler: ({ env }) => env.character.creatorNotes ?? '',
     });
+    MacroRegistry.registerMacro('charFirstMessage', {
+        aliases: [{ alias: 'greeting' }],
+        category: MacroCategory.CHARACTER,
+        unnamedArgs: [
+            {
+                name: 'index',
+                optional: true,
+                defaultValue: '0',
+                type: MacroValueType.INTEGER,
+                description: '0-based index. 0 (default) returns the main greeting, 1 and up return alternate greetings.',
+            },
+        ],
+        description: 'The character\'s first message / greeting. Optionally specify an index to access alternate greetings.',
+        returns: 'Character greeting at the given index, or empty string if out of bounds.',
+        exampleUsage: ['{{greeting}}', '{{greeting::0}}', '{{greeting::1}}'],
+        handler: ({ env, unnamedArgs: [index] }) => {
+            const i = Number(index ?? 0);
+            if (i === 0) return env.character.firstMessage ?? '';
+            const altGreetings = env.character.alternateGreetings;
+            if (!Array.isArray(altGreetings)) return '';
+            return altGreetings[i - 1] ?? '';
+        },
+    });
     // Character version macros (legacy variants and documented {{charVersion}})
     MacroRegistry.registerMacro('charVersion', {
         aliases: [

public/scripts/macros/engine/MacroEnv.types.js+2 -0 Viewed

  * @property {string} [charDepthPrompt]
  * @property {string} [creatorNotes]
  * @property {string} [version]
+ * @property {string} [firstMessage]
+ * @property {string[]} [alternateGreetings]
  */
 /**

public/scripts/macros/engine/MacroEnvBuilder.js+10 -1 Viewed

                     ['version', 'version'],
                     ['charDepthPrompt', 'charDepthPrompt'],
                     ['creatorNotes', 'creatorNotes'],
+                    ['firstMessage', 'firstMessage'],
+                    ['alternateGreetings', 'alternateGreetings'],
                 ]);
                 for (const [envKey, fieldKey] of fieldMappings) {
                     Object.defineProperty(env.character, envKey, {
-                        get() { return fields[fieldKey] || ''; },
+                        get() {
+                            const value = fields[fieldKey];
+                            // alternateGreetings should default to [] instead of ''
+                            if (envKey === 'alternateGreetings') {
+                                return Array.isArray(value) ? value : [];
+                            }
+                            return value || '';
+                        },
                         enumerable: true,
                         configurable: true,
                     });

tests/frontend/MacroEnvBuilder.e2e.js+2 -0 Viewed

             'version',
             'charDepthPrompt',
             'creatorNotes',
+            'firstMessage',
+            'alternateGreetings',
         ]));
     });