jules-ruby 0.0.67

data/lib/jules-ruby/resources/activities.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module JulesRuby
+  module Resources
+    class Activities < Base
+      # List activities for a session
+      #
+      # @param session_name [String] The session name (e.g., "sessions/123") or just the ID
+      # @param page_token [String, nil] Token for pagination
+      # @param page_size [Integer, nil] Number of results per page
+      # @return [Hash] Response with :activities array and :next_page_token
+      def list(session_name, page_token: nil, page_size: nil)
+        path = "#{normalize_session_path(session_name)}/activities"
+        params = {
+          pageToken: page_token,
+          pageSize: page_size
+        }.compact
+
+        response = get(path, params: params)
+
+        {
+          activities: (response['activities'] || []).map { |a| Models::Activity.new(a) },
+          next_page_token: response['nextPageToken']
+        }
+      end
+
+      # Get a specific activity by name
+      #
+      # @param name [String] The full activity name (e.g., "sessions/123/activities/abc")
+      # @return [Models::Activity] The activity object
+      def find(name)
+        path = name.start_with?('/') ? name : "/#{name}"
+        response = get(path)
+        Models::Activity.new(response)
+      end
+
+      # List all activities for a session with automatic pagination
+      #
+      # @param session_name [String] The session name or ID
+      # @yield [Models::Activity] Each activity
+      # @return [Enumerator] If no block given
+      def each(session_name, &block)
+        return enum_for(:each, session_name) unless block_given?
+
+        page_token = nil
+        loop do
+          result = list(session_name, page_token: page_token)
+          result[:activities].each(&block)
+
+          page_token = result[:next_page_token]
+          break if page_token.nil? || page_token.empty?
+        end
+      end
+
+      # Get all activities for a session as an array
+      #
+      # @param session_name [String] The session name or ID
+      # @return [Array<Models::Activity>]
+      def all(session_name)
+        each(session_name).to_a
+      end
+
+      private
+
+      def normalize_session_path(name)
+        if name.start_with?('sessions/')
+          "/#{name}"
+        elsif name.start_with?('/sessions/')
+          name
+        else
+          "/sessions/#{name}"
+        end
+      end
+    end
+  end
+end

data/lib/jules-ruby/resources/base.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module JulesRuby
+  module Resources
+    class Base
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+
+      private
+
+      def get(path, params: {})
+        client.get(path, params: params)
+      end
+
+      def post(path, body: {})
+        client.post(path, body: body)
+      end
+
+      def delete(path)
+        client.delete(path)
+      end
+    end
+  end
+end

