envoy_ai 0.0.1

data/lib/envoy/tool_definition.rb

@@ -0,0 +1,38 @@
+module Envoy
+  class ToolDefinition
+    attr_reader :name, :params, :perform_block
+    attr_accessor :tool_class
+
+    def initialize(name)
+      @name = name.to_s
+      @description = ""
+      @access = :read
+      @params = []
+      @perform_block = ->(**) { }
+    end
+
+    # --- DSL ---
+    def description(text = nil)
+      return @description if text.nil?
+      @description = text
+    end
+
+    def access(level = nil)
+      return @access if level.nil?
+      raise Envoy::Error, "access must be :read or :write" unless %i[read write].include?(level)
+      @access = level
+    end
+
+    def param(name, desc, type: :string, required: true)
+      @params << { name: name.to_sym, desc: desc, type: type, required: required }
+    end
+
+    def perform(&block)
+      @perform_block = block
+    end
+
+    # --- introspection ---
+    def read?  = @access == :read
+    def write? = @access == :write
+  end
+end

data/lib/envoy/toolset.rb

@@ -0,0 +1,72 @@
+module Envoy
+  class Toolset
+    attr_reader :key, :tools
+
+    def initialize(key)
+      @key = key.to_s
+      @description = ""
+      @tools = {}
+      @composed_keys = []
+    end
+
+    # Reader returns this toolset's own description followed by each composed
+    # toolset's (so the model understands every tool group); setter records it.
+    def description(text = nil)
+      return @description = text unless text.nil?
+      collect_descriptions.compact_blank.join("\n\n")
+    end
+
+    def tool(name, &block)
+      definition = ToolDefinition.new(name)
+      definition.instance_eval(&block)
+      @tools[definition.name] = definition
+    end
+
+    # Compose other toolsets into this one. Keys are resolved lazily (at
+    # tools_for / description time via Envoy.toolset), so the load order of
+    # toolset definitions does not matter.
+    def use(*keys)
+      @composed_keys.concat(keys.map(&:to_s))
+    end
+
+    # This toolset's own tools plus every composed toolset's, de-duplicated by
+    # name (own tools win, then composed in `use` order). read_only strips write
+    # tools across the merged set (governance lever for embeds).
+    def tools_for(read_only: false)
+      list = collect_tools.values
+      read_only ? list.select(&:read?) : list
+    end
+
+    protected
+
+    # seen threads the ancestry so a toolset that composes itself (directly or
+    # transitively) raises instead of looping forever.
+    def collect_tools(seen = [])
+      guard_cycle!(seen)
+      merged = {}
+      @tools.each { |name, definition| merged[name] = definition } # own first, own wins
+      @composed_keys.each do |composed_key|
+        Envoy.toolset(composed_key).collect_tools(seen + [ key ]).each do |name, definition|
+          merged[name] ||= definition # earlier composed wins over later
+        end
+      end
+      merged
+    end
+
+    def collect_descriptions(seen = [])
+      guard_cycle!(seen)
+      descriptions = [ @description ]
+      @composed_keys.each do |composed_key|
+        descriptions.concat(Envoy.toolset(composed_key).collect_descriptions(seen + [ key ]))
+      end
+      descriptions
+    end
+
+    private
+
+    def guard_cycle!(seen)
+      return unless seen.include?(key)
+      raise Envoy::ToolsetCycle, "toolset composition cycle: #{(seen + [ key ]).join(' -> ')}"
+    end
+  end
+end

data/lib/envoy/version.rb

@@ -0,0 +1,3 @@
+module Envoy
+  VERSION = "0.0.1"
+end

data/lib/envoy.rb

