pycentauri 0.5.0__tar.gz → 0.5.1__tar.gz

{pycentauri-0.5.0 → pycentauri-0.5.1}/CHANGELOG.md

@@ -6,6 +6,27 @@ Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.5.1] - 2026-06-17
+
+### Added
+- **CLI parity with the new live-adjust API.** Three new top-level
+  commands matching the library and HTTP surfaces shipped in 0.5.0:
+  - `centauri speed <silent|balanced|sport|ludicrous|50|100|130|160>`
+  - `centauri fan [--model N] [--aux N] [--chamber N]`
+  - `centauri temp [--nozzle N] [--bed N] [--chamber N]`
+  All require `--enable-control` and accept any subset of fan/heater
+  flags (omitted axes are left untouched).
+- **MCP tool parity:** three new tools (only registered with
+  `--enable-control`) — `set_print_speed`, `set_fan_speed`,
+  `set_temperatures`. Same shapes as the HTTP endpoints; not marked
+  "DESTRUCTIVE" because live runtime adjustment is their entire
+  purpose.
+
+### Fixed
+- 0.5.0 shipped the live-adjust API to the library, HTTP server, and
+  web UI but missed the CLI and MCP server. This release closes that
+  parity gap — every surface now exposes the same control set.
+
 ## [0.5.0] - 2026-06-17
 
 ### Added

