ask-coding-providers 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c705fccdf37e62127cbbff2ad58fa7102ac202429ab07fe291fe8b649ab3ddd4
-  data.tar.gz: 3884a19f15a0a7595b0d4a56787f38ff00d500438d4656d78db8ed3cb42332f9
+  metadata.gz: d7da8871d69c29d381c81338b07d851ec66d0030189aa9a8580352b363679630
+  data.tar.gz: 17f28c8a082971b3240b259081ecf97a913b9a093bb92d870887d610adb41859
 SHA512:
-  metadata.gz: 360d444a0f376927de910213f38d30f3ac1cfca4c86b1c85e8e44e5cd60f91dcb57feb4ce976d6124bf20a10d8bf5c2e920eaa682fd6393e74d087f5cfd72e06
-  data.tar.gz: 9860f5295b9926fa6317aeb6f3cb25c94c8082eed66b8a04d5f6f3d5a377c6c4d695f356772d9edc7dbdc9b6f1ee026bea5b3ff809968fcf758526128a6eb66a
+  metadata.gz: 77bc28345e275bd0999fe412c42593b191f6fd28386faf699780ababbad3e10ef0d40f018c5724a85da1487afa1c35baa85270f464fce809b1ce238095030ac1
+  data.tar.gz: 7650675be24e6c7653779b533cde463b219499f5d1fcfce733b04f881019489ee7ca7f64dd62be077b220bcb9070bf61dfc44f199cd3ad2509a48bc54ab630a5

data/README.md

