smith-agents 0.12.0 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b4a4a63bdb7f2a0c01885a1bf0b3f032cbed5d89ae0e75346cff1d542fc33dc
-  data.tar.gz: 7be2cbbba9a48596c1f5b764c5de4c518b75791182d59b31419ca77a57d544b0
+  metadata.gz: d7b7df9618321378d2d66ef460c4dd085913c08d5fac47367f33b199a1fe62d3
+  data.tar.gz: f0b0eb52fd277e0666f81a90f9347e2bfb9deddfa41e530bb230b6c90f00474a
 SHA512:
-  metadata.gz: 6db712429b885861ac677641f18d1525fc398cf042464e2abd933c40c2ebe979059a04b584fb1a771aab015b0d06eaf6940d4efa5f743bb03d38c19f7fda874d
-  data.tar.gz: 2ee6716229c0f56dc9a0ebebe0222bfd79471109575e9d9c7cf477f97b24d746a7a556756a5fb58b853265d64ef0e9c99bae70fe1c283b618940a6a80841f7e4
+  metadata.gz: 2cc72ed4a2cc6fa43d598ff5f31e4f0bc264436c72c53a8ddadf4786663d473296072016446694371b4a40aacf5602189a7b2da003f886208ef94f77d5503e0c
+  data.tar.gz: 2ce2632738c8e6c59e6f01cb16972610cf4a2fe144b4435e0e70ea00d6e29f9557330cb40c098c3058f3abcfeada3e90888c1f5eeb183c895b8297738f5227a3

data/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to Smith are documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Smith is pre-1.0 and under active development; expect occasional contract tightening between minor versions until 1.0.
 
+## [0.12.1] - 2026-10-11
+
+### Changed
+
+- `rails g smith:install` sets `persistence_max_bytes` to 16 MiB (it was
+  1 MiB), with the payload CHECK a third above it (22,373,717 bytes). One
+  step can add more than 1 MiB to a run's state (a `map` step's collected
+  results are bounded at 4 MiB), so the old default could refuse a run Smith
+  built itself. An app generated with 0.12.0 keeps its bound: raise
+  `config.persistence_max_bytes`, and replace the CHECK in a migration
+  (`remove_check_constraint` then `add_check_constraint` with the new
+  bound; on MySQL, also `change_column :workflow_states, :payload, :text,
+  limit: 22_373_717`).
+
 ## [0.12.0] - 2026-10-11
 
 ### Upgrade notes

data/README.md