@@ -0,0 +1,45 @@
+require "ruby_llm"
+require "commonmarker"
+require "envoy/version"
+require "envoy/configuration"
+require "envoy/markdown"
+require "envoy/badges"
+require "envoy/engine"
+require "envoy/errors"
+require "envoy/tool_definition"
+require "envoy/toolset"
+require "envoy/guard"
+require "envoy/compiled_tool"
+require "envoy/llm"
+require "envoy/runner"
+
+module Envoy
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    def configure
+      yield config
+    end
+
+    # Build an LLM runner for a turn.
+    def llm(**opts)
+      config.llm.call(**opts)
+    end
+
+    def toolsets
+      @toolsets ||= {}
+    end
+
+    def define_toolset(key, &block)
+      toolset = Toolset.new(key)
+      toolset.instance_eval(&block)
+      toolsets[toolset.key] = toolset
+    end
+
+    def toolset(key)
+      toolsets.fetch(key.to_s) { raise UnknownToolset, "no toolset #{key.inspect}" }
+    end
+  end
+end

data/lib/envoy_ai.rb

@@ -0,0 +1,3 @@
+# The gem is published as `envoy_ai` (the `envoy` name was taken), so
+# `require "envoy_ai"` — Bundler's default for the gem name — must work.
+require "envoy"

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: envoy_ai
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Travis Petticrew
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: commonmarker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+description: 'Envoy is a mountable Rails engine for governed, tool-calling agent chat:
+  a DSL for host-owned toolsets, guard hooks for authorizing every tool call, persisted
+  conversations, and a debug console.'
+email:
+- travis@launchsupply.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- app/assets/stylesheets/envoy/console.css
+- app/controllers/envoy/application_controller.rb
+- app/controllers/envoy/conversations_controller.rb
+- app/controllers/envoy/messages_controller.rb
+- app/controllers/envoy/system_prompts_controller.rb
+- app/javascript/envoy/controllers/autoscroll_controller.js
+- app/javascript/envoy/controllers/composer_controller.js
+- app/jobs/envoy/application_job.rb
+- app/jobs/envoy/run_job.rb
+- app/models/envoy/application_record.rb
+- app/models/envoy/conversation.rb
+- app/models/envoy/message.rb
+- app/models/envoy/system_prompt.rb
+- app/models/envoy/system_prompt_version.rb
+- app/models/envoy/tool_call.rb
+- app/views/envoy/conversations/_composer_input.html.erb
+- app/views/envoy/conversations/index.html.erb
+- app/views/envoy/conversations/new.html.erb
+- app/views/envoy/conversations/show.html.erb
+- app/views/envoy/messages/_message.html.erb
+- app/views/envoy/messages/_streaming.html.erb
+- app/views/envoy/messages/_tool_call.html.erb
+- app/views/envoy/messages/create.turbo_stream.erb
+- app/views/envoy/system_prompts/_form.html.erb
+- app/views/envoy/system_prompts/edit.html.erb
+- app/views/envoy/system_prompts/index.html.erb
+- app/views/envoy/system_prompts/new.html.erb
+- app/views/envoy/system_prompts/show.html.erb
+- app/views/layouts/envoy/application.html.erb
+- config/routes.rb
+- db/migrate/20260710000001_create_envoy_conversations.rb
+- db/migrate/20260710000002_create_envoy_messages.rb
+- db/migrate/20260710000003_create_envoy_tool_calls.rb
+- db/migrate/20260711000001_create_envoy_system_prompts.rb
+- db/migrate/20260711000002_create_envoy_system_prompt_versions.rb
+- db/migrate/20260711000003_add_system_prompt_version_to_envoy_conversations.rb
+- lib/envoy.rb
+- lib/envoy/badges.rb
+- lib/envoy/compiled_tool.rb
+- lib/envoy/configuration.rb
+- lib/envoy/engine.rb
+- lib/envoy/errors.rb
+- lib/envoy/guard.rb
+- lib/envoy/llm.rb
+- lib/envoy/markdown.rb
+- lib/envoy/runner.rb
+- lib/envoy/testing/fake_llm.rb
+- lib/envoy/tool_definition.rb
+- lib/envoy/toolset.rb
+- lib/envoy/version.rb
+- lib/envoy_ai.rb
+homepage: https://www.launchsupply.com/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://www.launchsupply.com/
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Governed, tool-calling agent chat as a mountable Rails engine.
+test_files: []