smith-agents 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b8a1ad3fc2cb40ef0287063f81e0bc01a6bca349b1625c4173daef763785202
-  data.tar.gz: b870358edea9686d15e164bb3d44e00edf8e50da8cb2d68b8a6a666bbc5d0f79
+  metadata.gz: 23c6a49b741d4ff6cfab0707ca1d917b484dc708106d1c892b4f90e2002e5b80
+  data.tar.gz: 72cfe59171b0f759f0312ff062f58c23aeb9a9f7e738f1603dfaf4a9174f9fbb
 SHA512:
-  metadata.gz: bd9dd710fb5008efc7896e950b52621d3c80dab9be902b323efdc76c3d4d12e4b1c066b2219e5e36c56edea5652add7406ecb1d740db79b320035eee9047cee6
-  data.tar.gz: 4d5e6b412d39269276096b697a399ad476dd1d4bc370792d8acfdd8f49041b567da2120e56a0fc1e090cbf4c351c9849201c8b0030fd5518f6c69495b175f534
+  metadata.gz: 245ac5f48372808860db62cc661bf9c9e5bf2a1a3bc4082533b16159b09c50b113bead696d4147e10e850fe0b7fff8cef775da17aa749fc4b7a5574058b765f7
+  data.tar.gz: 7837da6f0c9855f03a0936bdec22279ec6da9c8864fae27de8ab495a334b98654617147b36b7759d171dc19ad13ae80448b18fa3c7da4f16bf84f7c378c004bf

data/CHANGELOG.md

@@ -6,6 +6,32 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Version
 
 ## [Unreleased]
 
+## [0.4.4] - 2026-07-10
+
+Patch release for provider-safe workflow handoffs. Smith keeps accepted agent
+outputs in durable session history while adapting only the next provider call
+when a completed workflow stage would otherwise look like an unsupported
+assistant prefill.
+
+### Fixed
+
+- Adapt workflow-prepared provider input that ends with an accepted assistant
+  result by adding a non-persisted user continuation for the next agent call.
+  This preserves Smith session history while avoiding unsupported assistant
+  prefilling on provider models that require a user turn before completion.
+  Provider preparation now also reads string-keyed roles and content restored
+  through JSON host persistence. Explicit assistant-prefill seed messages remain
+  unchanged unless they match Smith's recorded accepted workflow output.
+
+### Verification
+
+- Default suite: 932 examples, 0 failures.
+- Practical gem-level JSON persistence/restore probe with a 25-branch parallel
+  handoff, provider-safe message ordering, non-persisted continuation, and
+  explicit assistant-prefill preservation.
+- Smith Runtime host verification on Ruby 4.0.1 and Rails 8.1.3: 139 tests,
+  391 assertions, 0 failures, plus a process-level restored workflow run.
+
 ## [0.4.3] - 2026-07-05
 
 ### Documentation

data/README.md

@@ -17,7 +17,7 @@ environment before calling the slice complete.
 
 ```ruby
 # Gemfile
-gem "smith-agents", "~> 0.4.3", require: "smith"
+gem "smith-agents", "0.4.4", require: "smith"
 ```
 
 ```bash

data/lib/smith/agent/lifecycle.rb

@@ -3,6 +3,10 @@
 module Smith
   class Agent
     module Lifecycle
+      WORKFLOW_CONTINUATION_MESSAGE =
+        "Use the preceding assistant result as input and perform your assigned workflow step."
+      private_constant :WORKFLOW_CONTINUATION_MESSAGE
+
       TRANSIENT_ERRORS = [
         RubyLLM::ServerError, RubyLLM::ServiceUnavailableError,
         RubyLLM::OverloadedError, RubyLLM::RateLimitError
@@ -111,6 +115,7 @@ module Smith
       def add_prepared_input(chat, prepared_input)
         return unless prepared_input
 
+        prepared_input = provider_safe_prepared_input(prepared_input)
         system_messages, other_messages = prepared_input.partition do |message|
           message_role(message) == :system
         end
@@ -119,6 +124,22 @@ module Smith
         other_messages.each { |message| chat.add_message(message) }
       end
 
+      def provider_safe_prepared_input(prepared_input)
+        messages = prepared_input.to_a
+        return messages unless workflow_handoff?(messages)
+
+        messages + [{ role: :user, content: WORKFLOW_CONTINUATION_MESSAGE }]
+      end
+
+      def workflow_handoff?(messages)
+        message = messages.reverse_each.find { |candidate| message_role(candidate) != :system }
+        return false unless message
+        return false unless message_role(message) == :assistant
+        return false unless defined?(@last_output) && !@last_output.nil?
+
+        message_content(message) == @last_output
+      end
+
       def merge_system_messages!(chat, prepared_system_messages)
         return prepared_system_messages.each { |message| chat.add_message(message) } unless chat.respond_to?(:messages)
 
@@ -143,19 +164,18 @@ module Smith
       end
 
       def message_role(message)
-        if message.respond_to?(:role)
-          message.role&.to_sym
-        else
-          message[:role]&.to_sym
-        end
+        message_attribute(message, :role)&.to_sym
       end
 
       def message_content(message)
-        if message.respond_to?(:content)
-          message.content
-        else
-          message[:content]
-        end
+        message_attribute(message, :content)
+      end
+
+      def message_attribute(message, name)
+        return message.public_send(name) if message.respond_to?(name)
+        return message[name] if message.respond_to?(:key?) && message.key?(name)
+
+        message[name.to_s]
       end
 
       def fallback_eligible?(error)

data/lib/smith/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Smith
-  VERSION = "0.4.3"
+  VERSION = "0.4.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smith-agents
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
 platform: ruby
 authors:
 - Samuel Ralak