automify 0.2.0 → 0.3.1

package/src/index.js

@@ -1,18 +1,9 @@
-export {
-  Automify,
-  createAutomify,
-  AutomifyError,
-  SafetyCheckError,
-  MaxStepsExceededError
-} from "./lib/automify.js";
+export { Automify, createAutomify, AutomifyError, SafetyCheckError, MaxStepsExceededError } from "./lib/automify.js";
+export { AutomifyTask, createTask } from "./lib/task.js";
 
 export { OpenAIResponsesClient } from "./lib/openai-responses-client.js";
 export { AnthropicModelAdapter, createAnthropicModelAdapter } from "./lib/anthropic-model-adapter.js";
-export {
-  createBrowserComputer,
-  createPlaywrightComputer,
-  executePlaywrightAction
-} from "./lib/playwright-computer.js";
+export { createBrowserComputer, createPlaywrightComputer, executePlaywrightAction } from "./lib/playwright-computer.js";
 export {
   captureLocalDesktopScreenshot,
   createLocalDesktopComputer,
@@ -20,19 +11,16 @@ export {
 } from "./lib/local-desktop-computer.js";
 export {
   DockerDesktopSession,
-  DockerVirtualDesktopSession,
   createDockerDesktopComputer,
-  createVirtualDesktopComputer,
   defaultDockerDesktopImage,
-  defaultVirtualDesktopImage,
-  dockerDesktopDockerfile,
-  virtualDesktopDockerfile
+  dockerDesktopDockerfile
 } from "./lib/docker-desktop-computer.js";
 export {
-  BrowserAutomify,
-  createBrowserAutomify,
-  withBrowserAutomify
-} from "./lib/browser-automify.js";
+  QemuDesktopSession,
+  createVirtualDesktopComputer,
+  defaultVirtualDesktopImage
+} from "./lib/qemu-desktop-computer.js";
+export { BrowserAutomify, createBrowserAutomify, withBrowserAutomify } from "./lib/browser-automify.js";
 export { initAutomify } from "./lib/init.js";
 export { createModelAdapter } from "./lib/model-adapter.js";
 export {
@@ -57,27 +45,19 @@ export { jsonOutput } from "./lib/output.js";
 export {
   DockerComputerAutomify,
   LocalComputerAutomify,
+  VirtualComputerAutomify,
   createComputerAutomify,
   createDockerComputerAutomify,
-  createLocalComputerAutomify
+  createLocalComputerAutomify,
+  createVirtualComputerAutomify
 } from "./lib/computer-automify.js";
+export { CliAutomify, createCliAutomify, runShellCommand } from "./lib/cli-automify.js";
+export { DockerCliAutomify, DockerCliSession, createDockerCliAutomify } from "./lib/docker-cli-automify.js";
 export {
-  CliAutomify,
-  createCliAutomify,
-  runShellCommand
-} from "./lib/cli-automify.js";
-export {
-  DockerCliAutomify,
-  DockerCliSession,
-  createDockerCliAutomify,
-  DockerVirtualCliSession,
+  QemuCliSession,
+  QemuVirtualCliSession,
   VirtualCliAutomify,
   createVirtualCliAutomify
-} from "./lib/docker-cli-automify.js";
-export {
-  fileToEvaluate,
-  fileToData,
-  filesToEvaluate,
-  filesToData
-} from "./lib/file-data.js";
+} from "./lib/qemu-cli-automify.js";
+export { fileToEvaluate, fileToData, filesToEvaluate, filesToData } from "./lib/file-data.js";
 export { argumentReference } from "./lib/argument-reference.js";

package/src/lib/adapter-toolkit.js

