antigravity-sdk 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbeafe860899a22961b7c19a418337cb456594d683708d49b06b293711429c57
-  data.tar.gz: 7e0caad86e9aa6dd49e2f541ddb041ee9fc0518a21575bfe634b43cb3e879e94
+  metadata.gz: 665ab001fa484b0bc5ba97c2e7feb960712b0f8e5070ed521f0caf5ad0f16a58
+  data.tar.gz: 3f556321b1083daadea10792632ac216ba168abb26708fc5cc3a81824301d460
 SHA512:
-  metadata.gz: 624c1c92b64d248113fd1ef0bd02367c84097666a873b0cecda4063107719406533861faa4cd9baf401afe91ae91e7f2fe185d811027adc7521a09e4e51fa1ae
-  data.tar.gz: def792e62ad5f0c2b0c7198022453c5d28ccdf7b9c70668ce79207b81589e778310cd0779a58d13301902663b6c0b59e2db15ef57fcb99cc92105b41c505dbb8
+  metadata.gz: d60ff58a66fec4ed17a85ad51015568e743363f313eb1a27b9e6512a767ae5a7abca062796ae0bc19edbe59545202828415b693f6551b77a22d8a1ff5cca99ea
+  data.tar.gz: 9e09ed8b23e59d29f644d10f421b73d70f357c7d9fd601ba67ba429df8c2814768d0264084e5e6439cd9161d2f8c13313f6890bcd11faf6f66f7e43e3ea2578f

data/lib/antigravity/agent.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module Antigravity
-  class Agent
-    include Emojifiable
+  class Agent < Base
 
     attr_accessor :model, :system_instruction, :api_key
     attr_reader :tools, :skills, :hooks, :sidecars, :client, :logger_guard

data/lib/antigravity/base.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Antigravity
+  # Base class for all Antigravity domain objects.
+  # Subclasses automagically get .emoji / #emoji via Emojifiable.
+  #
+  # ⚠️  Keep this class SUPER thin!
+  # Every SDK class inherits from it, so any weight here
+  # is carried by Agent, Tool, Skill, Message, Sidecar::Runner, etc.
+  class Base
+    include Emojifiable
+
+    def self.inherited(subclass)
+      super
+      subclass.include(Emojifiable) unless subclass < Emojifiable
+    end
+  end
+end

data/lib/antigravity/emojis.rb

@@ -3,7 +3,7 @@
 module Antigravity
   EMOJIS = {
     gem: "💎",
-    agent: "💎",
+    agent: "🕵️‍♂️",
     prompt: "💬",
     response: "🤖",
     thinking: "🤔",
@@ -13,35 +13,60 @@ module Antigravity
     sidecar: "🚗",
     logger: "🪵",
     skill: "📁",
+    message: "💬",
     guard: "🛡️",
     test: "🧪",
-    success: "✅"
+    success: "✅",
+    unknown: "🤷"
+  }.freeze
+
+  # Name fragments we recognise in the class hierarchy
+  EMOJI_CLASS_MAP = {
+    "Agent" => :agent,
+    "Tool" => :tool,
+    "Sidecar" => :sidecar,
+    "Runner" => :sidecar,
+    "Skill" => :skill,
+    "Message" => :message,
+    "Chunk" => :message,
+    "Guard" => :guard,
+    "Logger" => :logger
   }.freeze
 
   class << self
     def emoji(key)
-      EMOJIS[key.to_sym] || "💎"
+      EMOJIS[key.to_sym] || EMOJIS[:unknown]
     end
 
     def emoji_for(target)
-      key = case target
-            when Message, Chunk
-              target.respond_to?(:role) && target.role == :user ? :prompt : :response
-            when Symbol, String
-              target
-            else
-              klass = target.is_a?(Class) || target.is_a?(Module) ? target : target.class
-              matched_part = klass.name&.split("::")&.reverse&.find do |part|
-                %w[Agent Tool Sidecar Skill Message Guard Logger].include?(part)
-              end
-              matched_part ? matched_part.downcase.to_sym : :gem
-            end
-
+      key = resolve_emoji_key(target)
       emoji(key)
     end
