@trycua/cua-driver 0.36.0 → 0.38.0

package/README.md

@@ -14,11 +14,8 @@ import { CuaDriver } from "@trycua/cua-driver"
 organizational `/embedded` entrypoint; they are the same generated Rust object.
 The `/electron` entrypoint is a thin compatibility naming layer over the same
 generated macOS permission functions. The package does not contain a TypeScript
-MCP protocol implementation. The optional `/fleet` entrypoint forwards service
-bytes to the shared Rust typed-MCP client and returns the canonical Driver.
-See [the candidate Fleet connection guide](../docs/shared-fleet-mcp-client.md)
-for prerequisites, ownership, and release limits. Agents already have
-runtime-neutral MCP clients and should configure the executable directly:
+MCP protocol implementation. Agents already have runtime-neutral MCP clients
+and should configure the executable directly:
 
 ```text
 cua-driver mcp

package/dist/native/cua_driver_contract.d.ts

@@ -77,6 +77,25 @@ export declare const ActionEvidence: Readonly<{
     new: (partial: Partial<ActionEvidence> & Required<Omit<ActionEvidence, "detail">>) => ActionEvidence;
     defaults: () => Partial<ActionEvidence>;
 }>;
+/**
+ * A call an agent can make next: `{tool, arguments}`.
+ */
+export type ActionNextCall = {
+    tool: string;
+    /**
+     * The call's arguments. A JSON object on the wire; the SDK records carry
+     * the same object as JSON text.
+     */
+    arguments: string;
+};
+/**
+ * Generated factory for {@link ActionNextCall} record objects.
+ */
+export declare const ActionNextCall: Readonly<{
+    create: (partial: Partial<ActionNextCall> & Required<Omit<ActionNextCall, never>>) => ActionNextCall;
+    new: (partial: Partial<ActionNextCall> & Required<Omit<ActionNextCall, never>>) => ActionNextCall;
+    defaults: () => Partial<ActionNextCall>;
+}>;
 export declare enum ActionEffect {
     Confirmed = 0,
     Partial = 1,
@@ -109,13 +128,26 @@ export type ActionResult = {
      * Present only with `effect: refused`.
      */
     error?: ActionError;
+    /**
+     * What to do next, in one short sentence. Present when the effect is
+     * `unverifiable` or `suspected_noop`, so an unconfirmed action points at
+     * the next step instead of leaving the agent to guess. Also carries a
+     * suggestion to chain steps with `run_steps` after several direct actions
+     * in a row.
+     */
+    hint?: string;
+    /**
+     * The call that moves the task forward, always safe to run as is (a read,
+     * or a call that keeps the user's window where it is).
+     */
+    nextCall?: ActionNextCall;
 };
 /**
  * Generated factory for {@link ActionResult} record objects.
  */
 export declare const ActionResult: Readonly<{
-    create: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "delivery" | "evidence" | "escalation" | "summary" | "error">>) => ActionResult;
-    new: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "delivery" | "evidence" | "escalation" | "summary" | "error">>) => ActionResult;
+    create: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "hint" | "delivery" | "evidence" | "escalation" | "summary" | "error" | "nextCall">>) => ActionResult;
+    new: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "hint" | "delivery" | "evidence" | "escalation" | "summary" | "error" | "nextCall">>) => ActionResult;
     defaults: () => Partial<ActionResult>;
 }>;
 export type AppInfo = {
@@ -2437,6 +2469,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): ActionEvidenceKind;
             lower(value: ActionEvidenceKind, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
         };
+        FfiConverterTypeActionNextCall: {
+            read(from: RustBuffer): ActionNextCall;
+            write(value: ActionNextCall, into: RustBuffer): void;
+            allocationSize(value: ActionNextCall): number;
+            lift(value: UniffiByteArray): ActionNextCall;
+            lower(value: ActionNextCall, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
         FfiConverterTypeActionResult: {
             read(from: RustBuffer): ActionResult;
             write(value: ActionResult, into: RustBuffer): void;

package/dist/native/cua_driver_contract.js

@@ -293,6 +293,40 @@ const FfiConverterTypeActionEvidence = (() => {
     ;
     return new FFIConverter();
 })();
+/**
+ * Generated factory for {@link ActionNextCall} record objects.
+ */
+export const ActionNextCall = (() => {
+    const defaults = () => ({});
+    const create = (() => {
+        return uniffiCreateRecord(defaults);
+    })();
+    return Object.freeze({
+        create,
+        new: create,
+        defaults: () => Object.freeze(defaults()),
+    });
+})();
+const FfiConverterTypeActionNextCall = (() => {
+    class FFIConverter extends AbstractFfiConverterByteArray {
+        read(from) {
+            return {
+                tool: FfiConverterString.read(from),
+                arguments: FfiConverterString.read(from)
+            };
+        }
+        write(value, into) {
+            FfiConverterString.write(value.tool, into);
+            FfiConverterString.write(value.arguments, into);
+        }
+        allocationSize(value) {
+            return FfiConverterString.allocationSize(value.tool) +
+                FfiConverterString.allocationSize(value.arguments);
+        }
+    }
+    ;
+    return new FFIConverter();
+})();
 export var ActionEffect;
 (function (ActionEffect) {
     ActionEffect[ActionEffect["Confirmed"] = 0] = "Confirmed";
@@ -392,7 +426,9 @@ const FfiConverterTypeActionResult = (() => {
                 evidence: FfiConverterOptionalSequenceTypeActionEvidence.read(from),
                 escalation: FfiConverterOptionalTypeActionEscalation.read(from),
                 summary: FfiConverterOptionalString.read(from),
-                error: FfiConverterOptionalTypeActionError.read(from)
+                error: FfiConverterOptionalTypeActionError.read(from),
+                hint: FfiConverterOptionalString.read(from),
+                nextCall: FfiConverterOptionalTypeActionNextCall.read(from)
             };
         }
         write(value, into) {
@@ -403,6 +439,8 @@ const FfiConverterTypeActionResult = (() => {
             FfiConverterOptionalTypeActionEscalation.write(value.escalation, into);
             FfiConverterOptionalString.write(value.summary, into);
             FfiConverterOptionalTypeActionError.write(value.error, into);
+            FfiConverterOptionalString.write(value.hint, into);
+            FfiConverterOptionalTypeActionNextCall.write(value.nextCall, into);
         }
         allocationSize(value) {
             return FfiConverterTypeActionEffect.allocationSize(value.effect) +
@@ -411,7 +449,9 @@ const FfiConverterTypeActionResult = (() => {
                 FfiConverterOptionalSequenceTypeActionEvidence.allocationSize(value.evidence) +
                 FfiConverterOptionalTypeActionEscalation.allocationSize(value.escalation) +
                 FfiConverterOptionalString.allocationSize(value.summary) +
-                FfiConverterOptionalTypeActionError.allocationSize(value.error);
+                FfiConverterOptionalTypeActionError.allocationSize(value.error) +
+                FfiConverterOptionalString.allocationSize(value.hint) +
+                FfiConverterOptionalTypeActionNextCall.allocationSize(value.nextCall);
         }
     }
     ;
@@ -4861,6 +4901,8 @@ const FfiConverterOptionalSequenceTypeActionEvidence = new FfiConverterOptional(
 const FfiConverterOptionalTypeActionEscalation = new FfiConverterOptional(FfiConverterTypeActionEscalation);
 // FfiConverter for ActionError | undefined
 const FfiConverterOptionalTypeActionError = new FfiConverterOptional(FfiConverterTypeActionError);
+// FfiConverter for ActionNextCall | undefined
+const FfiConverterOptionalTypeActionNextCall = new FfiConverterOptional(FfiConverterTypeActionNextCall);
 // FfiConverter for number | undefined
 const FfiConverterOptionalFloat64 = new FfiConverterOptional(FfiConverterFloat64);
 // FfiConverter for ClickButton | undefined
@@ -4974,6 +5016,7 @@ export default Object.freeze({
         FfiConverterTypeActionEscalationTarget,
         FfiConverterTypeActionEvidence,
         FfiConverterTypeActionEvidenceKind,
+        FfiConverterTypeActionNextCall,
         FfiConverterTypeActionResult,
         FfiConverterTypeActionRoute,
         FfiConverterTypeActionTarget,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trycua/cua-driver",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "description": "Rust-backed Cua Driver SDK and embedded Node host",
   "type": "module",
   "license": "MIT",
@@ -22,10 +22,6 @@
     "./electron": {
       "types": "./dist/electron.d.ts",
       "import": "./dist/electron.js"
-    },
-    "./fleet": {
-      "types": "./dist/fleet.d.ts",
-      "import": "./dist/fleet.js"
     }
   },
   "files": [
@@ -35,8 +31,6 @@
     "dist/embedded.d.ts",
     "dist/electron.js",
     "dist/electron.d.ts",
-    "dist/fleet.js",
-    "dist/fleet.d.ts",
     "dist/native",
     "README.md",
     "dist/daemon.js",
@@ -50,11 +44,11 @@
     "@ubjs/node": "0.31.0-3"
   },
   "optionalDependencies": {
-    "@trycua/cua-driver-darwin-arm64": "0.36.0",
-    "@trycua/cua-driver-darwin-x64": "0.36.0",
-    "@trycua/cua-driver-linux-arm64-gnu": "0.36.0",
-    "@trycua/cua-driver-linux-x64-gnu": "0.36.0",
-    "@trycua/cua-driver-win32-arm64-msvc": "0.36.0",
-    "@trycua/cua-driver-win32-x64-msvc": "0.36.0"
+    "@trycua/cua-driver-darwin-arm64": "0.38.0",
+    "@trycua/cua-driver-darwin-x64": "0.38.0",
+    "@trycua/cua-driver-linux-arm64-gnu": "0.38.0",
+    "@trycua/cua-driver-linux-x64-gnu": "0.38.0",
+    "@trycua/cua-driver-win32-arm64-msvc": "0.38.0",
+    "@trycua/cua-driver-win32-x64-msvc": "0.38.0"
   }
 }

package/dist/fleet.d.ts

@@ -1,48 +0,0 @@
-import { type CuaDriverLike } from './index.js';
-/** Structural subset of Fleet's generated Sandbox record. */
-export interface FleetDriverSandbox {
-    namespace: string;
-    claim: string;
-    name: string;
-    services: string[];
-}
-/** Compatible with the generated Fleet client; no shared native pointers. */
-export interface FleetDriverClient {
-    serviceRequest(sandbox: FleetDriverSandbox, service: string, path: string, request: {
-        method: string;
-        url: string;
-        headers: {
-            name: string;
-            value: string;
-        }[];
-        body?: ArrayBuffer;
-        timeoutSecs?: bigint;
-        maxResponseBytes?: bigint;
-    }, options?: {
-        signal: AbortSignal;
-    }): Promise<{
-        status: number;
-        headers: {
-            name: string;
-            value: string;
-        }[];
-        body: ArrayBuffer;
-    }>;
-}
-export interface FleetDriverConnection {
-    readonly driver: CuaDriverLike;
-    readonly sessionName: string;
-    /** Close before releasing the Fleet claim. This never releases the claim. */
-    close(): Promise<void>;
-}
-/**
- * Connect to an advertised service on the caller's live Fleet claim.
- * The caller owns the client and claim, and must await close before releasing
- * either. Abort closes this connection; it does not undo desktop actions.
- */
-export declare function connectFleetDriver({ client, sandbox, service, signal, }: {
-    client: FleetDriverClient;
-    sandbox: FleetDriverSandbox;
-    service?: string;
-    signal?: AbortSignal;
-}): Promise<FleetDriverConnection>;

package/dist/fleet.js

@@ -1,98 +0,0 @@
-/** Node-only composition of an existing Fleet client and the shared Rust Driver. */
-import { randomUUID } from 'node:crypto';
-import { openMcpDriverChannel, DriverServiceTransportError, } from './index.js';
-const FLEET_DRIVER_MAX_RESPONSE_BYTES = 16n * 1024n * 1024n;
-/**
- * Connect to an advertised service on the caller's live Fleet claim.
- * The caller owns the client and claim, and must await close before releasing
- * either. Abort closes this connection; it does not undo desktop actions.
- */
-export async function connectFleetDriver({ client, sandbox, service = 'mcp', signal, }) {
-    const target = {
-        namespace: sandbox.namespace,
-        claim: sandbox.claim,
-        name: sandbox.name,
-        services: [...sandbox.services],
-    };
-    if (!target.services.includes(service)) {
-        throw new Error('Fleet sandbox does not advertise the requested Driver service');
-    }
-    if (signal?.aborted)
-        throw new Error('Fleet Driver connection aborted');
-    const serviceRequest = client.serviceRequest.bind(client);
-    let closing;
-    async function send(request) {
-        // Keep routing authority in Fleet even if the native boundary changes.
-        if (!request.path.startsWith('/') ||
-            request.path.length > 2048 ||
-            request.path.startsWith('//') ||
-            /[\\?#\s%]/u.test(request.path) ||
-            request.path.split('/').some((part) => part === '.' || part === '..') ||
-            request.timeoutMs <= 0n ||
-            request.timeoutMs > 2147483647n) {
-            throw new DriverServiceTransportError.Failed({
-                reason: 'Invalid bounded Driver service request',
-            });
-        }
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), Number(request.timeoutMs));
-        let onAbort = () => { };
-        const aborted = new Promise((_, reject) => {
-            onAbort = () => reject(new Error('Fleet Driver service request canceled'));
-            controller.signal.addEventListener('abort', onAbort, { once: true });
-        });
-        try {
-            const response = await Promise.race([
-                serviceRequest({ ...target, services: [...target.services] }, service, request.path, {
-                    method: request.method,
-                    url: `https://service.invalid${request.path}`,
-                    headers: request.headers.map((header) => ({ ...header })),
-                    body: request.body,
-                    timeoutSecs: (request.timeoutMs + 999n) / 1000n,
-                    maxResponseBytes: FLEET_DRIVER_MAX_RESPONSE_BYTES,
-                }, { signal: controller.signal }),
-                aborted,
-            ]);
-            if (BigInt(response.body.byteLength) > FLEET_DRIVER_MAX_RESPONSE_BYTES) {
-                throw new Error('Fleet Driver response exceeds the configured size limit');
-            }
-            return response;
-        }
-        catch {
-            // Native callback errors must not expose Fleet credentials or response bodies.
-            throw new DriverServiceTransportError.Failed({
-                reason: 'Fleet Driver service request failed',
-            });
-        }
-        finally {
-            clearTimeout(timeout);
-            controller.signal.removeEventListener('abort', onAbort);
-        }
-    }
-    const channel = openMcpDriverChannel({ send }, `fleet:${randomUUID()}`);
-    const close = () => {
-        if (!closing) {
-            signal?.removeEventListener('abort', onAbort);
-            // Retain the promise so cancellation cannot orphan cleanup or hide errors
-            // from a later explicit close. Rust bounds its own session teardown.
-            closing = channel.close();
-        }
-        return closing;
-    };
-    const onAbort = () => {
-        void close().catch(() => { });
-    };
-    signal?.addEventListener('abort', onAbort, { once: true });
-    try {
-        if (signal?.aborted)
-            throw new Error('Fleet Driver connection aborted');
-        await channel.open();
-        if (signal?.aborted || closing)
-            throw new Error('Fleet Driver connection aborted');
-        return Object.freeze({ driver: channel.driver(), sessionName: channel.publicSession(), close });
-    }
-    catch (error) {
-        await close();
-        throw error;
-    }
-}