provider

type Provider struct {
	provider.Base

	// LuaBinding is the container key for the *hex/lua.Environment.
	// Defaults to "lua".
	LuaBinding string

	// AgentBinding is the container key for the ai.Agent. Defaults to
	// "ai".
	AgentBinding string

	// RegistryBinding is the container key for the ai.ToolRegistry.
	// Defaults to "ai.tools". Falls back to Registry when the binding
	// is missing.
	RegistryBinding string

	// ModuleName is the Lua module name registered via
	// env.PreloadModule. Defaults to "agent". Change when the
	// consumer wants to expose multiple agents under distinct names.
	ModuleName string

	// Registry is a fallback exposed to Lua via agent.tools() when the
	// container has no RegistryBinding. Typical usage relies on the
	// container-bound registry from hex/ai/provider; this field is
	// only useful when wiring the Lua module without the standard AI
	// provider.
	Registry ai.ToolRegistry

	// Store persists conversation history keyed by the first argument
	// to agent.ask. Optional; when nil each call is single-turn.
	Store ai.ConversationStore

	// Mutex is locked around every Generate call so concurrent
	// agent.ask invocations from event handlers do not race on the
	// shared *lua.LState. When nil, the provider allocates its own
	// mutex — this is the correct default for event-bus dispatched
	// scripts (see PLAT-3545).
	Mutex *sync.Mutex
}