farming-code 2.2.29 → 2.2.32

package/extensions/computer/backend/farming-computer-client.cjs

@@ -0,0 +1,84 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var farming_computer_client_exports = {};
+__export(farming_computer_client_exports, {
+  requestJson: () => requestJson
+});
+module.exports = __toCommonJS(farming_computer_client_exports);
+const fs = require("fs");
+const http = require("http");
+const https = require("https");
+const { URL } = require("url");
+function connection(env = process.env) {
+  const controlUrl = String(env.FARMING_CONTROL_URL || "").trim();
+  if (!controlUrl) throw new Error("FARMING_CONTROL_URL is not available");
+  let token = "";
+  if (env.FARMING_TOKEN_FILE && fs.existsSync(env.FARMING_TOKEN_FILE)) {
+    token = fs.readFileSync(env.FARMING_TOKEN_FILE, "utf8").trim();
+  }
+  return { controlUrl: controlUrl.replace(/\/+$/, ""), token };
+}
+function requestJson(method, pathname, body, env = process.env) {
+  const target = connection(env);
+  const url = new URL(`${target.controlUrl}${pathname}`);
+  const client = url.protocol === "https:" ? https : http;
+  const payload = body === void 0 ? "" : JSON.stringify(body);
+  return new Promise((resolve, reject) => {
+    const request = client.request(url, {
+      method,
+      headers: {
+        Accept: "application/json",
+        ...payload ? { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(payload) } : {},
+        ...target.token ? { Cookie: `farming_token=${encodeURIComponent(target.token)}` } : {},
+        ...env.FARMING_AGENT_ID ? { "X-Farming-Agent-Id": env.FARMING_AGENT_ID } : {}
+      }
+    }, (response) => {
+      const chunks = [];
+      response.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+      response.on("end", () => {
+        const text = Buffer.concat(chunks).toString("utf8");
+        let value = {};
+        try {
+          value = text ? JSON.parse(text) : {};
+        } catch {
+          value = { error: text || `HTTP ${response.statusCode}` };
+        }
+        if (Number(response.statusCode) < 200 || Number(response.statusCode) >= 300) {
+          const record = value && typeof value === "object" ? value : {};
+          reject(Object.assign(new Error(String(record.error || `HTTP ${response.statusCode}`)), {
+            status: response.statusCode,
+            code: record.code,
+            uncertain: record.uncertain === true
+          }));
+          return;
+        }
+        resolve(value);
+      });
+    });
+    request.setTimeout(6e4, () => request.destroy(new Error("Computer request timed out")));
+    request.on("error", reject);
+    if (payload) request.write(payload);
+    request.end();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  requestJson
+});

package/extensions/computer/backend/index.cjs

@@ -0,0 +1,35 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var backend_exports = {};
+__export(backend_exports, {
+  ComputerResourceManager: () => import_computer_resource_manager.ComputerResourceManager,
+  IsolatedBrowserProvider: () => import_isolated_browser_provider.IsolatedBrowserProvider,
+  createComputerRouter: () => import_computer_router.createComputerRouter
+});
+module.exports = __toCommonJS(backend_exports);
+var import_computer_resource_manager = require("./computer-resource-manager.cjs");
+var import_computer_router = require("./computer-router.cjs");
+var import_isolated_browser_provider = require("./isolated-browser-provider.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ComputerResourceManager,
+  IsolatedBrowserProvider,
+  createComputerRouter
+});

package/extensions/computer/backend/isolated-browser-provider.cjs

