Packages

normandy

1.2.0
1.3.0 1.2.0 1.1.1 1.1.0 1.0.0 0.6.2 0.6.1 0.6.0 0.5.1 0.5.0 0.4.0 0.3.0 0.2.0 0.1.0

Elixir framework for building production-ready AI agents and LLM applications: type-safe schemas with JSON Schema generation, tool calling, streaming, multi-agent coordination, guardrails, and distributed fault-tolerant sessions, with first-class Anthropic Claude support.

HexDocs

Current section

Files

Jump to
Readme
14 Versions
10 Dependencies
Dependants
Files
Activity
normandy lib normandy behaviours budget_tracker.ex
Raw

lib/normandy/behaviours/budget_tracker.ex 

defmodule Normandy.Behaviours.BudgetTracker do

  @moduledoc """

  Contract for budget gating and accounting around tool calls.



  `check/2` is an optional pre-spend gate (returns `:ok` to proceed or

  `{:error, reason}` to deny before executing); `record/2` accounts for actual

  usage after the call. `scope` identifies the budget owner (e.g.

  `%{agent: name, model: model}`); `est`/`usage` are the planned/actual cost

  carriers. The default impl `NoOp` preserves current (untracked) behavior.

  """



  @type scope :: term()



  @callback check(scope(), est :: term()) :: :ok | {:error, term()}

  @callback record(scope(), usage :: term()) :: :ok



  defmodule NoOp do

    @moduledoc "Default BudgetTracker: no gating, no accounting (back-compat)."

    @behaviour Normandy.Behaviours.BudgetTracker



    @impl true

    def check(_scope, _est), do: :ok



    @impl true

    def record(_scope, _usage), do: :ok

  end

end