[Firebase AI] Add Generable macro for schema generation

.github/workflows/common.yml

@@ -52,40 +52,10 @@ on:
         required: false
         default: ""
 
-    outputs:
-      cache_key:
-        description: "The cache key for the Swift package resolution."
-        value: ${{ jobs.spm-package-resolved.outputs.cache_key }}
-
 jobs:
-  spm-package-resolved:
-    env:
-      FIREBASECI_USE_LATEST_GOOGLEAPPMEASUREMENT: 1
-    runs-on: macos-15
-    outputs:
-      cache_key: ${{ steps.generate_cache_key.outputs.cache_key }}
-    steps:
-      - uses: actions/checkout@v4
-      - name: Xcode
-        run: sudo xcode-select -s /Applications/Xcode_16.4.app/Contents/Developer
-      - name: Generate Swift Package.resolved
-        id: swift_package_resolve
-        run: swift package resolve
-      - name: Generate cache key
-        id: generate_cache_key
-        run: |
-          cache_key="${{ runner.os }}-spm-${{ hashFiles('**/Package.resolved') }}"
-          echo "cache_key=${cache_key}" >> "$GITHUB_OUTPUT"
-      - uses: actions/cache/save@v4
-        id: cache
-        with:
-          path: .build
-          key: ${{ steps.generate_cache_key.outputs.cache_key }}
-
   spm:
     # Run on the main repo's scheduled jobs or pull requests and manual workflow invocations.
     if: (github.repository == 'firebase/firebase-ios-sdk' && github.event_name == 'schedule') || contains(fromJSON('["pull_request", "workflow_dispatch"]'), github.event_name)
-    needs: [spm-package-resolved]
     strategy:
       matrix:
         os: [macos-15]
@@ -101,10 +71,6 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v4
-    - uses: actions/cache/restore@v4
-      with:
-        path: .build
-        key: ${{needs.spm-package-resolved.outputs.cache_key}}
     - name: Xcode
       run: sudo xcode-select -s /Applications/${{ matrix.xcode }}.app/Contents/Developer
     - name: Run setup command, if needed.

.github/workflows/firebaseai.yml

@@ -95,6 +95,8 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Xcode
-      run: sudo xcode-select -s /Applications/${{ matrix.xcode }}.app/Contents/Developer
+      run: |
+        sudo xcode-select -s /Applications/${{ matrix.xcode }}.app/Contents/Developer
+        defaults write com.apple.dt.Xcode IDEPackageEnablePrebuilts NO
     - name: Build Quickstart
       run: scripts/quickstart_build_spm.sh FirebaseAI

FirebaseAI/Sources/Macros/FirebaseAILogicPlugin.swift

@@ -0,0 +1,23 @@
+// 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 SwiftCompilerPlugin
+import SwiftSyntaxMacros
+
+@main
+struct FirebaseAILogicPlugin: CompilerPlugin {
+  let providingMacros: [Macro.Type] = [
+    StringifyMacro.self,
+  ]
+}

FirebaseAI/Sources/Macros/StringifyMacro.swift

@@ -0,0 +1,37 @@
+// 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 SwiftSyntax
+import SwiftSyntaxBuilder
+import SwiftSyntaxMacros
+
+/// Implementation of the `stringify` macro, which takes an expression
+/// of any type and produces a tuple containing the value of that expression
+/// and the source code that produced the value. For example
+///
+///     #stringify(x + y)
+///
+///  will expand to
+///
+///     (x + y, "x + y")
+public struct StringifyMacro: ExpressionMacro {
+  public static func expansion(of node: some FreestandingMacroExpansionSyntax,
+                               in context: some MacroExpansionContext) -> ExprSyntax {
+    guard let argument = node.arguments.first?.expression else {
+      fatalError("compiler bug: the macro does not have any arguments")
+    }
+
+    return "(\(argument), \(literal: argument.description))"
+  }
+}

FirebaseAI/Sources/Types/Public/Generable/ConvertibleFromModelOutput.swift

@@ -0,0 +1,44 @@
+// 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 can be initialized from model output.
+@available(iOS 15.0, macOS 12.0, macCatalyst 15.0, tvOS 15.0, watchOS 8.0, *)
+public protocol ConvertibleFromModelOutput: SendableMetatype {
+  /// Creates an instance from content generated by a model.
+  ///
+  /// Conformance to this protocol is provided by the `@Generable` macro. A manual implementation
+  /// may be used to map values onto properties using different names. To manually initialize your
+  /// type from model output, decode the values as shown below:
+  ///
+  /// ```swift
+  /// struct Person: ConvertibleFromModelOutput {
+  ///     var name: String
+  ///     var age: Int
+  ///
+  ///     init(_ content: ModelOutput) {
+  ///         self.name = try content.value(forProperty: "firstName")
+  ///         self.age = try content.value(forProperty: "ageInYears")
+  ///     }
+  /// }
+  /// ```
+  ///
+  /// - Important: If your type also conforms to ``ConvertibleToModelOutput``, it is critical
+  /// that this implementation be symmetrical with
+  /// ``ConvertibleToModelOutput/modelOutput``.
+  ///
+  /// - SeeAlso: `@Generable` macro ``Generable(description:)``
+  init(_ content: ModelOutput) throws
+}

FirebaseAI/Sources/Types/Public/Generable/ConvertibleToModelOutput.swift

@@ -0,0 +1,43 @@
+// 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.
+
+/// A type that can be converted to model output.
+@available(iOS 15.0, macOS 12.0, macCatalyst 15.0, tvOS 15.0, watchOS 8.0, *)
+public protocol ConvertibleToModelOutput {
+  /// This instance represented as model output.
+  ///
+  /// Conformance to this protocol is provided by the `@Generable` macro. A manual implementation
+  /// may be used to map values onto properties using different names. Use the `modelOutput`
+  /// property as shown below, to manually return a new ``ModelOutput`` with the properties
+  /// you specify.
+  ///
+  /// ```swift
+  /// struct Person: ConvertibleToModelOutput {
+  ///    var name: String
+  ///    var age: Int
+  ///
+  ///    var modelOutput: ModelOutput {
+  ///        ModelOutput(properties: [
+  ///            "firstName": name,
+  ///            "ageInYears": age
+  ///        ])
+  ///    }
+  /// }
+  /// ```
+  ///
+  /// - Important: If your type also conforms to ``ConvertibleFromModelOutput``, it is
+  /// critical that this implementation be symmetrical with
+  /// ``ConvertibleFromModelOutput/init(_:)``.
+  var modelOutput: ModelOutput { get }
+}