firebase-ios-sdk/FirebaseAI/Sources/TemplateGenerativeModel.swift

// Copyright 2025 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

import Foundation

/// A type that represents a remote multimodal model (like Gemini), with the ability to generate
/// content based on various input types.
@available(iOS 15.0, macOS 12.0, macCatalyst 15.0, tvOS 15.0, watchOS 8.0, *)
public final class TemplateGenerativeModel: Sendable {
  let generativeAIService: GenerativeAIService
  let apiConfig: APIConfig

  init(generativeAIService: GenerativeAIService, apiConfig: APIConfig) {
    self.generativeAIService = generativeAIService
    self.apiConfig = apiConfig
  }

  /// Generates content from a prompt template and variables.
  ///
  /// - Parameters:
  ///   - template: The prompt template to use.
  ///   - variables: A dictionary of variables to substitute into the template.
  /// - Returns: The content generated by the model.
  /// - Throws: A ``GenerateContentError`` if the request failed.
  public func generateContent(template: String,
                              variables: [String: Any],
                              options: RequestOptions = RequestOptions()) async throws
    -> GenerateContentResponse {
    let templateVariables = try variables.mapValues { try TemplateVariable(value: $0) }
    return try await generateContentWithHistory(
      history: [],
      template: template,
      variables: templateVariables,
      options: options
    )
  }

  /// Generates content from a prompt template, variables, and history.
  ///
  /// - Parameters:
  ///   - history: The conversation history to use.
  ///   - template: The prompt template to use.
  ///   - variables: A dictionary of variables to substitute into the template.
  /// - Returns: The content generated by the model.
  /// - Throws: A ``GenerateContentError`` if the request failed.
  func generateContentWithHistory(history: [ModelContent], template: String,
                                  variables: [String: TemplateVariable],
                                  options: RequestOptions = RequestOptions()) async throws
    -> GenerateContentResponse {
    let request = TemplateGenerateContentRequest(
      template: template,
      variables: variables,
      history: history,
      projectID: generativeAIService.firebaseInfo.projectID,
      stream: false,
      apiConfig: apiConfig,
      options: options
    )
    let response: GenerateContentResponse = try await generativeAIService
      .loadRequest(request: request)
    return response
  }

  public func generateContentStream(template: String,
                                    variables: [String: Any],
                                    options: RequestOptions = RequestOptions()) throws
    -> AsyncThrowingStream<GenerateContentResponse, Error> {
    let templateVariables = try variables.mapValues { try TemplateVariable(value: $0) }
    let request = TemplateGenerateContentRequest(
      template: template,
      variables: templateVariables,
      history: [],
      projectID: generativeAIService.firebaseInfo.projectID,
      stream: true,
      apiConfig: apiConfig,
      options: options
    )
    return generativeAIService.loadRequestStream(request: request)
  }

  func generateContentStreamWithHistory(history: [ModelContent], template: String,
                                        variables: [String: TemplateVariable],
                                        options: RequestOptions = RequestOptions()) throws
    -> AsyncThrowingStream<GenerateContentResponse, Error> {
    let request = TemplateGenerateContentRequest(
      template: template,
      variables: variables,
      history: history,
      projectID: generativeAIService.firebaseInfo.projectID,
      stream: true,
      apiConfig: apiConfig,
      options: options
    )
    return generativeAIService.loadRequestStream(request: request)
  }

  /// Creates a new chat conversation using this model with the provided history and template.
  ///
  /// - Parameters:
  ///   - template: The prompt template to use.
  ///   - history: The conversation history to use.
  /// - Returns: A new ``TemplateChatSession`` instance.
  public func startChat(template: String,
                        history: [ModelContent] = []) -> TemplateChatSession {
    return TemplateChatSession(
      model: self,
      template: template,
      history: history
    )
  }
}