Packages

codex_sdk

0.4.1
0.17.0 0.16.1 0.16.0 0.14.0 0.13.0 0.12.0 0.11.0 0.10.1 0.10.0 0.9.0 0.8.0 0.7.2 0.7.1 0.7.0 0.6.0 0.5.0 0.4.5 0.4.4 0.4.3 0.4.2 0.4.1 0.4.0 0.3.0 0.2.5 0.2.4 0.2.3 0.2.2 0.2.1 0.2.0 0.1.0

Idiomatic Elixir SDK for OpenAI's Codex agent. Provides a complete, production-ready interface with streaming support, comprehensive event handling, and robust testing utilities.

HexDocs

Current section

Files

Jump to
Readme
30 Versions
6 Dependencies
Dependants
Files
Activity
codex_sdk lib codex session.ex
Raw

lib/codex/session.ex 

defmodule Codex.Session do

  @moduledoc """

  Behaviour for persisting conversation state across runs.

  """



  @callback load(state :: term()) :: {:ok, term()} | {:error, term()}

  @callback save(state :: term(), entry :: term()) :: :ok | {:error, term()}

  @callback clear(state :: term()) :: :ok | {:error, term()}



  @type t :: {module(), term()}



  @doc """

  Loads session history.

  """

  @spec load(t()) :: {:ok, term()} | {:error, term()}

  def load({mod, state}) when is_atom(mod), do: mod.load(state)



  @doc """

  Persists a session entry.

  """

  @spec save(t(), term()) :: :ok | {:error, term()}

  def save({mod, state}, entry) when is_atom(mod), do: mod.save(state, entry)



  @doc """

  Clears stored history.

  """

  @spec clear(t()) :: :ok | {:error, term()}

  def clear({mod, state}) when is_atom(mod), do: mod.clear(state)



  @doc """

  Validates a session reference.

  """

  @spec valid?(term()) :: boolean()

  def valid?({mod, _state}) when is_atom(mod), do: true

  def valid?(_), do: false

end