@@ -0,0 +1,65 @@
+# ask-coding-providers
+
+[![Gem Version](https://badge.fury.io/rb/ask-coding-providers.svg)](https://badge.fury.io/rb/ask-coding-providers)
+
+A registry of coding agent adapters for the ask-rb ecosystem. It provides a
+uniform interface for driving AI coding agents (Claude Code, Codex, ACP-based
+agents, ask_agent) and a read-only helper for reading ZCode's session store.
+
+## Installation
+
+```ruby
+gem "ask-coding-providers"
+```
+
+## Quick Start
+
+```ruby
+require "ask-coding-providers"
+
+# Build an adapter by registered name
+adapter = Ask::CodingProviders.build_adapter("acp", workspace_path: Dir.pwd)
+adapter = Ask::CodingProviders.build_adapter("ask_agent", model: "deepseek-v4-flash")
+
+# The environment variable selects the adapter when none is given
+# (see Ask::CodingProviders.resolve_adapter)
+```
+
+## Key entry points
+
+- `Ask::CodingProviders.register_adapter(name, klass)` - register an adapter
+  class under a name. Adapters register themselves when loaded.
+- `Ask::CodingProviders.resolve_adapter(name)` - look up an adapter class.
+  Raises `ConfigurationError` for unknown names and suggests setting the
+  `CODING_PROVIDER` environment variable.
+- `Ask::CodingProviders.build_adapter(name, **config)` - build an adapter
+  instance, passing config options to the adapter's `.from_config`.
+- Registered adapters: `:acp`, `:ask_agent`, `:claude`, `:codex`. There is no
+  `:zcode` adapter.
+- Adapter interface (`Ask::CodingProviders::Adapter`): `create_session`,
+  `resume_session`, `list_sessions`, `subscribe`, `send_message`,
+  `send_and_stream`, `get_events`, `respond`, `get_workspace_state`.
+- `Ask::CodingProviders::ZCode::ZCodeDB` - read-only helper for querying
+  ZCode's SQLite session store at `~/.zcode/cli/db/db.sqlite`. Methods
+  (`list_projects`, `find_sessions`, `session_history`, `recent_sessions`,
+  and others) return `nil` or empty arrays on error, never raising.
+- `Ask::CodingProviders::Error`, `ConfigurationError`, `ConnectionError`, and
+  `TimeoutError` - errors raised by the registry and adapters.
+
+## Full documentation
+
+The full ask-rb documentation lives at https://ask-rb.github.io/ask-docs.
+[Reference: Gem Index](https://ask-rb.github.io/ask-docs/reference/gems)
+covers ask-coding-providers in depth. API reference:
+https://ask-rb.github.io/ask-docs/reference/api.
+
+## Development
+
+```
+bundle install
+bundle exec rake test
+```
+
+## License
+
+MIT

data/lib/ask/coding_providers/acp/adapter.rb

@@ -32,19 +32,24 @@ module Ask
         # @param command [Array<String>] the command to spawn the ACP agent
         # @param cwd [String] working directory
         # @param request_timeout [Float] timeout for ACP requests
-        def initialize(command:, cwd: ".", request_timeout: 60.0)
+        def initialize(command: nil, cwd: ".", request_timeout: 60.0, replay: nil)
           require "ask/acp"
 
           @command = command
           @cwd = cwd
           @request_timeout = request_timeout
+          @replay = replay
           @client = nil
           @sessions = {}
         end
 
         def start
           return if @client
-          @client = Ask::ACP::Client.new(command: @command, request_timeout: @request_timeout)
+          if @replay
+            @client = Ask::ACP::ReplayClient.new(fixture_path: @replay)
+          else
+            @client = Ask::ACP::Client.new(command: @command, request_timeout: @request_timeout)
+          end
           @client.start
           @client.initialize!(client_name: "askoda", client_version: "0.1.0")
         end
@@ -101,6 +106,29 @@ module Ask
                 type: "model.streaming", seq: 2,
                 payload: { "delta" => delta, "sessionId" => session_id }
               }) unless delta.empty?
+            when "session/update"
+              update = event.dig(:params, "update") || {}
+              case update["sessionUpdate"]
+              when "tool_call"
+                kind = update["kind"] || "unknown"
+                block.call({
+                  type: "tool.use", seq: 2,
+                  payload: {
+                    "sessionId" => session_id,
+                    "toolName" => kind,
+                    "input" => update["content"]
+                  }
+                })
+              when "tool_call_update"
+                block.call({
+                  type: "tool.result", seq: 2,
+                  payload: {
+                    "sessionId" => session_id,
+                    "toolName" => event.dig(:params, "kind") || "unknown",
+                    "output" => update["content"]
+                  }
+                })
+              end
             when "turn_complete"
               block.call({
                 type: "turn.completed", seq: 3,

data/lib/ask/coding_providers/ask_agent/adapter.rb

@@ -77,15 +77,15 @@ module Ask
           { "eventSeq" => 0 }
         end
 
-        def send_message(session_id, content)
+        def send_message(session_id, content, attachments: nil)
           ensure_started
           # Run synchronously — returns when done
-          result = run_session(session_id, content)
+          result = run_session(session_id, content, attachments: attachments)
           { "response" => result }
         end
 
-        def send_and_stream(session_id, content, turn_timeout: 600.0, &block)
-          return enum_for(:send_and_stream, session_id, content, turn_timeout: turn_timeout) unless block
+        def send_and_stream(session_id, content, turn_timeout: 600.0, attachments: nil, &block)
+          return enum_for(:send_and_stream, session_id, content, turn_timeout: turn_timeout, attachments: attachments) unless block
           ensure_started
 
           # Build the ask-agent chat with our pre-configured provider
@@ -111,7 +111,7 @@ module Ask
           end
 
           begin
-            result = session.run(content)
+            result = session.run(content, attachments: attachments)
             block.call({
               type: "turn.completed", seq: 3,
               payload: { "response" => result, "sessionId" => session_id,
@@ -165,14 +165,14 @@ module Ask
           chat
         end
 
-        def run_session(session_id, content)
+        def run_session(session_id, content, attachments: nil)
           chat = build_chat
           session = Ask::Agent::Session.new(
             model: chat,
             max_turns: @max_turns,
             **@session_opts
           )
-          session.run(content)
+          session.run(content, attachments: attachments)
         end
       end
     end

data/lib/ask/coding_providers/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module CodingProviders
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-coding-providers
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -73,6 +73,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
 - lib/ask-coding-providers.rb
 - lib/ask/coding_providers.rb
 - lib/ask/coding_providers/acp.rb