pocketrb 0.1.0

data/lib/pocketrb.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "zeitwerk"
+require "async"
+require "json"
+require "yaml"
+require "logger"
+require "fileutils"
+require "pathname"
+
+# Pocketrb: Ruby AI agent with multi-LLM support and advanced planning capabilities
+module Pocketrb
+  # Base error class for all Pocketrb errors
+  class Error < StandardError; end
+
+  # Raised when configuration is invalid or corrupted
+  class ConfigurationError < Error; end
+
+  # Raised when LLM provider encounters an error
+  class ProviderError < Error; end
+
+  # Raised when tool execution fails
+  class ToolError < Error; end
+
+  # Raised when session management encounters an error
+  class SessionError < Error; end
+
+  # Raised when MCP (Model Context Protocol) operations fail
+  class MCPError < Error; end
+
+  class << self
+    attr_writer :logger
+
+    # Returns the logger instance for Pocketrb
+    # @return [Logger] the logger instance
+    def logger
+      @logger ||= Logger.new($stdout, level: Logger::INFO)
+    end
+
+    # Returns the root directory of the Pocketrb gem
+    # @return [Pathname] the gem root directory
+    # @example
+    #   Pocketrb.root #=> #<Pathname:/path/to/pocketrb>
+    def root
+      @root ||= Pathname.new(__dir__).parent
+    end
+  end
+end
+
+# Set up Zeitwerk autoloader
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect(
+  "cli" => "CLI",
+  "llm" => "LLM",
+  "mcp" => "MCP",
+  "openrouter" => "OpenRouter",
+  "ruby_llm_provider" => "RubyLLMProvider",
+  "claude_cli" => "ClaudeCLI",
+  "claude_max_proxy" => "ClaudeMaxProxy",
+  "whatsapp" => "WhatsApp"
+)
+
+# Tell Zeitwerk to ignore files that don't follow naming conventions
+# (they're loaded by their parent module)
+loader.ignore("#{__dir__}/pocketrb/bus/events.rb")
+loader.ignore("#{__dir__}/pocketrb/providers/types.rb")
+
+loader.setup
+
+# Manually require files that define multiple classes
+require_relative "pocketrb/bus/events"
+require_relative "pocketrb/providers/types"
+
+# Eager load in production for thread safety
+loader.eager_load if ENV["POCKETRB_EAGER_LOAD"]

data/pocketrb.gemspec

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require "pocketrb/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "pocketrb"
+  spec.version = Pocketrb::VERSION
+  spec.platform = Gem::Platform::RUBY
+  spec.authors = ["Maciej Mensfeld"]
+  spec.email = %w[maciej@mensfeld.pl]
+  spec.homepage = "https://github.com/mensfeld/pocketrb"
+  spec.licenses = %w[MIT]
+  spec.summary = "Pocket-sized Ruby AI agent framework with multi-LLM support"
+  spec.description = <<-DESC
+    Pocketrb is a Ruby AI agent framework featuring async message bus architecture,
+    multi-LLM support (Claude, OpenRouter, RubyLLM), multi-channel messaging
+    (CLI, Telegram, WhatsApp), planning system, context compaction, and simple
+    JSON-based memory with keyword matching.
+  DESC
+
+  spec.required_ruby_version = ">= 3.2.0"
+
+  # Runtime dependencies
+  spec.add_dependency "anthropic", "~> 0.3"
+  spec.add_dependency "async", "~> 2.0"
+  spec.add_dependency "faraday", "~> 2.0"
+  spec.add_dependency "faraday-follow_redirects", "~> 0.3"
+  spec.add_dependency "json", "~> 2.7"
+  spec.add_dependency "pastel", "~> 0.8"
+  spec.add_dependency "playwright-ruby-client", "~> 1.58"
+  spec.add_dependency "ruby_llm", "~> 1.0"
+  spec.add_dependency "telegram-bot-ruby", "~> 2.0"
+  spec.add_dependency "thor", "~> 1.3"
+  spec.add_dependency "tty-markdown", "~> 0.7"
+  spec.add_dependency "tty-prompt", "~> 0.23"
+  spec.add_dependency "yaml", "~> 0.3"
+  spec.add_dependency "zeitwerk", "~> 2.6"
+
+  spec.files = `git ls-files -z`.split("\x0").select do |f|
+    f.match(%r{^(lib|exe)/}) || %w[LICENSE.txt CHANGELOG.md README.md pocketrb.gemspec].include?(f)
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = %w[lib]
+
+  spec.metadata = {
+    "bug_tracker_uri" => "https://github.com/mensfeld/pocketrb/issues",
+    "changelog_uri" => "https://github.com/mensfeld/pocketrb/blob/master/CHANGELOG.md",
+    "homepage_uri" => "https://github.com/mensfeld/pocketrb",
+    "source_code_uri" => "https://github.com/mensfeld/pocketrb/tree/master",
+    "rubygems_mfa_required" => "true"
+  }
+end
+
+# Optional dependencies (loaded on demand)
+# For WhatsApp bridge: gem install websocket-client-simple
+# For cron expressions: gem install fugit

metadata

