samagotchi 0.98.0 → 0.100.0

data/lib/samagotchi/tools/tool_index.rb

@@ -56,6 +56,8 @@ module Samagotchi
         group: { type: "string", description: "search only this group" }
       }.freeze
       CALL_DESCRIPTION = "Call a tool #{FIND_NAME} found.".freeze
+      # A keyword answer's first line.
+      CALL_HINT = "Call one with #{CALL_NAME}(tool: \"<group>/<tool>\", args: {…}).".freeze
       CALL_PARAMS = {
         tool: { type: "string", required: true, description: "the tool as <group>/<tool>" },
         args: { type: "object", description: "the arguments, per the inputSchema #{FIND_NAME} gave" }
@@ -84,6 +86,19 @@ module Samagotchi
       # A Group's states.
       STATES = %i[ready starting failed].freeze
 
+      # A search's answer (#find): its text, and the tools it loads on a host
+      # that loads tools (+loaded+: the wire names of a keyword answer's
+      # callable matches, the ones a request can declare deferred; none for
+      # an empty query, a miss or the names listing).
+      class FoundText < String
+        attr_reader :loaded
+
+        def initialize(text, loaded = [])
+          super(text)
+          @loaded = loaded.freeze
+        end
+      end
+
       # One group of a source's tools (an MCP server): +summary+ its line in
       # the search tool's description (nil: its name and tool count only),
       # +state+ :ready, :starting (its tools may come: a lookup waits) or
@@ -236,7 +251,8 @@ module Samagotchi
           registry.register(spec.name, source: SOURCE, unwrap: unwrap, **spec.entry_fields(nil))
           spec
         end
-        registry.index = Registry::Index.new(source: SOURCE, call_name: CALL_NAME, sourced: !@sources.empty?)
+        registry.index = Registry::Index.new(source: SOURCE, call_name: CALL_NAME, sourced: !@sources.empty?,
+                                             deferrable: -> { deferrable }, wrap: ->(call) { wrap(call) })
         declared!(declared)
         declared.map(&:name)
       end
@@ -286,11 +302,12 @@ module Samagotchi
       # empty query every group's tool names. +server+ is the parameter's
       # name before it was +group+: a model that still gives it is told
       # every group was searched.
+      # @return [FoundText]
       def find(query, only = nil, server: nil)
         answer = find_in(query, only)
         return answer unless (only.nil? || only.strip.empty?) && !server.to_s.strip.empty?
 
-        "(searched every group)\n#{answer}"
+        FoundText.new("(searched every group)\n#{answer}", answer.loaded)
       end
 
       # ── The call ────────────────────────────────────────────────────────
@@ -348,6 +365,56 @@ module Samagotchi
         inner && BuiltinCalls.build(entry.name, inner).merge(via: CALL_NAME)
       end
 
+      # The sources' tools a host that loads tools may declare deferred
+      # (Tools::DeferredTools), by their acts_as: callable (no refusal),
+      # the only tool with that acts_as, a name Messages takes, and no
+      # registered tool's. Sorted by acts_as, so the same index gives the
+      # same list in any session and after a respawn.
+      # @return [Array<Tool>]
+      def deferrable
+        tools = groups.reject { |group| own?(group) }.flat_map(&:tools)
+        counts = tools.map(&:acts_as).tally
+        tools.select do |tool|
+          tool.refusal.nil? && counts[tool.acts_as] == 1 && tool.acts_as.match?(DEFERRABLE_NAME) &&
+            !@registry&.key?(tool.acts_as)
+        end.sort_by(&:acts_as)
+      end
+
+      # The name a request declares +name+'s tool by when it goes out
+      # deferred (Tools::DeferredTools): a reachable built-in's (by its
+      # name or chi/<name>), a deferrable source tool's acts_as (by it or
+      # <group>/<tool>). Nil for any other: declared, removed, unknown, or a
+      # source tool that can't be deferred. Never waits for a start.
+      # @return [String, nil]
+      def deferred_name(name)
+        name = name.to_s.strip
+        bare = name.delete_prefix("#{CHI_GROUP}/")
+        return bare if @registry&.indexed(bare)
+
+        tool = lookup_quietly(name) or return nil
+        return nil if tool.entry || tool.refusal
+
+        deferrable.any? { |t| t.acts_as == tool.acts_as } ? tool.acts_as : nil
+      end
+
+      # What a deferred source tool's wire name may be (Messages' tool
+      # name rule).
+      DEFERRABLE_NAME = /\A[a-zA-Z0-9_-]{1,128}\z/
+
+      # A direct call of a deferrable tool (#deferrable) by its acts_as, as
+      # the call_tool call it runs as (ToolRunner#run, under a host that
+      # loads tools): the call tool's row, rules and approvals. Nil for any
+      # other call.
+      # @return [Hash, nil]
+      def wrap(call)
+        name = call[:name].to_s
+        return nil if name.empty? || @registry&.key?(name)
+
+        tool = deferrable.find { |t| t.acts_as == name } or return nil
+        args = call[:args].is_a?(Hash) ? call[:args] : {}
+        BuiltinCalls.build(CALL_NAME, { "tool" => tool.full_name, "args" => args })
+      end
+
       # The call tool's activity row: <group>/<tool> and its arguments.
       def call_preview(args)
         tool = lookup_quietly(args["tool"].to_s)
@@ -403,17 +470,32 @@ module Samagotchi
         searched = all
         if only && !only.strip.empty?
           searched = all.select { |group| group.name == only.strip }
-          return "Error: no group #{only.strip}. Groups: #{all.map(&:name).join(", ")}" if searched.empty?
+          return FoundText.new("Error: no group #{only.strip}. Groups: #{all.map(&:name).join(", ")}") if searched.empty?
         end
-        return names_text(searched) if words(query).empty?
+        return FoundText.new(names_text(searched)) if words(query).empty?
 
         matches = ranked(query, searched.flat_map(&:tools)).take(FIND_RESULTS)
-        return "No tool matches \"#{query.strip}\".\n\n#{names_text(searched)}" if matches.empty?
+        return FoundText.new("No tool matches \"#{query.strip}\".\n\n#{names_text(searched)}") if matches.empty?
 
         blocks = matches.map { |tool| match_text(tool, all) }
         unsearched = searched.filter_map { |group| "#{group.name} #{group.note}" if group.tools.empty? && group.note }
         blocks << "Not searched: #{unsearched.join("; ")}." unless unsearched.empty?
-        "Call one with #{CALL_NAME}(tool: \"<group>/<tool>\", args: {…}).\n\n#{blocks.join("\n\n")}"
+        FoundText.new("#{CALL_HINT}\n\n#{blocks.join("\n\n")}",
+                      loadable(matches))
+      end
+
+      # The wire names of +matches+ a request can declare deferred: a
+      # built-in of the index's own groups by its name, a source's tool by
+      # its acts_as when it is #deferrable.
+      def loadable(matches)
+        sourced = nil
+        matches.filter_map do |tool|
+          next tool.name if tool.entry
+          next if tool.refusal
+
+          sourced ||= deferrable.map(&:acts_as)
+          tool.acts_as if sourced.include?(tool.acts_as)
+        end
       end
 
       # What the sources hear of the declared tools (/mcp's last line).

data/lib/samagotchi/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Samagotchi
-  VERSION = "0.98.0"
+  VERSION = "0.100.0"
   # Sent as the User-Agent of every HTTP request chi makes.
   USER_AGENT = "chi/#{VERSION}"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: samagotchi
 version: !ruby/object:Gem::Version
-  version: 0.98.0
+  version: 0.100.0
 platform: ruby
 authors:
 - Dmitry Dedov
@@ -266,6 +266,8 @@ files:
 - lib/samagotchi/bundles/system/manifest.yml
 - lib/samagotchi/bundles/system/memory_guide.md
 - lib/samagotchi/bundles/system/self_map.md
+- lib/samagotchi/bundles/work-cap/manifest.yml
+- lib/samagotchi/bundles/work-cap/plugin.rb
 - lib/samagotchi/cache_confirm.rb
 - lib/samagotchi/cancellation_controller.rb
 - lib/samagotchi/child_env.rb
@@ -523,6 +525,7 @@ files:
 - lib/samagotchi/session_metrics/model_segment.rb
 - lib/samagotchi/session_metrics/side_totals.rb
 - lib/samagotchi/session_metrics/totals.rb
+- lib/samagotchi/session_metrics/usage.rb
 - lib/samagotchi/session_model_settings.rb
 - lib/samagotchi/session_observer.rb
 - lib/samagotchi/session_retention.rb
@@ -590,6 +593,7 @@ files:
 - lib/samagotchi/tool_call_parser.rb
 - lib/samagotchi/tool_declarations.rb
 - lib/samagotchi/tool_ids.rb
+- lib/samagotchi/tool_loads.rb
 - lib/samagotchi/tool_output_cut.rb
 - lib/samagotchi/tool_output_files.rb
 - lib/samagotchi/tool_response.rb
@@ -605,6 +609,7 @@ files:
 - lib/samagotchi/tools/builtins.rb
 - lib/samagotchi/tools/cancel_reminder.rb
 - lib/samagotchi/tools/context_read.rb
+- lib/samagotchi/tools/deferred_tools.rb
 - lib/samagotchi/tools/delegate.rb
 - lib/samagotchi/tools/delegate_cursor.rb
 - lib/samagotchi/tools/delegate_relay.rb