solid_agent 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b204dd708358a41a24ed81cb3e27a76c83b97bd6b69fb098eeaf9a3c54d4ddd
-  data.tar.gz: 3ee800cb2936615ee7ac57072da8a26c6152bf73e92088c8853a8cbcdd3b4a6b
+  metadata.gz: 73594fa8639580da1945c6445fad2fef3eaf0500e0f48fd8842115c9f4e2ec33
+  data.tar.gz: 250018ddb7579ff3aabad5da2f8f7b43cf53d963a5d25ad0a241721d3591a304
 SHA512:
-  metadata.gz: 4a9d1c5133162f5ebd32fe1cf90ac999cd9b0f0f9c64396eb4e59ef9b60ca3d871e79c5d6e83fe50a830bfbbea6677837ff5ad0e0ca8e32277b885c577d63e9c
-  data.tar.gz: 6e3d799d6cb5321f10455d2a954cb24d2c41a0768c88489a86eb24f6bfe84f5b4ae25fffc614e60f0edfd05c517dc6dfef66c79c078e125d9ed275fa581e27a9
+  metadata.gz: fb3671bd7db8f8616ef267cdbab425a3280cf8961346ab2e1643557245bea283e0dacf97c3a656ce647f9718714541fbcd547043c7c488a0f478d73ea634d33c
+  data.tar.gz: 1e65df9005fdecceb369a2b30427c2003bb8f658bc2211e9ff2144a5b6fd72a40f7541df83e74f8a2eefab92498b5823bd4f9061209ec3ad0c617fd2fdc06604

data/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## [0.2.1] - 2026-10-07
+
+A patch release for activeagent 1.9, whose generations can pause to ask the
+user and resume with the answer.
+
+### Added
+
+- **`HasContext#resuming_generation?`** answers whether a generation resumes
+  one that paused for user input: true when the agent defines a public
+  `resuming?` that returns true, or after `self.resuming_generation = true`.
+  The writer is for a host that replays a stored conversation itself. Both
+  are private, so neither becomes one of the agent's actions.
+
+### Fixed
+
+- **`HasContext` skips persisting the response of a generation paused for
+  user input, and the prompt of the generation that resumes it.** A response
+  answering `awaiting_input?` with true is returned untouched: no generation
+  record, no assistant row and no tool rows, because its last message is an
+  unfinished turn. The paused generation's prompt, the user turn, is still
+  persisted. The resumed generation skips prompt persistence, because its
+  prompt replays that turn, and persists its response as usual. Both checks
+  are duck-typed, so framework releases without a pause behave as before.
+
+- Tool messages are now deduped by `tool_call_id` within one response's
+  stack as well as against rows already on the context, so a stack that
+  repeats a call persists it once even when the context's `messages` scope
+  cannot see rows written earlier in the same pass.
+
+## [0.2.0] - 2026-08-18
+
 ### Added
 
 - **`SolidAgent::Records::*` — behavior for the agent-configuration records.**

data/README.md

@@ -94,6 +94,28 @@ the user turn and the response as the assistant turn, both after the
 provider call — so reach for `add_conversation_user_message` only with
 `auto_save: false`, or the turn is stored twice.
 
+A generation that pauses for user input (its response answers
+`awaiting_input?` with true) persists only its prompt, the user turn. The
+paused response writes no generation record, assistant row or tool rows. The
+generation that resumes it persists the tool results and the final answer,
+and skips its own prompt, which replays the user turn already stored. Tool
+results are deduped by `tool_call_id`, so each is stored once.
+
+The resumed generation writes to whichever context it holds, so it must load
+the paused generation's context. Give `has_context` a `contextual:` param
+that names the same record on both runs, or load the context by id in the
+action (`load_conversation(context_id: ...)`).
+Without either, each agent instance creates its own anonymous context, and
+the user turn and the answer land in two different contexts.
+
+The agent counts as resuming when the framework's `resuming?` returns true.
+A host that replays a stored conversation itself sets the flag from inside
+the agent:
+
+```ruby
+before_generation { self.resuming_generation = params[:checkpoint].present? }
+```
+
 > **Naming a context also names its models.** `has_context :conversation`
 > infers `Conversation`, `ConversationMessage` and `ConversationGeneration`,
 > not the `AgentContext` family the installer wrote — hence `class_name:`

data/lib/solid_agent/has_context.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "digest"
+require "set"
 
 # HasContext provides database-backed prompt context management for agents.
 #
@@ -542,9 +543,34 @@ module SolidAgent
       self.class.public_send(reader)&.except(:access_token, :api_key)
     end
 
-    # After prompt callback - persists the rendered prompt message to context
+    # Marks this generation as resuming one that paused for user input, for a
+    # host that replays a stored conversation itself. Private, like
+    # #resuming_generation?, because every public method on an agent is one
+    # of its actions.
+    #
+    # @example
+    #   before_generation { self.resuming_generation = params[:checkpoint].present? }
+    attr_writer :resuming_generation
+
+    # Returns whether this generation resumes one that paused for user input:
+    # true when `self.resuming_generation = true` was set, or when the agent
+    # defines a public `resuming?` (the framework's resume flag) that returns
+    # true. A resuming generation does not persist its prompt.
+    #
+    # @return [Boolean]
+    def resuming_generation?
+      return true if @resuming_generation
+      return false unless respond_to?(:resuming?)
+
+      resuming? ? true : false
+    end
+
+    # After prompt callback - persists the rendered prompt message to context.
+    # Skipped for a resumed generation, because the generation that paused
+    # already persisted the user turn and the resumed prompt replays it.
     def persist_prompt_to_context
       return unless context
