ruby_llm-ai_sdk 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83d6d8d1f54099cf62f2f8514780f8df54b185e7ad9e0fe7dbd5bb6e57be4a45
-  data.tar.gz: 49069ade3a6b4ff8fe19a417680651740331df524b1126ebe7fec854cd9882ed
+  metadata.gz: 95427bfb5aaa6e2a7f396d47095e84b104886203850cdd88d5e5d2a0b75f9ef6
+  data.tar.gz: a6191fc53db9e82dd82d84eb0bd2ad2b76fbf2e1fd71ab820db459671ee36151
 SHA512:
-  metadata.gz: 53f1644c79f531dd9d89fc655e900b6a27b50c0d55a41b7dec1d8d81b12991a2cca82d9bec777bd1cc685071f321e904f73f7efa55c30abd7379ff025ab910df
-  data.tar.gz: 21219200c9740960c39bab1d1b8ae88c663009a0b6b2de0e8977e23cc45f6229470144e2ca336d27529388b70159a0ac7cc68c6b98010ac4cc199500ca6f79f3
+  metadata.gz: 2ed760fa36e55304ee7c96cba1c0e3751a493384704e56c934adea23c8b4e527c84955386414886cc2ecbfe247e36f0a33d746d4a5b18c4ed69f2aabd8e8ec83
+  data.tar.gz: d4646943ad0bca03f949273ef523b66389e14bf8f8d5c58e355f2ba5dee0085037680a2a160b7e0bb343196d0a331b2a80195f4cfe0c8ffe767a6e24df454c99

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0
+
+- Files attached to a `useChat` message reach the chat: hosted files by URL, data URLs decoded into attachments.
+- `examples/` holds the Rails and Next.js pair the gem was verified with end to end.
+
 ## 0.1.0
 
 - `RubyLLM::AiSdk::Stream` writes a chat turn as AI SDK UI message stream events: text, reasoning, tool calls, tool results, and approval requests.

data/README.md

@@ -39,7 +39,9 @@ const { messages, sendMessage, addToolApprovalResponse } = useChat({
 });
 ```
 
-`stream_chat` reads the body `useChat` posts. When the last message is from the user, it asks it. When the last assistant message carries approval decisions, it records them with `chat.approve` or `chat.deny` and continues the parked turn.
+`stream_chat` reads the body `useChat` posts. When the last message is from the user, it asks it, with any attached files passed to `chat.ask` as attachments. When the last assistant message carries approval decisions, it records them with `chat.approve` or `chat.deny` and continues the parked turn.
+
+[`examples/`](examples/) holds a complete pair, a Rails API app and a Next.js page, that exercises text, tools, approval and denial through a browser.
 
 ## Usage anywhere else
 
@@ -89,6 +91,10 @@ Declare a tool with `requires_approval` and the turn stops before it runs. The c
 - **Tool results come from the transcript, not the callback.** RubyLLM's `after_tool_result` does not carry the tool call id, so results are read from the tool messages appended to the chat. That also keeps concurrent tool execution correct.
 - **Steps follow model responses.** Each assistant message closes a step; a text or reasoning chunk that arrives with no step open opens one.
 
+## Files
+
+`useChat` sends file parts as data URLs by default, or as hosted URLs when you upload them yourself. Both reach `chat.ask` through `with:`: hosted files as their URL, data URLs decoded into a `RubyLLM::Attachment` that keeps the filename, so RubyLLM detects the type and sends it the way the provider expects.
+
 ## Development
 
 ```bash

data/lib/ruby_llm/ai_sdk/request.rb

@@ -12,6 +12,8 @@ module RubyLLM
     #   request.approvals # => []
     #
     class Request
+      DATA_URL = %r{\Adata:[^,]*;base64,(?<data>.*)\z}m # :nodoc:
+
       # One decision on a tool call that required approval.
       Approval = Struct.new(:tool_call_id, :approved, keyword_init: true) do
         # Returns whether the person approved the tool call.
@@ -49,6 +51,15 @@ module RubyLLM
         parts_of_type('text').map { |part| part['text'] }.join("\n")
       end
 
+      # Returns the files attached to the last user message as sources
+      # Chat#ask accepts with +with:+. Hosted files come through as their
+      # URL; data URLs are decoded into an Attachment with the file's name.
+      def files
+        return [] unless last_message&.fetch('role', nil) == 'user'
+
+        parts_of_type('file').map { |part| file_source(part) }
+      end
+
       # Returns the Approval decisions recorded on the last assistant
       # message, an empty array when there are none.
       def approvals
@@ -60,6 +71,12 @@ module RubyLLM
       end
 
       private
+      def file_source(part)
+        match = DATA_URL.match(part['url'].to_s)
+        return part['url'] unless match
+
+        RubyLLM::Attachment.new(StringIO.new(Base64.decode64(match[:data])), filename: part['filename'])
+      end
 
       def last_message
         messages.last

data/lib/ruby_llm/ai_sdk/stream.rb

@@ -30,12 +30,12 @@ module RubyLLM
 
       # Handles one +useChat+ request end to end. Records the approval
       # decisions when the request carries them and continues the parked
-      # turn, otherwise asks the last user message. Returns the final
-      # Message.
+      # turn, otherwise asks the last user message with its files attached.
+      # Returns the final Message.
       def serve(request)
         request = Request.parse(request) if request.is_a?(String)
         request = Request.new(request) if request.is_a?(Hash)
-        return ask(request.text) if request.approvals.empty?
+        return ask(request.text, with: request.files) if request.approvals.empty?
 
         request.approvals.each { |approval| decide(approval) }
         complete(message_id: request.message_id)

data/lib/ruby_llm/ai_sdk/version.rb

@@ -3,6 +3,6 @@
 module RubyLLM
   module AiSdk
     # The version of the ruby_llm-ai_sdk gem, as a string.
-    VERSION = '0.1.0'
+    VERSION = '0.2.0'
   end
 end

data/lib/ruby_llm/ai_sdk.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+require 'base64'
 require 'json'
 require 'securerandom'
+require 'stringio'
 require 'ruby_llm'
 require_relative 'ai_sdk/version'
 require_relative 'ai_sdk/request'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-ai_sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Bruno Costanzo