Skip to content

BuildRunner

File: tckit/ports/builder.py Purpose: Build, deploy, and runtime control with structured results.

Method Returns
build(project_path) BuildResult
deploy(target_ams_id) Result
start_runtime(target_ams_id) Result
get_status() BuildStatus

BuildResult carries each diagnostic as {file, line, message, severity} — never a raw log blob. Never deploy without a successful build first.

Why this shape

Tool outputs are context. A 2,000-line build log forces the model to scan, regex, and guess; a list of structured diagnostics lets it act. This is the high-signal tool result principle — return what the agent will use, not everything the underlying tool emitted.