farming-code 2.2.29 → 2.2.32

package/extensions/browser/bin/farming-browser

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 const fs = require('fs');
 const path = require('path');
-const { requestJson } = require('../backend/farming-browser-client');
-const { rootIdForPath } = require('../../../backend/workspace-root-registry');
+const { requestJson } = require('../backend/farming-browser-client.cjs');
+const { rootIdForPath } = require('../../../backend/workspace-root-registry.cjs');
 
 function usage() {
   return `Usage: farming browser <command> [options]
 
 Start here:
   capability                 Check whether Farming Browser is available
-  list                       Discover this Project's Browser Resources
+  list                       Discover this Agent's Browser Resources
   create                     Create another independently visible Browser
   help workflow              Read the recommended Agent workflow
 
@@ -31,7 +31,7 @@ const TOPIC_HELP = Object.freeze({
   workflow: `Recommended Agent workflow:
   1. farming capabilities
   2. farming browser list
-  3. Reuse a Project Browser, or create and start one
+  3. Reuse a Browser owned by this Agent, or create and start one
   4. Navigate, then take a snapshot
   5. Act through snapshot refs; wait and snapshot again after page changes
   6. Use inspection or debugging commands only when the normal flow is insufficient
@@ -230,16 +230,18 @@ function writeJson(value) {
 
 async function requireProjectBrowser(id) {
   const requestedWorkspace = String(process.env.FARMING_PROJECT_WORKSPACE || '').trim();
+  const requestedAgentId = String(process.env.FARMING_AGENT_ID || '').trim();
   if (!requestedWorkspace) return;
   const workspace = path.resolve(requestedWorkspace);
   const result = await requestJson('GET', '/api/browsers');
   const resource = (result.resources || []).find(item => (
     item?.id === id
+    && (!requestedAgentId || item.ownerAgentId === requestedAgentId)
     && item.workspace
     && path.resolve(item.workspace) === workspace
   ));
   if (!resource) {
-    throw new Error(`Browser Resource ${id} is not available in this Agent's Project`);
+    throw new Error(`Browser Resource ${id} is not owned by this Agent`);
   }
 }
 
@@ -258,7 +260,7 @@ async function run(argv = process.argv.slice(2)) {
     return 0;
   }
   if (command === 'mcp') {
-    const { runBrowserMcpServer } = require('../backend/browser-mcp-server');
+    const { runBrowserMcpServer } = require('../backend/browser-mcp-server.cjs');
     await runBrowserMcpServer();
     return 0;
   }
@@ -275,6 +277,7 @@ async function run(argv = process.argv.slice(2)) {
     const workspace = path.resolve(requestedWorkspace);
     const result = await requestJson('POST', '/api/browsers', {
       rootId: rootIdForPath(workspace),
+      agentId: process.env.FARMING_AGENT_ID || undefined,
       name: option(args, '--name') || undefined,
       url: option(args, '--url') || undefined,
     });
@@ -289,7 +292,13 @@ async function run(argv = process.argv.slice(2)) {
     const workspace = requestedWorkspace ? path.resolve(requestedWorkspace) : '';
     const result = await requestJson('GET', '/api/browsers');
     const resources = workspace
-      ? result.resources.filter(resource => path.resolve(resource.workspace) === workspace)
+      ? result.resources.filter(resource => (
+        path.resolve(resource.workspace) === workspace
+        && (
+          !process.env.FARMING_AGENT_ID
+          || resource.ownerAgentId === process.env.FARMING_AGENT_ID
+        )
+      ))
       : result.resources;
     writeJson({ resources });
     return 0;

package/extensions/computer/backend/agent-capability.cjs

@@ -0,0 +1,72 @@
+// 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 agent_capability_exports = {};
+__export(agent_capability_exports, {
+  FARMING_COMPUTER_MCP_SERVER_NAME: () => FARMING_COMPUTER_MCP_SERVER_NAME,
+  isFarmingComputerServer: () => isFarmingComputerServer,
+  mergeComputerMcpServer: () => mergeComputerMcpServer
+});
+module.exports = __toCommonJS(agent_capability_exports);
+const path = require("path");
+const FARMING_COMPUTER_MCP_SERVER_NAME = "farming-computer";
+const FARMING_COMPUTER_MCP_META_KEY = "farming.dev/extension";
+function recordValue(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function isFarmingComputerServer(server) {
+  const value = recordValue(server);
+  return recordValue(value._meta)[FARMING_COMPUTER_MCP_META_KEY] === "computer";
+}
+function computerMcpEnv(agentEnv) {
+  return [
+    "FARMING_AGENT_ID",
+    "FARMING_CONFIG_DIR",
+    "FARMING_CONTROL_URL",
+    "FARMING_DISABLE_AUTH",
+    "FARMING_PROJECT_WORKSPACE",
+    "FARMING_TOKEN_FILE"
+  ].flatMap((name) => agentEnv[name] === void 0 || agentEnv[name] === "" ? [] : [{ name, value: String(agentEnv[name]) }]);
+}
+function mergeComputerMcpServer(mcpServers, options) {
+  const existing = Array.isArray(mcpServers) ? mcpServers : [];
+  const collision = existing.find((server) => recordValue(server).name === FARMING_COMPUTER_MCP_SERVER_NAME && !isFarmingComputerServer(server));
+  if (collision) {
+    throw new Error(
+      `MCP server name "${FARMING_COMPUTER_MCP_SERVER_NAME}" is reserved by the Farming Computer Extension`
+    );
+  }
+  const command = path.join(options.cliBinDir, process.platform === "win32" ? "farming.cmd" : "farming");
+  return [
+    ...existing.filter((server) => !isFarmingComputerServer(server)),
+    {
+      name: FARMING_COMPUTER_MCP_SERVER_NAME,
+      command,
+      args: ["computer", "mcp"],
+      env: computerMcpEnv(options.agentEnv || {}),
+      _meta: { [FARMING_COMPUTER_MCP_META_KEY]: "computer" }
+    }
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FARMING_COMPUTER_MCP_SERVER_NAME,
+  isFarmingComputerServer,
+  mergeComputerMcpServer
+});

package/extensions/computer/backend/computer-constants.cjs

@@ -0,0 +1,59 @@
+// 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 computer_constants_exports = {};
+__export(computer_constants_exports, {
+  COMPUTER_CONTAINER_CPUS: () => COMPUTER_CONTAINER_CPUS,
+  COMPUTER_CONTAINER_MEMORY: () => COMPUTER_CONTAINER_MEMORY,
+  COMPUTER_CONTAINER_PIDS: () => COMPUTER_CONTAINER_PIDS,
+  COMPUTER_CONTAINER_SHM_SIZE: () => COMPUTER_CONTAINER_SHM_SIZE,
+  COMPUTER_DRIVER_BIN: () => COMPUTER_DRIVER_BIN,
+  COMPUTER_DRIVER_VERSION: () => COMPUTER_DRIVER_VERSION,
+  COMPUTER_IMAGE: () => COMPUTER_IMAGE,
+  COMPUTER_IMAGE_INDEX_DIGEST: () => COMPUTER_IMAGE_INDEX_DIGEST,
+  COMPUTER_SCHEMA_SHA256: () => COMPUTER_SCHEMA_SHA256,
+  COMPUTER_TOOL_COUNT: () => COMPUTER_TOOL_COUNT,
+  COMPUTER_USER: () => COMPUTER_USER
+});
+module.exports = __toCommonJS(computer_constants_exports);
+const COMPUTER_DRIVER_VERSION = "0.12.4";
+const COMPUTER_IMAGE_INDEX_DIGEST = "sha256:274eb636f5cf3fc58f705916ee72b7a701270b3877369d08533a385c5325be9b";
+const COMPUTER_IMAGE = `trycua/xfce-cua@${COMPUTER_IMAGE_INDEX_DIGEST}`;
+const COMPUTER_SCHEMA_SHA256 = "8c9bd7890cb3e1cfc2409c590b087d8313a80672eeed7ceae6beee19356c146c";
+const COMPUTER_TOOL_COUNT = 53;
+const COMPUTER_CONTAINER_MEMORY = "4g";
+const COMPUTER_CONTAINER_CPUS = "2";
+const COMPUTER_CONTAINER_SHM_SIZE = "1g";
+const COMPUTER_CONTAINER_PIDS = "1024";
+const COMPUTER_DRIVER_BIN = "/opt/venv/bin/cua-driver";
+const COMPUTER_USER = "cua";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  COMPUTER_CONTAINER_CPUS,
+  COMPUTER_CONTAINER_MEMORY,
+  COMPUTER_CONTAINER_PIDS,
+  COMPUTER_CONTAINER_SHM_SIZE,
+  COMPUTER_DRIVER_BIN,
+  COMPUTER_DRIVER_VERSION,
+  COMPUTER_IMAGE,
+  COMPUTER_IMAGE_INDEX_DIGEST,
+  COMPUTER_SCHEMA_SHA256,
+  COMPUTER_TOOL_COUNT,
+  COMPUTER_USER
+});

package/extensions/computer/backend/computer-mcp-server.cjs

@@ -0,0 +1,182 @@
+// 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 computer_mcp_server_exports = {};
+__export(computer_mcp_server_exports, {
+  ScopedComputerClient: () => ScopedComputerClient,
+  createComputerMcpServer: () => createComputerMcpServer,
+  loadManifest: () => loadManifest,
+  runComputerMcpServer: () => runComputerMcpServer
+});
+module.exports = __toCommonJS(computer_mcp_server_exports);
+var import_server = require("@modelcontextprotocol/sdk/server/index.js");
+var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+var import_types = require("@modelcontextprotocol/sdk/types.js");
+var import_workspace_root_registry = require("../../../backend/workspace-root-registry.cjs");
+var import_farming_computer_client = require("./farming-computer-client.cjs");
+var import_computer_constants = require("./computer-constants.cjs");
+const fs = require("fs");
+const path = require("path");
+const crypto = require("crypto");
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function textResult(value) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+    structuredContent: recordValue(value)
+  };
+}
+function loadManifest() {
+  const file = path.join(__dirname, "cua-tools.json");
+  const bytes = fs.readFileSync(file);
+  const sha256 = crypto.createHash("sha256").update(bytes).digest("hex");
+  if (sha256 !== import_computer_constants.COMPUTER_SCHEMA_SHA256) {
+    throw new Error(`Farming Computer tool schema integrity mismatch: ${sha256}`);
+  }
+  const manifest = JSON.parse(bytes.toString("utf8"));
+  if (manifest.driverVersion !== import_computer_constants.COMPUTER_DRIVER_VERSION || manifest.toolCount !== import_computer_constants.COMPUTER_TOOL_COUNT || manifest.tools.length !== import_computer_constants.COMPUTER_TOOL_COUNT) {
+    throw new Error("Farming Computer tool schema does not match the pinned Cua Driver contract");
+  }
+  return manifest;
+}
+class ScopedComputerClient {
+  env;
+  workspace;
+  agentId;
+  constructor(env = process.env) {
+    this.env = env;
+    this.workspace = String(env.FARMING_PROJECT_WORKSPACE || "").trim();
+    this.agentId = String(env.FARMING_AGENT_ID || "").trim();
+  }
+  requireBinding() {
+    if (!this.workspace || !this.agentId) {
+      throw new Error("This Computer tool server is not bound to a Farming Agent Project");
+    }
+  }
+  async list() {
+    this.requireBinding();
+    const snapshot = recordValue(await (0, import_farming_computer_client.requestJson)("GET", "/api/computers", void 0, this.env));
+    return (Array.isArray(snapshot.resources) ? snapshot.resources : []).map(recordValue).filter((resource) => resource.ownerAgentId === this.agentId);
+  }
+  async open(input = {}) {
+    this.requireBinding();
+    const existing = (await this.list())[0];
+    const resource = existing || recordValue(await (0, import_farming_computer_client.requestJson)("POST", "/api/computers", {
+      rootId: (0, import_workspace_root_registry.rootIdForPath)(this.workspace),
+      agentId: this.agentId,
+      name: input.name
+    }, this.env));
+    if (resource.status === "running") return resource;
+    return recordValue(await (0, import_farming_computer_client.requestJson)(
+      "POST",
+      `/api/computers/${encodeURIComponent(String(resource.id))}/start`,
+      void 0,
+      this.env
+    ));
+  }
+  async stop() {
+    const resource = (await this.list())[0];
+    if (!resource) return { stopped: true, resource: null };
+    return recordValue(await (0, import_farming_computer_client.requestJson)(
+      "POST",
+      `/api/computers/${encodeURIComponent(String(resource.id))}/stop`,
+      void 0,
+      this.env
+    ));
+  }
+  async call(upstreamName, input) {
+    const resource = await this.open();
+    const result = recordValue(await (0, import_farming_computer_client.requestJson)(
+      "POST",
+      `/api/computers/${encodeURIComponent(String(resource.id))}/tool/${encodeURIComponent(upstreamName)}`,
+      input,
+      this.env
+    ));
+    return result;
+  }
+}
+function createComputerMcpServer(options = {}) {
+  const manifest = loadManifest();
+  const client = options.client || new ScopedComputerClient(options.env);
+  const server = new import_server.Server(
+    { name: "farming-computer", version: "1.0.0" },
+    { capabilities: { tools: {} } }
+  );
+  const lifecycleTools = [{
+    name: "computer_open",
+    title: "Open Farming Computer",
+    description: "Create or start the isolated Computer owned by this Farming Agent.",
+    inputSchema: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        name: { type: "string", minLength: 1, maxLength: 120 }
+      }
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  }, {
+    name: "computer_list",
+    title: "List Farming Computer",
+    description: "List the isolated Computer owned by this Farming Agent.",
+    inputSchema: { type: "object", additionalProperties: false, properties: {} },
+    annotations: { readOnlyHint: true, openWorldHint: false }
+  }, {
+    name: "computer_stop",
+    title: "Stop Farming Computer",
+    description: "Stop this Agent Computer while retaining its resource row and container state.",
+    inputSchema: { type: "object", additionalProperties: false, properties: {} },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  }];
+  server.setRequestHandler(import_types.ListToolsRequestSchema, async () => ({
+    tools: [...lifecycleTools, ...manifest.tools]
+  }));
+  server.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
+    const name = request.params.name;
+    const input = recordValue(request.params.arguments);
+    if (name === "computer_open") return textResult(await client.open(input));
+    if (name === "computer_list") return textResult({ resources: await client.list() });
+    if (name === "computer_stop") return textResult(await client.stop());
+    const tool = manifest.tools.find((candidate) => candidate.name === name);
+    if (!tool) throw new Error(`Unknown Computer tool: ${name}`);
+    return client.call(tool.upstreamName, input);
+  });
+  return server;
+}
+async function runComputerMcpServer(options = {}) {
+  const server = createComputerMcpServer(options);
+  await server.connect(new import_stdio.StdioServerTransport());
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ScopedComputerClient,
+  createComputerMcpServer,
+  loadManifest,
+  runComputerMcpServer
+});