fc-plugin-codbi/com.github.xima_formcycle_entwicklerkreis.fc.plugin.codbi.logic.cb.ai.commons/LlamaProcessManager

LlamaProcessManager

class LlamaProcessManager(log: (CodBi.LogLevel, String) -> Unit)

Manages the lifecycle of a local LLAMA-Server OS process.

Responsibilities:

Launching the server process with a caller-provided command line
Capturing stdout / stderr on daemon threads
Polling the /health endpoint until the server is ready
Graceful + forced shutdown
Finding a free TCP port

Parameters

log

Logging callback (LogLevel, message).

Constructors

LlamaProcessManager

constructor(log: (CodBi.LogLevel, String) -> Unit)

Types

object Companion

Properties

var process: Process?

The running server process, or null if not started.

Functions

fun findFreePort(preferredPort: Int): Int

Finds a free TCP port starting from preferredPort. Probes upward (up to 20 attempts) until an available port is found. Falls back to an OS-assigned ephemeral port if all probed ports are busy.

fun isAlive(): Boolean

Returns true if the server process is alive.

fun launchProcess(command: List<String>, workingDir: File, port: Int): Boolean

Launches the LLAMA-Server process and waits for it to become healthy.

fun stopProcess()

Stops the server process gracefully. Tries destroy() first, then destroyForcibly() after a timeout.