Add scheduling parity and API alignment for v0.4.0

- Add SchedulerHealthResponse dataclass (13-field GET /health/scheduler)
- Add get_scheduler_health() method to ScheduleClient
- Add lazy-loaded Client.schedules property for ScheduleClient access
- Export all schedule types from package __init__
- Fix ScheduleClient._request() to parse JSON response
- Add 17 test cases covering all 11 ScheduleClient methods
- Bump version to 0.4.0

Author: jaschadub

CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.4.0] - 2026-02-07
+
+### Added
+
+#### Scheduling Parity & API Alignment
+- **SchedulerHealthResponse** — New dataclass for the 13-field `GET /health/scheduler` endpoint
+- **`get_scheduler_health()`** — New method on `ScheduleClient` to query scheduler health
+- **`Client.schedules` property** — Lazy-loaded `ScheduleClient` accessible directly from the main `Client` instance
+- **Schedule type exports** — All schedule dataclasses now exported from `symbiont` package (`CreateScheduleRequest`, `ScheduleSummary`, `ScheduleDetail`, `SchedulerHealthResponse`, etc.)
+
+#### Test Coverage
+- **ScheduleClient tests** — 18 test cases covering all 11 methods (list, create, get, update, delete, pause, resume, trigger, history, next-runs, scheduler-health) plus edge cases
+
+---
+
+## [0.3.1] - 2025-01-16
+
+### Added
+- ScheduleClient for cron schedule management API
+- Test compatibility fixes for enhanced Client class
+
+## [0.3.0] and earlier
+
+See previous releases for historical changes.

symbiont/__init__.py

@@ -82,11 +82,25 @@
     WorkflowExecutionRequest,
     WorkflowExecutionResponse,
 )
+from .schedules import (
+    CreateScheduleRequest,
+    CreateScheduleResponse,
+    DeleteScheduleResponse,
+    NextRunsResponse,
+    ScheduleActionResponse,
+    ScheduleClient,
+    ScheduleDetail,
+    ScheduleHistoryResponse,
+    SchedulerHealthResponse,
+    ScheduleRunEntry,
+    ScheduleSummary,
+    UpdateScheduleRequest,
+)
 
 # Load environment variables from .env file
 load_dotenv()
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"
 
 __all__ = [
     # Client
@@ -128,6 +142,15 @@
     'HttpInputConfig', 'HttpInputServerInfo', 'HttpInputCreateRequest', 'HttpInputUpdateRequest',
     'WebhookTriggerRequest', 'WebhookTriggerResponse',
 
+    # Schedule Models
+    'ScheduleClient',
+    'CreateScheduleRequest', 'CreateScheduleResponse',
+    'UpdateScheduleRequest',
+    'ScheduleSummary', 'ScheduleDetail', 'ScheduleRunEntry',
+    'ScheduleHistoryResponse', 'NextRunsResponse',
+    'ScheduleActionResponse', 'DeleteScheduleResponse',
+    'SchedulerHealthResponse',
+
     # Exceptions
     'SymbiontError',
     'APIError',

symbiont/client.py

@@ -84,6 +84,7 @@
     WebhookTriggerResponse,
     WorkflowExecutionRequest,
 )
+from .schedules import ScheduleClient
 
 
 class Client:
@@ -147,6 +148,16 @@ def __init__(self,
         self.api_key = self.config.api_key
         self.base_url = self.config.base_url
 
+        # Lazy-loaded sub-clients
+        self._schedules: Optional[ScheduleClient] = None
+
+    @property
+    def schedules(self) -> ScheduleClient:
+        """Lazy-loaded schedule management client."""
+        if self._schedules is None:
+            self._schedules = ScheduleClient(self)
+        return self._schedules
+
     def _request(self, method: str, endpoint: str, **kwargs):
         """Make an HTTP request to the API.
 

symbiont/schedules.py

@@ -7,8 +7,6 @@
 from dataclasses import dataclass, field
 from typing import Any, Dict, List, Optional
 
-from .exceptions import APIError, NotFoundError
-
 
 @dataclass
 class CreateScheduleRequest:
@@ -119,6 +117,25 @@ class DeleteScheduleResponse:
     deleted: bool
 
 
+@dataclass
+class SchedulerHealthResponse:
+    """Scheduler health response from GET /health/scheduler."""
+
+    is_running: bool
+    store_accessible: bool
+    jobs_total: int
+    jobs_active: int
+    jobs_paused: int
+    jobs_dead_letter: int
+    global_active_runs: int
+    max_concurrent: int
+    runs_total: int
+    runs_succeeded: int
+    runs_failed: int
+    average_execution_time_ms: float
+    longest_run_ms: float
+
+
 class ScheduleClient:
     """Client for managing cron schedules via the Symbiont Runtime API.
 
@@ -140,7 +157,8 @@ def _request(
         params: Optional[Dict[str, Any]] = None,
     ) -> Any:
         """Make an authenticated request through the parent client."""
-        return self._client._request(method, path, json=json, params=params)
+        response = self._client._request(method, path, json=json, params=params)
+        return response.json()
 
     def list_schedules(self) -> List[ScheduleSummary]:
         """List all scheduled jobs. ``GET /schedules``"""
@@ -219,3 +237,8 @@ def get_schedule_next_runs(
             "GET", f"/schedules/{job_id}/next-runs", params={"count": count}
         )
         return NextRunsResponse(**data)
+
+    def get_scheduler_health(self) -> SchedulerHealthResponse:
+        """Get scheduler health status. ``GET /health/scheduler``"""
+        data = self._request("GET", "/health/scheduler")
+        return SchedulerHealthResponse(**data)