Module hel_controller 

Controller-side lifecycle transitions and canonical-to-backend conversion.

Modules

move_session

One recoverable stop/restore operation, independent of its initiating viewer.

Structs

CheckpointArtifact

CheckpointDeferred

The session was working, so this checkpoint did not run. Nothing is wrong with the session, the target, or the last archive.

Controller

ControllerStoreGuard

Machine-wide advisory lock for one controller data store. This prevents a dashboard, server, or CLI lifecycle command from concurrently acting as a second controller against the same SQLite state and relay sessions.

QuickBundleCreation

The durable result of creating a quick bundle. The returned config is the same fresh config that was written, allowing a serving projection to publish the new bundle before acknowledging the request that created it.

RecoveryCandidate

RecoveryScan

ResumeRepositorySourceMismatch

ResumeRepositorySourceReceipt

SessionLaunchOptions

SessionResumeOptions

Enums

QuickBundleFailure

Failure stages exposed to a viewer request without exposing the underlying filesystem/configuration error. The detailed error remains available to the caller for logs and terminal notices.

ResumePlan

What a resume has to do to the session record before it provisions.

ResumeRepositorySourcePreflight

WorkerBinaryAvailability

WorkerUpgradeOutcome

What an upgrade attempt found. Nothing here is a failure: a worker that is already current and a session that started working again are both ordinary.

Functions

checkpoint_was_deferred

Whether a failed checkpoint only means the session was busy.

create_bundle_from_sources

Create one bundle from one or more local repositories or GitHub sources.

create_bundle_from_sources_in_config

Add a bundle for all sources to an already-loaded config. The source interpretation is shared with the persisted create_bundle_from_sources entry point and the legacy quick-bundle helper.

create_quick_bundle

Create a quick bundle from a local repository or GitHub source and persist it as one serialized fresh-config transaction. Identical sources reuse the existing configured bundle, matching the terminal’s behavior. The returned config is the same fresh config that was written, allowing a serving projection to publish the new bundle before acknowledging the request.

create_quick_bundle_in_config

Add a quick bundle to an already-loaded config. The helper still performs the local repository canonicalization/GitHub-source parsing, but callers that persist a config should use create_quick_bundle so concurrent saves cannot clobber one another.

image_refresh_plan

Every container image a background refresh keeps current, once per (host, image, platform).

local_project_repository

Inspect a local launch directory using the same Git error handling and linked-worktree identity as existing sessions.

pin_worker_binary_sources

Capture the worker sources used by this daemon before its asynchronous managers start. Missing sources are retained as per-architecture errors so an unused architecture does not prevent daemon startup.

reconcile_managed_checkpoint_archives

Remove checkpoint archives installed by a process that exited before its database transaction committed. Call this only while holding the machine-wide controller-store guard and before starting background work.

resume_compatibility

Whether session may resume on target_id, and what the resume must do to the session record. The error is shown to the person choosing the target, so it says where the session is tied down and what to pick instead.

worker_binary_prerequisite_for_arch

Find a worker source without downloading it.