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',
         ]));
     });