@agentorg/computer 0.0.10 → 0.0.11

package/README.md

@@ -148,7 +148,7 @@ A computer at `--access terminal` has a surface you can open live, as a WebSocke
 A computer at `--access read` or above has another, and at `read` it is the only one:
 
 - **`files`** (protocol `files@1`): its workspace's files, for a file window. Text messages are JSON, and each request has an `id` of your choosing, which its answer repeats. `openapi.yaml` has each one's fields.
-  - **`list`** is answered with `entries`: a folder's entries with their kind, size and date, folders first, the first thousand.
+  - **`list`** is answered with `entries`: a folder's entries with their kind, size and date, folders first, the first thousand. With them come `path`, the folder as it was asked for, and `workspace`, what the workspace is called: its folder's own name, and nothing of where it is. The two together name the folder, `Research/src`; a workspace the service made is called `workspace`, and one at the top of a disk has an empty name. A computer in a container made before `workspace` was added sends none, and then `path` alone names the folder.
   - **`read`** is answered with `data` and then one binary message, a range of a file's bytes. A file larger than one range is read by asking again from where the last ended.
   - **`changed`** is answered with `changes`: the files modified after a time, the newest thousand, the newest first. It skips what `.gitignore` files ignore, `.git`, `node_modules` and links, and a file that was removed isn't one of them. Each one asked walks the workspace once, a computer walks for one at a time, and nothing is walked that wasn't asked for.
   - **`write`**, on an `operate` socket, puts a file there a part at a time, each followed at once by one binary message, its bytes. Nothing is at the path until the part marked `last`, which puts the file there whole and is answered with `written`; the parts before it are answered only if one is refused. It makes no folders, and nothing removes or renames a file. A file not finished when the socket closes is given up.

package/dist/agentcomputer.js