data/lib/jules-ruby/resources/sessions.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module JulesRuby
+  module Resources
+    class Sessions < Base
+      # List all sessions
+      #
+      # @param page_token [String, nil] Token for pagination
+      # @param page_size [Integer, nil] Number of results per page
+      # @return [Hash] Response with :sessions array and :next_page_token
+      def list(page_token: nil, page_size: nil)
+        params = {
+          pageToken: page_token,
+          pageSize: page_size
+        }.compact
+
+        response = get('/sessions', params: params)
+
+        {
+          sessions: (response['sessions'] || []).map { |s| Models::Session.new(s) },
+          next_page_token: response['nextPageToken']
+        }
+      end
+
+      # Get a specific session by name or ID
+      #
+      # @param name [String] The session name (e.g., "sessions/123") or just the ID
+      # @return [Models::Session] The session object
+      def find(name)
+        path = normalize_session_path(name)
+        response = get(path)
+        Models::Session.new(response)
+      end
+
+      # Create a new session
+      #
+      # @param prompt [String] The prompt to start the session with
+      # @param source_context [Hash] The source context (use SourceContext.build helper)
+      # @param title [String, nil] Optional title for the session
+      # @param require_plan_approval [Boolean, nil] If true, plans require explicit approval
+      # @param automation_mode [String, nil] e.g., "AUTO_CREATE_PR"
+      # @return [Models::Session] The created session
+      def create(prompt:, source_context:, title: nil, require_plan_approval: nil, automation_mode: nil)
+        body = {
+          'prompt' => prompt,
+          'sourceContext' => source_context
+        }
+
+        body['title'] = title if title
+        body['requirePlanApproval'] = require_plan_approval unless require_plan_approval.nil?
+        body['automationMode'] = automation_mode if automation_mode
+
+        response = post('/sessions', body: body)
+        Models::Session.new(response)
+      end
+
+      # Approve the current plan for a session
+      #
+      # @param session_name [String] The session name (e.g., "sessions/123") or just the ID
+      # @return [Models::Session] The updated session
+      def approve_plan(session_name)
+        path = "#{normalize_session_path(session_name)}:approvePlan"
+        response = post(path, body: {})
+        Models::Session.new(response)
+      end
+
+      # Send a message to a session
+      #
+      # @param session_name [String] The session name (e.g., "sessions/123") or just the ID
+      # @param prompt [String] The message to send
+      # @return [Models::Session] The updated session
+      def send_message(session_name, prompt:)
+        path = "#{normalize_session_path(session_name)}:sendMessage"
+        response = post(path, body: { 'prompt' => prompt })
+        Models::Session.new(response)
+      end
+
+      # Delete a session
+      #
+      # @param session_name [String] The session name (e.g., "sessions/123") or just the ID
+      # @return [void]
+      def destroy(session_name)
+        path = normalize_session_path(session_name)
+        delete(path)
+        nil
+      end
+
+      # List all sessions with automatic pagination
+      #
+      # @yield [Models::Session] Each session
+      # @return [Enumerator] If no block given
+      def each(&block)
+        return enum_for(:each) unless block_given?
+
+        page_token = nil
+        loop do
+          result = list(page_token: page_token)
+          result[:sessions].each(&block)
+
+          page_token = result[:next_page_token]
+          break if page_token.nil? || page_token.empty?
+        end
+      end
+
+      # Get all sessions as an array
+      #
+      # @return [Array<Models::Session>]
+      def all
+        each.to_a
+      end
+
+      private
+
+      def normalize_session_path(name)
+        if name.start_with?('sessions/')
+          "/#{name}"
+        elsif name.start_with?('/sessions/')
+          name
+        else
+          "/sessions/#{name}"
+        end
+      end
+    end
+  end
+end

data/lib/jules-ruby/resources/sources.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module JulesRuby
+  module Resources
+    class Sources < Base
+      # List all available sources (connected repositories)
+      #
+      # @param page_token [String, nil] Token for pagination
+      # @param page_size [Integer, nil] Number of results per page
+      # @return [Hash] Response with :sources array and :next_page_token
+      def list(page_token: nil, page_size: nil)
+        params = {
+          pageToken: page_token,
+          pageSize: page_size
+        }.compact
+
+        response = get('/sources', params: params)
+
+        {
+          sources: (response['sources'] || []).map { |s| Models::Source.new(s) },
+          next_page_token: response['nextPageToken']
+        }
+      end
+
+      # Get a specific source by name
+      #
+      # @param name [String] The full resource name (e.g., "sources/github/owner/repo")
+      # @return [Models::Source] The source object
+      def find(name)
+        # Ensure the name has the correct format
+        path = name.start_with?('/') ? name : "/#{name}"
+        response = get(path)
+        Models::Source.new(response)
+      end
+
+      # List all sources with automatic pagination
+      #
+      # @yield [Models::Source] Each source
+      # @return [Enumerator] If no block given
+      def each(&block)
+        return enum_for(:each) unless block_given?
+
+        page_token = nil
+        loop do
+          result = list(page_token: page_token)
+          result[:sources].each(&block)
+
+          page_token = result[:next_page_token]
+          break if page_token.nil? || page_token.empty?
+        end
+      end
+
+      # Get all sources as an array
+      #
+      # @return [Array<Models::Source>]
+      def all
+        each.to_a
+      end
+    end
+  end
+end

data/lib/jules-ruby/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module JulesRuby
+  VERSION = '0.1.0'
+end

