Protocol for structured scope resolution in SkillKit.

Scopes carry authorization permissions and resolve named variables for skill template substitution and handler context injection.

Implementation

Define a struct and implement the protocol:

defmodule MyApp.Scope do
  defstruct [:user, permissions: []]
end

defimpl SkillKit.Scope, for: MyApp.Scope do
  def permissions(scope), do: scope.permissions

  def resolve(scope, "USERNAME", _context), do: {:ok, scope.user}
  def resolve(_scope, _key, _context), do: :error
end

Pass the scope at agent start:

SkillKit.start_agent("agents/my-agent", scope: %MyApp.Scope{user: "alice"})