pedicab 0.3.1 → 0.3.3

data/lib/pedicab.rb

@@ -3,174 +3,182 @@
 require "benchmark"
 require "open3"
 require "json"
-require "eqn"
-require "httparty"
-require "redcarpet"
-require "nokogiri"
-#require "knn"
+require "erb"
+
 require_relative "pedicab/version"
-require_relative "pedicab/on"
-require_relative "pedicab/mark"
-require_relative "pedicab/rank"
-require_relative "pedicab/poke"
-require_relative "pedicab/query"
-require_relative "pedicab/link"
 require_relative "pedicab/ride"
 
 module Pedicab
+  # Base exception class for Pedicab-specific errors
   class Error < StandardError; end
+
+  @@MEMORY= 5
+  def self.memory
+    @@MEMORY
+  end
+
+  def self.memory= size
+    @@MEMORY = size
+  end
+  # Lists all available GGUF models in the /models directory
+  # 
+  # @return [Array<String>] Array of model names (without .gguf extension)
+  # @example
+  #   puts Pedicab.models
+  #   => ["qwen", "llama2", "mistral"]
   def self.models
     Dir['/models/*'].map { |e| e.gsub('.gguf', '').gsub('/models/','') }
   end
-  class P
 
-    LIST = {
-      questions: "all unique questions necessary to respond to the following",
-      facts: "unique pieces of information within the following",
-      entities: "unique named entities within the following"
-    }
+  # Main conversation interface for AI interactions
+  # Provides context management, state tracking, and elegant operator syntax
+  class P
+    # @return [Float] Time taken for the last request in seconds
+    # @return [Array<Float>] Array of processing times for all requests
+    # @return [Array<String>] Array of LLM thinking processes
+    # @return [String] The last prompt sent to the model
+    # @return [Array<String>] Array of all responses received
+    # @return [String] The last response content
+    # @return [Pedicab::Ride] The associated ride instance for direct model access
+    # @return [Array<String>] Array of previous prompts
+    attr_reader :took, :time, :thoughts, :prompt, :response, :out, :ride, :last
     
-    attr_reader :took, :response, :rank
-    attr_accessor :out
+    # @return [Proc] Response handler lambda
+    # @return [Hash] Current conversation context
+    attr_accessor :handler, :context
     
-    def initialize k
+    # Initialize a new conversation instance
+    # 
+    # @param id [String] Unique identifier for the conversation
+    # @example
+    #   ai = Pedicab::P.new('my_bot')
+    #   response = ai["Hello, world!"]
+    def initialize(k)
       @id = k
-      @ride = Pedicab.ride[k]
+      @handler = lambda { |s| s.out }
+      @ride = Pedicab.ride(k)
+      @context = {}
       reset!
     end