@@ -0,0 +1,157 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var isolated_browser_provider_exports = {};
+__export(isolated_browser_provider_exports, {
+  IsolatedBrowserProvider: () => IsolatedBrowserProvider,
+  LEGACY_ISOLATED_BROWSER_IMAGE_DIGEST: () => LEGACY_ISOLATED_BROWSER_IMAGE_DIGEST
+});
+module.exports = __toCommonJS(isolated_browser_provider_exports);
+var import_managed_chromium_installer = require("../../browser/backend/managed-chromium-installer.cjs");
+const { execFile } = require("child_process");
+const { promisify } = require("util");
+const crypto = require("crypto");
+const execFileAsync = promisify(execFile);
+const LEGACY_ISOLATED_BROWSER_IMAGE_DIGEST = "sha256:27764b6a7867b1d7ed07975b4678e20c3005e469b0fb8178d8ee6986c14cc97b";
+function isolatedBrowserError(message, code, status = 409) {
+  return Object.assign(new Error(message), { code, status });
+}
+class IsolatedBrowserProvider {
+  computerResourceManager;
+  configFingerprint;
+  chromiumInstaller;
+  docker;
+  preparePromise = null;
+  constructor(options) {
+    this.computerResourceManager = options.computerResourceManager;
+    this.configFingerprint = crypto.createHash("sha256").update(options.configDir).digest("hex").slice(0, 12);
+    this.docker = options.dockerRunner || (async (args, runOptions = {}) => {
+      const result = await execFileAsync("docker", args, {
+        encoding: "utf8",
+        timeout: runOptions.timeoutMs || 9e4,
+        maxBuffer: runOptions.maxBuffer || 20 * 1024 * 1024
+      });
+      return {
+        stdout: String(result.stdout || ""),
+        stderr: String(result.stderr || "")
+      };
+    });
+    this.chromiumInstaller = options.chromiumInstaller || new import_managed_chromium_installer.ManagedChromiumInstaller({
+      configDir: options.configDir,
+      platform: "linux",
+      arch: process.arch,
+      platformKey: `linux-${process.arch}-computer`,
+      verifyBrowser: (executablePath) => this.computerResourceManager.verifyBrowserExecutable(executablePath)
+    });
+  }
+  async capability(refresh = false) {
+    const computer = await this.computerResourceManager.capability(refresh);
+    const chromiumValue = this.chromiumInstaller.status();
+    const chromium = chromiumValue && typeof chromiumValue === "object" ? chromiumValue : {};
+    const imageReady = computer.imageReady === true && chromium.state === "ready";
+    return {
+      available: computer.dockerAvailable === true && imageReady,
+      dockerAvailable: computer.dockerAvailable === true,
+      imageReady,
+      image: computer.image || "",
+      imageDigest: computer.imageDigest || "",
+      compatibilityMode: computer.compatibilityMode === true,
+      chromium,
+      error: String(computer.error || chromium.error || "")
+    };
+  }
+  prepare() {
+    if (this.preparePromise) return this.preparePromise;
+    this.preparePromise = (async () => {
+      await this.computerResourceManager.prepare();
+      await this.chromiumInstaller.install();
+      return this.capability(true);
+    })().finally(() => {
+      this.preparePromise = null;
+    });
+    return this.preparePromise;
+  }
+  async recover() {
+    let listed;
+    try {
+      listed = await this.docker([
+        "ps",
+        "-aq",
+        "--filter",
+        "label=farming.dev/kind=isolated-browser",
+        "--filter",
+        `label=farming.dev/config=${this.configFingerprint}`,
+        "--filter",
+        `label=farming.dev/image-digest=${LEGACY_ISOLATED_BROWSER_IMAGE_DIGEST}`
+      ], { timeoutMs: 1e4 });
+    } catch {
+      return;
+    }
+    for (const id of listed.stdout.split(/\s+/).filter(Boolean)) {
+      const inspected = await this.docker(["inspect", id], { timeoutMs: 1e4 });
+      const parsed = JSON.parse(inspected.stdout);
+      const value = Array.isArray(parsed) && parsed[0] && typeof parsed[0] === "object" ? parsed[0] : {};
+      const labels = value.Config && typeof value.Config === "object" ? value.Config.Labels : {};
+      if (labels["farming.dev/kind"] !== "isolated-browser" || labels["farming.dev/config"] !== this.configFingerprint || labels["farming.dev/image-digest"] !== LEGACY_ISOLATED_BROWSER_IMAGE_DIGEST) continue;
+      const state = value.State && typeof value.State === "object" ? value.State : {};
+      if (state.Running === true) {
+        await this.docker(["stop", "--time", "10", id], { timeoutMs: 3e4 });
+      }
+      await this.docker(["rm", id], { timeoutMs: 3e4 });
+    }
+  }
+  async acquire(owner) {
+    const ownerAgentId = String(owner.ownerAgentId || "").trim();
+    const projectRootId = String(owner.projectRootId || "").trim();
+    const workspace = String(owner.workspace || "").trim();
+    if (!ownerAgentId || !projectRootId || !workspace) {
+      throw isolatedBrowserError(
+        "An Agent-owned Browser requires an Agent and Project workspace",
+        "ISOLATED_BROWSER_AGENT_OWNER_REQUIRED",
+        400
+      );
+    }
+    const option = this.chromiumInstaller.browserOption();
+    const executablePath = String(option?.path || "").trim();
+    if (!executablePath) {
+      throw isolatedBrowserError(
+        "Prepare the isolated Browser runtime before starting this Browser",
+        "ISOLATED_BROWSER_IMAGE_NOT_READY",
+        503
+      );
+    }
+    return this.computerResourceManager.acquireBrowser({
+      ownerAgentId,
+      projectRootId,
+      workspace,
+      executablePath
+    });
+  }
+  release(leaseKey) {
+    return this.computerResourceManager.releaseBrowser(leaseKey);
+  }
+  deleteOwner(_ownerKey) {
+    return Promise.resolve();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IsolatedBrowserProvider,
+  LEGACY_ISOLATED_BROWSER_IMAGE_DIGEST
+});

