Synaptic.ToolResultStore (synaptic v0.3.0-alpha.12)

Ephemeral storage for oversized or compacted tool results.

Handles returned by the context hygiene layer can be resolved through this module for follow-up retrieval outside the model prompt.

Summary

entry()

delete(handle)

prune_expired()

@type entry() :: %{
  handle: String.t(),
  result: term(),
  metadata: map(),
  inserted_at: non_neg_integer(),
  expires_at: non_neg_integer()
}

@spec delete(String.t()) :: :ok

@spec delete_by_run(String.t()) :: non_neg_integer()

@spec fetch(
  String.t(),
  keyword()
) :: {:ok, entry()} | {:error, :not_found | :expired | :forbidden}

@spec prune_expired() :: non_neg_integer()

@spec put(term(), map(), pos_integer() | nil) :: String.t()