ask-coding-providers 0.1.0

data/lib/ask/coding_providers/codex/codex_db.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Ask
+  module CodingProviders
+    module Codex
+      # Queries Codex's SQLite database for thread/project data.
+      #
+      # Codex stores sessions in `~/.codex/state_5.sqlite` (threads table)
+      # and full message history in JSONL rollout files.
+      class CodexDB
+        DEFAULT_DB = File.expand_path("~/.codex/state_5.sqlite")
+
+        def initialize(db_path = nil)
+          @db_path = db_path || DEFAULT_DB
+        end
+
+        def available?
+          File.exist?(@db_path)
+        end
+
+        # List all projects (directories with threads), ordered by most recent.
+        # Returns [{project_id:, directory:, session_count:}] or [].
+        def list_projects
+          return [] unless available?
+
+          db = open_db
+          rows = db.execute(<<~SQL)
+            SELECT cwd AS directory,
+                   COUNT(*) AS session_count,
+                   MAX(updated_at) AS last_active
+            FROM threads
+            WHERE archived = 0
+            GROUP BY cwd
+            ORDER BY last_active DESC
+            LIMIT 20
+          SQL
+          rows.map do |r|
+            {
+              project_id: r["directory"],
+              directory: r["directory"],
+              session_count: r["session_count"].to_i
+            }
+          end
+        rescue => e
+          []
+        ensure
+          db&.close
+        end
+
+        # Find sessions in a given directory.
+        # Returns [{session_id:, title:, updated:}] or [].
+        def find_sessions(directory:, limit: 20)
+          return [] unless available?
+
+          db = open_db
+          rows = db.execute(<<~SQL, [directory, directory])
+            SELECT id, title, updated_at, preview
+            FROM threads
+            WHERE (cwd = ? OR ? LIKE cwd || '/%')
+              AND archived = 0
+            ORDER BY updated_at DESC
+            LIMIT ?
+          SQL
+          rows.map do |r|
+            {
+              session_id: r["id"],
+              title: r["title"].to_s.empty? ? (r["preview"] || "(untitled)") : r["title"],
+              updated: r["updated_at"]
+            }
+          end
+        rescue => e
+          []
+        ensure
+          db&.close
+        end
+
+        # Find the most recent session across all projects.
+        # Returns {session_id:, directory:} or nil.
+        def find_recent_session
+          return nil unless available?
+
+          db = open_db
+          row = db.get_first_row(<<~SQL)
+            SELECT id, cwd FROM threads
+            WHERE archived = 0
+            ORDER BY updated_at DESC LIMIT 1
+          SQL
+          row ? { session_id: row["id"], directory: row["cwd"] } : nil
+        rescue => e
+          nil
+        ensure
+          db&.close
+        end
+
+        # Find the most recent TUI session in a workspace.
+        def find_recent_tui_session(workspace_path)
+          return nil unless available?
+
+          db = open_db
+          row = db.get_first_row(<<~SQL, workspace_path, workspace_path)
+            SELECT id, title, cwd FROM threads
+            WHERE (cwd = ? OR ? LIKE cwd || '/%')
+              AND archived = 0
+            ORDER BY updated_at DESC LIMIT 1
+          SQL
+          return nil unless row
+          {
+            session_id: row["id"],
+            title: row["title"],
+            directory: row["cwd"]
+          }
+        rescue => e
+          nil
+        ensure
+          db&.close
+        end
+
+        # Look up a session's workspace directory by ID.
+        def session_directory(session_id)
+          return nil unless available?
+
+          db = open_db
+          row = db.get_first_row("SELECT cwd FROM threads WHERE id = ?", [session_id])
+          row&.dig("cwd")
+        rescue => e
+          nil
+        ensure
+          db&.close
+        end
+
+        # Get session message history from the rollout JSONL file.
+        # Returns [{text:, role:, origin:}] or [].
+        def session_history(session_id, limit: 100)
+          return [] unless available?
+
+          db = open_db
+          row = db.get_first_row("SELECT rollout_path, title, preview FROM threads WHERE id = ?", [session_id])
+          return [] unless row
+
+          rollout_path = row["rollout_path"]
+          return [] unless rollout_path && File.exist?(rollout_path)
+
+          parse_rollout(rollout_path, limit)
+        rescue => e
+          []
+        ensure
+          db&.close
+        end
+
+        # List recent sessions across all projects.
+        # Returns [{session_id:, title:, updated:, msg_count:}] or [].
+        def recent_sessions
+          return [] unless available?
+
+          db = open_db
+          rows = db.execute(<<~SQL)
+            SELECT id, title, updated_at, preview
+            FROM threads
+            WHERE archived = 0
+            ORDER BY updated_at DESC
+            LIMIT 50
+          SQL
+          rows.map do |r|
+            {
+              session_id: r["id"],
+              title: r["title"].to_s.empty? ? (r["preview"] || "(untitled)") : r["title"],
+              updated: r["updated_at"],
+              msg_count: 0
+            }
+          end
+        rescue => e
+          []
+        ensure
+          db&.close
+        end
+
+        private
+
+        def open_db
+          require "sqlite3"
+          db = SQLite3::Database.new(@db_path, readonly: true)
+          db.results_as_hash = true
+          db
+        end
+
+        def parse_rollout(path, limit)
+          messages = []
+          File.readlines(path).each do |line|
+            begin
+              event = JSON.parse(line)
+            rescue JSON::ParserError
+              next
+            end
+
+            case event["type"]
+            when "user_message"
+              messages << { text: event["content"].to_s, role: "You", origin: "real_user" }
+            when "agent_message"
+              messages << { text: event["content"].to_s, role: "Agent", origin: nil }
+            end
+            break if messages.length >= limit * 2
+          end
+          messages.last(limit)
+        end
+      end
+    end
+  end
+end

