@agentorg/computer 0.0.6 → 0.0.8

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

@@ -146,7 +146,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** A one-time ticket to watch or operate one of its surfaces live: the agent's commands as they run, or a shell of your own. Open its url as a WebSocket within 60 seconds. */
+        /** A one-time ticket to watch or operate one of its surfaces live: the agent's commands as they run, a shell of your own, its files, or its browser. Open its url as a WebSocket within 60 seconds. */
         post: operations["createLiveSession"];
         delete?: never;
         options?: never;
@@ -248,12 +248,12 @@ export interface components {
             };
         };
         /**
-         * @description commands: the agent's commands as they run, read-only, in commands@1. terminal: a shell of your own in its workspace, as its user, in pty@1. browser: its browser, in screencast@1: binary messages are JPEG frames of the page shown, text messages are ScreencastEvent one way and ScreencastInput the other. Operating it makes you the driver: the agent's browser calls wait up to 25 seconds while you are, then answer that a person has or had it. You stop being the driver when you send release, close the socket, or send nothing for 60 seconds.
+         * @description commands: the agent's commands as they run, read-only, in commands@1. terminal: a shell of your own in its workspace, as its user, in pty@1. files: its workspace's files, in files@1: text messages are FilesRequest one way and FilesAnswer the other, and a file's bytes travel as binary messages of at most 1,048,576 bytes. Watching lists and reads; operating also writes, which a computer with read access doesn't offer. browser: its browser, in screencast@1: binary messages are JPEG frames of the page shown, text messages are ScreencastEvent one way and ScreencastInput the other. Nobody waits for anybody: the agent's tools and a person's input act on the same browser at once. The page shown is each socket's own. A socket is shown each new tab as it opens, until it sends a tab input to show or open one; from then its page changes only when that page closes.
          * @enum {string}
          */
-        Surface: "commands" | "terminal" | "browser";
+        Surface: "commands" | "terminal" | "files" | "browser";
         /**
-         * @description In watch, what you send is dropped.
+         * @description In watch you see and don't act: what you send is dropped, except that a files socket may still ask to list, to read and for what changed.
          * @enum {string}
          */
         LiveMode: "watch" | "operate";
@@ -262,7 +262,7 @@ export interface components {
             protocol: string;
             /** @description Whether it can be operated */
             operate: boolean;
-            /** @description Why it can't be opened here */
+            /** @description Why it can't be opened now, if it can't. */
             unavailable?: string;
         };
         NewLiveSession: {
@@ -316,12 +316,6 @@ export interface components {
                 label: string;
                 selected: boolean;
             }[];
-        } | {
-            /** @constant */
-            type: "driver";
-            you: boolean;
-            held: boolean;
-            agentWaiting: boolean;
         };
         /** @description What an operate socket sends on screencast@1, as JSON text. A watch socket's is dropped. */
         ScreencastInput: {
@@ -374,11 +368,90 @@ export interface components {
         } | {
             /** @constant */
             type: "navigate";
-            /** @description A URL */
+            /** @description A URL, or back, forward or reload. */
             to: string;
+        };
+        /** @description What a socket sends on files@1, as JSON text. Each has an id of its own choosing, which the answer repeats; answers come as they are ready, in any order, and ids aren't checked for repeats. A request still unanswered when the socket closes gets no answer. A path is from the workspace, with / between its parts, or absolute inside it, and nothing outside the workspace is reached. A binary message that follows no write closes the socket, and so does any message over 1,048,576 bytes. */
+        FilesRequest: {
+            /** @constant */
+            type: "list";
+            id: string;
+            /** @description The workspace itself, if left out. */
+            path?: string;
+        } | {
+            /** @constant */
+            type: "read";
+            id: string;
+            path: string;
+            offset: number;
+            length: number;
+        } | {
+            /** @constant */
+            type: "changed";
+            id: string;
+            /** Format: date-time */
+            since: string;
+        } | {
+            /** @constant */
+            type: "write";
+            id: string;
+            path: string;
+            offset: number;
+            length: number;
+            last: boolean;
+        };
+        /** @description What the service sends on files@1, as JSON text, each with the id it answers. Nothing comes between a data message and its bytes. */
+        FilesAnswer: {
+            /** @constant */
+            type: "entries";
+            id: string;
+            path: string;
+            entries: {
+                name: string;
+                /** @enum {string} */
+                kind: "file" | "folder" | "link";
+                size: number;
+                /** Format: date-time */
+                modifiedAt: string;
+            }[];
+            /** @description Whether the folder has more than these. */
+            more: boolean;
         } | {
             /** @constant */
-            type: "release";
+            type: "data";
+            id: string;
+            path: string;
+            offset: number;
+            /** @description How many bytes follow. */
+            length: number;
+            size: number;
+            /** Format: date-time */
+            modifiedAt: string;
+        } | {
+            /** @constant */
+            type: "changes";
+            id: string;
+            /** Format: date-time */
+            since: string;
+            changes: {
+                path: string;
+                size: number;
+                /** Format: date-time */
+                modifiedAt: string;
+            }[];
+            /** @description Whether more than these changed. */
+            more: boolean;
+        } | {
+            /** @constant */
+            type: "written";
+            id: string;
+            path: string;
+            size: number;
+        } | {
+            /** @constant */
+            type: "refused";
+            id: string;
+            message: string;
         };
         ComputerLogs: {
             logs: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentorg/computer",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Computers for agents, as a service: a terminal, files and a browser over MCP",
   "license": "Apache-2.0",
   "repository": {
@@ -28,15 +28,15 @@
     "test": "npm run build && node --test --test-timeout=60000 \"out/test/**/*.test.js\""
   },
   "dependencies": {
-    "@playwright/mcp": "0.0.84",
     "playwright-core": "1.65.0-alpha-2026-10-30"
   },
   "devDependencies": {
-    "@agentorg/exec": "0.0.3",
+    "@agentorg/exec": "0.0.4",
     "@biomejs/biome": "2.6.5",
     "@modelcontextprotocol/client": "2.4.0",
     "@modelcontextprotocol/node": "2.1.2",
     "@modelcontextprotocol/server": "2.4.0",
+    "@playwright/mcp": "0.0.84",
     "@types/node": "^22.20.5",
     "@types/ws": "8.18.2",
     "ajv": "8.20.0",