Function maybeLoadResponseFormatFromExternalFile

src/util/file.ts:436–473

(
  responseFormat: any,
  vars?: Record<string, VarValue>,
)

 * @returns The processed response_format with all files loaded
 */
export function maybeLoadResponseFormatFromExternalFile(
  responseFormat: any,
  vars?: Record<string, VarValue>,
): any {
  if (responseFormat === undefined || responseFormat === null) {
    return responseFormat;
  }

  // First, render variables and load the outer response_format
  const rendered = renderVarsInObject(responseFormat, vars);
  const loaded = maybeLoadFromExternalFile(rendered);

  if (!loaded || typeof loaded !== 'object') {
    return loaded;
  }

  // For json_schema type, check if the nested schema is a file reference
  if (loaded.type === 'json_schema') {
    const nestedSchema = loaded.schema || loaded.json_schema?.schema;

    if (nestedSchema) {
      // Render and load the nested schema
      const loadedSchema = maybeLoadFromExternalFile(renderVarsInObject(nestedSchema, vars));

      // Return with the loaded schema in place
      if (loaded.schema !== undefined) {
        return { ...loaded, schema: loadedSchema };
      } else if (loaded.json_schema?.schema !== undefined) {
        return {
          ...loaded,
          json_schema: { ...loaded.json_schema, schema: loadedSchema },
        };
      }
    }
  }

  return loaded;
}

/**
 * Renders variables in a tools object and loads from external file if applicable.