Repository navigation
Releases
Turnframe 0.2.1
Turnframe 0.2.1 runs on OpenAI's GPT-6 models, and its figures are now measured on gpt-6-luna.
Published at 0.2.1: turnframe-provider-openai, turnframe-tasks, turnframe-understand, turnframe-test and the turnframe facade, which asks for the four at 0.2.1. Every other crate stays at 0.2.0. No breaking change.
Fixed
- GPT-6 models run. The OpenAI adapter knew reasoning models only by the
gpt-5,o1,o3ando4names, so agpt-6model was sentmax_tokensand a temperature, and OpenAI refused every call. Everygptfromgpt-5on is now sentmax_completion_tokensand its reasoning effort, and the least effort is one each model takes:noneongpt-6-lunaandgpt-6-sol,lowongpt-6-astraandgpt-6.1-sol. The adapter's live test passes on all four. - The reply is written at the least effort. It sent none, and a model whose default effort reasons could spend the whole reply thinking and return nothing.
- Refusing to give a value («you won't get A from me») is recorded as a refusal, and saying what one would rather a record hold («I'd rather A») is a request, not small talk.
- The check takes «the end of the month» or «next Friday» as stating the day they place, and still finds a day they do not place different.
- In the trip sample, a payer given for an extra the trip already holds assigns the payer, without asking for a new extra's price.
- Builds without warnings on Rust 1.99, which deprecates
AtomicU32::fetch_update.
Measured against OpenAI's gpt-6-luna at medium: the live corpus passed 227 of 228 samples for $0.37, merged from a whole run and re-runs of the items this release's rules act on, and ten simulated conversations reached their goal ten times with no dead end and no offer refused. The gpt-5.4-mini runs of 0.2.0 stay in the benchmarks.
What changed, crate by crate, is in the changelog. Minimum supported Rust version: 1.88. Licensed under MIT or Apache-2.0.
cargo add turnframeTurnframe 0.2.0
Turnframe 0.2.0 makes progress a guarantee of code: every reply ends on a way forward, the assistant's offers are data the next message is read against first, and an offer is made only when the domain would take it now.
Published at 0.2.0: every crate, on the workspace version again. turnframe-core's public API changed and every crate depends on it, so all of them move together. The design is ADR-021, a conversation always moves forward.
Breaking
WorkflowDefinition::next_stepsreturns typed offers and sees the state:fn next_steps(&self, state: Option<&Self::State>, view: &ViewOf<Self>) -> Vec<NextStep>. To migrate, wrap each sentence asNextStep::new(<the operation it offers>, sentence), adding.with_arguments(json)for values already known.AssistantTurn::offersrecords the next steps a reply offered. A literal that builds anAssistantTurnaddsoffers: Vec::new(). Stored turns read as before.ModelPurpose::TakeUpis a new purpose (ModelPurpose::ALLhas sixteen),UnderstandingInput::offerscarries the last reply's offers, andExtractInput::correctedcarries the dates a correction changes. Literals add the new fields empty.
New
- «yes, rebook it» after an offer runs that offer on its record, with nothing routed again. «no, that's all» declines the offers and is not reported as not understood.
- A next step is offered only when the domain accepts it now: the act is compiled and every command validated against the state before the reply offers it.
- A question asked again says it is still needed and offers the record's next steps beside it. A question no fact answers is told what the record holds and what it still needs.
- A request only a record can do, when none exists yet, is told so and offered to open one:
WorkflowDefinition::record_operationslists what a record could do. - One message that opens a record and acts on it runs both: an act on a record the message opens is checked against the state the opening leaves, when the workflow says what its commands leave (
WorkflowDefinition::state_after, defaulted). - A request about records that can do nothing now («confirm the rebooking» after it left) is answered with where they stand, not reported as not understood.
- A card left open is the next reply's way forward.
turnframe_eval::simulateholds conversations with simulated users: a goal in TOML, a model playing the person, and code scoring each conversation on reached, dead ends, loops and offers refused.
Fixed
- A correction keeps what it does not restate: a date corrected without its year takes the year of the date it changes, and a year the words do not say is never taken from today.
- One request cut in two by the message's parts is one act, and one record asked for twice in a message is created once.
- «open Trip 1» asks where Trip 1 stands, and the reply ends on what the trip still needs, instead of starting a second trip; an answer that is also a record's label is still the answer.
- An answer read as another operation than the one asked is checked as a request; one read only as acts nobody asked for is read again as the act asked, when its own words give the value.
- The check of a copied value is told the words of its part the value leaves out: «the name is X» read as X is no longer found to hold too much, and «can I O?» asks for O.
- An optional value the user did not give is left out, never asked back, and a part found not asked for no longer holds the other acts on its record.
- An answer to a question about a record still to create creates it, and a record named while the message creates the one of its kind is that record.
- A full stop ending the sentence is not part of the value («Lisbon offsite.», «Trip to Rio.»), nor is the sentence's comma or stop written inside closing quotes, while an initialism keeps its own («S.r.l.»).
Measured against OpenAI's gpt-5.4-mini at medium: ten simulated conversations reached their goal ten times with no dead end and no offer refused, and a whole run of the live corpus passed 227 of 228 samples.
What changed, crate by crate, with every migration note, is in the changelog. Minimum supported Rust version: 1.88. Licensed under MIT or Apache-2.0.
cargo add turnframeTurnframe 0.1.2
Turnframe 0.1.2 makes sure a conversation never stops on the assistant's side: every reply the runtime writes ends on a way forward.
Published at 0.1.2: turnframe, turnframe-understand, turnframe-runtime and turnframe-test. The other crates stay at 0.1.0. The facade asks for the three at 0.1.2, so moving to turnframe 0.1.2 brings every fix. No public API changed incompatibly.
Fixed
- Every reply ends on the ask, the card on screen, the next steps, or a question to go on. Before, a reply the review refused was replaced by the receipts alone, and could leave the user with nothing to say.
- Where no knowledge source is configured, a question is answered from what the records hold and what can be done, never with «the sources were not available».
- A correction takes its value from what the user just wrote, even when the reading pointed at the earlier message it corrects.
- Small talk stays small talk when a second reading finds nothing to do in it, where it used to be reported as not understood.
- The trip sample no longer offers to rebook a flight nobody quoted.
- The console shows a card that asks without blocking, such as which record was meant, with its numbered options.
What changed, crate by crate, is in the changelog. Minimum supported Rust version: 1.88. Licensed under MIT or Apache-2.0.
cargo add turnframeTurnframe 0.1.0
The first release of Turnframe: deterministic conversational workflows for Rust, built around the Flow Map. Models propose meaning, deterministic reducers decide effects, committed events decide claims.
What it holds is in the changelog, and what the live corpus measured is in benchmarks.
Minimum supported Rust version: 1.88. Licensed under MIT or Apache-2.0.
cargo add turnframeTurnframe 0.1.1
Turnframe 0.1.1 fixes how a conversation finds the record it is talking about, and adds a demonstration of the guarantees.
Published at 0.1.1: turnframe, turnframe-understand, turnframe-runtime and turnframe-test. The other crates stay at 0.1.0. The facade asks for the three at 0.1.1, so moving to turnframe 0.1.1 brings every fix. No public API changed incompatibly.
Fixed
- An answer to the assistant's question reaches the record the question asked about, when the last reply changed a different one. Before, it went to the record just changed, and the same question came back.
- A question about a record the turn did not touch names that record.
- Asked which record an act is for, a user who names one that does not exist yet and then says «create it» gets that record created, and nothing else opened.
- An act that would ask for a value is verified first, and dropped when nobody asked for it, so a message is never answered with a question about a value already settled.
- An act waiting for a named record is let go once that record exists.
- A repaired segmentation vote no longer shows its repair instruction as the gist of the message.
Added
examples/refund-deskand the «Break it» section of turnframe.rs: nine attacks on a refund, each recorded from the runtime. None of them sends a refund it should not.
What changed, crate by crate, is in the changelog. Minimum supported Rust version: 1.88. Licensed under MIT or Apache-2.0.
cargo add turnframe