Show depreciation warning

Author: danielfriis

lib/ruby_llm/schema/dsl/schema_builders.rb

@@ -44,7 +44,12 @@ def null_schema(description: nil)
           {type: "null", description: description}.compact
         end
 
-        def object_schema(description: nil, of: nil, &block)
+        def object_schema(description: nil, of: nil, reference: nil, &block)
+          if reference
+            warn "[DEPRECATION] The `reference` option will be deprecated. Please use `of` instead."
+            of = reference
+          end
+
           if of
             determine_object_reference(of, description)
           else

spec/ruby_llm/schema_spec.rb

@@ -249,7 +249,7 @@
       })
     end
 
-    it "supports reference to a defined schema by reference option" do
+    it "supports reference to a defined schema by `of` option" do
       schema_class.define :address do
         string :street
         string :city
@@ -274,6 +274,20 @@
         additionalProperties: false
       })
     end
+
+    it "shows deprecation warning if using `reference` instead of `of`" do
+      schema_class.define :address do
+        string :street
+        string :city
+      end
+
+      expect {
+        schema_class.object :user do
+          string :name
+          object :address, reference: :address
+        end
+      }.to output(/DEPRECATION.*reference/).to_stderr
+    end
   end
 
   # ===========================================