data/lib/ask/coding_providers/codex.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "codex/app_server_client"
+require_relative "codex/adapter"
+require_relative "codex/codex_db"
+
+module Ask
+  module CodingProviders
+    module Codex
+      class Error < Ask::CodingProviders::Error; end
+      class TimeoutError < Ask::CodingProviders::TimeoutError; end
+    end
+  end
+end

data/lib/ask/coding_providers/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Ask
+  module CodingProviders
+    VERSION = "0.1.0"
+  end
+end

data/lib/ask/coding_providers/zcode/zcode_db.rb

@@ -0,0 +1,195 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Ask
+  module CodingProviders
+    module ZCode
+      # Wraps the ZCode SQLite database, centralizing all session/project queries.
+      #
+      # Usage:
+      #   db = ZCodeDB.new
+      #   projects = db.list_projects
+      #   sessions = db.find_sessions(directory: "/path")
+      #
+      # All methods return nil or empty arrays on error (never raise).
+      # This makes it safe to use from any context without wrapping every call.
+      class ZCodeDB
+      def initialize(db_path = nil)
+        @db_path = db_path || File.expand_path("~/.zcode/cli/db/db.sqlite")
+      end
+
+      def available?
+        File.exist?(@db_path)
+      end
+
+      # List all projects with session counts, ordered by most recently updated.
+      # Returns [{project_id:, directory:, session_count:}] or [].
+      def list_projects
+        return [] unless available?
+
+        db = open_db
+        rows = db.execute(<<~SQL)
+          SELECT project_id, directory, count(*) as session_count
+          FROM session
+          WHERE task_type = 'interactive' AND time_archived IS NULL
+          GROUP BY project_id
+          ORDER BY MAX(time_updated) DESC
+          LIMIT 10
+        SQL
+        rows.map { |r| { project_id: r["project_id"], directory: r["directory"], session_count: r["session_count"].to_i } }
+      rescue => e
+        nil
+      ensure
+        db&.close
+      end
+
+      # Find sessions in a given directory (exact or prefix match).
+      # Returns [{session_id:, title:, updated:}] or [].
+      def find_sessions(directory:, limit: 20)
+        return [] unless available?
+
+        db = open_db
+        rows = db.execute(<<~SQL, [directory, directory, limit])
+          SELECT id, title, time_updated
+          FROM session
+          WHERE (directory = ? OR ? LIKE directory || '/%')
+            AND time_archived IS NULL AND task_type = 'interactive'
+          ORDER BY time_updated DESC
+          LIMIT ?
+        SQL
+        rows.map { |r| { session_id: r["id"], title: r["title"], updated: r["time_updated"] } }
+      rescue => e
+        []
+      ensure
+        db&.close
+      end
+
+      # Find the single most recent session across all projects.
+      # Returns {session_id:, directory:} or nil.
+      def find_recent_session
+        return nil unless available?
+
+        db = open_db
+        row = db.get_first_row(<<~SQL)
+          SELECT id, directory FROM session
+          WHERE time_archived IS NULL AND task_type = 'interactive'
+          ORDER BY time_updated DESC LIMIT 1
+        SQL
+        row ? { session_id: row["id"], directory: row["directory"] } : nil
+      rescue => e
+        nil
+      ensure
+        db&.close
+      end
+
+      # Find the most recent TUI session in a workspace path.
+      # Returns {session_id:, title:, directory:} or nil.
+      def find_recent_tui_session(workspace_path)
+        return nil unless available?
+
+        db = open_db
+        row = db.get_first_row(<<~SQL, [workspace_path, workspace_path])
+          SELECT id, title, directory
+          FROM session
+          WHERE (directory = ? OR ? LIKE directory || '/%')
+            AND time_archived IS NULL AND task_type = 'interactive'
+          ORDER BY time_updated DESC
+          LIMIT 1
+        SQL
+        row ? { session_id: row["id"], title: row["title"], directory: row["directory"] } : nil
+      rescue => e
+        nil
+      ensure
+        db&.close
+      end
+
+      # Look up a session's workspace directory by its ID.
+      # Returns the directory string, or nil.
+      def session_directory(session_id)
+        return nil unless available?
+
+        db = open_db
+        row = db.get_first_row("SELECT directory FROM session WHERE id = ?", [session_id])
+        row&.dig("directory")
+      rescue => e
+        nil
+      ensure
+        db&.close
+      end
+
+      # Load the last N text parts from a session, newest first.
+      # Returns [{text:, role:, origin:}] or [].
+      def session_history(session_id, limit: 100)
+        return [] unless available?
+
+        db = open_db
+        rows = db.execute(<<~SQL, [session_id, limit])
+          SELECT p.data, m.data as msg_data FROM part p
+          JOIN message m ON p.message_id = m.id
+          WHERE p.session_id = ? AND p.data LIKE '%"type":"text"%'
+          ORDER BY p.time_created DESC
+          LIMIT ?
+        SQL
+
+        rows.filter_map do |r|
+          part = JSON.parse(r["data"]) rescue next
+          content = part["text"] || ""
+          next if content.empty?
+
+          msg_data = JSON.parse(r["msg_data"]) rescue {}
+          role = msg_data["role"] == "user" ? "You" : "Agent"
+          origin = msg_data.dig("semantics", "origin") rescue nil
+
+          # Skip system-generated messages masquerading as user
+          next if role == "You" && origin != "real_user" && origin != nil
+
+          { text: content, role: role, origin: origin }
+        end
+      rescue => e
+        []
+      ensure
+        db&.close
+      end
+
+      # List recent sessions across all projects.
+      # Returns [{session_id:, title:, updated:, msg_count:}] or [].
+      def recent_sessions
+        return [] unless available?
+
+        db = open_db
+        rows = db.execute(<<~SQL)
+          SELECT s.id AS session_id, s.title AS title,
+                 s.time_updated AS updated,
+                 (SELECT count(*) FROM message m WHERE m.session_id = s.id) AS msg_count
+          FROM session s
+          WHERE s.task_type = 'interactive' AND s.time_archived IS NULL
+          ORDER BY s.time_updated DESC
+          LIMIT 20
+        SQL
+        rows.map do |r|
+          {
+            session_id: r["session_id"],
+            title: r["title"],
+            updated: r["updated"],
+            msg_count: r["msg_count"].to_i
+          }
+        end
+      rescue => e
+        []
+      ensure
+        db&.close
+      end
+
+      private
+
+      def open_db
+        require "sqlite3"
+        db = SQLite3::Database.new(@db_path, readonly: true)
+        db.results_as_hash = true
+        db
+	      end
+	    end
+	  end
+	end
+	end

