ai-lite 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6f864c2c29ee79c0aa144c940fa34a3a4b84189239436cab38fcd1862401726
-  data.tar.gz: 293507b5e1af278ab17658f81f63dc257a7d6ce2b00c79b77d64c6ba1e9fb434
+  metadata.gz: 3b1ae1b32c854b4f99a6fd8275a375c3d1870c93e5507756c9e6c3089ee220ea
+  data.tar.gz: fafd0e42607277bead469d0628d106af48cf7334ebecb100ca60b5ae5074b47a
 SHA512:
-  metadata.gz: 77bf79ade3eec73d1cbd06b269dd0d4566d4b06f96d7919dfa74a6f514572ff24fe36a93e65e9e43aa4a369e7c9a3db2e771e5c4419c8e22fc8f19d6f63db1af
-  data.tar.gz: 2033b7e8215841e2b57eb46355cef483e5badc30d56affffd1cd47b7e245442612fee91ec0918fda4828064fca7a7dc62e2268b329730ae0534e8ec07ed16aee
+  metadata.gz: eae14b861938c6a351a1b0430eb8ec03569a41fec7896af012addfb2fb5e4f60d6a28345c2cde6c1b82270ccd40cda21da9db470fa7694a2368930ab3e1f1072
+  data.tar.gz: a31f91cf5db94e669f992b03added0312d287aeb991b327adc3f7703d8cc582e460d26d3e7e2c4692a3a29693f2de6cf9998b4e59be593e7a64569b6fb66758d

data/README.md

@@ -91,6 +91,23 @@ The default model is `gpt-5.5`.
 
 The OpenAI API URL is fixed to `https://api.openai.com/v1/responses`.
 
+## Multi-Turn Chat
+
+Responses include a `response_id` that can be passed back through `options` as `previous_response_id`:
+
+```ruby
+first = ai.chat("Tell me a short joke.")
+
+follow_up = ai.chat(
+  "Explain why that is funny.",
+  options: {
+    previous_response_id: first["response_id"]
+  }
+)
+
+puts follow_up["content"]
+```
+
 ## Return Shape
 
 `chat` always returns a hash envelope.
