@spec decode([integer()], tokenizer_id() | String.t(), keyword()) ::
  {:ok, String.t()} | {:error, Tinkex.Error.t()}

Decode token IDs back to text using a cached tokenizer.

Mirrors encode/3 with the same caching and error contract.

@spec encode(String.t(), tokenizer_id() | String.t(), keyword()) ::
  {:ok, [integer()]} | {:error, Tinkex.Error.t()}

Encode text into token IDs using a cached tokenizer.

Loads (or reuses) the tokenizer keyed by the resolved tokenizer ID and returns {:ok, [integer()]}. Does not apply chat templates; pass the already formatted string you want to tokenize.

Examples

iex> {:ok, ids} = Tinkex.Tokenizer.encode("Hello", "gpt2")
iex> Enum.all?(ids, &is_integer/1)
true

@spec encode_text(String.t(), tokenizer_id() | String.t(), keyword()) ::
  {:ok, [integer()]} | {:error, Tinkex.Error.t()}

Convenience alias for encode/3.

Accepts the same options and returns the same tuple contract. Useful for user-facing API symmetry with Tinkex.Types.ModelInput.from_text/2.

@spec get_or_load_tokenizer(
  tokenizer_id(),
  keyword()
) :: {:ok, Tokenizers.Tokenizer.t()} | {:error, Tinkex.Error.t()}

Get a tokenizer handle from cache or load and cache it using the resolved ID.

The ETS table :tinkex_tokenizers is created on demand if the application has not already started it.

@spec get_tokenizer_id(String.t(), Tinkex.TrainingClient.t() | nil, keyword()) ::
  tokenizer_id()

Resolve the tokenizer ID for the given model.

• If a training_client is provided, attempts to fetch model_data.tokenizer_id via the provided :info_fun (defaults to &TrainingClient.get_info/1).
• Applies the Llama-3 gating workaround ("thinkingmachineslabinc/meta-llama-3-tokenizer").
• Falls back to the provided model_name.