Execute a GET request with retries # Errors Returns an error if the request fails after all retry attempts, including network timeouts, connection f

Emit an event through this emitter, automatically deriving metadata.

Check if cache exists

Create a directory with all parent directories # Errors Returns an error if: - Permission is denied - Any I/O operation fails during directory creat

Get a specific build system by name

Access filesystem operations

Send event if context has event sender

Execute installation # Errors Returns an error if dependency resolution fails, package download fails, or installation fails.

Execute a command with an explicit environment and optional allow-failure behavior. If `allow_failure` is true, this returns Ok(BuildCommandResult) ev

Build a package from a Starlark recipe # Errors Returns an error if: - The recipe file cannot be read or parsed - Build dependencies cannot be resol

Remove a single file # Errors Returns an error if: - The file removal operation fails (permissions, file not found, etc.)

Create a platform context for filesystem operations

Get the shared platform instance

Remove a directory and all its contents # Errors Returns an error if: - The directory removal operation fails (permissions, non-empty directory, etc

Update packages # Errors Returns an error if package resolution fails, download fails, or update fails.

Create a platform context with event emission

Validate a path access in the current context # Errors Returns an error if: - Path resolution fails - Path escapes build root (for unauthorized acce

Begin transaction (placeholder implementation) # Errors Returns an error if the database transaction cannot be started.

Rename a file or directory # Errors Returns an error if: - The rename operation fails (permissions, cross-device, etc.)

Add multiple arguments to the command

Parse version from string in format "major.minor.patch" # Errors Returns an error if the version string is malformed or contains invalid numbers

Main application logic

Check if a path exists

Expand variables in a single string

Get current state ID # Errors Returns an error if the database query fails.

Parse a shell command into tokens

Access binary operations

Access process operations

Add a package to the store from a .sp file This extracts the package, hashes individual files for deduplication, and stores the package metadata with

Create a tracker with phases

Emit a platform event if event sender is available

Execute a command with security validation # Errors Returns an error if: - Command parsing fails - Path validation fails for command arguments - Sec

Get all installed packages in current state # Errors Returns an error if the database query fails.

Get a tool path, using persistent cache or discovering if necessary

Mark that installation is requested This method does not actually perform installation during recipe execution. Instead, it marks that the package sh

Get the current active state # Errors Returns an error if the database operation fails.

Record that a build system was used during the build

Emit a debug log event

Emit a started event for an existing tracker using its stored metadata.

Get all installed packages in a specific state # Errors Returns an error if the database query fails.

Get access to the platform manager for tool registry and other services

Add a clause to the problem

Run configure step only # Errors Returns an error if the configure command fails.

Check if a path exists

Extract downloaded archives # Errors Returns an error if any archive extraction fails.

Get the current active state # Errors Returns an error if the database query fails or no active state exists.

Validate command arguments

Ensure a package version exists and add it to a state snapshot # Errors Returns an error if the database operation fails.

# Errors Returns an error if any required dependency is missing from the builder.

Ensure an archive CAS row exists # Errors Returns an error if the database operation fails.