Package com.tnsai.idempotency
package com.tnsai.idempotency
-
ClassDescriptionStored record of a previous tool / action call's outcome, keyed by its idempotency key in an
IdempotencyStore(issue #91).Lightweight snapshot of a stored failure.Thrown when an idempotency-protected call produces an outcome the framework cannot resolve safely (issue #91): a hard cache hit underRetryBehavior.FAIL_FAST, a hash collision against a different input, or the configuredIdempotencyStorebeing unreachable mid-call.Why the idempotency-protected call could not be resolved.Derives stable idempotency keys from tool / action input maps perKeyStrategy(issue #91).Opt-in interface a tool POJO implements to supply its own idempotency key underKeyStrategy.EXPLICIT(issue #91).Orchestrates a single tool / action call underIdempotentprotection (issue #91): derives the key, consults theIdempotencyStore, decides between returning the cached outcome and re-running the call body, then writes the new outcome back to the store on a cache miss.SPI for persistingIdempotencyEntrys keyed by their idempotency key (issue #91).Marks aTool(or action method) as side-effecting and therefore requiring idempotency protection on retry (issue #91).DefaultIdempotencyStore— process-local, ephemeral, no external dependencies (issue #91).Strategy for deriving the idempotency key of a tool / action call (issue #91).DurableIdempotencyStorebacked by a JDBC database (issue #91).DistributedIdempotencyStorebacked by Redis (issue #91).What the framework does when a retry hits a previously-stored idempotency entry (issue #91).