antigravity-sdk 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 449edf2b1bf5f2aaa389a0e79b74c6ed93bc5b7623a957068b2bd704b292347b
-  data.tar.gz: c876958eb74ccac96717634b5a0c1d7314e837f2a3695a557d1d19eee4b6d853
+  metadata.gz: 6e2f8d1b432e31aa733976b69c28c01db1c0a8f7d109eb920e489d22ee0fa001
+  data.tar.gz: c1dec66ab20e10063913499f9811a8baf1aaf63bf1113d8008b4410e4a68b92a
 SHA512:
-  metadata.gz: 6ccc779048181412d94425b9a9c4901339acfb957e4646b047ce4fe1b96e4d2b4f4b6096c560178920f68b22733a6d424b3d010769e17b592f90bc77d2004220
-  data.tar.gz: e170353f68f1fdbe47ab3c487136be397636a8855223204e72b4d216bd37c7d04592f935d22b207314d9ecd35c95b7ef3741397204005b89eaccdb7564578427
+  metadata.gz: 3601db0d85ee97d1607f61b08091560382bb6ff648042c1bf5340c72c58bd5a3ba026bb79d152281d7a80bd1103542f6de19f86fa4a6a20076884db2cf718374
+  data.tar.gz: 457ba9d83a710200dfefa3d07b14a83a2349efcd19f46c2033addf550070bdf927e37f21a93109d36eeeb6dc84e536b829397315683049f00ef52b67f638961d

data/lib/antigravity/agent.rb

@@ -3,9 +3,9 @@
 module Antigravity
   class Agent
     attr_accessor :model, :system_instruction, :api_key
-    attr_reader :tools, :skills, :hooks, :sidecars, :client
+    attr_reader :tools, :skills, :hooks, :sidecars, :client, :logger_guard
 
-    def initialize(model: nil, &block)
+    def initialize(model: nil, auto_logger: true, &block)
       @model = model || Antigravity.config.default_model
       @api_key = Antigravity.config.api_key
       @system_instruction = nil
@@ -14,6 +14,12 @@ module Antigravity
       @sidecars = []
       @hooks = Hooks.new
       @client = Client.new
+      @logger_guard = nil
+
+      # Automagic Logger attachment unless disabled via ENV["ANTIGRAVITY_LOGGER"]=false or auto_logger: false
+      if auto_logger && logger_enabled?
+        attach_logger
+      end
 
       yield(self) if block_given?
     end
@@ -35,6 +41,12 @@ module Antigravity
       sidecar
     end
 
+    def attach_logger(log_target = nil, level: ::Logger::INFO, silent_notice: false)
+      @logger_guard = Guards::AgentLogger.new(log_target, level: level, silent_notice: silent_notice)
+      @logger_guard.attach_to(self)
+      @logger_guard
+    end
+
     def load_skill(skill_path)
       skill = Skill.load(skill_path)
       @skills << skill
@@ -74,5 +86,14 @@ module Antigravity
       response
     end
     alias ask prompt
+
+    private
+
+    def logger_enabled?
+      env_val = ENV["ANTIGRAVITY_LOGGER"]&.downcase
+      return false if %w[false 0 none no].include?(env_val)
+
+      true
+    end
   end
 end

data/lib/antigravity/guards.rb

@@ -1,7 +1,79 @@
 # frozen_string_literal: true
 
+require "logger"
+require "fileutils"
+
 module Antigravity
   module Guards
+    # Configurable opt-in logger guard supporting file loggers and Rails.logger
+    class AgentLogger
+      attr_reader :logger, :target_description
+
+      def initialize(log_target = nil, level: Logger::INFO, silent_notice: false)
+        resolved_target = resolve_log_target(log_target)
+
+        if resolved_target.is_a?(String)
+          dir = File.dirname(resolved_target)
+          FileUtils.mkdir_p(dir) unless Dir.exist?(dir)
+          @logger = ::Logger.new(resolved_target)
+          @target_description = resolved_target
+        elsif resolved_target.respond_to?(:info)
+          @logger = resolved_target
+          @target_description = "Rails.logger"
+        else
+          @logger = ::Logger.new($stdout)
+          @target_description = "$stdout"
+        end
+
+        @logger.level = level if @logger.respond_to?(:level=)
+
+        unless silent_notice
+          puts "🪵 Logging to #{@target_description}"
+        end
+      end
+
+      def before_prompt(prompt_text)
+        @logger.info("[Antigravity::Prompt] User: '#{prompt_text}'")
+      end
+
+      def after_response(response)
+        @logger.info("[Antigravity::Response] Assistant (#{response.model_id}): #{response.content.strip}")
+      end
+
+      def before_tool_call(tool_name, params)
+        @logger.info("[Antigravity::Tool] Executing '#{tool_name}' with params: #{params.inspect}")
+      end
+
+      def after_tool_call(tool_name, params, result)
+        @logger.info("[Antigravity::Tool] Result for '#{tool_name}': #{result}")
+        result
+      end
+
+      def attach_to(agent)
+        logger_guard = self
+        agent.before_prompt { |p| logger_guard.before_prompt(p) }
+        agent.after_response { |r| logger_guard.after_response(r) }
+        agent.before_tool_call { |t, p| logger_guard.before_tool_call(t, p) }
+        agent.after_tool_call { |t, p, r| logger_guard.after_tool_call(t, p, r) }
+      end
+
+      private
+
+      def resolve_log_target(target)
+        return target if target
+
+        if defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
+          Rails.logger
+        elsif ENV["RAILS_ENV"] && !ENV["RAILS_ENV"].empty?
+          "log/#{ENV['RAILS_ENV']}.log"
+        elsif ENV["RACK_ENV"] && !ENV["RACK_ENV"].empty?
+          "log/#{ENV['RACK_ENV']}.log"
+        else
+          "log/antigravity.log"
+        end
+      end
+    end
+
     # Configurable opt-in file protection guard
     class FileProtection
       DEFAULT_FILES = [

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: antigravity-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Riccardo Carlesso
@@ -37,6 +37,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
 description: An elegant, Ruby-like SDK for building autonomous AI agents with Google
   Antigravity.
 email: