@agentorg/computer 0.0.12 → 0.0.13

package/README.md

@@ -35,6 +35,8 @@ That prints the computer's `computerID`, its endpoints and its `accessToken`, on
 | `terminal` | Those, and `exec_command`, `write_stdin`, `list_sessions` |
 | `none`     | No `computer` endpoint; needs `--browser`                 |
 
+`read` answers a text file as numbered lines, and a PNG, JPEG, GIF or WebP of up to 3 MiB as the picture itself: an image an MCP client can pass on to a model. The browser's `browser_take_screenshot` answers an image too, of whatever size it comes to: a `fullPage` one of a long page can be many megabytes. A container made by an earlier version keeps the program it was made with, and refuses a picture as a binary file until it is killed and made again.
+
 `about` tells the agent what a person looking at the computer reads. It takes nothing and answers JSON text, `{"rows": [...]}`, each row a `label` and a `value`, with `"path": true` on a value that is a path and `"caution": true` on one to be read as a caution; a row that is neither has neither. The rows come in this order:
 
 | `label`     | `value`                                                                                   |

package/dist/THIRD_PARTY_LICENSES.txt

@@ -1,4 +1,4 @@
-@agentorg/exec 0.0.6 (Apache-2.0)
+@agentorg/exec 0.0.7 (Apache-2.0)
 
 Apache License
                            Version 2.0, January 2004

package/dist/agentcomputer.js

