Download

File transfer verbs

Move files between the cloud container and the laptop (streamed, SHA-verified).

Part of the Adom Desktop verb reference. Invoke as adom-desktop <verb> '<json>'.

pull_file

Pull files from the desktop back to Docker. Streams as binary WS frames (1 MiB chunks) — works for files up to several hundred MB. The legacy 30s base64-JSON path is gone; pull_file v1.4.3+ has no practical size limit.

Args:

  • filePaths — required array of absolute Windows paths (e.g. "C:\Users\me\Downloads\big.pdf")
  • saveTo — optional directory on Docker (default /tmp). Created if missing.

Returns: files: [{name, path, size, sha256, chunks}] — sha256 verified before file is finalized; mismatch deletes the partial and reports failure. chunks is the number of 1 MiB binary frames received.

Note: Per-file timeout is 600s (enough for ~600 MB at 1 MB/s). For 75 MB files expect ~12s on a typical home connection. errors[] is included alongside files[] when at least one but not all files succeed; success is true iff at least one file landed.

send_files

Send files from Docker container to the desktop

Args:

  • destinationFolder — optional relative subfolder
  • filePaths — required array of absolute paths
  • targetApp — optional: general|kicad|fusion360