Function parseConfigSystemInstruction

src/providers/google/util.ts:1046–1082

(
  configSystemInstruction: Content | string | undefined,
  contextVars?: Record<string, VarValue>,
)

 * @returns Processed Content object or undefined
 */
export function parseConfigSystemInstruction(
  configSystemInstruction: Content | string | undefined,
  contextVars?: Record<string, VarValue>,
): Content | undefined {
  if (!configSystemInstruction) {
    return undefined;
  }

  // Make a copy to avoid mutating the original
  let configInstruction = clone(configSystemInstruction);

  // Load systemInstruction from file if it's a file path
  if (typeof configSystemInstruction === 'string') {
    configInstruction = loadFile(configSystemInstruction, contextVars);
  }

  // Convert string to Content structure
  if (typeof configInstruction === 'string') {
    configInstruction = { parts: [{ text: configInstruction }] };
  }

  // Render Nunjucks templates in all text parts
  if (contextVars && configInstruction) {
    const nunjucks = getNunjucksEngine();
    for (const part of configInstruction.parts) {
      if (part.text) {
        try {
          part.text = nunjucks.renderString(part.text, contextVars);
        } catch (err) {
          throw new Error(`Unable to render nunjucks in systemInstruction: ${err}`);
        }
      }
    }
  }

  return configInstruction;
}

export function geminiFormatAndSystemInstructions(
  prompt: string,