SkillKit.Runtime behaviour (SkillKit v0.1.0)

Behaviour for agent runtimes.

A runtime controls how an agent supervision tree is started. The default SkillKit.Runtime.Local starts agents in the current node. Alternative runtimes (e.g., FLAME) can start agents on remote nodes.

The behaviour defines one callback: start_agent/2. The public function start_agent/1 reads the runtime from the Agent struct, dispatches to the callback, and wraps the result in an AgentRef.

Summary

Callbacks

start_agent(t, keyword)

Functions

start_agent(agent)

Starts an agent using the runtime configured on its struct.

Callbacks

start_agent(t, keyword)

@callback start_agent(
  SkillKit.Agent.t(),
  keyword()
) :: {:ok, pid()} | {:error, term()}

Functions

start_agent(agent)

@spec start_agent(SkillKit.Agent.t()) ::
  {:ok, SkillKit.AgentRef.t()} | {:error, term()}

Starts an agent using the runtime configured on its struct.

Returns {:ok, %AgentRef{}} or {:error, reason}.