data/lib/jules-ruby.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'dotenv'
+Dotenv.load
+
+require_relative 'jules-ruby/version'
+require_relative 'jules-ruby/configuration'
+require_relative 'jules-ruby/errors'
+require_relative 'jules-ruby/client'
+
+# Models
+require_relative 'jules-ruby/models/github_repo'
+require_relative 'jules-ruby/models/github_branch'
+require_relative 'jules-ruby/models/source'
+require_relative 'jules-ruby/models/source_context'
+require_relative 'jules-ruby/models/session'
+require_relative 'jules-ruby/models/pull_request'
+require_relative 'jules-ruby/models/plan'
+require_relative 'jules-ruby/models/plan_step'
+require_relative 'jules-ruby/models/artifact'
+require_relative 'jules-ruby/models/activity'
+
+# Resources
+require_relative 'jules-ruby/resources/base'
+require_relative 'jules-ruby/resources/sources'
+require_relative 'jules-ruby/resources/sessions'
+require_relative 'jules-ruby/resources/activities'
+
+module JulesRuby
+  class << self
+    attr_accessor :configuration
+
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+      configuration
+    end
+
+    def reset_configuration!
+      self.configuration = Configuration.new
+    end
+  end
+end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = 'latest'

metadata

@@ -0,0 +1,232 @@
+--- !ruby/object:Gem::Specification
+name: jules-ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.67
+platform: ruby
+authors:
+- Taylor Weibley
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.75'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.75'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.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-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: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: A Ruby gem for interacting with the Jules API to programmatically create
+  and manage asynchronous coding tasks.
+email:
+- tweibley@gmail.com
+executables:
+- jules-ruby
+extensions: []
+extra_rdoc_files: []
+files:
+- ".jules/bolt.md"
+- ".rubocop.yml"
+- AGENTS.md
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE
+- README.md
+- Rakefile
+- SECURITY.md
+- assets/banner.png
+- bin/jules-ruby
+- jules-ruby.gemspec
+- lib/jules-ruby.rb
+- lib/jules-ruby/cli.rb
+- lib/jules-ruby/cli/activities.rb
+- lib/jules-ruby/cli/banner.rb
+- lib/jules-ruby/cli/base.rb
+- lib/jules-ruby/cli/interactive.rb
+- lib/jules-ruby/cli/interactive/activity_renderer.rb
+- lib/jules-ruby/cli/interactive/session_creator.rb
+- lib/jules-ruby/cli/interactive/session_manager.rb
+- lib/jules-ruby/cli/interactive/source_manager.rb
+- lib/jules-ruby/cli/prompts.rb
+- lib/jules-ruby/cli/sessions.rb
+- lib/jules-ruby/cli/sources.rb
+- lib/jules-ruby/client.rb
+- lib/jules-ruby/configuration.rb
+- lib/jules-ruby/errors.rb
+- lib/jules-ruby/models/activity.rb
+- lib/jules-ruby/models/artifact.rb
+- lib/jules-ruby/models/github_branch.rb
+- lib/jules-ruby/models/github_repo.rb
+- lib/jules-ruby/models/plan.rb
+- lib/jules-ruby/models/plan_step.rb
+- lib/jules-ruby/models/pull_request.rb
+- lib/jules-ruby/models/session.rb
+- lib/jules-ruby/models/source.rb
+- lib/jules-ruby/models/source_context.rb
+- lib/jules-ruby/resources/activities.rb
+- lib/jules-ruby/resources/base.rb
+- lib/jules-ruby/resources/sessions.rb
+- lib/jules-ruby/resources/sources.rb
+- lib/jules-ruby/version.rb
+- mise.toml
+homepage: https://github.com/tweibley/jules-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/tweibley/jules-ruby
+  source_code_uri: https://github.com/tweibley/jules-ruby
+  changelog_uri: https://github.com/tweibley/jules-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/tweibley/jules-ruby/issues
+  documentation_uri: https://github.com/tweibley/jules-ruby#readme
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Ruby CLI for the Jules API
+test_files: []