{pycentauri-0.5.0 → pycentauri-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycentauri
-Version: 0.5.0
+Version: 0.5.1
 Summary: Local-network toolkit for Elegoo Centauri Carbon 3D printers: async Python client, CLI, MCP server, REST/SSE HTTP server, web UI, and RTSP bridge
 Project-URL: Homepage, https://github.com/bjan/pycentauri
 Project-URL: Repository, https://github.com/bjan/pycentauri
@@ -109,8 +109,17 @@ centauri print start cube.gcode --host 192.168.1.209 --enable-control
 centauri print pause            --host 192.168.1.209 --enable-control
 centauri print resume           --host 192.168.1.209 --enable-control
 centauri print stop             --host 192.168.1.209 --enable-control
+
+# Live adjust — speed mode, fans, heaters (only effective mid-print for speed)
+centauri speed sport --host 192.168.1.209 --enable-control
+centauri fan  --model 100 --aux 60 --chamber 30 --host 192.168.1.209 --enable-control
+centauri temp --nozzle 215 --bed 60            --host 192.168.1.209 --enable-control
 ```
 
+The four speed modes (`silent`, `balanced`, `sport`, `ludicrous`) map to
+the firmware's only-accepted `PrintSpeedPct` values (50, 100, 130, 160) —
+arbitrary intermediate percentages are silently dropped by the firmware.
+
 The host can also come from the `PYCENTAURI_HOST` environment variable.
 If neither is set, every command auto-discovers via a 2.5 s UDP broadcast
 and bails out if it finds zero or more than one printer.
@@ -136,8 +145,11 @@ async def main():
 asyncio.run(main())
 ```
 
-Control actions (`start_print`, `pause`, `resume`, `stop`) require
-`Printer.connect(..., enable_control=True)`.
+Control actions (`start_print`, `pause`, `resume`, `stop`,
+`set_print_speed`, `set_fan_speed`, `set_temperatures`) require
+`Printer.connect(..., enable_control=True)`. The mode-to-value map for
+print speed is also exposed as `Printer.PRINT_SPEED_MODES` for callers
+that want to render their own picker.
 
 ## Quick start — HTTP server
 
@@ -166,6 +178,13 @@ centauri server --host 192.168.1.209 --bind 0.0.0.0 --port 8787 \
 | `GET` | `/docs` / `/redoc` | Auto-generated OpenAPI docs |
 | `POST` | `/print/start` | Body: `{"filename": "cube.gcode"}`. Requires `--enable-control`. |
 | `POST` | `/print/{pause,resume,stop}` | Requires `--enable-control`. |
+| `POST` | `/print/speed` | Body: `{"mode": "silent\|balanced\|sport\|ludicrous"}` (or `50\|100\|130\|160`). |
+| `POST` | `/print/fan` | Body: `{"model": 50, "auxiliary": 30, "chamber": 0}` (any subset; 0..100). |
+| `POST` | `/print/temperature` | Body: `{"nozzle": 215, "bed": 60, "chamber": 0}` (any subset; °C). |
+
+The web UI's **ADJUST** panel exposes all three of the above as a
+4-button speed-mode selector and per-fan/heater rows with auto-hydration
+from live status.
 
 The server holds a single long-lived WebSocket to the printer and reuses
 it for every request — no per-request reconnect, and it won't bump into
@@ -226,6 +245,9 @@ the host is pinned at spawn time. Tools exposed:
 | `pause_print` | only with `--enable-control` | Pauses the current print |
 | `resume_print` | only with `--enable-control` | Resumes a paused print |
 | `stop_print` | only with `--enable-control` | Stops the current print |
+| `set_print_speed` | only with `--enable-control` | Sets speed mode (`silent`/`balanced`/`sport`/`ludicrous`) — only takes effect mid-print |
+| `set_fan_speed` | only with `--enable-control` | Sets any subset of model/aux/chamber fan speeds (0..100%) |
+| `set_temperatures` | only with `--enable-control` | Sets any subset of nozzle/bed/chamber heater targets (°C, 0 = off) |
 
 Control tools aren't just gated — they're not *registered* without the
 flag, so an LLM that wasn't given the `--enable-control` launch can't see

{pycentauri-0.5.0 → pycentauri-0.5.1}/README.md

@@ -61,8 +61,17 @@ centauri print start cube.gcode --host 192.168.1.209 --enable-control
 centauri print pause            --host 192.168.1.209 --enable-control
 centauri print resume           --host 192.168.1.209 --enable-control
 centauri print stop             --host 192.168.1.209 --enable-control
+
+# Live adjust — speed mode, fans, heaters (only effective mid-print for speed)
+centauri speed sport --host 192.168.1.209 --enable-control
+centauri fan  --model 100 --aux 60 --chamber 30 --host 192.168.1.209 --enable-control
+centauri temp --nozzle 215 --bed 60            --host 192.168.1.209 --enable-control
 ```
 
+The four speed modes (`silent`, `balanced`, `sport`, `ludicrous`) map to
+the firmware's only-accepted `PrintSpeedPct` values (50, 100, 130, 160) —
+arbitrary intermediate percentages are silently dropped by the firmware.
+
 The host can also come from the `PYCENTAURI_HOST` environment variable.
 If neither is set, every command auto-discovers via a 2.5 s UDP broadcast
 and bails out if it finds zero or more than one printer.
@@ -88,8 +97,11 @@ async def main():
 asyncio.run(main())
 ```
 
-Control actions (`start_print`, `pause`, `resume`, `stop`) require
-`Printer.connect(..., enable_control=True)`.
+Control actions (`start_print`, `pause`, `resume`, `stop`,
+`set_print_speed`, `set_fan_speed`, `set_temperatures`) require
+`Printer.connect(..., enable_control=True)`. The mode-to-value map for
+print speed is also exposed as `Printer.PRINT_SPEED_MODES` for callers
+that want to render their own picker.
 
 ## Quick start — HTTP server
 
@@ -118,6 +130,13 @@ centauri server --host 192.168.1.209 --bind 0.0.0.0 --port 8787 \
 | `GET` | `/docs` / `/redoc` | Auto-generated OpenAPI docs |
 | `POST` | `/print/start` | Body: `{"filename": "cube.gcode"}`. Requires `--enable-control`. |
 | `POST` | `/print/{pause,resume,stop}` | Requires `--enable-control`. |
+| `POST` | `/print/speed` | Body: `{"mode": "silent\|balanced\|sport\|ludicrous"}` (or `50\|100\|130\|160`). |
+| `POST` | `/print/fan` | Body: `{"model": 50, "auxiliary": 30, "chamber": 0}` (any subset; 0..100). |
+| `POST` | `/print/temperature` | Body: `{"nozzle": 215, "bed": 60, "chamber": 0}` (any subset; °C). |
+
+The web UI's **ADJUST** panel exposes all three of the above as a
+4-button speed-mode selector and per-fan/heater rows with auto-hydration
+from live status.
 
 The server holds a single long-lived WebSocket to the printer and reuses
 it for every request — no per-request reconnect, and it won't bump into
@@ -178,6 +197,9 @@ the host is pinned at spawn time. Tools exposed:
 | `pause_print` | only with `--enable-control` | Pauses the current print |
 | `resume_print` | only with `--enable-control` | Resumes a paused print |
 | `stop_print` | only with `--enable-control` | Stops the current print |
+| `set_print_speed` | only with `--enable-control` | Sets speed mode (`silent`/`balanced`/`sport`/`ludicrous`) — only takes effect mid-print |
+| `set_fan_speed` | only with `--enable-control` | Sets any subset of model/aux/chamber fan speeds (0..100%) |
+| `set_temperatures` | only with `--enable-control` | Sets any subset of nozzle/bed/chamber heater targets (°C, 0 = off) |
 
 Control tools aren't just gated — they're not *registered* without the
 flag, so an LLM that wasn't given the `--enable-control` launch can't see

{pycentauri-0.5.0 → pycentauri-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycentauri"
-version = "0.5.0"
+version = "0.5.1"
 description = "Local-network toolkit for Elegoo Centauri Carbon 3D printers: async Python client, CLI, MCP server, REST/SSE HTTP server, web UI, and RTSP bridge"
 readme = "README.md"
 license = "Apache-2.0"

{pycentauri-0.5.0 → pycentauri-0.5.1}/src/pycentauri/__init__.py

@@ -25,4 +25,4 @@ __all__ = [
     "discover",
 ]
 
-__version__ = "0.5.0"
+__version__ = "0.5.1"

{pycentauri-0.5.0 → pycentauri-0.5.1}/src/pycentauri/cli.py

@@ -323,6 +323,119 @@ def cmd_print_stop(host: HostOpt = None, enable_control: ControlOpt = False) ->
     _run(run())
 
 
+@app.command("speed")
+def cmd_speed(
+    mode: Annotated[
+        str,
+        typer.Argument(
+            help="Speed mode: silent | balanced | sport | ludicrous "
+            "(or the integer 50 | 100 | 130 | 160).",
+        ),
+    ],
+    host: HostOpt = None,
+    enable_control: ControlOpt = False,
+) -> None:
+    """Set the print-speed mode. Only effective while a print is running."""
+    if not enable_control:
+        _echo_err("Refusing to send a write action without --enable-control.")
+        raise typer.Exit(code=2)
+
+    parsed: str | int = int(mode) if mode.lstrip("-").isdigit() else mode
+
+    async def run() -> None:
+        h, mid = await _resolve_target(host)
+        async with await Printer.connect(h, enable_control=True, mainboard_id=mid) as printer:
+            try:
+                await printer.set_print_speed(parsed)
+            except ValueError as err:
+                _echo_err(str(err))
+                raise typer.Exit(code=2) from err
+        typer.echo(f"speed mode set: {mode}")
+
+    _run(run())
+
+
+@app.command("fan")
+def cmd_fan(
+    model: Annotated[
+        int | None,
+        typer.Option("--model", help="Model (part-cooling) fan 0..100%."),
+    ] = None,
+    auxiliary: Annotated[
+        int | None,
+        typer.Option("--aux", "--auxiliary", help="Auxiliary fan 0..100%."),
+    ] = None,
+    chamber: Annotated[
+        int | None,
+        typer.Option("--chamber", help="Chamber/box fan 0..100%."),
+    ] = None,
+    host: HostOpt = None,
+    enable_control: ControlOpt = False,
+) -> None:
+    """Set fan speeds. Pass any subset; omitted fans are left untouched."""
+    if not enable_control:
+        _echo_err("Refusing to send a write action without --enable-control.")
+        raise typer.Exit(code=2)
+    if model is None and auxiliary is None and chamber is None:
+        _echo_err("Specify at least one of --model, --aux, --chamber.")
+        raise typer.Exit(code=2)
+
+    async def run() -> None:
+        h, mid = await _resolve_target(host)
+        async with await Printer.connect(h, enable_control=True, mainboard_id=mid) as printer:
+            try:
+                await printer.set_fan_speed(model=model, auxiliary=auxiliary, chamber=chamber)
+            except ValueError as err:
+                _echo_err(str(err))
+                raise typer.Exit(code=2) from err
+        parts = [
+            f"{k}={v}%"
+            for k, v in (("model", model), ("aux", auxiliary), ("chamber", chamber))
+            if v is not None
+        ]
+        typer.echo("fans set: " + ", ".join(parts))
+
+    _run(run())
+
+
+@app.command("temp")
+def cmd_temp(
+    nozzle: Annotated[
+        float | None, typer.Option("--nozzle", help="Nozzle target °C (0 = off).")
+    ] = None,
+    bed: Annotated[float | None, typer.Option("--bed", help="Bed target °C (0 = off).")] = None,
+    chamber: Annotated[
+        float | None, typer.Option("--chamber", help="Chamber target °C (0 = off).")
+    ] = None,
+    host: HostOpt = None,
+    enable_control: ControlOpt = False,
+) -> None:
+    """Set heater target temperatures. Pass any subset."""
+    if not enable_control:
+        _echo_err("Refusing to send a write action without --enable-control.")
+        raise typer.Exit(code=2)
+    if nozzle is None and bed is None and chamber is None:
+        _echo_err("Specify at least one of --nozzle, --bed, --chamber.")
+        raise typer.Exit(code=2)
+
+    async def run() -> None:
+        h, mid = await _resolve_target(host)
+        async with await Printer.connect(h, enable_control=True, mainboard_id=mid) as printer:
+            try:
+                await printer.set_temperatures(nozzle=nozzle, bed=bed, chamber=chamber)
+            except ValueError as err:
+                _echo_err(str(err))
+                raise typer.Exit(code=2) from err
+        parts = [
+            f"{k}={v}°C"
+            for k, v in (("nozzle", nozzle), ("bed", bed), ("chamber", chamber))
+            if v is not None
+        ]
+        typer.echo("targets set: " + ", ".join(parts))
+
+    _run(run())
+
+
 @app.command("server")
 def cmd_server(
     host: HostOpt = None,

{pycentauri-0.5.0 → pycentauri-0.5.1}/src/pycentauri/mcp/server.py

@@ -196,6 +196,53 @@ def build_server(*, enable_control: bool = False) -> FastMCP:
             result = await printer.stop()
         return {"ok": True, "response": result.inner}
 
+    @mcp.tool()
+    async def set_print_speed(mode: str | int) -> dict[str, Any]:
+        """Set the print-speed mode. Only effective while a print is running.
+
+        ``mode`` is one of ``"silent"``, ``"balanced"``, ``"sport"``,
+        ``"ludicrous"``, or the corresponding ``PrintSpeedPct`` value
+        (``50``, ``100``, ``130``, ``160``). Arbitrary intermediate
+        values are rejected by the firmware.
+        """
+        host, mid = await _resolve_target()
+        async with await Printer.connect(host, enable_control=True, mainboard_id=mid) as printer:
+            result = await printer.set_print_speed(mode)
+        return {"ok": True, "response": result.inner}
+
+    @mcp.tool()
+    async def set_fan_speed(
+        model: int | None = None,
+        auxiliary: int | None = None,
+        chamber: int | None = None,
+    ) -> dict[str, Any]:
+        """Set fan speeds (0..100% each). Pass any subset; omitted fans are untouched.
+
+        ``chamber`` is the chamber/box fan. At least one of the three must
+        be provided.
+        """
+        host, mid = await _resolve_target()
+        async with await Printer.connect(host, enable_control=True, mainboard_id=mid) as printer:
+            result = await printer.set_fan_speed(model=model, auxiliary=auxiliary, chamber=chamber)
+        return {"ok": True, "response": result.inner}
+
+    @mcp.tool()
+    async def set_temperatures(
+        nozzle: float | None = None,
+        bed: float | None = None,
+        chamber: float | None = None,
+    ) -> dict[str, Any]:
+        """Set heater target temperatures in °C. Pass any subset.
+
+        ``0`` turns the corresponding heater off. Safety caps applied:
+        nozzle 0..300, bed 0..110, chamber 0..60. Setting all heaters to
+        ``0`` mid-print effectively kills the print.
+        """
+        host, mid = await _resolve_target()
+        async with await Printer.connect(host, enable_control=True, mainboard_id=mid) as printer:
+            result = await printer.set_temperatures(nozzle=nozzle, bed=bed, chamber=chamber)
+        return {"ok": True, "response": result.inner}
+
     return mcp