-
-    ##
-    # extract intent.
-    def intent i
-      @intent = @ride.go(%[Respond with only the single word describing the type of the response necessary for the following:\n#{i}])
-    end
     
-    ##
-    # reset context.
+    # Reset all conversation state, context, and history
+    # Clears prompts, responses, timing data, and ride state
+    # 
+    # @return [void]
+    # @example
+    #   ai.reset!  # Start fresh conversation
     def reset!
       @ride.reset!
+      @exe = ""
+      @time = []
+      @last = []
       @response = []
-      @rank = RANK[@id]
-      @intent = ""
-      @prompt = ""
-      @out = ""
-      @took = 0      
+      @thoughts = []
+      @prompt = nil
+      @out = nil
+      @took = 0
     end
 
-    def dispatch i
-      @ride.go(i)
-    end
-    
-    ##
-    # if x, continue...
-    def gate x, &b
-      if @ride.go? ERB.new(x).result(binding)
-        if block_given?
-          b.call(self)
-        else
-          return true
-        end
-      else
-        if !block_given?
-          return false
-        end
+    # Set or execute the response handler
+    # 
+    # @param block [Proc, nil] Optional handler that receives the response object
+    # @return [Proc] The handler when setting, or handler result when executing
+    # @example
+    #   # Set custom handler
+    #   ai.handle { |response| puts response.out }
+    #   
+    #   # Execute handler
+    #   result = ai.handle
+    def handle(&block)
+      @handler = block
+      if @response.length > Pedicab.memory
+        @response.shift
+        @last.shift
+        @thoughts.shift
       end
     end
     
-    ##
-    # process prompt into context.
-    def prompt i
-      @prompt = i
-      @took = Benchmark.realtime { @out = dispatch([@response[-1], @prompt].flatten.compact.uniq.join("\n")) }
-      @response << @out
-      return @out
-    end
-
-    ##
-    # distill input
-    def extract i
-      @ride.go(%[Distill and outline the following without repeating yourself in the simplest possible terms:\n#{i}])
-    end
-    ##
-    # compile output
-    def compile i
-      @ride.go("Expand on the following and outline in plaintext without repeating yourself:\n#{i}").gsub("Outline:\n","").gsub(/\n\n+/, "\n")
-    end
-    ##
-    # integrate
-    def outline i
-      @ride.go("#{@respond.join("\n")}\nDistill the following into the above outline without repeating yourself:\n#{i}")
-    end
-    ##
-    # chain links
-    def chain i
-      a = [] 
-      LINK.each_pair { |k,v| if @ride.go?(%[A response to the following requires #{k}:\n#{i}]); a << k; end }
-      aa = a.compact.shuffle
-      puts %[#---[CHAIN]---> #{aa}]
-      [ aa.map { |e| LINK.on[e].call(self, i) }, i ].flatten
+    # Start a fresh conversation with the given prompt
+    # Clears previous context and begins a new conversation
+    # 
+    # @param input [String] The prompt to send to the LLM
+    # @return [Object] Result of the handler (typically the response object)
+    # @example
+    #   response = ai["What is the meaning of life?"]
+    #   puts response.out
+    def [] input
+      reset!
+      @prompt = input
+      think(input)
+      @handler.call(self)
     end
     
-    ##
-    # Is response complete?
-    def done?
-      @ride.go?(%["#{@out}" truthfully answers the following:\n#{@prompt}])
-    end
-
-    ##
-    # Is intent met by current output?
-    def ready?
-      @ride.go?(%[The following satisfies #{@intent}:\n#{@out}])
-    end
-
-    ##
-    # extract elements from prompt.
-    def each i, p, &b
-      @took = Benchmark.realtime { @ride.go!(i, p) { |e| b.call(e) } }
-    end
-
-    ##
-    # extract questions and expand into context.
-    def more q
-      each(LIST[:questions], POKE[q]) { |e| dispatch(%[#{e}\n#{@ride.go(e)}]); }
+    # Continue an existing conversation with context
+    # Maintains previous exchanges and builds upon them
+    # 
+    # @param input [String] The prompt to send to the LLM
+    # @return [Object] Result of the handler (typically the response object)
+    # @example
+    #   ai["What is Ruby?"]           # First question
+    #   ai << "What about Python?"    # Continues with context
+    def << input
+      @last << @prompt if @prompt
+      @prompt = input
+      think(input)
+      @handler.call(self)
     end
-    
-    ##
-    # process inputs into context.
 
-    def [] i
-      reset!
-      prompt(POKE[i])
+    # Calculate total processing time for all requests in the conversation
+    # 
+    # @return [Float] Total time in seconds
+    # @example
+    #   ai["Question 1"]
+    #   ai["Question 2"]
+    #   puts "Total time: #{ai.life}s"
+    def life
+      a = 0
+      @time.map { |e| a += e }
+      return a
     end
     
-    def << i
-      dispatch(POKE[i])
-    end
-  end
+    private
 
-  def self.chunk text, size=1024, &b
-    chunks = []
-    paragraphs = text.split(/\n\n+/)
-    
-    current_chunk = ""
-    paragraphs.each do |para|
-      # If adding this paragraph would exceed chunk size
-      if current_chunk.length + para.length > size && !current_chunk.empty?
-        chunks << current_chunk
-        current_chunk = para
-      else
-        current_chunk += (current_chunk.empty? ? "" : "\n\n") + para 
+    # Process a prompt through the LLM with conversation context
+    # Builds context from previous exchanges and sends to the ride
+    # 
+    # @param input [String] The prompt to process
+    # @return [String] The response content
+    def think(input)
+      # Build conversation context from previous exchanges
+      @context = @last.zip(@response).map { |k, v| "#{k}\n#{v}" }.join("\n\n")
+      full_prompt = [@context, @prompt].compact.join("\n\n")
+      
+      # Process through the ride with timing
+      @took = Benchmark.realtime { @out = @ride.go(full_prompt) }
+      
+      # Extract executable code if present in response
+      if m = /```(.*)```/.match(@out)
+        @exe = m[1]
       end
-    end
-    chunks << current_chunk unless current_chunk.empty?
-    if block_given?
-      return chunks.map { |e| b.call(self, e) }
-    else
-      return chunks
+      
+      # Record timing and response data
+      @time << @took
+      @thoughts << @ride[:thought]
+      @response << @out
+      @out
     end
   end
   
+  # Create a new conversation instance (convenience method)
+  # 
+  # @param k [String] Unique identifier for the conversation
+  # @return [Pedicab::P] New conversation instance
+  # @example
+  #   ai = Pedicab['my_assistant']
+  #   response = ai["Hello, world!"]
   def self.[] k
     P.new(k)
   end
 end
+
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pedicab
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.3
 platform: ruby
 authors:
 - Erik Olson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-21 00:00:00.000000000 Z
+date: 2026-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: benchmark
@@ -52,62 +52,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: eqn
-  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: httparty
-  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: redcarpet
-  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: nokogiri
-  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:
 email:
 - xorgnak@xorgnak.com
@@ -115,48 +59,21 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- "#README.md#"
+- API.md
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
+- EXAMPLES.md
 - Gemfile
 - Gemfile.lock
+- INSTALLATION.md
 - LICENSE.txt
 - README.md
 - Rakefile
-- books/Arnold_Bennett-How_to_Live_on_24_Hours_a_Day.txt
-- books/Edward_L_Bernays-crystallizing_public_opinion.txt
-- books/Emma_Goldman-Anarchism_and_Other_Essays.txt
-- books/Office_of_Strategic_Services-Simple_Sabotage_Field_Manual.txt
-- books/Sigmund_Freud-Group_Psychology_and_The_Analysis_of_The_Ego.txt
-- books/Steve_Hassan-The_Bite_Model.txt
-- books/Steve_Hassan-The_Bite_Model.txt~
-- books/Sun_Tzu-Art_of_War.txt
-- books/Sun_Tzu-Art_of_War.txt~
-- books/US-Constitution.txt
-- books/US-Constitution.txt~
-- books/cia-kubark.txt
-- books/machiavelli-the_prince.txt
-- books/sun_tzu-art_of_war.txt
-- books/us_army-bayonette.txt
 - lib/pedicab.py
 - lib/pedicab.rb
 - lib/pedicab.sh
-- lib/pedicab.sh~
-- lib/pedicab/calc.rb~
-- lib/pedicab/link.rb
-- lib/pedicab/link.rb~
-- lib/pedicab/mark.rb
-- lib/pedicab/mark.rb~
-- lib/pedicab/on.rb
-- lib/pedicab/on.rb~
-- lib/pedicab/poke.rb
-- lib/pedicab/poke.rb~
-- lib/pedicab/query.rb
-- lib/pedicab/query.rb~
-- lib/pedicab/rank.rb
-- lib/pedicab/rank.rb~
+- lib/pedicab/#city.rb#
 - lib/pedicab/ride.rb
-- lib/pedicab/ride.rb~
 - lib/pedicab/version.rb
 - sig/pedicab.rbs
 homepage: https://github.com/xorgnak/pedicab

data/#README.md#

@@ -1,51 +0,0 @@
-# Pedicab
-Install: bundle add pedicab
-bundler managed?: gem install pedicab
-
-## Usage
-
-What you going?
-0h!
-
-the gem!?
-
-okay.
-
-"AI" has been around since before buddy holly. Not citiong sources, but generic gguf files are the newest and asap pending *.  Short-fast-n-lould is their're a tech you should "understand"; no judgment.
-
-1. LLM's are a giant pattern response engines without souls.
-
-2. do the pre-req'. (curl a .gguf into /models/model.gguf)
-2.a. **Seriously!?**: Yes, that's it. no details.  dealer's choice. figure it out.
-
-2. You cab fix that with:
-
-   a. your favorite author.
-   b. your corpo gibberish.
-   c. you'll figure it out.
-
-Either way, use the `books/` to seed your distills.  Do it, and enjoy the product o' their results.
-
-usage:
-
-```
-@me = Pedicab['me']
-
-# to seed the model context.
-my = @me << "What is the meaning of life>?"
-
-# ... ( to expound... )
-# @me["But what if I'm a piece o'poop?"]
-# => try it, it works,
-
-# question: could I give you more guildance?
-# answert: yes.
-
-# question: would it matter?
-# answer: no. figure it out.
-
-# summary:
-# 
-
-
-```