automify 0.1.1 → 0.1.3

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm version](https://img.shields.io/npm/v/automify.svg)](https://www.npmjs.com/package/automify)
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18.18-brightgreen.svg)](https://nodejs.org/)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20.12.2-brightgreen.svg)](https://nodejs.org/)
 
 `Automify` is a Node.js library for AI computer use and command use across web apps, terminals, native desktops, Docker CLI sandboxes, and Docker-backed Linux desktops.
 
@@ -48,7 +48,15 @@ Chromium is installed by the package `postinstall` script. Skip it with:
 AUTOMIFY_SKIP_BROWSER_INSTALL=1 npm install automify
 ```
 
-Requirements: Node.js `18.18+` and a provider config. OpenAI examples use `gpt-5.5`.
+Requirements: Node.js `20.12.2+` and a provider config. OpenAI examples use `gpt-5.5`.
+
+Automify is published as an ES module package, so the examples use modern `import` syntax:
+
+```js
+import { initAutomify } from "automify";
+```
+
+Use this from an ES module project (`"type": "module"` in `package.json`) or from `.mjs` files. In CommonJS projects, use dynamic `import()` from your `require`-based files instead.
 
 Zod support is optional. Install Zod only if you want to build structured outputs from Zod schemas:
 
@@ -190,10 +198,10 @@ try {
 
 ### Desktop Computer Use
 
-Local desktop computer use is optional because OS control needs permissions:
+Local desktop computer use is optional. Install it with the command below; it may take a while because it compiles native desktop dependencies. When you use the local desktop adapter, your OS may ask for permission to control the desktop.
 
 ```bash
-npm run install:desktop
+npx automify-install-desktop
 ```
 
 ```js

package/examples/custom-computer.js

@@ -1,6 +1,6 @@
 import { createLocalDesktopComputer, initAutomify } from "../src/index.js";
 
-// Run `npm run install:desktop` once before using createLocalDesktopComputer().
+// Run `npx automify-install-desktop` once before using createLocalDesktopComputer().
 const automify = initAutomify({
   provider: {
     type: "openai",

package/examples/desktop-local.js

@@ -3,7 +3,7 @@ import { tmpdir } from "node:os";
 
 import { createLocalDesktopComputer, initAutomify } from "../src/index.js";
 
-// Run `npm run install:desktop` once before using createLocalDesktopComputer().
+// Run `npx automify-install-desktop` once before using createLocalDesktopComputer().
 const automify = initAutomify({
   provider: {
     type: "openai",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "automify",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "AI computer use for browser, CLI, and desktop in Node.js.",
   "homepage": "https://aldovincenti.github.io/automify",
   "bugs": {
@@ -13,6 +13,9 @@
   "type": "module",
   "main": "src/index.js",
   "types": "src/index.d.ts",
+  "bin": {
+    "automify-install-desktop": "./scripts/install-desktop.js"
+  },
   "exports": {
     ".": {
       "types": "./src/index.d.ts",
@@ -43,7 +46,7 @@
     "format:check": "prettier --check ."
   },
   "dependencies": {
-    "jimp": "^0.22.10",
+    "jimp": "^1.6.1",
     "playwright": ">=1.40.0"
   },
   "peerDependencies": {
@@ -55,7 +58,7 @@
     }
   },
   "engines": {
-    "node": ">=18.18"
+    "node": ">=20.12.2"
   },
   "keywords": [
     "automation",

package/scripts/install-desktop.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { spawnSync } from "node:child_process";
 import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
@@ -23,7 +24,7 @@ const platformPackageDir = join(nutScope, `libnut-${process.platform}`);
 const macPermissionsPackageDir = join(nutScope, "node-mac-permissions");
 
 const runtimeDependencies = [
-  "jimp@0.22.10",
+  "jimp@1.6.1",
   "node-abort-controller@3.1.1",
   "clipboardy@2.3.0",
   "bindings@1.5.0"
@@ -123,7 +124,7 @@ function checkBuildPrerequisites() {
   if (missing.length === 0) return;
 
   console.error(`Missing required desktop build tool(s): ${missing.join(", ")}`);
-  console.error("Install the native build prerequisites, then rerun: npm run install:desktop");
+  console.error("Install the native build prerequisites, then rerun: npx automify-install-desktop");
 
   if (process.platform === "darwin") {
     console.error("macOS: install Xcode Command Line Tools with `xcode-select --install` and install CMake.");

package/src/lib/automify.js

@@ -715,10 +715,10 @@ async function resizeScreenshot(screenshot, target, options, automify) {
   }
 
   try {
-    const { default: Jimp } = await import("jimp");
+    const { Jimp, JimpMime } = await import("jimp");
     const image = await Jimp.read(Buffer.from(screenshot));
-    image.resize(target.width, target.height);
-    return image.getBufferAsync(Jimp.MIME_PNG);
+    image.resize({ w: target.width, h: target.height });
+    return image.getBuffer(JimpMime.png);
   } catch (error) {
     debugLog(automify.debug, "automify", "screenshot_resize_skipped", {
       reason: error?.message,

package/src/lib/local-desktop-computer.js

@@ -432,7 +432,7 @@ async function importNut() {
     return await import("@nut-tree/nut-js");
   } catch (error) {
     throw new AutomifyError(
-      "createLocalDesktopComputer requires the local desktop adapter dependency built from source. Install it with: npm run install:desktop",
+      "createLocalDesktopComputer requires the local desktop adapter dependency built from source. Install it with: npx automify-install-desktop",
       { cause: error }
     );
   }