data/lib/ask/coding_providers/zcode.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "zcode/zcode_db"
+
+module Ask
+  module CodingProviders
+    # ZCode database reader — queries ZCode's SQLite session store.
+    # See {ZCodeDB} for session/project lookup methods.
+    module ZCode
+    end
+  end
+end

data/lib/ask/coding_providers.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "coding_providers/version"
+require_relative "coding_providers/adapter"
+
+module Ask
+  module CodingProviders
+    class Error < StandardError; end
+    class ConfigurationError < Error; end
+    class ConnectionError < Error; end
+    class TimeoutError < Error; end
+
+    # Registry of coding provider adapters by name.
+    # Adapters register themselves via {register_adapter}.
+    # The CLI resolves the active adapter via {build_adapter}.
+    #
+    # @example
+    #   adapter = Ask::CodingProviders.build_adapter("acp", workspace_path: Dir.pwd)
+    #   adapter = Ask::CodingProviders.build_adapter("ask_agent", model: "deepseek-v4-flash")
+    @adapter_registry = {}
+
+    class << self
+      # Register a coding adapter class under a name.
+      # Called automatically by adapter files when loaded.
+      def register_adapter(name, klass)
+        @adapter_registry[name.to_s] = klass
+      end
+
+      # Resolve an adapter class by name.
+      # @raise [ConfigurationError] if unknown
+      def resolve_adapter(name)
+        @adapter_registry[name.to_s] || raise(
+          ConfigurationError,
+          "Unknown coding provider: #{name.inspect}. " \
+          "Available: #{@adapter_registry.keys.join(', ')}. " \
+          "Set CODING_PROVIDER in your environment."
+        )
+      end
+
+      # Build an adapter instance by name, passing config options.
+      # Each adapter's .from_config class method decides how to use the config.
+      def build_adapter(name, **config)
+        resolve_adapter(name).from_config(**config)
+      end
+    end
+  end
+end
+
+require_relative "coding_providers/zcode"
+require_relative "coding_providers/ask_agent"
+require_relative "coding_providers/codex"
+require_relative "coding_providers/acp"
+require_relative "coding_providers/claude"