+
+    private
+
+    def resolve_emoji_key(target)
+      # Message/Chunk: role-aware
+      if target.is_a?(Message) || (defined?(Chunk) && target.is_a?(Chunk))
+        return target.respond_to?(:role) && target.role == :user ? :prompt : :response
+      end
+
+      # Direct symbol/string lookup
+      return target if target.is_a?(Symbol) || target.is_a?(String)
+
+      # Class hierarchy reflection
+      klass = target.is_a?(Class) || target.is_a?(Module) ? target : target.class
+      parts = klass.name&.split("::") || []
+      parts.reverse_each do |part|
+        return EMOJI_CLASS_MAP[part] if EMOJI_CLASS_MAP.key?(part)
+      end
+
+      :unknown
+    end
   end
 
-  # Mixin providing polymorphic .emoji class and instance methods
+  # Mixin providing polymorphic .emoji class and #emoji instance methods.
+  # Auto-included by Antigravity::Base via inherited hook.
   module Emojifiable
     def emoji
       Antigravity.emoji_for(self)

data/lib/antigravity/message.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module Antigravity
-  class Message
-    include Emojifiable
+  class Message < Base
 
     attr_accessor :role, :content, :thinking, :tool_calls, :model_id, :tokens
 

data/lib/antigravity/sidecar.rb

@@ -6,9 +6,9 @@ require "fileutils"
 
 module Antigravity
   module Sidecar
-    # Base class for non-blocking agent sidecars
-    class Base
-      include Emojifiable
+    # Abstract runner for non-blocking agent sidecars.
+    # Subclass and implement #process_event.
+    class Runner < Antigravity::Base
 
       attr_reader :name, :queue, :worker_thread
 
@@ -52,7 +52,7 @@ module Antigravity
     end
 
     # Async Audit Logger Sidecar
-    class AuditLogger < Base
+    class AuditLogger < Runner
       attr_reader :log_file
 
       def initialize(log_file = "log/agent_audit.jsonl")
@@ -72,7 +72,7 @@ module Antigravity
     end
 
     # Async Vulnerability & Code Quality Scanner Sidecar
-    class VulnerabilityScanner < Base
+    class VulnerabilityScanner < Runner
       attr_reader :scanned_events
 
       def initialize
@@ -90,5 +90,7 @@ module Antigravity
         @scanned_events << { tool: tool_name, params: params, verified: true }
       end
     end
+    # Backward-compatible alias
+    Base = Runner
   end
 end

data/lib/antigravity/skill.rb

@@ -3,8 +3,7 @@
 require "yaml"
 
 module Antigravity
-  class Skill
-    include Emojifiable
+  class Skill < Base
 
     attr_reader :name, :description, :instructions, :path
 

data/lib/antigravity/tool.rb

@@ -1,18 +1,15 @@
 # frozen_string_literal: true
 
 module Antigravity
-  class Tool
-    include Emojifiable
-
+  class Tool < Base
     class << self
       def inherited(subclass)
+        super
         subclass.extend(ClassMethods)
       end
     end
 
     module ClassMethods
-      include Emojifiable::ClassMethods
-
       def name(val = nil, desc: nil)
         if val
           @tool_name = val.to_s

data/lib/antigravity.rb

@@ -8,6 +8,7 @@ end
 
 require_relative "antigravity/version"
 require_relative "antigravity/emojis"
+require_relative "antigravity/base"
 require_relative "antigravity/config"
 require_relative "antigravity/message"
 require_relative "antigravity/harness"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: antigravity-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Riccardo Carlesso
@@ -61,6 +61,7 @@ extra_rdoc_files: []
 files:
 - lib/antigravity.rb
 - lib/antigravity/agent.rb
+- lib/antigravity/base.rb
 - lib/antigravity/client.rb
 - lib/antigravity/config.rb
 - lib/antigravity/emojis.rb