aicomputer 0.1.22 → 0.2.0

package/package.json

@@ -1,47 +1,40 @@
 {
   "name": "aicomputer",
-  "version": "0.1.22",
-  "description": "Computer CLI - manage your Agent Computer machines from the terminal",
-  "homepage": "https://agentcomputer.ai",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "High-level TypeScript SDK for AgentComputer computers and execution workflows.",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/getcompanion-ai/agentcomputer.git"
+    "url": "git+https://github.com/getcompanion-ai/microagentcomputer.git",
+    "directory": "packages/agentcomputer"
   },
-  "bin": {
-    "aicomputer": "./dist/index.js",
-    "agentcomputer": "./dist/index.js",
-    "computer": "./dist/index.js"
+  "homepage": "https://agentcomputer.ai",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
-  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/lib/autossh-runtime.ts src/lib/mount-config.ts src/lib/mount-host.ts src/lib/mount-mutagen.ts src/lib/mount-reconcile.ts src/lib/mutagen-runtime.ts src/lib/ssh-access.ts src/lib/ssh-config.ts src/lib/upgrade-version.ts --format esm --dts",
-    "dev": "tsup src/index.ts src/lib/autossh-runtime.ts src/lib/mount-config.ts src/lib/mount-host.ts src/lib/mount-mutagen.ts src/lib/mount-reconcile.ts src/lib/mutagen-runtime.ts src/lib/ssh-access.ts src/lib/ssh-config.ts src/lib/upgrade-version.ts --format esm --watch",
-    "postinstall": "node ./scripts/postinstall.mjs",
-    "prepack": "npm run build",
-    "sync:nix": "../../scripts/cli/sync-nix-package.sh",
-    "test": "npm run build && node --test test/**/*.test.mjs",
-    "typecheck": "tsc --noEmit"
-  },
-  "files": [
-    "dist",
-    "scripts",
-    "package.json",
-    "README.md"
-  ],
-  "dependencies": {
-    "@inquirer/prompts": "^8.3.2",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "open": "^10.1.0",
-    "ora": "^8.0.1"
+    "build": "pnpm --filter @microagentcomputer/public-api-client build && tsup",
+    "typecheck": "pnpm --filter @microagentcomputer/public-api-client build && tsc --noEmit",
+    "typecheck:examples": "pnpm --filter @microagentcomputer/public-api-client build && tsc -p tsconfig.examples.json --noEmit",
+    "docs:generate": "pnpm --filter @microagentcomputer/public-api-client build && node ./scripts/generate-docs.mjs"
   },
+  "dependencies": {},
   "devDependencies": {
-    "@types/node": "^20.0.0",
+    "@microagentcomputer/public-api-client": "workspace:*",
     "tsup": "^8.0.0",
-    "typescript": "^5.9.3"
+    "typedoc": "^0.28.14",
+    "typescript": "5.9.3"
   }
 }

package/dist/chunk-3ZF7JRBW.js