@@ -3268,7 +3268,7 @@ var require_stream = __commonJS({
       };
       duplex._final = function(callback) {
         if (ws.readyState === ws.CONNECTING) {
-          ws.once("open", function open4() {
+          ws.once("open", function open5() {
             duplex._final(callback);
           });
           return;
@@ -3289,7 +3289,7 @@ var require_stream = __commonJS({
       };
       duplex._write = function(chunk, encoding, callback) {
         if (ws.readyState === ws.CONNECTING) {
-          ws.once("open", function open4() {
+          ws.once("open", function open5() {
             duplex._write(chunk, encoding, callback);
           });
           return;
@@ -28169,12 +28169,13 @@ import { STATUS_CODES, ServerResponse, createServer } from "node:http";
 import { Http2ServerRequest, constants } from "node:http2";
 import { Readable as Readable2 } from "node:stream";
 import { randomBytes as randomBytes3 } from "node:crypto";
-import { lstat as lstat2, open as open2, readdir as readdir2, rename as rename2, rm as rm2, stat as stat2 } from "node:fs/promises";
+import { lstat as lstat2, open as open3, readdir as readdir2, rename as rename2, rm as rm2, stat as stat2 } from "node:fs/promises";
 import { dirname as dirname2, join as join3 } from "node:path";
 import { randomBytes as randomBytes2 } from "node:crypto";
 import {
   chmod,
   lstat,
+  open as open2,
   readdir,
   readFile,
   realpath,
@@ -34318,7 +34319,7 @@ function bucketFor2(state, inst) {
   return bucket;
 }
 var handoff2;
-var open3 = [];
+var open4 = [];
 var memo3 = {
   alloc(_inst, payload, empty) {
     const bucket = handoff2;
@@ -34327,7 +34328,7 @@ var memo3 = {
     handoff2 = void 0;
     const entry = { value: empty, issues: null };
     bucket.set(payload.value, entry);
-    open3.push(entry);
+    open4.push(entry);
     return empty;
   },
   guard(inst) {
@@ -34398,10 +34399,10 @@ var memo3 = {
           return payload;
         }
         handoff2 = bucket;
-        const depth = open3.length;
+        const depth = open4.length;
         const result = base(payload, ctx);
         handoff2 = void 0;
-        const entry = open3.length > depth ? open3.pop() : void 0;
+        const entry = open4.length > depth ? open4.pop() : void 0;
         if (result instanceof Promise) {
           return result.then((r) => {
             if (entry)
@@ -66158,6 +66159,21 @@ var MAX_READ_CHARS = 28e3;
 var MAX_LINE_CHARS = 2e3;
 var MAX_ENTRIES = 1e3;
 var MAX_EDIT_BYTES = 8 * 1024 * 1024;
+var MAX_PICTURE_BYTES = 3 * 1024 * 1024;
+async function pictureKind(path) {
+  const file2 = await open2(path);
+  try {
+    const { buffer, bytesRead } = await file2.read(Buffer.alloc(12), 0, 12, 0);
+    const start = buffer.toString("latin1", 0, bytesRead);
+    if (start.startsWith("\x89PNG\r\n\n")) return "image/png";
+    if (start.startsWith("\xFF\xD8\xFF")) return "image/jpeg";
+    if (start.startsWith("GIF87a") || start.startsWith("GIF89a")) return "image/gif";
+    if (start.startsWith("RIFF") && start.slice(8) === "WEBP") return "image/webp";
+    return void 0;
+  } finally {
+    await file2.close();
+  }
+}
 var reason = (error62) => {
   const { code, path } = error62;
   if (code === "ENOENT") return `No such file or folder: ${path}`;
@@ -66213,9 +66229,19 @@ function createFiles(root) {
     return bytes.toString("utf8");
   };
   return {
-    /** Numbered lines of a file. */
+    /** Numbered lines of a file, or the file itself where it is a picture. */
     read: (input2) => refusing(async () => {
-      const lines = (await text22(await at(input2.path), input2.path)).split("\n");
+      const path = await at(input2.path);
+      const { size } = await aFile(path, input2.path);
+      const mimeType = await pictureKind(path);
+      if (mimeType) {
+        if (size > MAX_PICTURE_BYTES)
+          throw new ExecRefused(
+            `${input2.path} is too large to read as a picture: ${size.toLocaleString("en-US")} bytes, and the most is ${MAX_PICTURE_BYTES.toLocaleString("en-US")}.`
+          );
+        return { mimeType, bytes: await readFile(path) };
+      }
+      const lines = (await text22(path, input2.path)).split("\n");
       const first2 = Math.max(input2.offset ?? 1, 1);
       const shown = lines.slice(first2 - 1, first2 - 1 + (input2.limit ?? DEFAULT_LINES)).map((line, i) => `${first2 + i}	${cut(line, MAX_LINE_CHARS)}`);
       const last = first2 + shown.length - 1;
@@ -66425,7 +66451,7 @@ function createHostFiles(root, level) {
         throw new ExecRefused("A read starts at 0 or later and takes 1 to 1,048,576 bytes.");
       const real = await inside(root, path);
       const found = await aFile(real, path);
-      const file2 = await open2(real, "r");
+      const file2 = await open3(real, "r");
       try {
         const bytes = Buffer.alloc(Math.max(0, Math.min(length, found.size - offset)));
         const { bytesRead } = await file2.read(bytes, 0, bytes.length, offset);
@@ -66454,7 +66480,7 @@ function createHostFiles(root, level) {
       if (before?.isDirectory()) throw new ExecRefused(`${path} is a folder.`);
       await stat2(dirname2(target));
       const temporary = join3(dirname2(target), `.agentexec-${randomBytes3(6).toString("hex")}`);
-      const file2 = await open2(temporary, "wx");
+      const file2 = await open3(temporary, "wx");
       const discard = async () => {
         await file2.close().catch(() => {
         });
@@ -66527,6 +66553,12 @@ var answering = async (work) => {
     return refused(error62);
   }
 };
+var pictured = (path, { mimeType, bytes }) => ({
+  content: [
+    { type: "text", text: `${path}: ${mimeType}` },
+    { type: "image", mimeType, data: bytes.toString("base64") }
+  ]
+});
 var saying = async (work) => {
   try {
     return text(await work());
@@ -66626,7 +66658,7 @@ function createServer2(root, sessions, version22, level, extraTools = []) {
   server.registerTool(
     "read",
     {
-      description: "Reads a text file as numbered lines.",
+      description: "Reads a text file as numbered lines, or shows a PNG, JPEG, GIF or WebP of up to 3 MiB as an image; offset and limit are for text.",
       inputSchema: {
         path: external_exports.string().min(1).describe("Inside the workspace; relative to it, or absolute."),
         offset: external_exports.number().int().positive().optional().describe("The first line, from 1."),
@@ -66634,7 +66666,14 @@ function createServer2(root, sessions, version22, level, extraTools = []) {
       },
       annotations: READ_ONLY
     },
-    (input2) => saying(() => files.read(input2))
+    async (input2) => {
+      try {
+        const read = await files.read(input2);
+        return typeof read === "string" ? text(read) : pictured(input2.path, read);
+      } catch (error62) {
+        return refused(error62);
+      }
+    }
   );
   server.registerTool(
     "list",
@@ -66677,7 +66716,7 @@ function createServer2(root, sessions, version22, level, extraTools = []) {
     );
   return server;
 }
-var VERSION = "0.0.6";
+var VERSION = "0.0.7";
 function createAgentExec(options) {
   const root = realpathSync(resolve3(options.workspace));
   const level = options.level ?? "read";
@@ -68093,7 +68132,7 @@ async function forward(url3, authorization, request, response) {
 }
 
 // src/handlers.ts
-var VERSION2 = "0.0.12";
+var VERSION2 = "0.0.13";
 function createHandlers(computers) {
   return {
     getInfo: async () => ({ version: VERSION2, isolation: computers.isolation }),
@@ -68677,8 +68716,8 @@ async function openLive(session, onMessage) {
 }
 var Terminals = class {
   #open;
-  constructor(open4) {
-    this.#open = open4;
+  constructor(open5) {
+    this.#open = open5;
   }
   /**
    * Each terminal as it starts, writes and exits: those already there first, each with the end of
@@ -85058,7 +85097,7 @@ var OPENAPI = {
   "openapi": "3.1.0",
   "info": {
     "title": "AgentComputer",
-    "version": "0.0.12",
+    "version": "0.0.13",
     "description": "Computers for agents. This file is the source of truth: the HTTP API, the MCP control tools and the SDK are all generated from it. An operation with `x-mcp-tool` is also an MCP tool of that name.",
     "license": {
       "name": "Apache-2.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentorg/computer",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Computers for agents, as a service: a terminal, files and a browser over MCP",
   "license": "Apache-2.0",
   "repository": {
@@ -31,7 +31,7 @@
     "playwright-core": "1.65.0-alpha-2026-10-30"
   },
   "devDependencies": {
-    "@agentorg/exec": "0.0.6",
+    "@agentorg/exec": "0.0.7",
     "@biomejs/biome": "2.6.5",
     "@modelcontextprotocol/client": "2.4.0",
     "@modelcontextprotocol/node": "2.1.2",