@@ -17,7 +17,7 @@ environment before calling the slice complete.
 
 ```ruby
 # Gemfile
-gem "smith-agents", "0.12.0", require: "smith"
+gem "smith-agents", "0.12.1", require: "smith"
 ```
 
 ```bash
@@ -31,7 +31,8 @@ for workflow state (`WorkflowState`, Smith's `:active_record` persistence
 adapter): a unique string key (child runs are stored under 64-character
 keys of their own, so the key is not a host row's id), the state as JSON
 text, the `lock_version` Smith's versioned writes compare, and a CHECK on
-the payload's size. The initializer sets `persistence_max_bytes` (1 MiB): a
+the payload's size. The initializer sets `persistence_max_bytes` (16 MiB,
+well above what one step can add, so it stops runaway growth only): a
 step whose result would take a stored run past it fails with
 `Smith::PersistedStateTooLarge` before the result is kept, as with any
 error (its usage recorded, its `on_failure` taken), so the run stays
@@ -460,7 +461,7 @@ Smith.configure do |config|
   config.persistence_adapter = :rails_cache
   config.persistence_options = { namespace: "smith" }
   config.persistence_ttl = 1.day.to_i
-  config.persistence_max_bytes = 1_048_576 # a stored state's bound (nil: none); see Installation
+  config.persistence_max_bytes = 16_777_216 # a stored state's bound (nil: none); see Installation
   config.persistence_retry_policy = { attempts: 3, base_delay: 0.1, max_delay: 1.0 }
 
   # Generic runtime resource bounds

data/docs/CONFIGURATION.md

@@ -176,7 +176,7 @@ from JSON or YAML has.
 | `persistence_adapter` | Adapter for durable workflow state | `:redis`, `:rails_cache`, `:active_record`, `:memory`, or a custom object |
 | `persistence_options` | Per-adapter options (client, namespace, model, columns) | See "Built-In Persistence Adapters" |
 | `persistence_ttl` | Global TTL for persisted state (Integer/Float seconds; nil = no expiry). `:active_record` cannot expire state, so its writes refuse a non-nil TTL (reads and deletes still work, and `smith doctor --durability` flags the combination) | Set when long-tail abandoned workflows accumulate in storage |
-| `persistence_max_bytes` | The most bytes a stored workflow state may take (nil, the default: no bound). A stored run's step whose result would take it past the bound fails with `Smith::PersistedStateTooLarge` (its `key`, `bytes` and `limit`) before the result is kept, as with any error: its usage is recorded and its `on_failure` taken, so the run stays storable, strict mode included. A tool loop refused for budget does not pause into a state past it (it goes on unheld). Any other state past it is refused before anything is written. The answer that did not fit is not kept. `rails g smith:install` sets it to 1 MiB, with a CHECK a third above it on the payload column | Set it above the largest output a step keeps, with a database CHECK on the payload, so an oversized state fails as a typed step error instead of a database one |
+| `persistence_max_bytes` | The most bytes a stored workflow state may take (nil, the default: no bound). A stored run's step whose result would take it past the bound fails with `Smith::PersistedStateTooLarge` (its `key`, `bytes` and `limit`) before the result is kept, as with any error: its usage is recorded and its `on_failure` taken, so the run stays storable, strict mode included. A tool loop refused for budget does not pause into a state past it (it goes on unheld). Any other state past it is refused before anything is written. The answer that did not fit is not kept. `rails g smith:install` sets it to 16 MiB (well above what one step can add: a map's collected results are at most 4 MiB, a wait's payload and a paused tool loop 1 MiB each), with a CHECK a third above it on the payload column | Set it above the largest output a step keeps, with a database CHECK on the payload, so an oversized state fails as a typed step error instead of a database one |
 | `persistence_retry_policy` | Exponential-backoff policy for transient adapter I/O failures | Defaults to `{ attempts: 3, base_delay: 0.1, max_delay: 1.0 }` |
 | `retry_attempt_limit` | Maximum attempts accepted by workflow and persistence retry policies | Defaults to `100` |
 | `parallel_branch_limit` | Maximum branches accepted by one homogeneous or heterogeneous fan-out | Defaults to `1_000` |

data/lib/generators/smith/install/install_generator.rb

@@ -13,13 +13,17 @@ module Smith
     # The most a PostgreSQL text column holds (1 GiB less a byte), the
     # payload's limit when no bound is set.
     UNBOUNDED_PAYLOAD = 1_073_741_823
+    # The default bound: well above what one step can add to a state (a
+    # map's collected results, 4 MiB; a wait's payload or a paused tool
+    # loop, 1 MiB each), so it refuses runaway growth, not a run Smith built.
+    MAX_STATE_BYTES = 16 * 1024 * 1024
 
     source_root File.expand_path("templates", __dir__)
     desc "Writes Smith's initializer, and a table and model for workflow state"
 
     class_option :state_model, type: :string, default: "WorkflowState",
                                desc: "The model that keeps workflow state"
-    class_option :max_state_bytes, type: :numeric, default: 1_048_576,
+    class_option :max_state_bytes, type: :numeric, default: MAX_STATE_BYTES,
                                    desc: "persistence_max_bytes, and the payload CHECK above it (0: neither)"
     class_option :skip_state_model, type: :boolean, default: false,
                                     desc: "Write only the initializer"
@@ -77,7 +81,7 @@ module Smith
     # ignores it, as SQLite does.
     def payload_limit = [check_bytes || UNBOUNDED_PAYLOAD, UNBOUNDED_PAYLOAD].min
 
-    # An Integer as a Ruby literal: 1_048_576.
+    # An Integer as a Ruby literal: 16_777_216.
     def literal(number) = number.to_s.gsub(/\B(?=(\d{3})+(?!\d))/, "_")
   end
 end

data/lib/smith/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Smith
-  VERSION = "0.12.0"
+  VERSION = "0.12.1"
   EXECUTION_SEMANTICS_VERSION = "7"
 end

metadata

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