Jido.AI.Reasoning.ReAct.Token (Jido AI v2.2.0)

Signed checkpoint tokens for caller-owned ReAct continuation.

Summary

Types

payload()

Functions

decode(token, config)

Decodes and validates a checkpoint token payload.

decode_state(token, config)

Decodes a token and restores runtime state from its payload.

issue(state, config)

Issues a signed checkpoint token for the provided ReAct state.

mark_cancelled(token, config, reason)

Marks a checkpointed run as cancelled and returns a new signed token.

Types

payload()

@type payload() :: %{
  v: pos_integer(),
  iss: String.t(),
  run_id: String.t(),
  request_id: String.t(),
  iat_ms: integer(),
  exp_ms: integer() | nil,
  config_fingerprint: String.t(),
  state: map()
}

Functions

decode(token, config)

@spec decode(String.t(), Jido.AI.Reasoning.ReAct.Config.t()) ::
  {:ok, payload()} | {:error, term()}

Decodes and validates a checkpoint token payload.

decode_state(token, config)

@spec decode_state(String.t(), Jido.AI.Reasoning.ReAct.Config.t()) ::
  {:ok, Jido.AI.Reasoning.ReAct.State.t(), payload()} | {:error, term()}

Decodes a token and restores runtime state from its payload.

issue(state, config)

@spec issue(Jido.AI.Reasoning.ReAct.State.t(), Jido.AI.Reasoning.ReAct.Config.t()) ::
  String.t()

Issues a signed checkpoint token for the provided ReAct state.

mark_cancelled(token, config, reason)

@spec mark_cancelled(String.t(), Jido.AI.Reasoning.ReAct.Config.t(), atom()) ::
  {:ok, String.t()} | {:error, term()}

Marks a checkpointed run as cancelled and returns a new signed token.