@@ -1,270 +0,0 @@
-import {
-  resolveSystemCommandPath
-} from "./chunk-5Y2NWK5I.js";
-
-// src/lib/autossh-runtime.ts
-import { spawnSync } from "child_process";
-import { createHash } from "crypto";
-import {
-  chmodSync,
-  existsSync,
-  mkdirSync,
-  readdirSync,
-  renameSync,
-  rmSync
-} from "fs";
-import { writeFile } from "fs/promises";
-import { homedir } from "os";
-import { dirname, join } from "path";
-var BUNDLED_AUTOSSH_VERSION = "1.4f";
-var BUNDLED_AUTOSSH_DOWNLOAD_BASE = `https://github.com/Autossh/autossh/archive/refs/tags/v${BUNDLED_AUTOSSH_VERSION}.tar.gz`;
-var BUNDLED_AUTOSSH_ARCHIVE_SHA256 = "fce67ee6e8e032eb41eca984f7e16a6ea74f85c513d94f78e56656815c473604";
-var AGENTCOMPUTER_AUTOSSH_PATH_ENV = "AGENTCOMPUTER_AUTOSSH_PATH";
-var AUTOSSH_SSH_PATH_ENV = "AUTOSSH_PATH";
-function getBundledAutosshAsset(platform = process.platform, homeDirectory = homedir()) {
-  if (!isSupportedPlatform(platform)) {
-    return null;
-  }
-  const installDir = join(
-    homeDirectory,
-    ".agentcomputer",
-    "tools",
-    "autossh",
-    `v${BUNDLED_AUTOSSH_VERSION}`,
-    platform
-  );
-  return {
-    platform,
-    version: BUNDLED_AUTOSSH_VERSION,
-    archiveName: `autossh-v${BUNDLED_AUTOSSH_VERSION}.tar.gz`,
-    downloadUrl: BUNDLED_AUTOSSH_DOWNLOAD_BASE,
-    archiveSha256: BUNDLED_AUTOSSH_ARCHIVE_SHA256,
-    installDir,
-    executablePath: join(installDir, "bin", "autossh")
-  };
-}
-function hasBundledAutossh() {
-  const asset = getBundledAutosshAsset();
-  return asset ? existsSync(asset.executablePath) : false;
-}
-async function ensureAutosshCommandPath(env = process.env) {
-  const resolution = lookupAutosshCommandPath(env);
-  if (resolution.commandPath) {
-    return resolution.commandPath;
-  }
-  if (!resolution.asset) {
-    throw new Error(
-      `Agent Computer does not ship bundled autossh for ${process.platform}. Install autossh manually and rerun \`computer ssh\`.`
-    );
-  }
-  try {
-    return await installBundledAutossh(resolution.asset);
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : "unknown autossh install failure";
-    throw new Error(
-      `Failed to install Agent Computer's bundled autossh (${reason}). Check your network connection and local build tools, then rerun \`computer ssh\`.`
-    );
-  }
-}
-async function ensureBundledAutosshInstalled() {
-  const asset = getBundledAutosshAsset();
-  if (!asset) {
-    throw new Error(
-      `Agent Computer does not ship bundled autossh for ${process.platform}.`
-    );
-  }
-  return installBundledAutossh(asset);
-}
-function resolveAutosshCommandPath(env = process.env) {
-  const resolution = lookupAutosshCommandPath(env);
-  if (resolution.commandPath) {
-    return resolution.commandPath;
-  }
-  if (!resolution.asset) {
-    throw new Error(
-      `Agent Computer does not ship bundled autossh for ${process.platform}. Install autossh manually and rerun \`computer ssh\`.`
-    );
-  }
-  throw new Error(
-    "autossh is not installed yet. Re-run `computer ssh` and Agent Computer will install its bundled copy."
-  );
-}
-function resolveAutosshSSHCommandPath(env = process.env) {
-  const overridden = env[AUTOSSH_SSH_PATH_ENV]?.trim();
-  if (overridden) {
-    return overridden;
-  }
-  const systemPath = resolveSystemCommandPath("ssh", env);
-  if (systemPath) {
-    return systemPath;
-  }
-  throw new Error(getMissingOpenSSHClientMessage());
-}
-function getMissingOpenSSHClientMessage(platform = process.platform) {
-  switch (platform) {
-    case "darwin":
-      return "OpenSSH client tools are required for `computer ssh`. Install the macOS command line tools or make sure `ssh` is available on PATH, then rerun the command.";
-    case "linux":
-      return "OpenSSH client tools are required for `computer ssh`. Install `ssh` and `scp` with your package manager, then rerun the command.";
-    default:
-      return "OpenSSH client tools are required for `computer ssh`. Install `ssh` and `scp`, then rerun the command.";
-  }
-}
-async function installBundledAutossh(asset) {
-  if (existsSync(asset.executablePath)) {
-    return asset.executablePath;
-  }
-  const sshPath = resolveSystemCommandPath("ssh");
-  if (!sshPath) {
-    throw new Error("OpenSSH client (`ssh`) is required before autossh can be provisioned");
-  }
-  if (!resolveSystemCommandPath("make")) {
-    throw new Error("`make` is required to build bundled autossh");
-  }
-  const ccPath = resolveSystemCommandPath("cc") ?? resolveSystemCommandPath("clang");
-  if (!ccPath) {
-    throw new Error("a C compiler is required to build bundled autossh");
-  }
-  if (!resolveSystemCommandPath("tar")) {
-    throw new Error("`tar` is required to extract bundled autossh");
-  }
-  mkdirSync(dirname(asset.installDir), { recursive: true });
-  const stagingDir = `${asset.installDir}.staging-${process.pid}-${Date.now()}`;
-  const archivePath = join(stagingDir, asset.archiveName);
-  const prefixDir = join(stagingDir, "prefix");
-  rmSync(stagingDir, { recursive: true, force: true });
-  if (existsSync(asset.installDir) && !existsSync(asset.executablePath)) {
-    rmSync(asset.installDir, { recursive: true, force: true });
-  }
-  mkdirSync(stagingDir, { recursive: true });
-  try {
-    const response = await fetch(asset.downloadUrl, {
-      headers: {
-        "User-Agent": "aicomputer-cli"
-      }
-    });
-    if (!response.ok || !response.body) {
-      throw new Error(`download failed with status ${response.status}`);
-    }
-    const archiveBuffer = Buffer.from(await response.arrayBuffer());
-    verifyAutosshArchiveChecksum(asset, archiveBuffer);
-    await writeFile(archivePath, archiveBuffer, {
-      mode: 384
-    });
-    const extract = spawnSync("tar", ["-xzf", archivePath, "-C", stagingDir], {
-      encoding: "utf8"
-    });
-    if (extract.status !== 0) {
-      throw new Error(
-        extract.stderr.trim() || extract.stdout.trim() || `failed to extract ${asset.archiveName}`
-      );
-    }
-    const sourceDir = findExtractedSourceDir(stagingDir);
-    if (!sourceDir) {
-      throw new Error("downloaded autossh archive did not contain source files");
-    }
-    const configure = spawnSync(
-      "./configure",
-      [`--prefix=${prefixDir}`, `--with-ssh=${sshPath}`],
-      {
-        cwd: sourceDir,
-        encoding: "utf8",
-        env: {
-          ...process.env,
-          CC: ccPath
-        }
-      }
-    );
-    if (configure.status !== 0) {
-      throw new Error(
-        configure.stderr.trim() || configure.stdout.trim() || "autossh configure failed"
-      );
-    }
-    const make = spawnSync("make", [], {
-      cwd: sourceDir,
-      encoding: "utf8",
-      env: {
-        ...process.env,
-        CC: ccPath
-      }
-    });
-    if (make.status !== 0) {
-      throw new Error(make.stderr.trim() || make.stdout.trim() || "autossh build failed");
-    }
-    const install = spawnSync("make", ["install"], {
-      cwd: sourceDir,
-      encoding: "utf8",
-      env: {
-        ...process.env,
-        CC: ccPath
-      }
-    });
-    if (install.status !== 0) {
-      throw new Error(
-        install.stderr.trim() || install.stdout.trim() || "autossh install failed"
-      );
-    }
-    if (!existsSync(join(prefixDir, "bin", "autossh"))) {
-      throw new Error("autossh install did not produce the executable");
-    }
-    chmodSync(join(prefixDir, "bin", "autossh"), 493);
-    rmSync(archivePath, { force: true });
-    try {
-      renameSync(prefixDir, asset.installDir);
-    } catch (error) {
-      if (!existsSync(asset.executablePath)) {
-        throw error;
-      }
-    }
-    rmSync(stagingDir, { recursive: true, force: true });
-    return asset.executablePath;
-  } catch (error) {
-    rmSync(stagingDir, { recursive: true, force: true });
-    throw error;
-  }
-}
-function lookupAutosshCommandPath(env) {
-  const overridden = env[AGENTCOMPUTER_AUTOSSH_PATH_ENV]?.trim();
-  const asset = getBundledAutosshAsset();
-  if (overridden) {
-    return { asset, commandPath: overridden };
-  }
-  if (asset && existsSync(asset.executablePath)) {
-    return { asset, commandPath: asset.executablePath };
-  }
-  return {
-    asset,
-    commandPath: resolveSystemCommandPath("autossh", env)
-  };
-}
-function verifyAutosshArchiveChecksum(asset, archiveBuffer) {
-  const digest = createHash("sha256").update(archiveBuffer).digest("hex");
-  if (digest !== asset.archiveSha256) {
-    throw new Error(
-      `autossh archive checksum mismatch (expected ${asset.archiveSha256}, got ${digest})`
-    );
-  }
-}
-function findExtractedSourceDir(stagingDir) {
-  for (const entry of readdirSync(stagingDir, { withFileTypes: true })) {
-    if (entry.isDirectory() && entry.name !== "prefix") {
-      return join(stagingDir, entry.name);
-    }
-  }
-  return null;
-}
-function isSupportedPlatform(platform) {
-  return platform === "darwin" || platform === "linux";
-}
-
-export {
-  AGENTCOMPUTER_AUTOSSH_PATH_ENV,
-  AUTOSSH_SSH_PATH_ENV,
-  getBundledAutosshAsset,
-  hasBundledAutossh,
-  ensureAutosshCommandPath,
-  ensureBundledAutosshInstalled,
-  resolveAutosshCommandPath,
-  resolveAutosshSSHCommandPath,
-  getMissingOpenSSHClientMessage
-};