@@ -3849,7 +3849,7 @@ async function serveBrowserMcp(options) {
 import { execFile as execFile2, spawn as spawn3 } from "node:child_process";
 import { readFileSync as readFileSync3 } from "node:fs";
 import { connect } from "node:net";
-import { join as join8 } from "node:path";
+import { basename as basename3, join as join8 } from "node:path";
 import { createInterface as createInterface2 } from "node:readline";
 import { Readable as Readable3 } from "node:stream";
 import { promisify as promisify2 } from "node:util";
@@ -28158,7 +28158,7 @@ import { join as join7 } from "node:path";
 // src/runtime.ts
 import { chmodSync as chmodSync2, existsSync, statSync as statSync2 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
-import { dirname as dirname3, join as join6 } from "node:path";
+import { basename as basename2, dirname as dirname3, join as join6 } from "node:path";
 
 // node_modules/@agentorg/exec/dist/lib.js
 import { realpathSync } from "node:fs";
@@ -28915,11 +28915,11 @@ var require_ignore = __commonJS2({
         const rules = this._rules;
         const { length } = rules;
         const shortcut = this._basenameCount * 2 >= length;
-        const basename2 = shortcut ? basenameOf(path) : path;
+        const basename22 = shortcut ? basenameOf(path) : path;
         for (let index = length - 1; index >= 0; index--) {
           const rule = rules[index];
           if (rule[mode].test(
-            shortcut && rule._basenameOnly ? basename2 : path
+            shortcut && rule._basenameOnly ? basename22 : path
           )) {
             const { negative } = rule;
             const ret = {
@@ -67117,16 +67117,6 @@ var BrowserLive = class {
   }
 };
 
-// node_modules/ws/wrapper.mjs
-var import_stream2 = __toESM(require_stream(), 1);
-var import_extension = __toESM(require_extension(), 1);
-var import_permessage_deflate = __toESM(require_permessage_deflate(), 1);
-var import_receiver = __toESM(require_receiver(), 1);
-var import_sender = __toESM(require_sender(), 1);
-var import_subprotocol = __toESM(require_subprotocol(), 1);
-var import_websocket = __toESM(require_websocket(), 1);
-var import_websocket_server = __toESM(require_websocket_server(), 1);
-
 // src/files-live.ts
 var MAX_PART = 1024 * 1024;
 var MAX_BUFFERED2 = 4 * 1024 * 1024;
@@ -67137,13 +67127,16 @@ var whole = (value) => Number.isSafeInteger(value);
 var sleep4 = (ms) => new Promise((done) => setTimeout(done, ms));
 var FilesLive = class {
   #files;
+  #workspace;
   #sockets = /* @__PURE__ */ new Set();
   /** One walk of the workspace at a time, however many ask. */
   #walking = Promise.resolve();
   /** How many files are part written, over every socket. */
   #uploads = 0;
-  constructor(files) {
+  /** `workspace` is what the workspace is called: its folder's own name, not where it is. */
+  constructor(files, workspace) {
     this.#files = files;
+    this.#workspace = workspace;
   }
   close() {
     for (const ws of this.#sockets) ws.close(1001, "It stopped.");
@@ -67213,7 +67206,13 @@ var FilesLive = class {
           const path = request.path ?? ".";
           if (!text2(path)) throw new Error("A path is text.");
           return inTurn(
-            async () => send2({ type: "entries", id, path, ...await this.#files.list(path) })
+            async () => send2({
+              type: "entries",
+              id,
+              workspace: this.#workspace,
+              path,
+              ...await this.#files.list(path)
+            })
           );
         }
         case "read": {
@@ -67294,6 +67293,16 @@ var FilesLive = class {
   }
 };
 
+// node_modules/ws/wrapper.mjs
+var import_stream2 = __toESM(require_stream(), 1);
+var import_extension = __toESM(require_extension(), 1);
+var import_permessage_deflate = __toESM(require_permessage_deflate(), 1);
+var import_receiver = __toESM(require_receiver(), 1);
+var import_sender = __toESM(require_sender(), 1);
+var import_subprotocol = __toESM(require_subprotocol(), 1);
+var import_websocket = __toESM(require_websocket(), 1);
+var import_websocket_server = __toESM(require_websocket_server(), 1);
+
 // src/text.ts
 var MAX_TEXT = 1e4;
 function* pieces(text3, most = MAX_TEXT) {
@@ -67346,7 +67355,7 @@ var Live = class {
   /** Whether a person may write files here: not where the agent can only read them. */
   #writes;
   #load;
-  constructor(exec, access, load, browser) {
+  constructor(exec, access, load, files, browser) {
     this.#load = load;
     if (exec && access === "terminal") {
       this.#terminals = exec.terminals;
@@ -67354,7 +67363,7 @@ var Live = class {
         for (const message of messages(event)) for (const ws of this.#viewers) deliver(ws, message);
       });
     }
-    this.#files = exec && new FilesLive(exec.files);
+    this.#files = files;
     this.#writes = access !== "read";
     this.#browser = browser;
   }
@@ -67648,7 +67657,8 @@ var ProcessRuntime = class {
       browser.gate = browserLive;
     }
     const load = new LoadLive(spec.workspace ?? folder, this.#contained);
-    const live = new Live(exec, spec.access, load, browserLive);
+    const files = exec && new FilesLive(exec.files, spec.workspaceName ?? basename2(spec.workspace));
+    const live = new Live(exec, spec.access, load, files, browserLive);
     const surfaces = live.surfaces();
     return {
       browserTools: browser?.tools ?? [],
@@ -67678,6 +67688,7 @@ var ProcessRuntime = class {
 // src/inside.ts
 var INNER_PORT = 8e3;
 var INNER_TOKEN_VARIABLE = "AGENTCOMPUTER_INNER_TOKEN";
+var WORKSPACE_NAME_VARIABLE = "AGENTCOMPUTER_WORKSPACE_NAME";
 var BROWSER = "/opt/browsers/headless-shell";
 async function serveInside(options) {
   const token = process.env[INNER_TOKEN_VARIABLE];
@@ -67688,7 +67699,7 @@ async function serveInside(options) {
     {
       id: "inside",
       ...options,
-      ...options.access === "none" ? {} : { workspace: "/workspace" }
+      ...options.access === "none" ? {} : { workspace: "/workspace", workspaceName: process.env[WORKSPACE_NAME_VARIABLE] }
     },
     privateFolder(join7(homedir(), ".agentcomputer")),
     {
@@ -67816,6 +67827,9 @@ var ContainerRuntime = class {
         // By name, so the value stays out of the command line other users can see.
         "--env",
         INNER_TOKEN_VARIABLE,
+        // What its workspace is called, which in there is only /workspace. An image from before
+        // this was told leaves it.
+        ...spec.workspace ? ["--env", WORKSPACE_NAME_VARIABLE] : [],
         // Files it writes in the workspace belong to whoever runs the service.
         ...uid ? ["--user", `${uid}:${process.getgid?.()}`] : [],
         ...spec.workspace ? [
@@ -67828,7 +67842,11 @@ var ContainerRuntime = class {
         spec.access,
         ...spec.browser ? ["--browser"] : []
       ],
-      { ...process.env, [INNER_TOKEN_VARIABLE]: token }
+      {
+        ...process.env,
+        [INNER_TOKEN_VARIABLE]: token,
+        ...spec.workspace ? { [WORKSPACE_NAME_VARIABLE]: basename3(spec.workspace) } : {}
+      }
     );
   }
   /** The token between the service and this container, which a restart has to find again. */
@@ -67972,7 +67990,7 @@ async function forward(url3, authorization, request, response) {
 }
 
 // src/handlers.ts
-var VERSION2 = "0.0.10";
+var VERSION2 = "0.0.11";
 function createHandlers(computers) {
   return {
     getInfo: async () => ({ version: VERSION2, isolation: computers.isolation }),
@@ -84935,7 +84953,7 @@ var OPENAPI = {
   "openapi": "3.1.0",
   "info": {
     "title": "AgentComputer",
-    "version": "0.0.10",
+    "version": "0.0.11",
     "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",
@@ -86442,8 +86460,13 @@ var OPENAPI = {
               "id": {
                 "type": "string"
               },
+              "workspace": {
+                "type": "string",
+                "description": "What the workspace is called: its folder's own name, and nothing of where it is. It comes with every entries answer, whichever folder was asked for, so that with path it names the folder. A computer in a container made before `workspace` was added sends none, and there path alone names the folder. It is `workspace` for a workspace the service made, and empty for one at the top of a disk."
+              },
               "path": {
-                "type": "string"
+                "type": "string",
+                "description": "The folder as it was asked for: `.` for the workspace itself."
               },
               "entries": {
                 "type": "array",

package/dist/types/generated/schema.d.ts

@@ -487,6 +487,9 @@ export interface components {
             /** @constant */
             type: "entries";
             id: string;
+            /** @description What the workspace is called: its folder's own name, and nothing of where it is. It comes with every entries answer, whichever folder was asked for, so that with path it names the folder. A computer in a container made before `workspace` was added sends none, and there path alone names the folder. It is `workspace` for a workspace the service made, and empty for one at the top of a disk. */
+            workspace?: string;
+            /** @description The folder as it was asked for: `.` for the workspace itself. */
             path: string;
             entries: {
                 name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentorg/computer",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Computers for agents, as a service: a terminal, files and a browser over MCP",
   "license": "Apache-2.0",
   "repository": {