@isomorph.ai/app-sdk 1.42.0 → 1.44.0

package/README.md

@@ -451,7 +451,7 @@ Keep that table protected by the app's user row rules. A trusted action must sti
 - `requestTakeover(reason, requiredInput?)` requests a pause; `requiredInput` is `human` (default) or `login`. It answers the pause (`taskId`, `pauseId`, `status`, `reason`, `requiredInput`; the same pause again if one exists). Poll `check()` until `waiting_for_input` gives the pause plus the optional login result; while the task is not waiting, `check()` answers its progress (`status`, `steps`, `lastStep`, `summary`, `finalUrl`, `waiting`, `message`).
 - `view(pauseId)` returns `{status:'ready', screenshot, url}`; while the task is still pausing, or once it resumed, the API answers 409 and the call throws. Reuse the existing sign-in screenshot UI: display the base64 PNG as an image, map clicks to image pixels, and forward keyboard/scroll events through app actions. Viewing does not itself resume the agent.
 - `input(pauseId, action)` sends the same `SignInAction` click/type/key/scroll commands used by `sendSignInInput` (`typeText` may be up to 4096 characters here) and answers what the computer did. The CUA accepts human input only while the task is paused; it blocks the helper and main agent from acting at the same time.
-- `completeLogin(pauseId, {allowedHosts, username, password})`, or `completeLogin(pauseId, {otp})`, queues the separate browser-action-only login agent on this computer. **Call only from private server code, never expose this method or credentials as model tool inputs, prompts, progress, logs or job input/results.** Poll `check()` for `login.status: success | needs_input | human_help_needed`, with `input:'otp'` when another code is needed. Helper success leaves the main agent paused.
+- `completeLogin(pauseId, {allowedHosts, username, password})`, or `completeLogin(pauseId, {otp})`, queues the separate browser-action-only login agent on this computer. **Call only from private server code, never expose this method or credentials as model tool inputs, prompts, progress, logs or job input/results.** Poll `check()` for `login.status: success | needs_input | human_help_needed`, with `input:'otp'` when another code is needed, `reason` (`unverified_success`, `helper_gave_up`, `second_code_requested`, `helper_error:<type>`) when a person is needed, and the helper's short `evidence` (never a private value). Helper success leaves the main agent paused.
 - `resume(pauseId)` explicitly resumes and answers the pause with `status: 'resume_queued'`; it does not wait for completion. On Continue, call this from the authorized app action, then enqueue the app's continuation job. That job creates `createComputerUseTool({...jobOptions, runKey: originalRunKey, attach:true})`: it polls the same task without sending `/tasks` again. Keep the original saved-session and download options if needed. Stale/duplicate resumes fail with 409; do not silently retry with a new pause ID. If enqueue fails, retry attaching to the already resumed task, not another resume.
 - `cancel()` stops the task, including while waiting.
 

package/dist/computer-use-handoff-tool.d.ts

@@ -41,6 +41,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
                 login?: {
                     status: "success" | "needs_input" | "human_help_needed";
                     input?: "otp";
+                    reason?: string;
+                    evidence?: string;
                 };
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
@@ -55,6 +57,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
@@ -69,6 +73,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
@@ -101,6 +107,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     }) | ({
@@ -139,6 +147,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
                 login?: {
                     status: "success" | "needs_input" | "human_help_needed";
                     input?: "otp";
+                    reason?: string;
+                    evidence?: string;
                 };
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
@@ -153,6 +163,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
@@ -167,6 +179,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
@@ -199,6 +213,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     }) | ({
@@ -237,6 +253,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
                 login?: {
                     status: "success" | "needs_input" | "human_help_needed";
                     input?: "otp";
+                    reason?: string;
+                    evidence?: string;
                 };
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
@@ -251,6 +269,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
@@ -265,6 +285,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
@@ -290,6 +312,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     }) | ({
@@ -328,6 +352,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
                 login?: {
                     status: "success" | "needs_input" | "human_help_needed";
                     input?: "otp";
+                    reason?: string;
+                    evidence?: string;
                 };
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
@@ -342,6 +368,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
@@ -356,6 +384,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
@@ -381,6 +411,8 @@ export declare function createComputerUseHandoffTools(options: ComputerUseHandof
             login?: {
                 status: "success" | "needs_input" | "human_help_needed";
                 input?: "otp";
+                reason?: string;
+                evidence?: string;
             };
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     });

package/dist/computer-use-handoff.d.ts

@@ -13,9 +13,13 @@ export interface ComputerUseWaiting {
     reason: string;
     requiredInput: 'login' | 'otp' | 'human';
     message?: ComputerUseMessage;
+    /** The private login helper's answer; `reason` says why a person is needed (`unverified_success`, `helper_gave_up`,
+     * `second_code_requested`, `helper_error:<type>`) and `evidence` is the helper's short note on the page, never a private value. */
     login?: {
         status: 'success' | 'needs_input' | 'human_help_needed';
         input?: 'otp';
+        reason?: string;
+        evidence?: string;
     };
 }
 export declare function waitingInput(answer: {

package/dist/computer-use-handoff.js

@@ -22,7 +22,11 @@ export function waitingInput(answer) {
         result.message = message;
     const login = answer.login;
     if (login && ['success', 'needs_input', 'human_help_needed'].includes(login.status)) {
-        result.login = { status: login.status, ...(login.input === 'otp' ? { input: 'otp' } : {}) };
+        result.login = {
+            status: login.status, ...(login.input === 'otp' ? { input: 'otp' } : {}),
+            ...(typeof login.reason === 'string' && login.reason ? { reason: login.reason.slice(0, 200) } : {}),
+            ...(typeof login.evidence === 'string' && login.evidence ? { evidence: login.evidence.slice(0, 300) } : {}),
+        };
     }
     return result;
 }

package/dist/computer-use-otp.js

@@ -77,7 +77,7 @@ export async function signInWithOtp(handoff, pauseId, login, otp, options = {})
         if (login?.status === 'success')
             return { status: 'success' };
         if (login?.status === 'human_help_needed')
-            return { status: 'human_help_needed', reason: 'The sign-in helper could not finish on its own.' };
+            return { status: 'human_help_needed', reason: `The sign-in helper could not finish on its own${login.reason ? ` (${login.reason})` : ''}.` };
         if (login?.status === 'needs_input' && login.input === 'otp') {
             if (answered)
                 return { status: 'human_help_needed', reason: 'The website asked for a second code.' };

package/dist/index.d.ts

@@ -1161,6 +1161,7 @@ export type ZohoBooksRequest = {
     input: {
         customerId: string;
         pageToken?: string;
+        orderStatus?: 'all';
     };
 } | {
     operation: 'zohobooks.salesorder.read' | 'zohobooks.creditnote.read';

package/dist/integration-execute-input-rules.d.ts

@@ -2437,6 +2437,11 @@ export declare const IntegrationExecuteInputRules: {
                 readonly minLength: 1;
                 readonly maxLength: 2048;
             };
+            readonly orderStatus: {
+                readonly kind: "enum";
+                readonly required: false;
+                readonly values: readonly ["all"];
+            };
         };
     };
     readonly "zohobooks.salesorder.read": {

package/dist/integration-execute-input-rules.js

@@ -750,6 +750,7 @@ export const IntegrationExecuteInputRules = {
         fields: {
             customerId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
             pageToken: { kind: "string", required: false, minLength: 1, maxLength: 2048 },
+            orderStatus: { kind: "enum", required: false, values: ["all"] },
         },
     },
     "zohobooks.salesorder.read": {

package/package.json

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