There's a lot of open issues
One form-neutral tool definition built from an action, with thin wrappers for the MCP Ruby SDK and RubyLLM. Context fields (identity, station) are filled by the server, never by the model.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

>= 2.0.0.pre1, < 3
>= 1.0.0.pre1, < 2
~> 3.16
 Project Readme

gems

Ruby gems for typed data and the actions that move it around, plus the adapters that carry both into other formats. One repo, one docs site, each gem published on its own.

An action, ReservePlaces, called three times: the string '4' arrives as the integer 4 and both steps run to a success; nine places stops at check_room with :fully_booked; a missing hut code fails with :invalid_input before any step runs.
Gem Path What it does
field_struct gems/field_struct Plain Ruby objects with declared fields that coerce, check presence and validate
actionable-rb gems/actionable Action objects with declared input, steps and outcomes
field_struct-json_schema adapters/field_struct-json_schema JSON Schema from a struct class
field_struct-avro adapters/field_struct-avro Avro schemas, encode and decode, schema evolution
field_struct-avro-native adapters/field_struct-avro-native An optional Rust encoder for field_struct-avro, same bytes, faster
field_struct-protobuf adapters/field_struct-protobuf Protobuf descriptors, .proto output and messages (API may change)
actionable-otel adapters/actionable-otel OpenTelemetry spans for action runs and steps
actionable-tools adapters/actionable-tools Actions as LLM and MCP tools
actionable-docs adapters/actionable-docs Process pages for actions: Markdown and a Mermaid chart (API may change)

The docs site lives in site/.

Working here

Each gem is self-contained. From its directory:

bundle install
bundle exec rake                 # specs + rubocop
bundle exec rake release:check   # adds doctests, signatures and YARD

From the repo root, bin/oracle runs every gem's default task, then runs its suite again with ActiveSupport loaded first, and fails if any run fails. Nothing is done until it passes. bin/oracle --rails also runs integration/rails, a one-file Rails app that uses the gems the way an app does: params, render json:, transactions, jobs and eager loading.

Gems that depend on each other point at the local copy through path: in their Gemfile, so a change in field_struct is tested against every adapter before it ships.

History

FieldStruct and Actionable started as ideas I carried for years. Their first implementations grew up with the support of Acima and later Paymentbox, and both companies released them as open source under the MIT license. I'm grateful to both, and to the colleagues there who used the early versions and pushed back on them, for the room to try these ideas in real systems.

This repository is a complete rewrite. Design specs were written by studying how the earlier versions behaved, and the new code was written from those specs alone, without access to the earlier code. The public API keeps the same names on purpose, so the ideas stay familiar, and everything under it is new. The earlier versions are not maintained here, and neither company is involved in or endorses this project.

License

MIT, Copyright (c) 2026 Adrian Madrid. Each gem carries its own LICENSE.txt.