+      return if resuming_generation?
 
       if prompt_options[:messages].present?
         rendered_message = prompt_options[:messages].last
@@ -560,10 +586,18 @@ module SolidAgent
       generation_response
     end
 
-    # Persists the generation response to context
+    # Persists the generation response to context. A response paused for user
+    # input is skipped, because its last message is an unfinished turn. The
+    # response of the generation that resumes it repeats the restored tool
+    # results, so they are persisted with the final answer.
     def persist_generation_to_context
       return unless context && generation_response
 
+      if generation_paused?
+        Rails.logger.info "[SolidAgent] Skipping persistence - generation is awaiting user input"
+        return
+      end
+
       persist_tool_messages_to_context
 
       begin
@@ -584,6 +618,12 @@ module SolidAgent
       end
     end
 
+    def generation_paused?
+      return false unless generation_response.respond_to?(:awaiting_input?)
+
+      generation_response.awaiting_input? ? true : false
+    end
+
     # Overridable enrichment hook for tool persistence. Executors that run
     # tools server-side (a platform's execution service, a job) can
     # override this to return their own invocation records — an array of
@@ -602,19 +642,25 @@ module SolidAgent
     #
     # Requires the context model to expose add_tool_message (the install
     # generator's AgentContext does); contexts without it are skipped.
-    # Messages are deduped by tool_call_id so re-persisting a shared
-    # message stack (multi-turn conversations) doesn't duplicate rows.
+    # Messages are deduped by tool_call_id. A response's stack repeats
+    # earlier turns (a multi-turn conversation's history, a resumed
+    # generation's restored conversation), so a call already on the context
+    # or earlier in the same stack is skipped.
     def persist_tool_messages_to_context
       return unless context.respond_to?(:add_tool_message)
       return unless generation_response.respond_to?(:messages)
 
       tool_index = -1
+      seen_tool_call_ids = Set.new
       Array(generation_response.messages).each do |message|
         next unless message.respond_to?(:role) && message.role.to_s == "tool"
 
         tool_index += 1
         tool_call_id = message.respond_to?(:tool_call_id) ? message.tool_call_id : nil
-        next if tool_call_id.present? && tool_message_persisted?(tool_call_id)
+        if tool_call_id.present?
+          next unless seen_tool_call_ids.add?(tool_call_id.to_s)
+          next if tool_message_persisted?(tool_call_id)
+        end
 
         invocation = tool_invocation_for(tool_call_id, tool_index)
         # Provider tool messages often carry no name (Ollama's don't); the

data/lib/solid_agent/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolidAgent
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/solid_agent.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/solid_agent/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "solid_agent"
+  spec.version = SolidAgent::VERSION
+  spec.authors = ["Justin Bowen"]
+  spec.email = ["JusBowen@gmail.com"]
+
+  spec.summary = "Database-backed context, tools, and streaming for ActiveAgent"
+  spec.description = "SolidAgent extends ActiveAgent with database-backed prompt context management, declarative tool schemas, and real-time streaming updates. Provides has_context, has_tools, and streams_tool_updates concerns for building robust AI agents."
+  spec.homepage = "https://docs.activeagents.ai/solid_agent"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/activeagents/solid_agent"
+  spec.metadata["changelog_uri"] = "https://github.com/activeagents/solid_agent/blob/main/CHANGELOG.md"
+  spec.metadata["documentation_uri"] = "https://docs.activeagents.ai/solid_agent"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git assets/ appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activeagent", ">= 1.0.0"
+  spec.add_dependency "activesupport", ">= 7.0"
+  spec.add_dependency "activerecord", ">= 7.0"
+  # AgentManifest is an ActiveModel, and lib/solid_agent.rb now requires it by
+  # name so the gem loads outside Rails. It arrived transitively through
+  # activerecord before; a require deserves a declaration.
+  spec.add_dependency "activemodel", ">= 7.0"
+end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_agent
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Justin Bowen
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activeagent
@@ -175,6 +176,7 @@ files:
 - lib/solid_agent/tool_cache.rb
 - lib/solid_agent/version.rb
 - sig/solid_agent.rbs
+- solid_agent.gemspec
 homepage: https://docs.activeagents.ai/solid_agent
 licenses:
 - MIT
@@ -183,6 +185,7 @@ metadata:
   source_code_uri: https://github.com/activeagents/solid_agent
   changelog_uri: https://github.com/activeagents/solid_agent/blob/main/CHANGELOG.md
   documentation_uri: https://docs.activeagents.ai/solid_agent
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -197,7 +200,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Database-backed context, tools, and streaming for ActiveAgent
 test_files: []