@@ -34,10 +34,14 @@ export function computerCall(action, options = {}) {
 export function runCommandCall(command, options = {}) {
   const callId = options.callId ?? options.call_id ?? `call_${Date.now()}`;
 
-  return functionCall("run_command", { command, cwd: options.cwd, timeoutMs: options.timeoutMs }, {
-    ...withoutKeys(options, ["callId", "call_id", "cwd", "timeoutMs"]),
-    callId
-  });
+  return functionCall(
+    "run_command",
+    { command, cwd: options.cwd, timeoutMs: options.timeoutMs },
+    {
+      ...withoutKeys(options, ["callId", "call_id", "cwd", "timeoutMs"]),
+      callId
+    }
+  );
 }
 
 export function functionCall(name, args = {}, options = {}) {

package/src/lib/anthropic-model-adapter.js

@@ -75,12 +75,18 @@ export class AnthropicModelAdapter {
         ? await this.responseTransform(data, { payload, context, request: finalRequest })
         : data;
     const automifyResponse = this.#fromAnthropicResponse(finalData, context, payload);
-    const previous = payload.previous_response_id ? this.transcripts.get(payload.previous_response_id) ?? [] : [];
-    this.transcripts.set(automifyResponse.id, compactMessagesForStorage([
-      ...previous,
-      ...this.#userMessagesFromPayload(payload, context),
-      { role: "assistant", content: finalData.content ?? [] }
-    ], context));
+    const previous = payload.previous_response_id ? (this.transcripts.get(payload.previous_response_id) ?? []) : [];
+    this.transcripts.set(
+      automifyResponse.id,
+      compactMessagesForStorage(
+        [
+          ...previous,
+          ...this.#userMessagesFromPayload(payload, context),
+          { role: "assistant", content: finalData.content ?? [] }
+        ],
+        context
+      )
+    );
 
     return automifyResponse;
   }
@@ -100,8 +106,11 @@ export class AnthropicModelAdapter {
   }
 
   async #toAnthropicRequest(payload, context) {
-    const previous = payload.previous_response_id ? this.transcripts.get(payload.previous_response_id) ?? [] : [];
-    const messages = compactMessagesForRequest([...previous, ...this.#userMessagesFromPayload(payload, context)], context);
+    const previous = payload.previous_response_id ? (this.transcripts.get(payload.previous_response_id) ?? []) : [];
+    const messages = compactMessagesForRequest(
+      [...previous, ...this.#userMessagesFromPayload(payload, context)],
+      context
+    );
     const tools = this.#toolsFromPayload(payload);
 
     return removeUndefined({
@@ -204,11 +213,13 @@ export class AnthropicModelAdapter {
 
       if (item.type === "tool_use") {
         if (item.name === "run_command") {
-          output.push(runCommandCall(item.input?.command ?? "", {
-            callId: item.id,
-            cwd: item.input?.cwd,
-            timeoutMs: item.input?.timeoutMs
-          }));
+          output.push(
+            runCommandCall(item.input?.command ?? "", {
+              callId: item.id,
+              cwd: item.input?.cwd,
+              timeoutMs: item.input?.timeoutMs
+            })
+          );
         } else if (item.name === "computer") {
           output.push(computerCall(mapAnthropicComputerAction(item.input), { callId: item.id }));
         } else {

package/src/lib/argument-reference.js

@@ -11,10 +11,11 @@ export const argumentReference = [
       "hooks",
       "screenshots",
       "screenshot",
+      "recording",
       "command"
     ],
     notes:
-      "Use data for structured JSON, evaluate for files the model should inspect directly, limits.steps to change the max model-action turns, and command only on CLI surfaces."
+      "Use data for structured JSON, evaluate for files the model should inspect directly, limits.steps to change the max model-action turns, recording to save visual runs with ffmpeg, and command only on CLI surfaces."
   },
   {
     surface: "automify.browser()",
@@ -51,7 +52,24 @@ export const argumentReference = [
       "logFile"
     ],
     notes:
-      'Requires Docker to be installed and running. Use additionalAptPackages to apt-install Debian packages before commands run. Use preset: "repo" to mount the current workspace at /workspace and allow common repo commands. Use logFile to capture CLI and Docker container events.'
+      'Requires Docker to be installed and running. Use additionalAptPackages to apt-install packages before commands run. Use preset: "repo" to mount the current workspace at /workspace and allow common repo commands. Use logFile to capture CLI and Docker container events.'
+  },
+  {
+    surface: "automify.virtualCli()",
+    preferred: [
+      "preset",
+      "vm",
+      "ssh",
+      "defaultImageCache",
+      "additionalAptPackages",
+      "workdir",
+      "shared",
+      "sharedFiles",
+      "command",
+      "logFile"
+    ],
+    notes:
+      'Creates a QEMU-backed CLI runner. Without image or vm.image, Automify uses the prepared Debian image cache by default; use defaultImageCache to configure or refresh that cache. Use preset: "repo" to expose the current workspace at /workspace.'
   },
   {
     surface: "automify.dockerComputer()",
@@ -66,19 +84,36 @@ export const argumentReference = [
       "logFile"
     ],
     notes:
-      "Creates a Docker-backed Linux desktop runner and requires Docker to be installed and running. Pass startupCommand or desktop.startupCommand to launch the initial app. Use additionalAptPackages to apt-install extra Debian packages. Use logFile to capture automation and Docker desktop events. Explicit container names are locked per name until close()."
+      "Creates a Docker-backed Linux desktop runner and requires Docker to be installed and running. Pass startupCommand or desktop.startupCommand to launch the initial app. Use additionalAptPackages to apt-install extra packages. Use logFile to capture automation and Docker desktop events. Explicit container names are locked per name until close()."
+  },
+  {
+    surface: "automify.virtualComputer()",
+    preferred: [
+      "preset",
+      "vm",
+      "ssh",
+      "viewport",
+      "desktop",
+      "defaultImageCache",
+      "additionalAptPackages",
+      "shared",
+      "sharedFiles",
+      "logFile"
+    ],
+    notes:
+      "Creates a QEMU-backed Linux desktop runner. Without image or vm.image, Automify uses the prepared Debian image cache by default. Pass startupCommand or desktop.startupCommand to launch the initial app; the guest runs Xvfb/openbox/xdotool/scrot over SSH."
   },
   {
     surface: "automify.localComputer()",
-    preferred: ["viewport", "mouse", "keyboard", "calibration", "virtualDisplay", "logFile"],
+    preferred: ["viewport", "mouse", "keyboard", "calibration", "virtualDisplay", "lockResource", "logFile"],
     notes:
-      "Creates a local desktop runner and takes an exclusive cross-process lock until close(). Linux local desktop requires X11/Xorg or Xvfb; Wayland is not supported. Use logFile to capture automation and local desktop events."
+      "Creates a local desktop runner and takes an exclusive cross-process lock until close(). Linux local desktop requires X11/Xorg or Xvfb; Wayland is not supported. Use lockResource only for independent desktop sessions or isolated tests. Use logFile to capture automation and local desktop events."
   },
   {
     surface: "createLocalDesktopComputer()",
-    preferred: ["viewport", "mouse", "keyboard", "calibration", "virtualDisplay", "logFile"],
+    preferred: ["viewport", "mouse", "keyboard", "calibration", "virtualDisplay", "lockResource", "logFile"],
     notes:
-      "Grouped mouse, keyboard, and calibration options are preferred over the older flat names. Linux local desktop requires X11/Xorg or Xvfb; Wayland is not supported. Use logFile to capture local desktop events. Local desktop control takes an exclusive cross-process lock until close()."
+      "Grouped mouse, keyboard, and calibration options are preferred over the older flat names. Linux local desktop requires X11/Xorg or Xvfb; Wayland is not supported. Local desktop control takes an exclusive cross-process lock until close(); use lockResource only for independent desktop sessions or isolated tests. Use logFile to capture local desktop events."
   },
   {
     surface: "createDockerDesktopComputer()",
@@ -93,6 +128,23 @@ export const argumentReference = [
       "logFile"
     ],
     notes:
-      "Requires Docker to be installed and running. container controls Docker and resource limits; startupCommand or desktop.startupCommand is required; shared/sharedFiles control host file access. Use additionalAptPackages to apt-install extra Debian packages and logFile to capture Docker desktop events."
+      "Requires Docker to be installed and running. container controls Docker and resource limits; startupCommand or desktop.startupCommand is required; shared/sharedFiles control host file access. Use additionalAptPackages to apt-install extra packages and logFile to capture Docker desktop events."
+  },
+  {
+    surface: "createVirtualDesktopComputer()",
+    preferred: [
+      "preset",
+      "vm",
+      "ssh",
+      "viewport",
+      "desktop",
+      "defaultImageCache",
+      "additionalAptPackages",
+      "shared",
+      "sharedFiles",
+      "logFile"
+    ],
+    notes:
+      "Requires QEMU. Without image or vm.image, Automify uses the prepared Debian image cache by default. vm controls QEMU, custom images, resources, acceleration, and cache configuration; ssh controls login for custom images; startupCommand or desktop.startupCommand is required."
   }
 ];

package/src/lib/automify.js

@@ -6,6 +6,8 @@ import { OpenAIResponsesClient } from "./openai-responses-client.js";
 import { toDataUrl } from "./adapter-toolkit.js";
 import { filesToEvaluate } from "./file-data.js";
 import { buildRunResult, buildTextConfig } from "./result.js";
+import { startScreenRecording } from "./screen-recording.js";
+import { createTask } from "./task.js";
 import {
   callHook,
   debugLog,
@@ -58,6 +60,7 @@ export class Automify {
       initialScreenshot,
       finalScreenshot,
       actionScreenshots,
+      screenRecording,
       trace,
       silent,
       debug,
@@ -87,6 +90,7 @@ export class Automify {
     this.initialScreenshot = initialScreenshot;
     this.finalScreenshot = finalScreenshot;
     this.actionScreenshots = actionScreenshots;
+    this.screenRecording = screenRecording;
     this.trace = trace;
     this.silent = silent;
     this.debug = debug;
@@ -103,6 +107,7 @@ export class Automify {
     const { data, options } = normalizeDoArguments(runOptions, maybeOptions);
     const previousSilent = this.silent;
     if ("silent" in options) this.silent = options.silent;
+    let screenRecording = null;
 
     try {
       const maxSteps = options.maxSteps ?? this.maxSteps;
@@ -120,12 +125,14 @@ export class Automify {
       const initialScreenshotPath = initialScreenshotPathFor(options, this);
       const finalScreenshotPath = finalScreenshotPathFor(options, this);
       const actionScreenshotsPath = actionScreenshotsPathFor(options, this);
+      const screenRecordingPath = screenRecordingPathFor(options, this);
       this.#debug("run_start", {
         model,
         maxSteps,
         initialScreenshot: initialScreenshotPath ?? null,
         finalScreenshot: finalScreenshotPath ?? null,
         actionScreenshots: actionScreenshotsPath ?? null,
+        screenRecording: screenRecordingPath ?? null,
         screenshotDetail: screenshotDetailFor(options, this),
         screenshotMaxWidth: screenshotMaxWidthFor(options, this),
         screenshotMaxHeight: screenshotMaxHeightFor(options, this)
@@ -137,10 +144,12 @@ export class Automify {
         initialScreenshot: initialScreenshotPath ?? null,
         finalScreenshot: finalScreenshotPath ?? null,
         actionScreenshots: actionScreenshotsPath ?? null,
+        screenRecording: screenRecordingPath ?? null,
         screenshotDetail: screenshotDetailFor(options, this)
       });
 
       await this.#assertAllowedCurrentUrl(options);
+      screenRecording = await this.#startScreenRecording({ instruction, data }, options, trace);
 
       const initial = await this.#initialInput(
         instruction,
@@ -173,6 +182,8 @@ export class Automify {
           const result = buildRunResult(response, steps, options.output);
           const finalScreenshot = await this.#saveFinalScreenshot({ response, steps }, options, trace);
           if (finalScreenshot) result.finalScreenshot = finalScreenshot;
+          const recording = await this.#stopScreenRecording(screenRecording, { response, steps }, trace);
+          if (recording) result.recording = recording;
           if (traceEnabled) result.trace = traceEvents;
           await this.#complete(result, { instruction, data }, options);
           return result;
@@ -357,10 +368,49 @@ export class Automify {
 
       throw new MaxStepsExceededError(maxSteps);
     } finally {
+      await this.#stopScreenRecording(screenRecording, { discarded: true }).catch((error) => {
+        this.#debug("recording_stop_failed", { reason: error?.message });
+      });
       this.silent = previousSilent;
     }
   }
 
+  task(options = {}) {
+    return createTask(this, options);
+  }
+
+  addStep(instruction, options = {}) {
+    return this.task().addStep(instruction, options);
+  }
+
+  addAct(instruction, options = {}) {
+    return this.task().addAct(instruction, options);
+  }
+
+  addWait(conditionOrMs, options = {}) {
+    return this.task().addWait(conditionOrMs, options);
+  }
+
+  addWaitFor(condition, options = {}) {
+    return this.task().addWaitFor(condition, options);
+  }
+
+  addPause(ms, options = {}) {
+    return this.task().addPause(ms, options);
+  }
+
+  addObserve(instruction, options = {}) {
+    return this.task().addObserve(instruction, options);
+  }
+
+  addExtract(instruction, options = {}) {
+    return this.task().addExtract(instruction, options);
+  }
+
+  addAssert(instruction, options = {}) {
+    return this.task().addAssert(instruction, options);
+  }
+
   async #initialInput(instruction, data, options, trace) {
     const content = [{ type: "input_text", text: formatInstruction(instruction, data, this.computer, options) }];
     content.push(...(await evaluationContentFor(options.filesToEvaluate)));
@@ -494,6 +544,41 @@ export class Automify {
     return this.#redactScreenshot(screenshot, context, options);
   }
 
+  async #startScreenRecording(context, options, trace) {
+    const screenRecording = screenRecordingFor(options, this);
+    if (!screenRecording) return null;
+
+    const recording = await startScreenRecording(screenRecording, {
+      ...context,
+      captureFrame: (frameContext) => this.#captureRawScreenshot(frameContext, options)
+    });
+    this.#debug("recording_start", {
+      path: recording.path,
+      framesDir: recording.framesDir,
+      fps: recording.fps
+    });
+    trace?.({
+      type: "recording_start",
+      path: recording.path,
+      fps: recording.fps
+    });
+    return recording;
+  }
+
+  async #stopScreenRecording(recording, context, trace) {
+    if (!recording || recording.stopped) return null;
+    recording.stopped = true;
+    const result = await recording.stop(context);
+    if (!result) return null;
+
+    this.#debug("recording_stop", result);
+    trace?.({
+      type: "recording_stop",
+      ...result
+    });
+    return result;
+  }
+
   #computerTool(options) {
     return cleanUndefined({
       type: "computer",
@@ -813,6 +898,17 @@ function actionScreenshotsPathFor(options, automify) {
   return resolveScreenshotPath(options.actionScreenshots ?? automify.actionScreenshots);
 }
 
+function screenRecordingFor(options, automify) {
+  return options.screenRecording ?? automify.screenRecording;
+}
+
+function screenRecordingPathFor(options, automify) {
+  const recording = screenRecordingFor(options, automify);
+  if (typeof recording === "string") return recording;
+  if (recording && typeof recording === "object" && typeof recording.path === "string") return recording.path;
+  return null;
+}
+
 function resolveScreenshotPath(value) {
   return typeof value === "string" && value.length > 0 ? value : null;
 }

package/src/lib/cli-automify.js

@@ -4,6 +4,7 @@ import { OpenAIResponsesClient } from "./openai-responses-client.js";
 import { filesToEvaluate } from "./file-data.js";
 import { applyCliPreset } from "./presets.js";
 import { buildRunResult, buildTextConfig } from "./result.js";
+import { createTask } from "./task.js";
 import {
   AUTOMIFY_OPTION_KEYS,
   COMMAND_OPTION_KEYS,
@@ -188,7 +189,7 @@ export class CliAutomify {
               role: "user",
               content: [
                 { type: "input_text", text: formatCliInstruction(instruction, data, options.cwd ?? this.cwd) },
-                ...await evaluationContentFor(options.filesToEvaluate)
+                ...(await evaluationContentFor(options.filesToEvaluate))
               ]
             }
           ],
@@ -292,6 +293,42 @@ export class CliAutomify {
     }
   }
 
+  task(options = {}) {
+    return createTask(this, options);
+  }
+
+  addStep(instruction, options = {}) {
+    return this.task().addStep(instruction, options);
+  }
+
+  addAct(instruction, options = {}) {
+    return this.task().addAct(instruction, options);
+  }
+
+  addWait(conditionOrMs, options = {}) {
+    return this.task().addWait(conditionOrMs, options);
+  }
+
+  addWaitFor(condition, options = {}) {
+    return this.task().addWaitFor(condition, options);
+  }
+
+  addPause(ms, options = {}) {
+    return this.task().addPause(ms, options);
+  }
+
+  addObserve(instruction, options = {}) {
+    return this.task().addObserve(instruction, options);
+  }
+
+  addExtract(instruction, options = {}) {
+    return this.task().addExtract(instruction, options);
+  }
+
+  addAssert(instruction, options = {}) {
+    return this.task().addAssert(instruction, options);
+  }
+
   async #confirm(command, call, response, options) {
     const approval = options.approval ?? this.approval;
     if (approval === "never") return;
@@ -360,7 +397,9 @@ function cliInstructions(options) {
         "After a command changes files, runs tests, or produces the requested result, decide from its output whether another command is necessary. Stop when the task is complete and return a concise summary instead of calling more tools."
       ].join("\n"),
     commandPolicyGuidance(options)
-  ].filter(Boolean).join("\n\n");
+  ]
+    .filter(Boolean)
+    .join("\n\n");
 }
 
 function assertModel(model) {

package/src/lib/computer-automify.js

@@ -1,26 +1,14 @@
 import { Automify, createAutomify } from "./automify.js";
-import {
-  createDockerDesktopComputer,
-  DOCKER_DESKTOP_COMPUTER_OPTION_KEYS
-} from "./docker-desktop-computer.js";
-import {
-  createLocalDesktopComputer,
-  LOCAL_DESKTOP_COMPUTER_OPTION_KEYS
-} from "./local-desktop-computer.js";
-import {
-  AUTOMIFY_OPTION_KEYS,
-  assertKnownOptions,
-  mergeOptionKeys,
-  pickKnownOptions
-} from "./runtime.js";
+import { createDockerDesktopComputer, DOCKER_DESKTOP_COMPUTER_OPTION_KEYS } from "./docker-desktop-computer.js";
+import { createVirtualDesktopComputer, VIRTUAL_DESKTOP_COMPUTER_OPTION_KEYS } from "./qemu-desktop-computer.js";
+import { createLocalDesktopComputer, LOCAL_DESKTOP_COMPUTER_OPTION_KEYS } from "./local-desktop-computer.js";
+import { AUTOMIFY_OPTION_KEYS, assertKnownOptions, mergeOptionKeys, pickKnownOptions } from "./runtime.js";
 
-const DOCKER_COMPUTER_AUTOMIFY_OPTION_KEYS = mergeOptionKeys(
-  AUTOMIFY_OPTION_KEYS,
-  DOCKER_DESKTOP_COMPUTER_OPTION_KEYS
-);
-const LOCAL_COMPUTER_AUTOMIFY_OPTION_KEYS = mergeOptionKeys(
+const DOCKER_COMPUTER_AUTOMIFY_OPTION_KEYS = mergeOptionKeys(AUTOMIFY_OPTION_KEYS, DOCKER_DESKTOP_COMPUTER_OPTION_KEYS);
+const LOCAL_COMPUTER_AUTOMIFY_OPTION_KEYS = mergeOptionKeys(AUTOMIFY_OPTION_KEYS, LOCAL_DESKTOP_COMPUTER_OPTION_KEYS);
+const VIRTUAL_COMPUTER_AUTOMIFY_OPTION_KEYS = mergeOptionKeys(
   AUTOMIFY_OPTION_KEYS,
-  LOCAL_DESKTOP_COMPUTER_OPTION_KEYS
+  VIRTUAL_DESKTOP_COMPUTER_OPTION_KEYS
 );
 
 export function createComputerAutomify(options = {}) {
@@ -33,9 +21,9 @@ export function createComputerAutomify(options = {}) {
 export async function createDockerComputerAutomify(options = {}) {
   assertKnownOptions("Docker computer adapter", options, DOCKER_COMPUTER_AUTOMIFY_OPTION_KEYS);
   const usesProvidedComputer = Boolean(options.computer);
-  const computer = options.computer ?? (await createDockerDesktopComputer(
-    pickKnownOptions(options, DOCKER_DESKTOP_COMPUTER_OPTION_KEYS)
-  ));
+  const computer =
+    options.computer ??
+    (await createDockerDesktopComputer(pickKnownOptions(options, DOCKER_DESKTOP_COMPUTER_OPTION_KEYS)));
   const automifyOptions = pickKnownOptions(options, AUTOMIFY_OPTION_KEYS);
   if (!usesProvidedComputer) {
     delete automifyOptions.instructions;
@@ -47,12 +35,29 @@ export async function createDockerComputerAutomify(options = {}) {
   });
 }
 
+export async function createVirtualComputerAutomify(options = {}) {
+  assertKnownOptions("QEMU virtual computer adapter", options, VIRTUAL_COMPUTER_AUTOMIFY_OPTION_KEYS);
+  const usesProvidedComputer = Boolean(options.computer);
+  const computer =
+    options.computer ??
+    (await createVirtualDesktopComputer(pickKnownOptions(options, VIRTUAL_DESKTOP_COMPUTER_OPTION_KEYS)));
+  const automifyOptions = pickKnownOptions(options, AUTOMIFY_OPTION_KEYS);
+  if (!usesProvidedComputer) {
+    delete automifyOptions.instructions;
+  }
+
+  return new VirtualComputerAutomify({
+    ...automifyOptions,
+    computer
+  });
+}
+
 export async function createLocalComputerAutomify(options = {}) {
   assertKnownOptions("local computer adapter", options, LOCAL_COMPUTER_AUTOMIFY_OPTION_KEYS);
   const usesProvidedComputer = Boolean(options.computer);
-  const computer = options.computer ?? (await createLocalDesktopComputer(
-    pickKnownOptions(options, LOCAL_DESKTOP_COMPUTER_OPTION_KEYS)
-  ));
+  const computer =
+    options.computer ??
+    (await createLocalDesktopComputer(pickKnownOptions(options, LOCAL_DESKTOP_COMPUTER_OPTION_KEYS)));
   const automifyOptions = pickKnownOptions(options, AUTOMIFY_OPTION_KEYS);
   if (!usesProvidedComputer) {
     delete automifyOptions.instructions;
@@ -91,6 +96,20 @@ export class DockerComputerAutomify extends Automify {
   }
 }
 
+export class VirtualComputerAutomify extends Automify {
+  constructor(options) {
+    super(pickKnownOptions(options, AUTOMIFY_OPTION_KEYS));
+    this.session = this.computer.session;
+    this.sharedFolder = this.computer.sharedFolder;
+  }
+
+  async close() {
+    if (typeof this.computer.close === "function") {
+      await this.computer.close();
+    }
+  }
+}
+
 function defaultComputerEnvironment() {
   switch (process.platform) {
     case "darwin":

package/src/lib/docker-cli-automify.js

@@ -20,7 +20,7 @@ const execFileAsync = promisify(execFile);
 const DEFAULT_IMAGE = "debian:bookworm-slim";
 const DEFAULT_CWD = "/workspace";
 const DEFAULT_TIMEOUT_MS = 30_000;
-const VIRTUAL_CLI_OPTION_KEYS = mergeOptionKeys(AUTOMIFY_OPTION_KEYS, [
+const DOCKER_CLI_OPTION_KEYS = mergeOptionKeys(AUTOMIFY_OPTION_KEYS, [
   "preset",
   "command",
   "commands",
@@ -297,12 +297,8 @@ export class DockerCliSession {
   }
 }
 
-export const createVirtualCliAutomify = createDockerCliAutomify;
-export const VirtualCliAutomify = DockerCliAutomify;
-export const DockerVirtualCliSession = DockerCliSession;
-
 function normalizeVirtualCliOptions(options = {}) {
-  assertKnownOptions("Docker CLI adapter", options, VIRTUAL_CLI_OPTION_KEYS);
+  assertKnownOptions("Docker CLI adapter", options, DOCKER_CLI_OPTION_KEYS);
   assertKnownOptions("Docker CLI container", options.container, CONTAINER_OPTION_KEYS);
   options = applyDockerCliPreset(options);
   const container = options.container ?? {};