@isomorph.ai/app-sdk 1.25.0 → 1.26.0

package/dist/computer-use.d.ts

@@ -1,4 +1,11 @@
+export interface ComputerUseFile {
+    name: string;
+    contentType: "application/pdf";
+    dataBase64: string;
+}
 export interface ComputerUseOptions {
+    /** App-authorized PDFs, at most five files and 2 MiB total. Never supplied by the model. */
+    files?: readonly ComputerUseFile[];
     /** The job's runId, or `<job name>/<scheduledAt>` for a scheduled job: one task record per job run. */
     runKey: string;
     /** The job's progress: called on each new step and at least once a minute, which renews the job's lease. */

package/dist/computer-use.js

@@ -8,6 +8,24 @@ const HEARTBEAT_MS = 60_000;
 // Checks the API did not answer (a throttle, a 5xx, no connection) before the tool gives up: about a minute.
 const MAX_MISSED_CHECKS = 12;
 export function createComputerUseTool(options) {
+    const files = options.files?.map(file => ({ ...file }));
+    if (files) {
+        const names = new Set();
+        let total = 0;
+        if (files.length > 5)
+            throw new Error("Computer use accepts at most five PDFs.");
+        for (const file of files) {
+            if (!/^[A-Za-z0-9][A-Za-z0-9_.-]{0,119}\.pdf$/.test(file.name) || names.has(file.name))
+                throw new Error("Computer use PDF names must be unique safe basenames.");
+            if (file.contentType !== "application/pdf" || typeof file.dataBase64 !== "string" || file.dataBase64.length > Math.ceil(2 * 1024 * 1024 / 3) * 4)
+                throw new Error("Computer use needs base64 PDFs, at most 2 MiB total.");
+            const bytes = Buffer.from(file.dataBase64, "base64");
+            total += bytes.length;
+            if (bytes.toString("base64") !== file.dataBase64 || bytes.subarray(0, 5).toString() !== "%PDF-" || total > 2 * 1024 * 1024)
+                throw new Error("Computer use needs PDFs, at most 2 MiB total.");
+            names.add(file.name);
+        }
+    }
     const env = options.env ?? process.env;
     const base = env.ISOMORPH_COMPUTER_USE_URL?.replace(/\/+$/, '');
     if (!base)
@@ -26,7 +44,7 @@ export function createComputerUseTool(options) {
         description: 'Do one task in a web browser, such as filling in and submitting a form on a website. Describe the whole task in plain words, with the website address and any details it needs. Waits until the task ends and returns its status and a summary.',
         inputSchema: jsonSchema({ type: 'object', properties: { task: { type: 'string', minLength: 1 } }, required: ['task'], additionalProperties: false }),
         execute: async ({ task }) => {
-            const started = await call('/tasks', { run_key: options.runKey, task });
+            const started = await call('/tasks', { run_key: options.runKey, task, ...(files?.length ? { files } : {}) });
             if (started.status !== 200)
                 throw refused('/tasks', started.status, started.body);
             await options.progress(0, 'Computer use task started.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isomorph.ai/app-sdk",
-  "version": "1.25.0",
+  "version": "1.26.0",
   "type": "module",
   "repository": {
     "type": "git",