package/extensions/computer/bin/farming-computer

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+const { requestJson } = require('../backend/farming-computer-client.cjs');
+const { rootIdForPath } = require('../../../backend/workspace-root-registry.cjs');
+
+function usage() {
+  return `Usage: farming computer <command> [options]
+
+Start here:
+  capability                 Check Docker and the pinned Computer runtime
+  list                       Show this Agent's Computer Resource
+  open [--name <name>]       Create or start this Agent's isolated Computer
+  stop                       Stop it without deleting the owned container
+  help workflow              Read the recommended Agent workflow
+
+Advanced:
+  call <tool> [json]         Call one pinned Cua Driver tool
+  mcp                        Serve the complete computer_* MCP catalog
+
+The Computer is owned by the current Farming Agent. The user can observe the
+same desktop in Farming and explicitly take control. Run \`farming computer
+help workflow\` before the first terminal-driven task.
+`;
+}
+
+function workflowHelp() {
+  return `Recommended Computer workflow:
+  1. farming capabilities
+  2. farming computer list
+  3. farming computer open
+  4. Observe with get_desktop_state or get_window_state before each action
+  5. Act through a specific Cua Driver tool
+  6. Observe again and verify the result
+
+If an action times out, its outcome is uncertain. Observe before any retry.
+When a human returns control to the Agent, the next call must be an observation.
+`;
+}
+
+function option(args, name) {
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] : undefined;
+}
+
+function envBinding() {
+  const workspace = String(process.env.FARMING_PROJECT_WORKSPACE || '').trim();
+  const agentId = String(process.env.FARMING_AGENT_ID || '').trim();
+  if (!workspace || !agentId) {
+    throw new Error('farming computer must run inside a Farming Agent Project');
+  }
+  return { workspace, agentId };
+}
+
+async function list() {
+  const snapshot = await requestJson('GET', '/api/computers', undefined, process.env);
+  return Array.isArray(snapshot.resources) ? snapshot.resources : [];
+}
+
+async function open(args) {
+  const { workspace, agentId } = envBinding();
+  const existing = (await list())[0];
+  const resource = existing || await requestJson('POST', '/api/computers', {
+    rootId: rootIdForPath(workspace),
+    agentId,
+    name: option(args, '--name'),
+  }, process.env);
+  if (resource.status === 'running') return resource;
+  return requestJson(
+    'POST',
+    `/api/computers/${encodeURIComponent(resource.id)}/start`,
+    undefined,
+    process.env,
+  );
+}
+
+async function run(argv = process.argv.slice(2)) {
+  const command = argv[0] || 'help';
+  if (command === 'help' || command === '--help' || command === '-h') {
+    console.log(argv[1] === 'workflow' ? workflowHelp() : usage());
+    return 0;
+  }
+  if (command === 'mcp') {
+    const { runComputerMcpServer } = require('../backend/computer-mcp-server.cjs');
+    await runComputerMcpServer();
+    return 0;
+  }
+  if (command === 'capability') {
+    console.log(JSON.stringify(await requestJson('GET', '/api/computers/capability', undefined, process.env), null, 2));
+    return 0;
+  }
+  if (command === 'list') {
+    console.log(JSON.stringify({ resources: await list() }, null, 2));
+    return 0;
+  }
+  if (command === 'open') {
+    console.log(JSON.stringify(await open(argv.slice(1)), null, 2));
+    return 0;
+  }
+  if (command === 'stop') {
+    const resource = (await list())[0];
+    const result = resource
+      ? await requestJson('POST', `/api/computers/${encodeURIComponent(resource.id)}/stop`, undefined, process.env)
+      : { stopped: true, resource: null };
+    console.log(JSON.stringify(result, null, 2));
+    return 0;
+  }
+  if (command === 'call') {
+    const tool = String(argv[1] || '').trim().replace(/^computer_/, '');
+    if (!tool) throw new Error('Usage: farming computer call <tool> [json]');
+    const input = argv[2] ? JSON.parse(argv[2]) : {};
+    const resource = await open([]);
+    console.log(JSON.stringify(await requestJson(
+      'POST',
+      `/api/computers/${encodeURIComponent(resource.id)}/tool/${encodeURIComponent(tool)}`,
+      input,
+      process.env,
+    ), null, 2));
+    return 0;
+  }
+  throw new Error(`Unknown farming computer command: ${command}`);
+}
+
+if (require.main === module) {
+  run().then(code => {
+    if (code) process.exit(code);
+  }).catch(error => {
+    console.error(error?.message || error);
+    process.exit(1);
+  });
+}
+
+module.exports = { run };