amigent 1.0.0__tar.gz

amigent-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andreas Wendorf (Akustikrausch)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

amigent-1.0.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: amigent
+Version: 1.0.0
+Summary: Complete remote control for a real Amiga, by AI or manually
+Author: Andreas Wendorf (Akustikrausch)
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/akustikrausch/amigent
+Project-URL: Documentation, https://github.com/akustikrausch/amigent/blob/main/docs/GUIDE.md
+Project-URL: Changelog, https://github.com/akustikrausch/amigent/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/akustikrausch/amigent/issues
+Keywords: amiga,amigaos,mcp,remote-desktop,retrocomputing,ai-agent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: System :: Emulators
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp<2,>=1.2
+Requires-Dist: pillow>=10
+Dynamic: license-file
+
+```
+     _____            .__                            __
+    /  _  \    _____  |__|   ____    ____    ____  _/  |_
+   /  /_\  \  /     \ |  |  / ___\ _/ __ \  /    \ \   __\
+  /    |    \|  Y Y  \|  | / /_/  >\  ___/ |   |  \ |  |
+  \____|__  /|__|_|  /|__| \___  /  \___  >|___|  / |__|
+          \/       \/     /_____/       \/      \/
+
+     complete remote control for a real Amiga, by AI or manually
+```
+
+<p align="center"><img src="https://raw.githubusercontent.com/akustikrausch/amigent/main/src/amigent/web/icon.png" width="96" alt="Amigent icon"></p>
+
+Amigent connects your PC or Mac to your real Amiga over the home network. Then you can:
+
+- **let an AI agent do the work**, for example Claude Code or Codex: install
+  software, update programs, change settings, copy files, click through
+  programs. Just tell it what you want.
+- **use the Amiga yourself from your computer**, as a remote desktop like
+  TeamViewer or VNC: a window with the live screen, your own mouse and
+  keyboard, file transfer and a shared clipboard.
+
+Both at the same time: you see every click the agent makes and can take over at
+any moment.
+
+![Amigent with a Workbench screen and the keyboard panel](https://raw.githubusercontent.com/akustikrausch/amigent/main/docs/screenshots/viewer.png)
+
+## Installation
+
+### On the Amiga
+
+**1.** Copy [`amigentd`](https://github.com/akustikrausch/amigent/blob/main/src/amigent/amiga/bin/amigentd) to the Amiga (`amigentd.000` on a
+68000), or unpack the archive from the
+[releases](https://github.com/akustikrausch/amigent/releases).
+
+**2.** Start it with `amigentd SETUP` in a Shell, or double-click its icon.
+
+### On the PC or Mac
+
+**3.** Paste this into your AI agent:
+
+    Install Amigent for me: run "pipx install amigent" (if pipx or Python 3.10
+    or newer is missing, install them first: Windows winget, macOS Homebrew,
+    Linux the package manager). Then run amigent-setup; it finds my Amiga on
+    the network by itself. Register the MCP server "amigent" with the command
+    amigent-server, and run amigent-viewer --install so the remote desktop
+    shows up as a program. Tell me if you need to be restarted.
+
+The agent sets up the Amiga over the network; from then on amigentd starts
+with it.
+
+**Windows:** Amigent appears in the Start menu. For an encrypted connection
+`openssl` is needed, which comes with Git for Windows.
+
+**macOS:** Amigent appears in `~/Applications`. On its first start, allow it
+access to the local network, or it cannot reach the Amiga. Cmd is the right
+Amiga key.
+
+**Linux:** there is no program entry; start the remote desktop with
+`amigent-viewer`.
+
+Without an AI agent: see the [manual installation](https://github.com/akustikrausch/amigent/blob/main/docs/GUIDE.md#manual-installation).
+
+## What you need
+
+- An Amiga with AmigaOS 3.x, any CPU from the 68000 on, a network connection
+  (a plipbox on the parallel port is enough) and a TCP/IP stack such as Roadshow.
+  The faster the CPU, the smoother the screen.
+- A PC or Mac with Windows, macOS or Linux and Python 3.10 or newer.
+
+## What you can ask for
+
+    "Check which programs on the Amiga are outdated."
+    "Install the game from my Downloads folder and add it to the Games menu."
+    "Copy the demo to the Amiga and start it."
+    "Open the remote desktop."
+
+## Good to know
+
+- **Slow networks are fine.** Only the parts of the screen that change are sent.
+- **New address after a restart?** Amigent finds the Amiga again by itself. It
+  takes only the one that proves to be yours.
+- **Several Amigas?** `amigent-fleet` shows them side by side with a preview.
+- **After a big OS update**, `amigent-repair` puts back what the update removed.
+- **Safe at home.** A key keeps other computers on the network out, and the
+  connection can be encrypted. Don't open the Amiga to the internet.
+
+More in the [guide](https://github.com/akustikrausch/amigent/blob/main/docs/GUIDE.md) and the [FAQ](https://github.com/akustikrausch/amigent/blob/main/docs/FAQ.md).
+
+## Other projects
+
+- [amimcp](https://github.com/thomas-luebker/amimcp) by Thomas Luebker also lets
+  an AI agent control a real Amiga, from OS 2.04 on, with amifleet as a native
+  Mac app for several machines. Use it if your Amiga runs OS 2.x or you want
+  nothing but Python's standard library on the PC.
+- [MCP-AmigaOS4](https://github.com/derfsss/MCP-AmigaOS4) is for AmigaOS 4.1.
+- For emulators such as WinUAE and Amiberry there are MCP servers of their own.
+
+Amigent is the one to pick if you want to use the Amiga yourself as well, have a
+slow network, or want help keeping the machine in shape.
+
+## Thanks
+
+tbdye for amigactld, Volker Barthelmann for vbcc, and the PiStorm, Emu68, AmiKit
+and Aminet people.
+
+## License
+
+MIT, see [LICENSE](https://github.com/akustikrausch/amigent/blob/main/LICENSE). By Andreas Wendorf (Akustikrausch).
+Changes are in the [changelog](https://github.com/akustikrausch/amigent/blob/main/CHANGELOG.md).

amigent-1.0.0/README.md

@@ -0,0 +1,110 @@
+```
+     _____            .__                            __
+    /  _  \    _____  |__|   ____    ____    ____  _/  |_
+   /  /_\  \  /     \ |  |  / ___\ _/ __ \  /    \ \   __\
+  /    |    \|  Y Y  \|  | / /_/  >\  ___/ |   |  \ |  |
+  \____|__  /|__|_|  /|__| \___  /  \___  >|___|  / |__|
+          \/       \/     /_____/       \/      \/
+
+     complete remote control for a real Amiga, by AI or manually
+```
+
+<p align="center"><img src="https://raw.githubusercontent.com/akustikrausch/amigent/main/src/amigent/web/icon.png" width="96" alt="Amigent icon"></p>
+
+Amigent connects your PC or Mac to your real Amiga over the home network. Then you can:
+
+- **let an AI agent do the work**, for example Claude Code or Codex: install
+  software, update programs, change settings, copy files, click through
+  programs. Just tell it what you want.
+- **use the Amiga yourself from your computer**, as a remote desktop like
+  TeamViewer or VNC: a window with the live screen, your own mouse and
+  keyboard, file transfer and a shared clipboard.
+
+Both at the same time: you see every click the agent makes and can take over at
+any moment.
+
+![Amigent with a Workbench screen and the keyboard panel](https://raw.githubusercontent.com/akustikrausch/amigent/main/docs/screenshots/viewer.png)
+
+## Installation
+
+### On the Amiga
+
+**1.** Copy [`amigentd`](https://github.com/akustikrausch/amigent/blob/main/src/amigent/amiga/bin/amigentd) to the Amiga (`amigentd.000` on a
+68000), or unpack the archive from the
+[releases](https://github.com/akustikrausch/amigent/releases).
+
+**2.** Start it with `amigentd SETUP` in a Shell, or double-click its icon.
+
+### On the PC or Mac
+
+**3.** Paste this into your AI agent:
+
+    Install Amigent for me: run "pipx install amigent" (if pipx or Python 3.10
+    or newer is missing, install them first: Windows winget, macOS Homebrew,
+    Linux the package manager). Then run amigent-setup; it finds my Amiga on
+    the network by itself. Register the MCP server "amigent" with the command
+    amigent-server, and run amigent-viewer --install so the remote desktop
+    shows up as a program. Tell me if you need to be restarted.
+
+The agent sets up the Amiga over the network; from then on amigentd starts
+with it.
+
+**Windows:** Amigent appears in the Start menu. For an encrypted connection
+`openssl` is needed, which comes with Git for Windows.
+
+**macOS:** Amigent appears in `~/Applications`. On its first start, allow it
+access to the local network, or it cannot reach the Amiga. Cmd is the right
+Amiga key.
+
+**Linux:** there is no program entry; start the remote desktop with
+`amigent-viewer`.
+
+Without an AI agent: see the [manual installation](https://github.com/akustikrausch/amigent/blob/main/docs/GUIDE.md#manual-installation).
+
+## What you need
+
+- An Amiga with AmigaOS 3.x, any CPU from the 68000 on, a network connection
+  (a plipbox on the parallel port is enough) and a TCP/IP stack such as Roadshow.
+  The faster the CPU, the smoother the screen.
+- A PC or Mac with Windows, macOS or Linux and Python 3.10 or newer.
+
+## What you can ask for
+
+    "Check which programs on the Amiga are outdated."
+    "Install the game from my Downloads folder and add it to the Games menu."
+    "Copy the demo to the Amiga and start it."
+    "Open the remote desktop."
+
+## Good to know
+
+- **Slow networks are fine.** Only the parts of the screen that change are sent.
+- **New address after a restart?** Amigent finds the Amiga again by itself. It
+  takes only the one that proves to be yours.
+- **Several Amigas?** `amigent-fleet` shows them side by side with a preview.
+- **After a big OS update**, `amigent-repair` puts back what the update removed.
+- **Safe at home.** A key keeps other computers on the network out, and the
+  connection can be encrypted. Don't open the Amiga to the internet.
+
+More in the [guide](https://github.com/akustikrausch/amigent/blob/main/docs/GUIDE.md) and the [FAQ](https://github.com/akustikrausch/amigent/blob/main/docs/FAQ.md).
+
+## Other projects
+
+- [amimcp](https://github.com/thomas-luebker/amimcp) by Thomas Luebker also lets
+  an AI agent control a real Amiga, from OS 2.04 on, with amifleet as a native
+  Mac app for several machines. Use it if your Amiga runs OS 2.x or you want
+  nothing but Python's standard library on the PC.
+- [MCP-AmigaOS4](https://github.com/derfsss/MCP-AmigaOS4) is for AmigaOS 4.1.
+- For emulators such as WinUAE and Amiberry there are MCP servers of their own.
+
+Amigent is the one to pick if you want to use the Amiga yourself as well, have a
+slow network, or want help keeping the machine in shape.
+
+## Thanks
+
+tbdye for amigactld, Volker Barthelmann for vbcc, and the PiStorm, Emu68, AmiKit
+and Aminet people.
+
+## License
+
+MIT, see [LICENSE](https://github.com/akustikrausch/amigent/blob/main/LICENSE). By Andreas Wendorf (Akustikrausch).
+Changes are in the [changelog](https://github.com/akustikrausch/amigent/blob/main/CHANGELOG.md).

amigent-1.0.0/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "amigent"
+dynamic = ["version"]
+description = "Complete remote control for a real Amiga, by AI or manually"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Andreas Wendorf (Akustikrausch)" }]
+keywords = ["amiga", "amigaos", "mcp", "remote-desktop", "retrocomputing", "ai-agent"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Environment :: Console",
+  "Intended Audience :: End Users/Desktop",
+  "Operating System :: Microsoft :: Windows",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: System :: Emulators",
+  "Topic :: System :: Networking",
+]
+dependencies = ["mcp>=1.2,<2", "pillow>=10"]
+
+[project.urls]
+Homepage = "https://github.com/akustikrausch/amigent"
+Documentation = "https://github.com/akustikrausch/amigent/blob/main/docs/GUIDE.md"
+Changelog = "https://github.com/akustikrausch/amigent/blob/main/CHANGELOG.md"
+Issues = "https://github.com/akustikrausch/amigent/issues"
+
+[project.scripts]
+amigent-server = "amigent.server:main"
+amigent-doctor = "amigent.doctor:main"
+amigent-setup = "amigent.setup:main"
+amigent-viewer = "amigent.viewer:main"
+amigent-fleet = "amigent.fleet:main"
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = { attr = "amigent.__version__" }
+
+[tool.setuptools.package-data]
+amigent = ["web/*", "web/locales/*", "macos/*", "amiga/*", "amiga/bin/*"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

amigent-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

amigent-1.0.0/src/amigent/__init__.py

@@ -0,0 +1,3 @@
+"""Amigent: complete remote control for a real Amiga, by AI or manually."""
+
+__version__ = "1.0.0"

amigent-1.0.0/src/amigent/amiga/amigent-repair

@@ -0,0 +1,65 @@
+; amigent-repair: restores Amigent after a system update. Safe to run twice.
+FailAt 21
+; amigent-setup puts its folder here (SYS:amigent unless --home says otherwise)
+Set SRC SYS:amigent
+; amigactld only where an older setup installed it
+If EXISTS $SRC/amigactld
+  If NOT EXISTS C:amigactld
+    Copy $SRC/amigactld C: CLONE
+    Protect C:amigactld rwed
+  EndIf
+EndIf
+If NOT EXISTS C:amigentd
+  Copy $SRC/amigentd C: CLONE
+  Protect C:amigentd rwed
+EndIf
+If NOT EXISTS S:amigent.key
+  If EXISTS $SRC/amigent.key
+    Copy $SRC/amigent.key S: CLONE
+  EndIf
+EndIf
+If NOT EXISTS S:amigent-tls.pem
+  If EXISTS $SRC/amigent-tls.pem
+    Copy $SRC/amigent-tls.pem S: CLONE
+  EndIf
+EndIf
+If NOT EXISTS S:amigactld.conf
+  If EXISTS $SRC/amigactld.conf
+    Copy $SRC/amigactld.conf S: CLONE
+  EndIf
+EndIf
+Delete >NIL: S:amigent-start QUIET
+If EXISTS $SRC/amigactld
+  Search >NIL: S:User-Startup "C:amigactld" QUIET
+  If WARN
+    Echo >>S:User-Startup "RUN >NIL: C:amigactld"
+  EndIf
+EndIf
+Search >NIL: S:User-Startup "C:amigentd" QUIET
+If WARN
+  If EXISTS $SRC/amigent.tlsonly
+    Echo >>S:User-Startup "RUN >NIL: C:amigentd TLSONLY"
+  Else
+    Echo >>S:User-Startup "RUN >NIL: C:amigentd"
+  EndIf
+EndIf
+If EXISTS C:amigactld
+  Status >NIL: COMMAND=C:amigactld
+  If WARN
+    Run >NIL: C:amigactld
+  EndIf
+EndIf
+Status >NIL: COMMAND=C:amigentd
+If WARN
+  Run >NIL: C:amigentd
+EndIf
+; every installed program brings its own module
+List $SRC/repair.d PAT=#?.repair LFORMAT "Execute %p%n" >T:amigent-modules
+Execute T:amigent-modules
+Delete >NIL: T:amigent-modules QUIET
+Search >NIL: S:Startup-Sequence "S:User-Startup" QUIET
+If WARN
+  RequestChoice >NIL: "Amigent" "Startup-Sequence no longer runs S:User-Startup.*NPlease tell the AI agent." "OK"
+Else
+  RequestChoice >NIL: "Amigent" "Amigent is repaired.*NPlease restart the Amiga." "OK"
+EndIf

amigent-1.0.0/src/amigent/amiga/amigent-scan

@@ -0,0 +1,9 @@
+; amigent-scan: inventory of programs and their $VER strings.
+; Writes RAM:amigent-inventory.txt, then RAM:amigent-scan.done
+FailAt 21
+Delete >NIL: RAM:amigent-inventory.txt RAM:amigent-scan.script RAM:amigent-scan.done QUIET
+Echo >RAM:amigent-scan.script "FailAt 21"
+ChangeTaskPri -5
+List >>RAM:amigent-scan.script SYS:C SYS:L SYS:Libs SYS:Classes SYS:Devs SYS:Expansion SYS:Internet SYS:Prefs SYS:Rexxc SYS:Storage SYS:System SYS:Tools SYS:Utilities SYS:WBStartup ALL FILES PAT=~(#?.(info|guide|txt|doc|readme|pdf|html|htm|png|jpg|jpeg|gif|iff|ilbm|mod|wav|mp3|h|c|i|s|asm|fd|cat|catalog|font|pfb|ttf|cfg|prefs|lha|lzx|zip)) LFORMAT "Echo >>RAM:amigent-inventory.txt *"@%p%n|%l*"*NVersion >>RAM:amigent-inventory.txt *"%p%n*""
+Execute >NIL: RAM:amigent-scan.script
+Echo >RAM:amigent-scan.done "done"

amigent-1.0.0/src/amigent/amiga/menu-add.rexx

@@ -0,0 +1,45 @@
+/* Inserts an entry into the AmiStart menu file, sorted by name.
+   Args: SECTION|Name|Program[|Stack]. AmiStart shows it after its next start.
+   The file is handled as one string because READLN splits lines over 1000 chars. */
+parse arg section '|' name '|' file '|' stack
+if stack = '' then stack = 32768
+prefs = 'SYS:Utilities/Expansion/AmiStart/sm.prefs'
+temp = 'T:sm.prefs.new'
+nl = '0a'x
+item = 'ITEM ICON="'file'" NAME="'name'" METHOD="0" CMDMODE="0" RGB="0x0" TEXTRGB="0x0" FILE="'file'" EXECMODE="0" STACK="'stack'"'
+
+if ~open('in', prefs, 'R') then exit 10
+data = readch('in', 65535)
+call close('in')
+if length(data) > 65000 then exit 10
+
+start = index(data, nl'NEWDIR NAME="'section'"')
+if start = 0 then exit 10
+stop = index(data, nl'ENDDIR', start)
+if stop = 0 then exit 10
+
+insert = stop + 1
+p = index(data, nl, start + 1) + 1
+do while p < stop
+  e = index(data, nl, p)
+  line = substr(data, p, e - p)
+  if left(line, 5) == 'ITEM ' & index(line, '" GROUP ') = 0 then do
+    parse var line 'NAME="' current '"'
+    if upper(current) > upper(name) then do
+      insert = p
+      leave
+    end
+  end
+  p = e + 1
+end
+
+if ~open('out', temp, 'W') then exit 10
+call writech('out', left(data, insert - 1) || item || nl || substr(data, insert))
+call close('out')
+
+do try = 1 to 10
+  address command 'Copy' temp prefs 'QUIET'
+  if rc = 0 then exit 0
+  address command 'Wait 1'
+end
+exit 10

amigent-1.0.0/src/amigent/amigactl.py

@@ -0,0 +1,199 @@
+"""Client for the amigactld wire protocol: files, commands, system state. The old-school path.
+
+Clean-room job from the published spec (docs/protocol.md and
+docs/protocol-commands.md in the amigactl project), not a rip of its client code.
+"""
+
+from __future__ import annotations
+
+import socket
+
+from .client import ExecResult, VolumeFlush, join_path
+from .errors import AmigaError
+from .roster import address
+
+__all__ = ["AmigaCtl", "AmigaError", "ExecResult", "join_path"]  # the old addresses still deliver
+
+ENCODING = "iso-8859-1"
+CHUNK_SIZE = 4096
+MAX_LINE = 4096
+
+
+class AmigaCtl(VolumeFlush):
+    def __init__(self, host: str, port: int = 6800, timeout: float = 30.0):
+        self.host = host
+        self.port = port
+        self.timeout = timeout
+        self._sock: socket.socket | None = None
+        self._buf = b""
+        self.banner = ""
+
+    def connect(self) -> None:
+        self.close()
+        try:
+            self._sock = socket.create_connection((address(self.host), self.port), self.timeout)
+            self.banner = self._line()
+        except OSError as e:
+            self.close()
+            raise AmigaError(f"cannot reach amigactld at {self.host}:{self.port}: {e}") from e
+        if not self.banner.startswith("AMIGACTL "):
+            banner, self.banner = self.banner, ""
+            self.close()
+            raise AmigaError(f"unexpected banner: {banner!r}")
+
+    def close(self) -> None:
+        if self._sock:
+            self._sock.close()
+        self._sock = None
+        self._buf = b""
+
+    # framing
+
+    def _recv(self) -> None:
+        assert self._sock
+        data = self._sock.recv(65536)
+        if not data:
+            raise AmigaError("connection closed by daemon")
+        self._buf += data
+
+    def _line(self) -> str:
+        while b"\n" not in self._buf:
+            self._recv()
+        raw, self._buf = self._buf.split(b"\n", 1)
+        return raw.rstrip(b"\r").decode(ENCODING)
+
+    def _exact(self, n: int) -> bytes:
+        while len(self._buf) < n:
+            self._recv()
+        data, self._buf = self._buf[:n], self._buf[n:]
+        return data
+
+    def _send_line(self, line: str) -> None:
+        raw = line.encode(ENCODING) + b"\n"
+        if len(raw) - 1 > MAX_LINE or "\n" in line:
+            raise AmigaError("command line too long or contains a newline")
+        if not self._sock:
+            self.connect()
+        assert self._sock
+        self._sock.sendall(raw)
+
+    def _status(self, line: str) -> str:
+        """The info field of an OK line; on ERR eat the sentinel and raise."""
+        if line == "OK" or line.startswith("OK "):
+            return line[3:]
+        if line.startswith("ERR "):
+            parts = line.split(" ", 2)
+            self._line()  # sentinel
+            code = int(parts[1]) if parts[1].isdigit() else None
+            raise AmigaError(parts[2] if len(parts) > 2 else line, code)
+        raise AmigaError(f"malformed response: {line!r}")
+
+    def _text(self, command: str, *extra_lines: str) -> tuple[str, list[str]]:
+        """Run a command whose answer is dot-stuffed lines, SMTP style, ended by '.'."""
+        self._send_line(command)
+        for line in extra_lines:
+            self._send_line(line)
+        info = self._status(self._line())
+        lines = []
+        while True:
+            line = self._line()
+            if line == ".":
+                return info, lines
+            lines.append(line[1:] if line.startswith("..") else line)
+
+    def _binary(self, command: str, timeout: float | None = None) -> tuple[str, bytes]:
+        """Run a command whose answer comes in DATA chunks until END."""
+        self._send_line(command)
+        assert self._sock
+        self._sock.settimeout(timeout if timeout is not None else self.timeout)
+        try:
+            info = self._status(self._line())
+            chunks = []
+            while True:
+                line = self._line()
+                if line == "END":
+                    break
+                if not line.startswith("DATA "):
+                    raise AmigaError(f"malformed chunk header: {line!r}")
+                chunks.append(self._exact(int(line[5:])))
+            if self._line() != ".":
+                raise AmigaError("missing sentinel")
+            return info, b"".join(chunks)
+        finally:
+            if self._sock:
+                self._sock.settimeout(self.timeout)
+
+    # files
+
+    def list_dir(self, path: str, recursive: bool = False) -> list[dict]:
+        _, lines = self._text(f"DIR {path}" + (" RECURSIVE" if recursive else ""))
+        entries = []
+        for line in lines:
+            kind, name, size, protection, stamp = line.split("\t")
+            entries.append(
+                {"type": kind, "name": name, "size": int(size), "protection": protection, "date": stamp}
+            )
+        return entries
+
+    def stat(self, path: str) -> dict:
+        _, lines = self._text(f"STAT {path}")
+        return dict(line.split("=", 1) for line in lines)
+
+    def read_file(self, path: str) -> bytes:
+        return self._binary(f"READ {path}")[1]
+
+    def write_file(self, path: str, data: bytes, append: bool = False) -> None:
+        self._send_line(f"{'APPEND' if append else 'WRITE'} {path} {len(data)}")
+        line = self._line()
+        if line != "READY":
+            self._status(line)
+            raise AmigaError(f"expected READY, got {line!r}")
+        assert self._sock
+        for i in range(0, len(data), CHUNK_SIZE):
+            chunk = data[i : i + CHUNK_SIZE]
+            self._sock.sendall(f"DATA {len(chunk)}\n".encode() + chunk)
+        self._sock.sendall(b"END\n")
+        self._status(self._line())
+        if self._line() != ".":
+            raise AmigaError("missing sentinel")
+
+    def checksum(self, path: str, size: int = 0) -> int:  # size: AmigaChannel uses it for patience
+        return int(dict(line.split("=", 1) for line in self._text(f"CHECKSUM {path}")[1])["crc32"], 16)
+
+    def delete(self, path: str) -> None:
+        self._text(f"DELETE {path}")
+
+    def rename(self, old: str, new: str) -> None:
+        self._text("RENAME", old, new)
+
+    def copy(self, source: str, dest: str) -> None:
+        self._text("COPY", source, dest)
+
+    def makedir(self, path: str) -> None:
+        self._text(f"MAKEDIR {path}")
+
+    # commands
+
+    def exec(self, command: str, cd: str | None = None, timeout: float | None = None) -> ExecResult:
+        """Run synchronously. The daemon is single-tasking here: everyone waits till it returns."""
+        prefix = f"CD={cd} " if cd else ""
+        info, data = self._binary(f"EXEC {prefix}{command}", timeout)
+        return ExecResult(int(info.split("=", 1)[1]), data.decode(ENCODING))
+
+    def exec_async(self, command: str) -> int:
+        """Fire and forget, no output captured; returns the daemon's process id."""
+        return int(self._text(f"EXEC ASYNC {command}")[0])
+
+    # system state
+
+    def sysinfo(self) -> dict:
+        _, lines = self._text("SYSINFO")
+        return dict(line.split("=", 1) for line in lines)
+
+    def volumes(self) -> list[dict]:
+        _, lines = self._text("VOLUMES")
+        keys = ("name", "used", "free", "capacity", "blocksize")
+        return [
+            {k: (v if k == "name" else int(v)) for k, v in zip(keys, line.split("\t"))}
+            for line in lines
+        ]