@isomorph.ai/app-sdk 1.34.0 → 1.34.1

package/README.md

@@ -386,6 +386,7 @@ const computerUse = createComputerUseTool({ runKey: ctx.runId ?? `my-job/${ctx.s
 - It calls `progress(step count, note)` on every new step and at least once a minute, so the job's lease does not run out.
 - When `cancelled()` turns true it sends `POST /tasks/cancel` once and keeps checking until the task has `failed`.
 - One task record per `runKey`: a retried job run sends the same key and gets the queued, running or finished task back. Only a failed task starts a new attempt.
+- For a website account the owner has connected in the app, pass its opaque `connectionId` in the options. The SDK sends it only when starting the task, outside the model's tool arguments. The computer-use service verifies that the signed app role owns that connection; omit it for ordinary browser tasks.
 
 (1.25.0; data plane ADR 0078)
 

package/dist/computer-use.d.ts

@@ -6,6 +6,8 @@ export interface ComputerUseFile {
 export interface ComputerUseOptions {
     /** App-authorized PDFs, at most five files and 2 MiB total. Never supplied by the model. */
     files?: readonly ComputerUseFile[];
+    /** Owner-authorized browser session reference. Never supplied by the model. */
+    connectionId?: string;
     /** 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,10 @@ 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 connectionId = options.connectionId;
+    if (connectionId !== undefined && (typeof connectionId !== 'string' || !/^[a-f0-9]{32}$/.test(connectionId))) {
+        throw new Error('Computer use needs a valid browser connection ID.');
+    }
     const files = options.files?.map(file => ({ ...file }));
     if (files) {
         const names = new Set();
@@ -44,7 +48,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, ...(files?.length ? { files } : {}) });
+            const started = await call('/tasks', { run_key: options.runKey, task, ...(files?.length ? { files } : {}), ...(connectionId ? { connectionId } : {}) });
             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.34.0",
+  "version": "1.34.1",
   "type": "module",
   "repository": {
     "type": "git",