Autonoma Elixir SDK

Elixir implementation of the Autonoma Environment Factory SDK.

Packages

Quick Start

Install

Add to your mix.exs deps:

defp deps do
  [
    {:autonoma, "~> 0.2"}
  ]
end

Plug + Factories

# In your router
factories = %{
  "Organization" => Autonoma.Factory.define_factory(%{
    create: fn data, ctx ->
      org = MyApp.Repo.insert!(%MyApp.Organization{name: data["name"]})
      %{"id" => org.id, "name" => org.name}
    end,
    input_fields: [%{name: "name", type: "string", required: true}],
    teardown: fn record, ctx ->
      MyApp.Repo.delete!(%MyApp.Organization{id: record["id"]})
    end
  })
}

config = %{
  scope_field: "organization_id",
  shared_secret: System.get_env("AUTONOMA_SHARED_SECRET"),
  signing_secret: System.get_env("AUTONOMA_SIGNING_SECRET"),
  factories: factories,
  auth: fn user, _context ->
    token = MyApp.Auth.create_session_token(user["id"])
    %{"headers" => %{"Authorization" => "Bearer #{token}"}}
  end
}

forward "/api/autonoma", Autonoma.Plug.Handler, config

Commands

mix deps.get   # install dependencies
mix test        # run tests

Documentation

Full agent-facing docs ship inside the Hex package under docs/ (start with docs/implement.md); AGENTS.md is the agent pointer. For the language-agnostic wire protocol, see the root protocol/ directory.