Initial install of ruby-llm.

Author: justinlittman

Gemfile

@@ -42,16 +42,20 @@ gem 'image_processing', '~> 1.2'
 gem 'action_policy'
 gem 'blanks' # ActiveRecord-like forms.
 gem 'cocina_display'
+gem 'commonmarker' # For rendering markdown in system and tool messages.
 gem 'config'
 gem 'csv'
 gem 'dor-services-client', '~> 15.1'
 gem 'dry-monads'
+gem 'googleauth' # For Vertex AI authentication
+gem 'hashdiff' # For showing differences between original and updated cocina descriptions.
 gem 'honeybadger'
 gem 'mission_control-jobs'
 gem 'okcomputer'
 gem 'roo' # work with newer Excel files and other types (xlsx, ods, csv).
 # Note that dropping roo-xls for older xls support since not updated for roo 3.x.
 gem 'rsolr'
+gem 'ruby_llm'
 gem 'sdr_view_components'
 gem 'view_component'
 

Gemfile.lock

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# Agent that determines the Cocina field that is being updated based on the user's request.
+class CocinaDescriptionClassifierAgent < RubyLLM::Agent
+  model 'gemini-3.1-flash-lite-preview', provider: Rails.env.production? ? :vertexai : :gemini
+
+  instructions
+  schema do
+    string :field,
+           enum: %w[title contributor event form language note identifier subject access geographic
+                    relatedResource adminMetadata marcEncodedData valueAt none]
+  end
+  thinking effort: :low
+  temperature 1.0 # With Gemini 3+, recommended to keep >= 1.0
+end

app/agents/.gitkeep

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Agent that updates a Cocina description based on the user's request.
+class CocinaDescriptionEditorAgent < RubyLLM::Agent
+  # model 'gemini-3-flash-preview', provider: Rails.env.production? ? :vertexai : :gemini
+  model 'gemini-3.1-flash-lite-preview', provider: Rails.env.production? ? :vertexai : :gemini
+  chat_model Chat
+  tools UrlFetchTool, ModelTool
+  params generationConfig: { responseMimeType: 'application/json' }
+  temperature 1.0 # With Gemini 3+, recommended to keep >= 1.0
+  thinking effort: :medium
+end

app/agents/cocina_description_classifier_agent.rb

@@ -3,6 +3,7 @@
 @import 'bl_facets';
 @import 'search';
 @import 'show';
+@import 'show_editor';
 
 /* Header color */
 .stone-dark {

app/agents/cocina_description_editor_agent.rb

@@ -0,0 +1,17 @@
+// Styles for the show editor page
+
+.container:has(div[data-description-changed="true"]) #save-btn {
+  display: block;
+}
+
+#save-btn {
+  display: none;
+}
+
+.container:has(#system-and-tool-messages div) #system-messages-btn {
+  display: inline-block;
+}
+
+#system-messages-btn {
+  display: none;
+}

app/assets/stylesheets/application.bootstrap.scss

@@ -0,0 +1,5 @@
+<div class="card" id="cocina-description-card">
+  <div class="card-body">
+    <%= render Elements::JsonViewerComponent.new(hash: cocina_description_hash, expanded: 1, show_tip: true) %>
+  </div>
+</div>

app/assets/stylesheets/show_editor.scss

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module DescriptionEditor
+  class CocinaDescriptionCardComponent < ApplicationComponent
+    def initialize(cocina_description_hash:)
+      @cocina_description_hash = cocina_description_hash
+      super()
+    end
+
+    private
+
+    attr_reader :cocina_description_hash
+  end
+end

app/components/description_editor/cocina_description_card_component.html.erb

@@ -0,0 +1,2 @@
+<div class="fst-italic fw-semibold"><%= change_type %> at <%= path %>:</div>
+<%= render Elements::JsonViewerComponent.new(hash: change_value, show_toolbar: false) %>