Skip to content

types

types

Shared data types for the Marianne daemon.

Defines request/response models and status types used across daemon components (server, service, CLI bridge). All models are Pydantic v2 BaseModel for serialization over IPC.

Classes

JobSubmitParams

Bases: TypedDict

Parameters for the job.submit IPC method.

JobIdentifyParams

Bases: TypedDict

Parameters for IPC methods that identify a job (status, pause, resume).

JobCancelParams

Bases: TypedDict

Parameters for the job.cancel IPC method.

DaemonShutdownParams

Bases: TypedDict

Parameters for the daemon.shutdown IPC method.

JobRequest

Bases: BaseModel

Request to submit a job to the daemon.

Sent by clients (CLI, dashboard) to the daemon over IPC. The daemon validates the config and either accepts or rejects.

JobResponse

Bases: BaseModel

Response from the daemon after a job submission.

Returned immediately — does not wait for job completion. Clients poll status separately via DaemonStatus or job-specific queries.

ObserverEvent

Bases: TypedDict

Structured event emitted by the runner and routed through the daemon.

Standard event types

sheet.started, sheet.completed, sheet.failed, sheet.retrying, sheet.validation_passed, sheet.validation_failed, job.cost_update, job.iteration

Profiler event types

monitor.anomaly — resource anomaly detected by the profiler. Data payload: {"anomaly_type": str, "severity": str, "description": str, "pid": int | None, "metric_value": float, "threshold": float}

DaemonStatus

Bases: BaseModel

Current status snapshot of the running daemon.

Returned by health check / status queries. Provides a lightweight overview without per-job detail.