Behaviour for CLI-based local agent protocols.

Extends AgentProtocol with CLI-specific lifecycle, configuration, and availability checking.

CLI Configuration

The configuration maps to OpenClaw's CliBackendConfig with these key fields:

%{
  command: "claude",           # CLI binary name or path
  args: ["-p", "--output-format", "stream-json"],  # base args
  env: %{...},                 # extra env vars
  clear_env: [...],            # env vars to remove
  session_mode: :always,       # :always | :existing | :none
  session_id_fields: ["session_id"],  # where to find session ID in output
  session_args: [...],         # extra args for resuming
  system_prompt_mode: :append, # :append | :replace
  system_prompt_when: :first,  # :first | :always | :never
  reliability: %{
    watchdog: %{
      fresh: %{no_output_timeout_ms: 120_000},
      resume: %{no_output_timeout_ms: 300_000}
    }
  }
}

Usage

Use this behaviour in your protocol implementation:

defmodule MyAgentProtocol do
  use Agentic.AgentProtocol.CLI

  @impl true
  def cli_name, do: "my-agent"

  @impl true
  def build_config(profile_config) do
    %{
      command: "my-agent",
      args: ["-p", "--output-format", "stream-json"],
      session_mode: :always,
      session_id_fields: ["session_id"]
    }
  end
end