@@ -100,6 +117,7 @@ Text output:
 ```ruby
 {
   "content" => "Hello!",
+  "response_id" => "resp_...",
   "status" => 200,
   "error" => nil,
   "raw" => nil
@@ -111,6 +129,7 @@ JSON-looking model output:
 ```ruby
 {
   "content" => { "valid" => true },
+  "response_id" => "resp_...",
   "status" => 200,
   "error" => nil,
   "raw" => nil
@@ -122,6 +141,7 @@ Failure:
 ```ruby
 {
   "content" => nil,
+  "response_id" => nil,
   "status" => 401,
   "error" => "Invalid API key",
   "raw" => nil
@@ -135,6 +155,7 @@ result = ai.chat("Say hello", debug: true)
 
 {
   "content" => "Hello!",
+  "response_id" => "resp_...",
   "status" => 200,
   "error" => nil,
   "raw" => { ... }

data/lib/ai_lite/version.rb

@@ -1,3 +1,3 @@
 class AiLite
-  VERSION = "0.1.0".freeze
+  VERSION = "0.1.1".freeze
 end

data/lib/ai_lite.rb

@@ -106,12 +106,24 @@ class AiLite
     parsed_response = JSON.parse(response.body)
 
     unless success_status?(status)
-      return prettify_data(status: status, error: error_message(parsed_response), raw: parsed_response, debug: debug)
+      return prettify_data(
+        status: status,
+        error: error_message(parsed_response),
+        response_id: parsed_response["id"],
+        raw: parsed_response,
+        debug: debug
+      )
     end
 
     raw_content = extract_output_text(parsed_response)
     content = parse_content(raw_content)
-    prettify_data(status: status, content: content, raw: parsed_response, debug: debug)
+    prettify_data(
+      status: status,
+      content: content,
+      response_id: parsed_response["id"],
+      raw: parsed_response,
+      debug: debug
+    )
   rescue JSON::ParserError => e
     prettify_data(status: response_status(response), error: e.message, raw: response&.body, debug: debug)
   rescue => e
@@ -154,9 +166,10 @@ class AiLite
     response&.code&.to_i || "unknown"
   end
 
-  def prettify_data(status:, content: nil, error: nil, raw:, debug: false)
+  def prettify_data(status:, content: nil, error: nil, response_id: nil, raw:, debug: false)
     {
       "content" => content,
+      "response_id" => response_id,
       "status" => status,
       "error" => error,
       "raw" => debug ? raw : nil

data/test/ai_lite_test.rb

@@ -130,6 +130,7 @@ class AiLiteTest < Minitest::Test
       payload = JSON.parse(request.body)
 
       assert_equal "Hello!", result["content"]
+      assert_equal "resp_test_123", result["response_id"]
       assert_equal 200, result["status"]
       assert_nil result["error"]
       assert_nil result["raw"]
@@ -196,9 +197,28 @@ class AiLiteTest < Minitest::Test
     end
   end
 
+  def test_chat_supports_previous_response_id_through_options
+    client = AiLite.new(api_key: "token-abc")
+
+    with_stubbed_http(success_response("Follow-up")) do |captured, _response|
+      result = client.chat(
+        "Explain why that is funny",
+        options: {
+          previous_response_id: "resp_previous_123"
+        }
+      )
+      payload = JSON.parse(captured[:http].last_request.body)
+
+      assert_equal "resp_previous_123", payload["previous_response_id"]
+      assert_equal "Follow-up", result["content"]
+      assert_equal "resp_test_123", result["response_id"]
+    end
+  end
+
   def test_extracts_text_from_nested_output_text_items
     client = AiLite.new(api_key: "token-abc")
     body = JSON.generate(
+      "id" => "resp_nested_123",
       "output" => [
         { "type" => "reasoning", "content" => [] },
         {
@@ -215,6 +235,7 @@ class AiLiteTest < Minitest::Test
       result = client.chat("Say hello")
 
       assert_equal "Hello world", result["content"]
+      assert_equal "resp_nested_123", result["response_id"]
       assert_equal 200, result["status"]
       assert_nil result["error"]
     end
@@ -264,6 +285,7 @@ class AiLiteTest < Minitest::Test
       result = client.chat("Say hello")
 
       assert_nil result["content"]
+      assert_nil result["response_id"]
       assert_equal 401, result["status"]
       assert_equal "Invalid API key", result["error"]
       assert_nil result["raw"]
@@ -291,6 +313,7 @@ class AiLiteTest < Minitest::Test
       result = client.chat("Say hello")
 
       assert_nil result["content"]
+      assert_nil result["response_id"]
       assert_equal 200, result["status"]
       assert_match(/unexpected token|unexpected character|parse/i, result["error"])
       assert_nil result["raw"]
@@ -321,6 +344,7 @@ class AiLiteTest < Minitest::Test
     result = client.chat("Say hello")
 
     assert_nil result["content"]
+    assert_nil result["response_id"]
     assert_equal "unknown", result["status"]
     assert_equal "connection failed", result["error"]
     assert_nil result["raw"]
@@ -332,6 +356,7 @@ class AiLiteTest < Minitest::Test
 
   def success_response(content)
     body = JSON.generate(
+      "id" => "resp_test_123",
       "output" => [
         {
           "type" => "message",

metadata

@@ -1,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: ai-lite
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - William Basmayor
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-05-13 00:00:00.000000000 Z
+date: 2026-05-29 00:00:00.000000000 Z
 dependencies: []
 description: AI Lite is a dependency-light Ruby client for Rails apps and plain Ruby
   projects that need simple OpenAI Responses API calls.
-email:
+email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -27,7 +27,7 @@ homepage: https://github.com/wbasmayor/ai-lite
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -42,8 +42,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: Minimal Ruby client for simple AI chat calls through the OpenAI Responses
   API.