config/sys.config

%% HyperKitty Chromium :: runtime configuration.
%%
%% Project-local, not global: this file lives in the repository and
%% is the only place environment-specific values are set. There is
%% no assumption of a machine-wide Erlang config, chromium install
%% location, or port -- override any of these per-deployment by
%% copying this file (e.g. `config/sys.config.local`) rather than
%% editing global system files.
[
    {hyperkitty, [
        %% Path to the Chromium/Chrome executable used by
        %% hk_browser_session. The bundled bootstrap script
        %% (bin/bootstrap.sh) installs Chromium via Homebrew and
        %% prints the exact path to put here.
        {chromium_executable, "/opt/homebrew/bin/chromium"},

        %% HTTP/WebSocket API port (hk_api_listener).
        {api_port, 8420},

        %% Search provider module implementing hk_search_provider.
        %% hk_search_provider_mock is a self-contained reference
        %% implementation with no external network dependency; swap
        %% for a real adapter module in any non-development config.
        {search_provider, hk_search_provider_mock},

        %% Default <browser_agent_loop> limits, overridable per
        %% agent at creation time (POST /api/agents "limits").
        {default_agent_limits, #{
            max_actions => 40,
            max_execution_ms => 300000,
            max_browser_sessions => 2,
            max_network_requests => 200,
            max_search_iterations => 5
        }}
    ]},

    {kernel, [
        {logger_level, info},
        {logger, [
            {handler, default, logger_std_h, #{
                formatter => {logger_formatter, #{
                    template => [time, " ", level, " ", pid, " ", mfa, " ", msg, "\n"]
                }}
            }}
        ]}
    ]}
].