data/lib/ask-coding-providers.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "ask/coding_providers"

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: ask-coding-providers
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.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: Coding agent adapter interface and implementations (ACP, Codex, Claude,
+  AskAgent) for the askoda ecosystem.
+email:
+- kaka@myrrlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ask-coding-providers.rb
+- lib/ask/coding_providers.rb
+- lib/ask/coding_providers/acp.rb
+- lib/ask/coding_providers/acp/adapter.rb
+- lib/ask/coding_providers/adapter.rb
+- lib/ask/coding_providers/ask_agent.rb
+- lib/ask/coding_providers/ask_agent/adapter.rb
+- lib/ask/coding_providers/claude.rb
+- lib/ask/coding_providers/claude/adapter.rb
+- lib/ask/coding_providers/codex.rb
+- lib/ask/coding_providers/codex/adapter.rb
+- lib/ask/coding_providers/codex/app_server_client.rb
+- lib/ask/coding_providers/codex/codex_db.rb
+- lib/ask/coding_providers/version.rb
+- lib/ask/coding_providers/zcode.rb
+- lib/ask/coding_providers/zcode/zcode_db.rb
+homepage: https://github.com/ask-rb/ask-coding-providers
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-coding-providers
+  source_code_uri: https://github.com/ask-rb/ask-coding-providers
+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.3
+specification_version: 4
+summary: Coding agent adapters for the ask-rb ecosystem
+test_files: []