scout-ai 1.0.0 → 1.0.1

data/test/scout/llm/backends/test_openai.rb

@@ -2,7 +2,7 @@ require File.expand_path(__FILE__).sub(%r(/test/.*), '/test/test_helper.rb')
 require File.expand_path(__FILE__).sub(%r(.*/test/), '').sub(/test_(.*)\.rb/,'\1')
 
 class TestLLMOpenAI < Test::Unit::TestCase
-  def _test_ask
+  def test_ask
     prompt =<<-EOF
 system: you are a coding helper that only write code and comments without formatting so that it can work directly, avoid the initial and end commas ```.
 user: write a script that sorts files in a directory
@@ -21,7 +21,7 @@ Some text
     assert(Float === emb.first)
   end
 
-  def _test_tool_call_output
+  def test_tool_call_output
     Log.severity = 0
     prompt =<<-EOF
 function_call:
@@ -41,7 +41,7 @@ know if you didn't get it.
     ppp LLM::OpenAI.ask prompt, model: 'gpt-4.1-nano'
   end
 
-  def _test_tool_call_output_2
+  def test_tool_call_output_2
     Log.severity = 0
     prompt =<<-EOF
 function_call:
@@ -59,7 +59,7 @@ should i take an umbrella?
     ppp LLM::OpenAI.ask prompt, model: 'gpt-4.1-nano'
   end
 
-  def _test_tool_call_output_features
+  def test_tool_call_output_features
     Log.severity = 0
     prompt =<<-EOF
 function_call:
@@ -79,7 +79,7 @@ know if you didn't get it.
     ppp LLM::OpenAI.ask prompt, model: 'gpt-4.1-nano'
   end
 
-  def _test_tool_call_output_weather
+  def test_tool_call_output_weather
     Log.severity = 0
     prompt =<<-EOF
 function_call:
@@ -97,6 +97,45 @@ should i take an umbrella?
     ppp LLM::OpenAI.ask prompt, model: 'gpt-4.1-nano'
   end
 
+
+  def test_tool_gpt5
+    prompt =<<-EOF
+user:
+What is the weather in London. Should I take my umbrella?
+    EOF
+
+    tools = [
+      {
+        "type": "function",
+        "function": {
+          "name": "get_current_temperature",
+          "description": "Get the current temperature and raining conditions for a specific location",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "location": {
+                "type": "string",
+                "description": "The city and state, e.g., San Francisco, CA"
+              },
+              "unit": {
+                "type": "string",
+                "enum": ["Celsius", "Fahrenheit"],
+                "description": "The temperature unit to use. Infer this from the user's location."
+              }
+            },
+            "required": ["location", "unit"]
+          }
+        }
+      },
+    ]
+
+    respose = LLM::OpenAI.ask prompt, tool_choice: 'required', tools: tools, model: "gpt-5", log_errors: true do |name,arguments|
+      "It's 15 degrees and raining."
+    end
+
+    ppp respose
+  end
+
   def test_tool
     prompt =<<-EOF
 user:
@@ -136,7 +175,7 @@ What is the weather in London. Should I take my umbrella?
     ppp respose
   end
 
-  def _test_json_output
+  def test_json_output
     prompt =<<-EOF
 system:
 

data/test/scout/llm/backends/test_responses.rb

@@ -111,5 +111,129 @@ What other movies have the protagonists of the original gost busters played on,
     sss 0
     ppp LLM::Responses.ask prompt, format: :json
   end
+
+  def test_json_format
+    prompt =<<-EOF
+user:
+
+What other movies have the protagonists of the original gost busters played on.
+Name each actor and the top movie they took part of
+    EOF
+    sss 0
+
+    format = {
+      name: 'actors_and_top_movies',
+      type: 'object',
+      properties: {},
+      additionalProperties: {type: :string}
+    }
+    ppp LLM::Responses.ask prompt, format: format
+  end
+
+  def test_json_format_list
+    prompt =<<-EOF
+user:
+
+What other movies have the protagonists of the original gost busters played on.
+Name each actor as keys and the top 3 movies they took part of as values
+    EOF
+    sss 0
+
+    format = {
+      name: 'actors_and_top_movies',
+      type: 'object',
+      properties: {},
+      additionalProperties: {type: :array, items: {type: :string}}
+    }
+    ppp LLM::Responses.ask prompt, format: format
+  end
+
+  def test_json_format_actor_list
+    prompt =<<-EOF
+user:
+
+What other movies have the protagonists of the original gost busters played on.
+Name each actor as keys and the top 3 movies they took part of as values
+    EOF
+    sss 0
+
+    format = {
+      name: 'actors_and_top_movies',
+      type: 'object',
+      properties: {},
+      additionalProperties: false,
+      items: {
+        type: 'object', 
+        properties: {
+          name: {type: :string, description: 'actor name'}, 
+          movies: {type: :array, description: 'list of top 3 movies', items: {type: :string, description: 'movie title plus year in parenthesis'} }, 
+          additionalProperties: false
+        }
+      }
+    }
+
+    schema =  {
+      "type": "object",
+      "properties": {
+        "people": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "movies": {
+                "type": "array",
+                "items": { "type": "string" },
+                "minItems": 3,
+                "maxItems": 3
+              }
+            },
+            "required": ["name", "movies"],
+            additionalProperties: false
+          }
+        }
+      },
+      additionalProperties: false,
+      "required": ["people"]
+    }
+    ppp LLM::Responses.ask prompt, format: schema
+  end
+
+  def test_tool_gpt5
+    prompt =<<-EOF
+user:
+What is the weather in London. Should I take my umbrella?
+    EOF
+
+    tools = [
+      {
+        "type": "function",
+        "name": "get_current_temperature",
+        "description": "Get the current temperature and raining conditions for a specific location",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "location": {
+              "type": "string",
+              "description": "The city and state, e.g., San Francisco, CA"
+            },
+            "unit": {
+              "type": "string",
+              "enum": ["Celsius", "Fahrenheit"],
+              "description": "The temperature unit to use. Infer this from the user's location."
+            }
+          },
+          "required": ["location", "unit"]
+        }
+      },
+    ]
+
+    sss 0
+    respose = LLM::Responses.ask prompt, tool_choice: 'required', tools: tools, model: "gpt-5", log_errors: true do |name,arguments|
+      "It's 15 degrees and raining."
+    end
+
+    ppp respose
+  end
 end
 

data/test/scout/llm/test_agent.rb

@@ -39,76 +39,6 @@ class TestLLMAgent < Test::Unit::TestCase
     end
   end
 
-  def test_workflow
-    m = Module.new do
-      extend Workflow
-      self.name = "Registration"
-
-      desc "Register a person"
-      input :name, :string, "Last, first name"
-      input :age, :integer, "Age"
-      input :gender, :select, "Gender", nil, :select_options => %w(male female)
-      task :person => :yaml do
-        iii inputs.to_hash
-        inputs.to_hash
-      end
-    end
-
-    sss 0
-    #ppp LLM.workflow_ask(m, "Register Eduard Smith, a 25 yo male", model: "Meta-Llama-3.3-70B-Instruct")
-    ppp LLM.workflow_ask(m, "Register Eduard Smith, a 25 yo male, using a tool call to the tool provided", backend: 'ollama', model: "llama3")
-  end
-
-  def _test_openai
-    TmpFile.with_dir do |dir|
-      kb = KnowledgeBase.new dir
-      kb.format = {"Person" => "Alias"}
-      kb.register :brothers, datafile_test(:person).brothers, undirected: true
-      kb.register :marriages, datafile_test(:person).marriages, undirected: true, source: "=>Alias", target: "=>Alias"
-      kb.register :parents, datafile_test(:person).parents
-
-      sss 3
-      agent = LLM::Agent.new knowledge_base: kb, model: 'gpt-4o'
-
-      agent.system = ""
-
-      ppp agent.ask "Who is Miguel's brother-in-law"
-    end
-  end
-
-  def _test_argonne
-    TmpFile.with_dir do |dir|
-      kb = KnowledgeBase.new dir
-      kb.format = {"Person" => "Alias"}
-      kb.register :brothers, datafile_test(:person).brothers, undirected: true
-      kb.register :marriages, datafile_test(:person).marriages, undirected: true, source: "=>Alias", target: "=>Alias"
-      kb.register :parents, datafile_test(:person).parents
-
-      agent.system = ""
-
-      ppp agent.ask "Who is Miguel's brother-in-law"
-    end
-  end
-
-  def _test_nvidia
-    TmpFile.with_dir do |dir|
-      kb = KnowledgeBase.new dir
-      kb.format = {"Person" => "Alias"}
-      kb.register :brothers, datafile_test(:person).brothers, undirected: true
-      kb.register :marriages, datafile_test(:person).marriages, undirected: true, source: "=>Alias", target: "=>Alias"
-      kb.register :parents, datafile_test(:person).parents
-
-      sss 0
-
-      ppp LLM::OpenAI.ask "Say Hi", url: "https://integrate.api.nvidia.com/v1", model: "deepseek-ai/deepseek-r1"
-      exit
-
-
-      agent.system = ""
-
-      ppp agent.ask "Who is Miguel's brother-in-law. Make use of the tools using tool_calls"
-    end
-  end
 
 end
 

data/test/scout/llm/test_ask.rb

@@ -38,9 +38,11 @@ user: write a script that sorts files in a directory
           "1 minute"
         end
       end
+      export :recipe_steps, :step_time
     end
 
-    ppp LLM.workflow_ask(m, "How much time does it take to prepare a cake recipe")
+    sss 0
+    ppp LLM.workflow_ask(m, "How much time does it take to prepare a 'vanilla' cake recipe, use the tools provided to find out")
   end
 
   def test_knowledbase

data/test/scout/llm/test_chat.rb

@@ -173,7 +173,25 @@ What other movies have the protagonists of the original gost busters played on,
     end
   end
 
-  def test_tools
+  def test_tool
+    require 'scout/llm/ask'
+
+    sss 0
+    question =<<-EOF
+user:
+
+Use the provided tool to learn the instructions of baking a tray of muffins. Don't
+give me your own recipe, return the one provided by the tool
+
+tool: Baking
+    EOF
+
+    TmpFile.with_file question do |file|
+      ppp LLM.ask file, endpoint: :nano
+    end
+  end
+
+  def test_tools_with_task
     require 'scout/llm/ask'
 
     question =<<-EOF
@@ -210,5 +228,29 @@ association: marriages #{datafile_test(:person).marriages} undirected=true sourc
       ppp LLM.ask file
     end
   end
+
+  def test_previous_response
+    require 'scout/llm/ask'
+    sss 0
+    question =<<-EOF
+user:
+
+Say hi
+
+assistant:
+
+Hi
+
+previous_response_id: asdfasdfasdfasdf
+
+Bye
+
+    EOF
+
+    messages = LLM.messages question
+
+    iii messages
+
+  end
 end
 

data/test/scout/llm/test_mcp.rb

@@ -0,0 +1,29 @@
+require File.expand_path(__FILE__).sub(%r(/test/.*), '/test/test_helper.rb')
+require File.expand_path(__FILE__).sub(%r(.*/test/), '').sub(/test_(.*)\.rb/,'\1')
+
+require "scout-ai"
+class TestMCP < Test::Unit::TestCase
+  def test_workflow_stdio
+    require "mcp/server/transports/stdio_transport"
+    wf = Module.new do
+      extend Workflow
+      self.name = "TestWorkflow"
+
+      desc "Just say hi to someone"
+      input :name, :string, "Name", nil, required: true
+      task :hi => :string do |name|
+        "Hi #{name}"
+      end
+
+      desc "Just say bye to someone"
+      input :name, :string, "Name", nil, required: true
+      task :bye => :string do |name|
+        "Bye #{name}"
+      end
+    end
+
+    transport = MCP::Server::Transports::StdioTransport.new(wf.mcp(:hi))
+    transport.open
+  end
+end
+

data/test/scout/llm/tools/test_knowledge_base.rb

@@ -0,0 +1,22 @@
+require File.expand_path(__FILE__).sub(%r(/test/.*), '/test/test_helper.rb')
+require File.expand_path(__FILE__).sub(%r(.*/test/), '').sub(/test_(.*)\.rb/,'\1')
+
+class TestLLMToolKB < Test::Unit::TestCase
+  def test_knowledbase_definition
+    TmpFile.with_dir do |dir|
+      kb = KnowledgeBase.new dir
+      kb.register :brothers, datafile_test(:person).brothers, undirected: true
+      kb.register :parents, datafile_test(:person).parents
+
+      assert_include kb.all_databases, :brothers
+
+      assert_equal Person, kb.target_type(:parents)
+
+      knowledge_base_definition = LLM.knowledge_base_tool_definition(kb)
+      ppp JSON.pretty_generate knowledge_base_definition
+
+      assert_equal ['Isa~Miki', 'Miki~Isa', 'Guille~Clei'], LLM.call_knowledge_base(kb, :brothers, entities: %w(Isa Miki Guille))
+    end
+  end
+end
+

data/test/scout/llm/tools/test_mcp.rb

@@ -0,0 +1,11 @@
+require File.expand_path(__FILE__).sub(%r(/test/.*), '/test/test_helper.rb')
+require File.expand_path(__FILE__).sub(%r(.*/test/), '').sub(/test_(.*)\.rb/,'\1')
+
+class TestClass < Test::Unit::TestCase
+  def test_client
+   c = LLM.mcp_tools("https://api.githubcopilot.com/mcp/")
+   assert_include c.keys, "get_me"
+  end
+end
+
+

data/test/scout/llm/tools/test_workflow.rb

@@ -0,0 +1,39 @@
+require File.expand_path(__FILE__).sub(%r(/test/.*), '/test/test_helper.rb')
+require File.expand_path(__FILE__).sub(%r(.*/test/), '').sub(/test_(.*)\.rb/,'\1')
+
+class TestLLMToolWorkflow < Test::Unit::TestCase
+  def test_workflow_definition
+    m = Module.new do
+      extend Workflow
+      self.name = "RecipeWorkflow"
+
+      desc "List the steps to cook a recipe"
+      input :recipe, :string, "Recipe for which to extract steps"
+      task :recipe_steps => :array do |recipe|
+        ["prepare batter", "bake"]
+      end
+
+      desc "Calculate time spent in each step of the recipe"
+      input :step, :string, "Cooking step"
+      task :step_time => :string do |step|
+        case step 
+        when "prepare batter"
+          "2 hours"
+        when "bake"
+          "30 minutes"
+        else
+          "1 minute"
+        end
+      end
+    end
+
+    LLM.task_tool_definition(m, :recipe_steps)
+    LLM.task_tool_definition(m, :step_time)
+
+    tool_definitions = LLM.workflow_tools(m)
+    ppp JSON.pretty_generate tool_definitions
+
+    assert_equal ["prepare batter", "bake"], LLM.call_workflow(m, :recipe_steps)
+  end
+end
+

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: scout-ai
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Miguel Vazquez
 bindir: bin
 cert_chain: []
-date: 2025-06-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: scout-rig
@@ -23,6 +23,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-openai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-mcp-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: assorted functionalities to help scouts use AI
 email: mikisvaz@gmail.com
 executables:
@@ -31,20 +59,28 @@ extensions: []
 extra_rdoc_files:
 - LICENSE
 - LICENSE.txt
-- README.rdoc
+- README.md
 files:
 - ".document"
 - ".vimproject"
 - LICENSE
 - LICENSE.txt
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - bin/scout-ai
+- doc/Agent.md
+- doc/Chat.md
+- doc/LLM.md
+- doc/Model.md
+- doc/RAG.md
 - lib/scout-ai.rb
 - lib/scout/llm/agent.rb
 - lib/scout/llm/agent/chat.rb
+- lib/scout/llm/agent/delegate.rb
+- lib/scout/llm/agent/iterate.rb
 - lib/scout/llm/ask.rb
+- lib/scout/llm/backends/anthropic.rb
 - lib/scout/llm/backends/bedrock.rb
 - lib/scout/llm/backends/huggingface.rb
 - lib/scout/llm/backends/ollama.rb
@@ -54,9 +90,14 @@ files:
 - lib/scout/llm/backends/responses.rb
 - lib/scout/llm/chat.rb
 - lib/scout/llm/embed.rb
+- lib/scout/llm/mcp.rb
 - lib/scout/llm/parse.rb
 - lib/scout/llm/rag.rb
 - lib/scout/llm/tools.rb
+- lib/scout/llm/tools/call.rb
+- lib/scout/llm/tools/knowledge_base.rb
+- lib/scout/llm/tools/mcp.rb
+- lib/scout/llm/tools/workflow.rb
 - lib/scout/llm/utils.rb
 - lib/scout/model/base.rb
 - lib/scout/model/python/base.rb
@@ -73,37 +114,30 @@ files:
 - lib/scout/model/util/run.rb
 - lib/scout/model/util/save.rb
 - python/scout_ai/__init__.py
-- python/scout_ai/__pycache__/__init__.cpython-310.pyc
-- python/scout_ai/__pycache__/__init__.cpython-311.pyc
-- python/scout_ai/__pycache__/huggingface.cpython-310.pyc
-- python/scout_ai/__pycache__/huggingface.cpython-311.pyc
-- python/scout_ai/__pycache__/util.cpython-310.pyc
-- python/scout_ai/__pycache__/util.cpython-311.pyc
-- python/scout_ai/atcold/__init__.py
-- python/scout_ai/atcold/plot_lib.py
-- python/scout_ai/atcold/spiral.py
 - python/scout_ai/huggingface/data.py
 - python/scout_ai/huggingface/eval.py
 - python/scout_ai/huggingface/model.py
 - python/scout_ai/huggingface/rlhf.py
 - python/scout_ai/huggingface/train/__init__.py
-- python/scout_ai/huggingface/train/__pycache__/__init__.cpython-310.pyc
-- python/scout_ai/huggingface/train/__pycache__/next_token.cpython-310.pyc
 - python/scout_ai/huggingface/train/next_token.py
-- python/scout_ai/language_model.py
 - python/scout_ai/util.py
 - scout-ai.gemspec
 - scout_commands/agent/ask
 - scout_commands/agent/kb
+- scout_commands/documenter
 - scout_commands/llm/ask
 - scout_commands/llm/process
+- scout_commands/llm/server
 - scout_commands/llm/template
+- share/server/chat.html
+- share/server/chat.js
 - test/data/cat.jpg
 - test/data/person/brothers
 - test/data/person/identifiers
 - test/data/person/marriages
 - test/data/person/parents
 - test/scout/llm/agent/test_chat.rb
+- test/scout/llm/backends/test_anthropic.rb
 - test/scout/llm/backends/test_bedrock.rb
 - test/scout/llm/backends/test_huggingface.rb
 - test/scout/llm/backends/test_ollama.rb
@@ -115,10 +149,15 @@ files:
 - test/scout/llm/test_ask.rb
 - test/scout/llm/test_chat.rb
 - test/scout/llm/test_embed.rb
+- test/scout/llm/test_mcp.rb
 - test/scout/llm/test_parse.rb
 - test/scout/llm/test_rag.rb
 - test/scout/llm/test_tools.rb
 - test/scout/llm/test_utils.rb
+- test/scout/llm/tools/test_call.rb
+- test/scout/llm/tools/test_knowledge_base.rb
+- test/scout/llm/tools/test_mcp.rb
+- test/scout/llm/tools/test_workflow.rb
 - test/scout/model/python/huggingface/causal/test_next_token.rb
 - test/scout/model/python/huggingface/test_causal.rb
 - test/scout/model/python/huggingface/test_classification.rb
@@ -147,7 +186,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 3.7.0.dev
 specification_version: 4
 summary: AI gear for scouts
 test_files: []

data/README.rdoc

@@ -1,18 +0,0 @@
-= scout-ai
-
-Description goes here.
-
-== Contributing to scout-ai
- 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
-* Fork the project.
-* Start a feature/bugfix branch.
-* Commit and push until you are happy with your contribution.
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2025 Miguel Vazquez. See LICENSE.txt for
-further details.