@@ -0,0 +1,327 @@
+--- !ruby/object:Gem::Specification
+name: pocketrb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Maciej Mensfeld
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: anthropic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-follow_redirects
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: playwright-ruby-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.58'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.58'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: telegram-bot-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: tty-markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+- !ruby/object:Gem::Dependency
+  name: yaml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  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: |2
+      Pocketrb is a Ruby AI agent framework featuring async message bus architecture,
+      multi-LLM support (Claude, OpenRouter, RubyLLM), multi-channel messaging
+      (CLI, Telegram, WhatsApp), planning system, context compaction, and simple
+      JSON-based memory with keyword matching.
+email:
+- maciej@mensfeld.pl
+executables:
+- pocketrb
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/pocketrb
+- lib/pocketrb.rb
+- lib/pocketrb/agent/compaction.rb
+- lib/pocketrb/agent/context.rb
+- lib/pocketrb/agent/loop.rb
+- lib/pocketrb/agent/spawn_tool.rb
+- lib/pocketrb/agent/subagent_manager.rb
+- lib/pocketrb/bus/events.rb
+- lib/pocketrb/bus/message_bus.rb
+- lib/pocketrb/channels/base.rb
+- lib/pocketrb/channels/cli.rb
+- lib/pocketrb/channels/telegram.rb
+- lib/pocketrb/channels/whatsapp.rb
+- lib/pocketrb/cli.rb
+- lib/pocketrb/cli/base.rb
+- lib/pocketrb/cli/chat.rb
+- lib/pocketrb/cli/config.rb
+- lib/pocketrb/cli/cron.rb
+- lib/pocketrb/cli/gateway.rb
+- lib/pocketrb/cli/init.rb
+- lib/pocketrb/cli/plans.rb
+- lib/pocketrb/cli/skills.rb
+- lib/pocketrb/cli/start.rb
+- lib/pocketrb/cli/telegram.rb
+- lib/pocketrb/cli/version.rb
+- lib/pocketrb/cli/whatsapp.rb
+- lib/pocketrb/config.rb
+- lib/pocketrb/cron/job.rb
+- lib/pocketrb/cron/service.rb
+- lib/pocketrb/heartbeat/service.rb
+- lib/pocketrb/mcp/client.rb
+- lib/pocketrb/mcp/memory_tool.rb
+- lib/pocketrb/media/processor.rb
+- lib/pocketrb/memory.rb
+- lib/pocketrb/planning/manager.rb
+- lib/pocketrb/planning/plan.rb
+- lib/pocketrb/planning/tool.rb
+- lib/pocketrb/providers/anthropic.rb
+- lib/pocketrb/providers/base.rb
+- lib/pocketrb/providers/claude_cli.rb
+- lib/pocketrb/providers/claude_max_proxy.rb
+- lib/pocketrb/providers/openrouter.rb
+- lib/pocketrb/providers/registry.rb
+- lib/pocketrb/providers/ruby_llm_provider.rb
+- lib/pocketrb/providers/types.rb
+- lib/pocketrb/session/manager.rb
+- lib/pocketrb/session/session.rb
+- lib/pocketrb/skills/builtin/github/SKILL.md
+- lib/pocketrb/skills/builtin/proactive/SKILL.md
+- lib/pocketrb/skills/builtin/reflection/SKILL.md
+- lib/pocketrb/skills/builtin/tmux/SKILL.md
+- lib/pocketrb/skills/builtin/weather/SKILL.md
+- lib/pocketrb/skills/create_tool.rb
+- lib/pocketrb/skills/loader.rb
+- lib/pocketrb/skills/modify_tool.rb
+- lib/pocketrb/skills/skill.rb
+- lib/pocketrb/tools/background_job_manager.rb
+- lib/pocketrb/tools/base.rb
+- lib/pocketrb/tools/browser.rb
+- lib/pocketrb/tools/browser_advanced.rb
+- lib/pocketrb/tools/browser_session.rb
+- lib/pocketrb/tools/cron.rb
+- lib/pocketrb/tools/edit_file.rb
+- lib/pocketrb/tools/exec.rb
+- lib/pocketrb/tools/jobs.rb
+- lib/pocketrb/tools/list_dir.rb
+- lib/pocketrb/tools/memory.rb
+- lib/pocketrb/tools/message.rb
+- lib/pocketrb/tools/para_memory.rb
+- lib/pocketrb/tools/read_file.rb
+- lib/pocketrb/tools/registry.rb
+- lib/pocketrb/tools/send_file.rb
+- lib/pocketrb/tools/think.rb
+- lib/pocketrb/tools/web_fetch.rb
+- lib/pocketrb/tools/web_search.rb
+- lib/pocketrb/tools/write_file.rb
+- lib/pocketrb/version.rb
+- pocketrb.gemspec
+homepage: https://github.com/mensfeld/pocketrb
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/mensfeld/pocketrb/issues
+  changelog_uri: https://github.com/mensfeld/pocketrb/blob/master/CHANGELOG.md
+  homepage_uri: https://github.com/mensfeld/pocketrb
+  source_code_uri: https://github.com/mensfeld/pocketrb/tree/master
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.0.beta2
+specification_version: 4
+summary: Pocket-sized Ruby AI agent framework with multi-LLM support
+test_files: []