ruby_llm-providers-groq 2.0.0.pre.1

data/spec/fixtures/vcr_cassettes/rubyllm_chat_groq_qwen_qwen3_8_27b_can_use_tools.yml

@@ -0,0 +1,152 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.groq.com/openai/v1/responses
+    body:
+      encoding: UTF-8
+      string: '{"model":"qwen/qwen3.8-27b","input":[{"role":"user","content":"What''s
+        the weather in Berlin? Use 52.5200, 13.4050."}],"stream":false,"store":false,"tools":[{"type":"function","name":"weather","description":"Gets
+        current weather for a location","parameters":{"type":"object","properties":{"latitude":{"type":"string","description":"Latitude"},"longitude":{"type":"string","description":"Longitude"}},"required":["latitude","longitude"],"additionalProperties":false,"strict":true},"strict":false}]}'
+    headers:
+      User-Agent:
+      - Faraday v2.14.4
+      Authorization:
+      - Bearer <AUTH_TOKEN>
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Wed, 07 Oct 2026 16:48:59 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Cache-Control:
+      - private, max-age=0, no-store, no-cache, must-revalidate
+      Server:
+      - cloudflare
+      Vary:
+      - Origin
+      X-Groq-Region:
+      - dls
+      X-Ratelimit-Limit-Requests:
+      - '1000'
+      X-Ratelimit-Limit-Tokens:
+      - '8000'
+      X-Ratelimit-Remaining-Requests:
+      - '994'
+      X-Ratelimit-Remaining-Tokens:
+      - '7281'
+      X-Ratelimit-Reset-Requests:
+      - 8m38.4s
+      X-Ratelimit-Reset-Tokens:
+      - 23.34s
+      X-Request-Id:
+      - req_01m4bm9b16ekpr23jjhgq99gdc
+      Via:
+      - 1.1 google
+      Alt-Svc:
+      - h3=":443"; ma=86400
+      Cf-Cache-Status:
+      - DYNAMIC
+      Set-Cookie:
+      - __cf_bm=6n0BSCZAb4sticznTXikANIWQ4hRD0KAdXlgDEiQg1s-1791391738.8197184-1.0.1.1-5D88MLf22WDRiQhFRiEcyUBCinTMXeWMYkWGMy50.3eUrzi._wMKyeY3A7dYYzOmKtSIMqZPoXBG7d29JP9mB9CnwJtJdaHHSfS.4UK7khx5Hw_t5.J1DSHEBagnmj.x;
+        HttpOnly; SameSite=None; Secure; Path=/; Domain=groq.com; Expires=Wed, 07
+        Oct 2026 17:18:59 GMT
+      Strict-Transport-Security:
+      - max-age=15552000
+      Cf-Ray:
+      - a46e657f9c7102ba-HEL
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"resp_01m4bm9b82et4rkabjx8zjy7dg","object":"response","status":"completed","created_at":1791391739,"output":[{"type":"reasoning","id":"resp_01m4bm9b82et58g8q94rw0ejcc","status":"completed","summary":[]},{"type":"function_call","id":"need8cqcy","status":"completed","call_id":"need8cqcy","name":"weather","arguments":"{\"latitude\":\"52.5200\",\"longitude\":\"13.4050\"}"}],"previous_response_id":null,"model":"qwen/qwen3.8-27b","reasoning":{"effort":"none"},"max_output_tokens":null,"text":{"format":{"type":"text"}},"tools":[{"type":"function","name":"weather","description":"Gets
+        current weather for a location","parameters":{"additionalProperties":false,"properties":{"latitude":{"description":"Latitude","type":"string"},"longitude":{"description":"Longitude","type":"string"}},"required":["latitude","longitude"],"strict":true,"type":"object"},"strict":false}],"tool_choice":"auto","truncation":"disabled","metadata":{},"groq":null,"temperature":1,"top_p":1,"user":null,"service_tier":"default","background":false,"error":null,"incomplete_details":null,"usage":{"input_tokens":330,"input_tokens_details":{"cached_tokens":0},"output_tokens":50,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":380},"parallel_tool_calls":true,"store":false,"top_logprobs":null,"max_tool_calls":null}
+
+        '
+  recorded_at: Wed, 07 Oct 2026 16:48:59 GMT
+- request:
+    method: post
+    uri: https://api.groq.com/openai/v1/responses
+    body:
+      encoding: UTF-8
+      string: '{"model":"qwen/qwen3.8-27b","input":[{"role":"user","content":"What''s
+        the weather in Berlin? Use 52.5200, 13.4050."},{"type":"function_call","call_id":"need8cqcy","name":"weather","arguments":"{\"latitude\":\"52.5200\",\"longitude\":\"13.4050\"}"},{"type":"function_call_output","call_id":"need8cqcy","output":"Current
+        weather at 52.5200, 13.4050: 15°C, Wind: 10 km/h"}],"stream":false,"store":false,"tools":[{"type":"function","name":"weather","description":"Gets
+        current weather for a location","parameters":{"type":"object","properties":{"latitude":{"type":"string","description":"Latitude"},"longitude":{"type":"string","description":"Longitude"}},"required":["latitude","longitude"],"additionalProperties":false,"strict":true},"strict":false}]}'
+    headers:
+      User-Agent:
+      - Faraday v2.14.4
+      Authorization:
+      - Bearer <AUTH_TOKEN>
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Wed, 07 Oct 2026 16:48:59 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Cache-Control:
+      - private, max-age=0, no-store, no-cache, must-revalidate
+      Server:
+      - cloudflare
+      Vary:
+      - Origin
+      X-Groq-Region:
+      - dls
+      X-Ratelimit-Limit-Requests:
+      - '1000'
+      X-Ratelimit-Limit-Tokens:
+      - '8000'
+      X-Ratelimit-Remaining-Requests:
+      - '993'
+      X-Ratelimit-Remaining-Tokens:
+      - '6708'
+      X-Ratelimit-Reset-Requests:
+      - 10m4.8s
+      X-Ratelimit-Reset-Tokens:
+      - 35.699s
+      X-Request-Id:
+      - req_01m4bm9bj5e0tbrfxv3ggsc541
+      Via:
+      - 1.1 google
+      Alt-Svc:
+      - h3=":443"; ma=86400
+      Cf-Cache-Status:
+      - DYNAMIC
+      Set-Cookie:
+      - __cf_bm=sMd2yUwGBBEW3i4mnVSFWKBtbgB1nhkCWBTAqofoNL4-1791391739.3726306-1.0.1.1-_RWoeDDTaqG4pxnQ8oyitUmC_1.IGF8x8EiPyB73b7nG.De3EC_TmPxh_fYBOADgdpgQQb.lhRJdHmHxq2FABtPQDuifhYzQhU9Md76q3xQ04NQHmp5z.C.9AahrVONy;
+        HttpOnly; SameSite=None; Secure; Path=/; Domain=groq.com; Expires=Wed, 07
+        Oct 2026 17:18:59 GMT
+      Strict-Transport-Security:
+      - max-age=15552000
+      Cf-Ray:
+      - a46e65831e0d8d58-HEL
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        eyJpZCI6InJlc3BfMDFtNGJtOWJucmU3ZWJheTFiNnJwbTdnY2IiLCJvYmplY3QiOiJyZXNwb25zZSIsInN0YXR1cyI6ImNvbXBsZXRlZCIsImNyZWF0ZWRfYXQiOjE3OTEzOTE3MzksIm91dHB1dCI6W3sidHlwZSI6InJlYXNvbmluZyIsImlkIjoicmVzcF8wMW00Ym05Ym5yZTdlcmYyMW1zeDgzczl5eSIsInN0YXR1cyI6ImNvbXBsZXRlZCIsInN1bW1hcnkiOltdfSx7InR5cGUiOiJtZXNzYWdlIiwiaWQiOiJtc2dfMDFtNGJtOWJucmU3ZjgxNmM1NnlyYmhycGsiLCJzdGF0dXMiOiJjb21wbGV0ZWQiLCJyb2xlIjoiYXNzaXN0YW50IiwiY29udGVudCI6W3sidHlwZSI6Im91dHB1dF90ZXh0IiwidGV4dCI6IlRoZSBjdXJyZW50IHdlYXRoZXIgaW4gQmVybGluIGlzIDE1wrBDIHdpdGggYSB3aW5kIHNwZWVkIG9mIDEwIGttL2guIiwiYW5ub3RhdGlvbnMiOltdLCJsb2dwcm9icyI6bnVsbH1dfV0sInByZXZpb3VzX3Jlc3BvbnNlX2lkIjpudWxsLCJtb2RlbCI6InF3ZW4vcXdlbjMuOC0yN2IiLCJyZWFzb25pbmciOnsiZWZmb3J0Ijoibm9uZSJ9LCJtYXhfb3V0cHV0X3Rva2VucyI6bnVsbCwidGV4dCI6eyJmb3JtYXQiOnsidHlwZSI6InRleHQifX0sInRvb2xzIjpbeyJ0eXBlIjoiZnVuY3Rpb24iLCJuYW1lIjoid2VhdGhlciIsImRlc2NyaXB0aW9uIjoiR2V0cyBjdXJyZW50IHdlYXRoZXIgZm9yIGEgbG9jYXRpb24iLCJwYXJhbWV0ZXJzIjp7ImFkZGl0aW9uYWxQcm9wZXJ0aWVzIjpmYWxzZSwicHJvcGVydGllcyI6eyJsYXRpdHVkZSI6eyJkZXNjcmlwdGlvbiI6IkxhdGl0dWRlIiwidHlwZSI6InN0cmluZyJ9LCJsb25naXR1ZGUiOnsiZGVzY3JpcHRpb24iOiJMb25naXR1ZGUiLCJ0eXBlIjoic3RyaW5nIn19LCJyZXF1aXJlZCI6WyJsYXRpdHVkZSIsImxvbmdpdHVkZSJdLCJzdHJpY3QiOnRydWUsInR5cGUiOiJvYmplY3QifSwic3RyaWN0IjpmYWxzZX1dLCJ0b29sX2Nob2ljZSI6ImF1dG8iLCJ0cnVuY2F0aW9uIjoiZGlzYWJsZWQiLCJtZXRhZGF0YSI6e30sImdyb3EiOm51bGwsInRlbXBlcmF0dXJlIjoxLCJ0b3BfcCI6MSwidXNlciI6bnVsbCwic2VydmljZV90aWVyIjoiZGVmYXVsdCIsImJhY2tncm91bmQiOmZhbHNlLCJlcnJvciI6bnVsbCwiaW5jb21wbGV0ZV9kZXRhaWxzIjpudWxsLCJ1c2FnZSI6eyJpbnB1dF90b2tlbnMiOjQzMCwiaW5wdXRfdG9rZW5zX2RldGFpbHMiOnsiY2FjaGVkX3Rva2VucyI6MH0sIm91dHB1dF90b2tlbnMiOjIyLCJvdXRwdXRfdG9rZW5zX2RldGFpbHMiOnsicmVhc29uaW5nX3Rva2VucyI6MH0sInRvdGFsX3Rva2VucyI6NDUyfSwicGFyYWxsZWxfdG9vbF9jYWxscyI6dHJ1ZSwic3RvcmUiOmZhbHNlLCJ0b3BfbG9ncHJvYnMiOm51bGwsIm1heF90b29sX2NhbGxzIjpudWxsfQo=
+  recorded_at: Wed, 07 Oct 2026 16:48:59 GMT
+recorded_with: VCR 6.4.0

data/spec/fixtures/vcr_cassettes/rubyllm_chat_groq_qwen_qwen3_8_27b_returns_structured_output.yml

@@ -0,0 +1,77 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.groq.com/openai/v1/responses
+    body:
+      encoding: UTF-8
+      string: '{"model":"qwen/qwen3.8-27b","input":[{"role":"user","content":"Generate
+        a person named John who is 30 years old"}],"stream":false,"store":false,"text":{"format":{"type":"json_schema","name":"response","schema":{"type":"object","properties":{"name":{"type":"string"},"age":{"type":"integer"}},"required":["name","age"],"additionalProperties":false},"strict":true}}}'
+    headers:
+      User-Agent:
+      - Faraday v2.14.4
+      Authorization:
+      - Bearer <AUTH_TOKEN>
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Wed, 07 Oct 2026 16:48:53 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Cache-Control:
+      - private, max-age=0, no-store, no-cache, must-revalidate
+      Server:
+      - cloudflare
+      Vary:
+      - Origin
+      X-Groq-Region:
+      - dls
+      X-Ratelimit-Limit-Requests:
+      - '1000'
+      X-Ratelimit-Limit-Tokens:
+      - '8000'
+      X-Ratelimit-Remaining-Requests:
+      - '999'
+      X-Ratelimit-Remaining-Tokens:
+      - '7791'
+      X-Ratelimit-Reset-Requests:
+      - 1m26.4s
+      X-Ratelimit-Reset-Tokens:
+      - 1.567s
+      X-Request-Id:
+      - req_01m4bm95h6eknbhd2g57rb86ak
+      Via:
+      - 1.1 google
+      Alt-Svc:
+      - h3=":443"; ma=86400
+      Cf-Cache-Status:
+      - DYNAMIC
+      Set-Cookie:
+      - __cf_bm=Rp.gZmJcvxYbWZDsbdfQDBTAz7DaFtywcVrwdQQSlXk-1791391733.2010832-1.0.1.1-MBeC0_FXCrPoveYPbgkP024YhTYGhnm2G8ai26jtHdCFBhXKN11v070xGxHdVs6b11ivLdL8VDl_Rkqlhfa4lE0lfIcHCiMUBNgwfgDgZ88op59V9O6YeWQYlBnkTMXH;
+        HttpOnly; SameSite=None; Secure; Path=/; Domain=groq.com; Expires=Wed, 07
+        Oct 2026 17:18:53 GMT
+      Strict-Transport-Security:
+      - max-age=15552000
+      Cf-Ray:
+      - a46e655c799e4825-HEL
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"resp_01m4bm95k1ejrt9pm29qkr3r1w","object":"response","status":"completed","created_at":1791391733,"output":[{"type":"reasoning","id":"resp_01m4bm95k1ejs9anac75h9cntj","status":"completed","summary":[]},{"type":"message","id":"msg_01m4bm95k1ejst5m6wcxpz59xh","status":"completed","role":"assistant","content":[{"type":"output_text","text":"{\"age\":
+        30, \"name\": \"John\"}","annotations":[],"logprobs":null}]}],"previous_response_id":null,"model":"qwen/qwen3.8-27b","reasoning":{"effort":"none"},"max_output_tokens":null,"text":{"format":{"type":"json_schema","name":"response","schema":{"additionalProperties":false,"properties":{"age":{"type":"integer"},"name":{"type":"string"}},"required":["name","age"],"type":"object"},"strict":true}},"tools":[],"tool_choice":"auto","truncation":"disabled","metadata":{},"groq":null,"temperature":1,"top_p":1,"user":null,"service_tier":"default","background":false,"error":null,"incomplete_details":null,"usage":{"input_tokens":24,"input_tokens_details":{"cached_tokens":0},"output_tokens":15,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":39},"parallel_tool_calls":true,"store":false,"top_logprobs":null,"max_tool_calls":null}
+
+        '
+  recorded_at: Wed, 07 Oct 2026 16:48:53 GMT
+recorded_with: VCR 6.4.0

data/spec/fixtures/vcr_cassettes/rubyllm_chat_groq_qwen_qwen3_8_27b_returns_the_raw_response.yml

@@ -0,0 +1,77 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.groq.com/openai/v1/responses
+    body:
+      encoding: UTF-8
+      string: '{"model":"qwen/qwen3.8-27b","input":[{"role":"user","content":"What
+        is the capital of France?"}],"stream":false,"store":false}'
+    headers:
+      User-Agent:
+      - Faraday v2.14.4
+      Authorization:
+      - Bearer <AUTH_TOKEN>
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Wed, 07 Oct 2026 16:48:57 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Cache-Control:
+      - private, max-age=0, no-store, no-cache, must-revalidate
+      Server:
+      - cloudflare
+      Vary:
+      - Origin
+      X-Groq-Region:
+      - dls
+      X-Ratelimit-Limit-Requests:
+      - '1000'
+      X-Ratelimit-Limit-Tokens:
+      - '8000'
+      X-Ratelimit-Remaining-Requests:
+      - '995'
+      X-Ratelimit-Remaining-Tokens:
+      - '7392'
+      X-Ratelimit-Reset-Requests:
+      - 7m12s
+      X-Ratelimit-Reset-Tokens:
+      - 35.34s
+      X-Request-Id:
+      - req_01m4bm99xzedvt58x4pv2vqdtn
+      Via:
+      - 1.1 google
+      Alt-Svc:
+      - h3=":443"; ma=86400
+      Cf-Cache-Status:
+      - DYNAMIC
+      Set-Cookie:
+      - __cf_bm=XLgVqOc4BryYpxr3WtbJj06g9ruNoyrH7wPhKXTx4OY-1791391737.6914153-1.0.1.1-fvXlPgyrWk0GhH6hiMdkiKPIMQMcDI6ar4utialeFyFpzwbD6tDVU4IKhZCK6J4.WdVQT.16glOHfj5lwpSsDuVqP_E_HMKTWdaVZpxcEowI2DGTh.aCZt32QFwRjwYK;
+        HttpOnly; SameSite=None; Secure; Path=/; Domain=groq.com; Expires=Wed, 07
+        Oct 2026 17:18:57 GMT
+      Strict-Transport-Security:
+      - max-age=15552000
+      Cf-Ray:
+      - a46e65789a841ede-HEL
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"resp_01m4bm99zeeeavesphwjm6thn2","object":"response","status":"completed","created_at":1791391737,"output":[{"type":"reasoning","id":"resp_01m4bm99zeeeb877rssymg8dbc","status":"completed","summary":[]},{"type":"message","id":"msg_01m4bm99zeeebtv8sty8x7x5qf","status":"completed","role":"assistant","content":[{"type":"output_text","text":"The
+        capital of France is **Paris**.","annotations":[],"logprobs":null}]}],"previous_response_id":null,"model":"qwen/qwen3.8-27b","reasoning":{"effort":"none"},"max_output_tokens":null,"text":{"format":{"type":"text"}},"tools":[],"tool_choice":"auto","truncation":"disabled","metadata":{},"groq":null,"temperature":1,"top_p":1,"user":null,"service_tier":"default","background":false,"error":null,"incomplete_details":null,"usage":{"input_tokens":19,"input_tokens_details":{"cached_tokens":0},"output_tokens":9,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":28},"parallel_tool_calls":true,"store":false,"top_logprobs":null,"max_tool_calls":null}
+
+        '
+  recorded_at: Wed, 07 Oct 2026 16:48:57 GMT
+recorded_with: VCR 6.4.0

data/spec/fixtures/vcr_cassettes/rubyllm_chat_groq_qwen_qwen3_8_27b_supports_streaming_responses.yml

@@ -0,0 +1,126 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.groq.com/openai/v1/responses
+    body:
+      encoding: UTF-8
+      string: '{"model":"qwen/qwen3.8-27b","input":[{"role":"user","content":"Count
+        from 1 to 3"}],"stream":true,"store":false}'
+    headers:
+      User-Agent:
+      - Faraday v2.14.4
+      Authorization:
+      - Bearer <AUTH_TOKEN>
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Wed, 07 Oct 2026 16:48:53 GMT
+      Content-Type:
+      - text/event-stream
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Cache-Control:
+      - no-cache
+      Server:
+      - cloudflare
+      Vary:
+      - Origin
+      X-Groq-Region:
+      - dls
+      X-Ratelimit-Limit-Requests:
+      - '1000'
+      X-Ratelimit-Limit-Tokens:
+      - '8000'
+      X-Ratelimit-Remaining-Requests:
+      - '998'
+      X-Ratelimit-Remaining-Tokens:
+      - '7637'
+      X-Ratelimit-Reset-Requests:
+      - 2m52.8s
+      X-Ratelimit-Reset-Tokens:
+      - 20.639s
+      X-Request-Id:
+      - req_01m4bm95xdecs8vyvydz11t9f3
+      Via:
+      - 1.1 google
+      Alt-Svc:
+      - h3=":443"; ma=86400
+      Cf-Cache-Status:
+      - DYNAMIC
+      Set-Cookie:
+      - __cf_bm=dFAMGYsleaUx5TfCxJRPrwOcHlC98BasyB4BcELoUS0-1791391733.5906844-1.0.1.1-VJy8waJsRXkDe2_7PLnqoH6bsxhgpxa9Ljjn1V_9ajfz9zPnXSkn8wH6HaVwA.WBgsiqO38cbaoVujL_7RBJlVJ0WA.DJpY3PRRDXdlX6eSBIcaTDm0uS8nmch_n5hDU;
+        HttpOnly; SameSite=None; Secure; Path=/; Domain=groq.com; Expires=Wed, 07
+        Oct 2026 17:18:53 GMT
+      Strict-Transport-Security:
+      - max-age=15552000
+      Cf-Ray:
+      - a46e655ee85cf78c-HEL
+    body:
+      encoding: UTF-8
+      string: |+
+        event: response.created
+        data: {"type":"response.created","sequence_number":0,"response":{"id":"resp_01m4bm95y7eb28tghetrch4vgh","object":"response","status":"in_progress","created_at":1791391733,"output":[],"previous_response_id":null,"model":"qwen/qwen3.8-27b","reasoning":{"effort":"none"},"max_output_tokens":null,"text":{"format":{"type":"text"}},"tools":[],"tool_choice":"auto","truncation":"disabled","metadata":{},"groq":null,"temperature":1,"top_p":1,"user":null,"service_tier":"default","background":false,"error":null,"incomplete_details":null,"parallel_tool_calls":true,"store":false,"top_logprobs":null,"max_tool_calls":null}}
+
+        event: response.in_progress
+        data: {"type":"response.in_progress","sequence_number":1,"response":{"id":"resp_01m4bm95y7eb28tghetrch4vgh","object":"response","status":"in_progress","created_at":1791391733,"output":[],"previous_response_id":null,"model":"qwen/qwen3.8-27b","reasoning":{"effort":"none"},"max_output_tokens":null,"text":{"format":{"type":"text"}},"tools":[],"tool_choice":"auto","truncation":"disabled","metadata":{},"groq":null,"temperature":1,"top_p":1,"user":null,"service_tier":"default","background":false,"error":null,"incomplete_details":null,"parallel_tool_calls":true,"store":false,"top_logprobs":null,"max_tool_calls":null}}
+
+        event: response.output_item.added
+        data: {"type":"response.output_item.added","sequence_number":2,"output_index":1,"item":{"type":"message","id":"msg_01m4bm95y8ezvtt1mwca86he3j","role":"assistant","content":[]}}
+
+        event: response.content_part.added
+        data: {"type":"response.content_part.added","sequence_number":3,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"part":{"type":"output_text","text":"","annotations":[],"logprobs":null}}
+
+        event: response.output_text.delta
+        data: {"type":"response.output_text.delta","sequence_number":4,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"delta":"1","logprobs":[]}
+
+        event: response.output_text.delta
+        data: {"type":"response.output_text.delta","sequence_number":5,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"delta":",","logprobs":[]}
+
+        event: response.output_text.delta
+        data: {"type":"response.output_text.delta","sequence_number":6,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"delta":" ","logprobs":[]}
+
+        event: response.output_text.delta
+        data: {"type":"response.output_text.delta","sequence_number":7,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"delta":"2","logprobs":[]}
+
+        event: response.output_text.delta
+        data: {"type":"response.output_text.delta","sequence_number":8,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"delta":",","logprobs":[]}
+
+        event: response.output_text.delta
+        data: {"type":"response.output_text.delta","sequence_number":9,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"delta":" ","logprobs":[]}
+
+        event: response.output_text.delta
+        data: {"type":"response.output_text.delta","sequence_number":10,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"delta":"3","logprobs":[]}
+
+        event: response.output_item.added
+        data: {"type":"response.output_item.added","sequence_number":11,"output_index":0,"item":{"type":"reasoning","id":"resp_01m4bm95y7eb2tjx9hqns9d3pg","content":[{"type":"reasoning_text","text":""}],"summary":[]}}
+
+        event: response.output_item.done
+        data: {"type":"response.output_item.done","sequence_number":12,"output_index":0,"item":{"type":"reasoning","id":"resp_01m4bm95y7eb2tjx9hqns9d3pg","content":[{"type":"reasoning_text","text":""}],"summary":[]}}
+
+        event: response.output_text.done
+        data: {"type":"response.output_text.done","sequence_number":13,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"text":"1, 2, 3","logprobs":[]}
+
+        event: response.content_part.done
+        data: {"type":"response.content_part.done","sequence_number":14,"item_id":"msg_01m4bm95y8ezvtt1mwca86he3j","output_index":1,"content_index":0,"part":{"type":"output_text","text":"1, 2, 3","annotations":[],"logprobs":null}}
+
+        event: response.output_item.done
+        data: {"type":"response.output_item.done","sequence_number":15,"output_index":1,"item":{"type":"message","id":"msg_01m4bm95y8ezvtt1mwca86he3j","status":"completed","role":"assistant","content":[{"type":"output_text","text":"1, 2, 3","annotations":[],"logprobs":[]}]}}
+
+        event: response.completed
+        data: {"type":"response.completed","sequence_number":16,"response":{"id":"resp_01m4bm95y7eb28tghetrch4vgh","object":"response","status":"completed","created_at":1791391733,"output":[{"type":"reasoning","id":"resp_01m4bm95y7eb2tjx9hqns9d3pg","content":[{"type":"reasoning_text","text":""}],"summary":[]},{"type":"message","id":"msg_01m4bm95y8ezvtt1mwca86he3j","status":"completed","role":"assistant","content":[{"type":"output_text","text":"1, 2, 3","annotations":[],"logprobs":[]}]}],"previous_response_id":null,"model":"qwen/qwen3.8-27b","reasoning":{"effort":"none"},"max_output_tokens":null,"text":{"format":{"type":"text"}},"tools":[],"tool_choice":"auto","truncation":"disabled","metadata":{},"groq":null,"temperature":1,"top_p":1,"user":null,"service_tier":"default","background":false,"error":null,"incomplete_details":null,"usage":{"input_tokens":19,"input_tokens_details":{"cached_tokens":0},"output_tokens":8,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":27},"parallel_tool_calls":true,"store":false,"top_logprobs":null,"max_tool_calls":null}}
+
+  recorded_at: Wed, 07 Oct 2026 16:48:53 GMT
+recorded_with: VCR 6.4.0
+...

data/spec/ruby_llm/chat_schema_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  let(:person_schema) do
+    {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        age: { type: 'integer' }
+      },
+      required: %w[name age],
+      additionalProperties: false
+    }
+  end
+
+  each_model(STRUCTURED_OUTPUT_MODELS) do |provider, model|
+    it "#{provider}/#{model} returns structured output" do
+      response = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+                        .with_schema(person_schema)
+                        .ask('Generate a person named John who is 30 years old')
+
+      expect(response.content).to be_a(String)
+      expect(response.parsed).to include('name' => 'John', 'age' => 30)
+    end
+  end
+end

data/spec/ruby_llm/chat_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(CHAT_MODELS) do |provider, model|
+    it "#{provider}/#{model} can have a basic conversation" do
+      response = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true).ask("What's 2 + 2?")
+
+      expect(response.content).to include('4')
+      expect(response.role).to eq(:assistant)
+      expect(response.tokens.input.to_i).to be_positive
+      expect(response.tokens.output.to_i).to be_positive
+    end
+
+    it "#{provider}/#{model} returns the raw response" do
+      response = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+                        .ask('What is the capital of France?')
+
+      expect(response.raw.status).to eq(200)
+      expect(response.raw.headers).not_to be_empty
+      expect(response.raw.body).not_to be_empty
+      expect(response.raw.env.request_body).not_to be_empty
+    end
+
+    it "#{provider}/#{model} can handle a multi-turn conversation" do
+      chat = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+
+      expect(chat.ask('Who created the programming language Ruby?').content).to match(/Matz|Matsumoto/i)
+      expect(chat.ask('What year was Ruby first released?').content).to include('199')
+    end
+  end
+end

data/spec/ruby_llm/chat_streaming_spec.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(CHAT_MODELS) do |provider, model|
+    it "#{provider}/#{model} supports streaming responses" do
+      chunks = []
+      chat = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true)
+
+      response = chat.ask('Count from 1 to 3') { |chunk| chunks << chunk }
+
+      expect(chunks).not_to be_empty
+      expect(chunks.first).to be_a(RubyLLM::Chunk)
+      expect(response.raw.status).to eq(200)
+      expect(response.raw.headers).not_to be_empty
+      expect(response.raw.env.request_body).not_to be_empty
+    end
+  end
+end

data/spec/ruby_llm/chat_tools_spec.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Chat, :live do
+  include_context 'with configured RubyLLM'
+
+  let(:weather_tool) do
+    Class.new(RubyLLM::Tool) do
+      def self.name = 'WeatherTool'
+      description 'Gets current weather for a location'
+      parameter :latitude, description: 'Latitude'
+      parameter :longitude, description: 'Longitude'
+
+      def execute(latitude:, longitude:)
+        "Current weather at #{latitude}, #{longitude}: 15°C, Wind: 10 km/h"
+      end
+    end
+  end
+
+  each_model(TOOL_MODELS) do |provider, model|
+    it "#{provider}/#{model} can use tools" do
+      chat = RubyLLM.chat(model: model, provider: provider, assume_model_exists: true).with_tools(weather_tool)
+      response = chat.ask("What's the weather in Berlin? Use 52.5200, 13.4050.")
+
+      expect(response.content).to include('15')
+      expect(response.content).to include('10')
+      expect(chat.messages.any?(&:tool_call?)).to be(true)
+    end
+  end
+end

data/spec/ruby_llm/embedding_spec.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Embedding, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(EMBEDDING_MODELS) do |provider, model, model_info|
+    it "#{provider}/#{model} embeds one text" do
+      embedding = RubyLLM.embed(
+        "Ruby is a programmer's best friend",
+        model: model,
+        provider: provider,
+        assume_model_exists: true
+      )
+
+      expect(embedding.vectors).to be_an(Array)
+      expect(embedding.vectors.first).to be_a(Numeric)
+      expect(embedding.model).to eq(model)
+      expect(embedding.tokens.input.to_i).to be >= 0
+    end
+
+    it "#{provider}/#{model} embeds several texts" do
+      embeddings = RubyLLM.embed(
+        %w[Ruby Python JavaScript],
+        model: model,
+        provider: provider,
+        assume_model_exists: true
+      )
+
+      expect(embeddings.vectors.size).to eq(3)
+      expect(embeddings.vectors).to all(be_an(Array))
+    end
+
+    next unless model_info[:dimensions]
+
+    it "#{provider}/#{model} supports custom dimensions" do
+      embedding = RubyLLM.embed(
+        'Ruby',
+        model: model,
+        provider: provider,
+        assume_model_exists: true,
+        dimensions: model_info[:dimensions]
+      )
+
+      expect(embedding.vectors.length).to eq(model_info[:dimensions])
+    end
+  end
+end

data/spec/ruby_llm/image_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Image, :live do
+  include_context 'with configured RubyLLM'
+
+  each_model(IMAGE_GENERATION_MODELS) do |provider, model, model_info|
+    it "#{provider}/#{model} paints an image" do
+      image = RubyLLM.paint(
+        'a siamese cat',
+        model: model,
+        provider: provider,
+        assume_model_exists: true,
+        provider_options: model_info.fetch(:provider_options, {})
+      )
+
+      expect(image.mime_type).to include('image')
+      expect(image.model).to eq(model)
+      expect(image.to_blob.bytesize).to be > 1000
+    end
+  end
+end

data/spec/ruby_llm/models_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe RubyLLM::Models do
+  include_context 'with configured RubyLLM'
+
+  it 'expects generated providers to add registry metadata before use' do
+    expect(RubyLLM::Providers::Groq.assume_models_exist?).to be(false)
+  end
+end