package/dist/chunk-5Y2NWK5I.js

@@ -1,14 +0,0 @@
-// src/lib/system-tools.ts
-import { spawnSync } from "child_process";
-function resolveSystemCommandPath(command, env = process.env) {
-  const result = spawnSync("which", [command], { encoding: "utf8", env });
-  if (result.status !== 0) {
-    return null;
-  }
-  const resolved = result.stdout.trim();
-  return resolved.length > 0 ? resolved : null;
-}
-
-export {
-  resolveSystemCommandPath
-};

package/dist/chunk-E7QD4MHI.js

@@ -1,279 +0,0 @@
-// src/lib/config.ts
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-var CONFIG_DIR = join(homedir(), ".computer");
-var CONFIG_FILE = join(CONFIG_DIR, "config.json");
-function ensureConfigDir() {
-  if (!existsSync(CONFIG_DIR)) {
-    mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
-  }
-}
-function readConfig() {
-  ensureConfigDir();
-  if (!existsSync(CONFIG_FILE)) {
-    return {};
-  }
-  try {
-    return JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
-  } catch {
-    return {};
-  }
-}
-function writeConfig(config) {
-  ensureConfigDir();
-  const tempFile = `${CONFIG_FILE}.${process.pid}.tmp`;
-  writeFileSync(tempFile, JSON.stringify(config, null, 2), { mode: 384 });
-  renameSync(tempFile, CONFIG_FILE);
-}
-function getAPIKey() {
-  const envValue = process.env.COMPUTER_API_KEY ?? process.env.AGENTCOMPUTER_API_KEY;
-  if (envValue) {
-    return envValue.trim();
-  }
-  return getStoredAPIKey();
-}
-function getStoredAPIKey() {
-  return readConfig().auth?.apiKey?.trim() || null;
-}
-function hasEnvAPIKey() {
-  return Boolean(process.env.COMPUTER_API_KEY ?? process.env.AGENTCOMPUTER_API_KEY);
-}
-function setAPIKey(apiKey) {
-  const config = readConfig();
-  config.auth = { apiKey: apiKey.trim() };
-  writeConfig(config);
-}
-function clearAPIKey() {
-  const config = readConfig();
-  delete config.auth;
-  writeConfig(config);
-}
-
-// src/lib/api.ts
-var BASE_URL = process.env.COMPUTER_API_URL ?? process.env.AGENTCOMPUTER_API_URL ?? "https://api.computer.agentcomputer.ai";
-var WEB_URL = process.env.COMPUTER_WEB_URL ?? process.env.AGENTCOMPUTER_WEB_URL ?? resolveDefaultWebURL(BASE_URL);
-var ApiError = class extends Error {
-  constructor(status, message) {
-    super(message);
-    this.status = status;
-    this.name = "ApiError";
-  }
-};
-function getBaseURL() {
-  return BASE_URL;
-}
-function getWebURL() {
-  return WEB_URL;
-}
-async function api(path, options = {}) {
-  const apiKey = getAPIKey();
-  if (!apiKey) {
-    throw new ApiError(401, "not logged in; run 'computer login' first");
-  }
-  return requestWithKey(apiKey, path, options);
-}
-function resolveDefaultWebURL(apiURL) {
-  try {
-    const parsed = new URL(apiURL);
-    if (parsed.hostname === "api.computer.agentcomputer.ai") {
-      return "https://agentcomputer.ai";
-    }
-    if (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1") {
-      return `${parsed.protocol}//${parsed.hostname}:3000`;
-    }
-  } catch {
-    return "https://agentcomputer.ai";
-  }
-  return "https://agentcomputer.ai";
-}
-async function apiWithKey(apiKey, path, options = {}) {
-  return requestWithKey(apiKey, path, options);
-}
-async function requestWithKey(apiKey, path, options) {
-  const headers = {
-    Accept: "application/json",
-    ...options.headers ?? {}
-  };
-  if (options.body !== void 0) {
-    headers["Content-Type"] = "application/json";
-  }
-  if (apiKey) {
-    headers.Authorization = `Bearer ${apiKey}`;
-  }
-  const response = await fetch(`${BASE_URL}${path}`, {
-    ...options,
-    headers
-  });
-  if (!response.ok) {
-    throw new ApiError(response.status, await readErrorMessage(response));
-  }
-  if (response.status === 204) {
-    return void 0;
-  }
-  return await response.json();
-}
-async function readErrorMessage(response) {
-  const contentType = response.headers.get("content-type") ?? "";
-  if (contentType.includes("application/json")) {
-    try {
-      const payload = await response.json();
-      if (payload.error) {
-        return payload.error;
-      }
-      return JSON.stringify(payload);
-    } catch {
-      return response.statusText || "request failed";
-    }
-  }
-  const body = await response.text();
-  return body || response.statusText || "request failed";
-}
-
-// src/lib/computers.ts
-async function listComputers(signal) {
-  const [ownedResponse, sharedResponse] = await Promise.all([
-    api("/v1/computers", { signal }),
-    api("/v1/computers/shared", { signal }).catch((error) => {
-      if (!(error instanceof Error) || !("status" in error)) {
-        throw error;
-      }
-      const status = Reflect.get(error, "status");
-      if (status === 404 || status === 405) {
-        return { computers: [] };
-      }
-      throw error;
-    })
-  ]);
-  return mergeComputerLists(ownedResponse.computers, sharedResponse.computers);
-}
-async function getComputerByID(id) {
-  return api(`/v1/computers/${id}`);
-}
-async function createComputer(input) {
-  return api("/v1/computers", {
-    method: "POST",
-    body: JSON.stringify(input)
-  });
-}
-async function deleteComputer(computerID) {
-  return api(`/v1/computers/${computerID}`, {
-    method: "DELETE"
-  });
-}
-async function powerOnComputer(computerID) {
-  return api(`/v1/computers/${computerID}/power-on`, {
-    method: "POST"
-  });
-}
-async function powerOffComputer(computerID) {
-  return api(`/v1/computers/${computerID}/power-off`, {
-    method: "POST"
-  });
-}
-async function getFilesystemSettings() {
-  return api("/v1/me/filesystem");
-}
-async function getConnectionInfo(computerID, signal) {
-  return api(`/v1/computers/${computerID}/connection`, {
-    signal
-  });
-}
-async function createBrowserAccess(computerID) {
-  return api(`/v1/computers/${computerID}/access/browser`, {
-    method: "POST"
-  });
-}
-async function listPublishedPorts(computerID) {
-  const response = await api(`/v1/computers/${computerID}/ports`);
-  return response.ports;
-}
-async function publishPort(computerID, input) {
-  return api(`/v1/computers/${computerID}/ports`, {
-    method: "POST",
-    body: JSON.stringify(input)
-  });
-}
-async function deletePublishedPort(computerID, targetPort) {
-  return api(`/v1/computers/${computerID}/ports/${targetPort}`, {
-    method: "DELETE"
-  });
-}
-async function resolveComputer(identifier) {
-  try {
-    return await getComputerByID(identifier);
-  } catch (error) {
-    if (!(error instanceof Error) || !("status" in error)) {
-      throw error;
-    }
-    const status = Reflect.get(error, "status");
-    if (status !== 404) {
-      throw error;
-    }
-  }
-  const computers = await listComputers();
-  const exact = computers.find(
-    (computer) => computer.handle === identifier || computer.id === identifier
-  );
-  if (exact) {
-    return exact;
-  }
-  throw new Error(`computer '${identifier}' not found`);
-}
-function mergeComputerLists(owned, shared) {
-  const merged = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const computer of [...owned, ...shared]) {
-    if (seen.has(computer.id)) {
-      continue;
-    }
-    seen.add(computer.id);
-    merged.push(computer);
-  }
-  return merged;
-}
-function webURL(computer) {
-  return `https://${computer.primary_web_host}${normalizePrimaryPath(computer.primary_path)}`;
-}
-function vncURL(computer) {
-  if (!computer.vnc_enabled) {
-    return null;
-  }
-  const domain = computer.primary_web_host.replace(/^[^.]+\./, "");
-  return `https://6080--${computer.handle}.${domain}`;
-}
-function normalizePrimaryPath(primaryPath) {
-  const trimmed = primaryPath?.trim();
-  if (!trimmed) {
-    return "/";
-  }
-  return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
-}
-
-export {
-  getAPIKey,
-  getStoredAPIKey,
-  hasEnvAPIKey,
-  setAPIKey,
-  clearAPIKey,
-  ApiError,
-  getBaseURL,
-  getWebURL,
-  api,
-  apiWithKey,
-  listComputers,
-  getComputerByID,
-  createComputer,
-  deleteComputer,
-  powerOnComputer,
-  powerOffComputer,
-  getFilesystemSettings,
-  getConnectionInfo,
-  createBrowserAccess,
-  listPublishedPorts,
-  publishPort,
-  deletePublishedPort,
-  resolveComputer,
-  webURL,
-  vncURL
-};