@anionex/dsh-computer-use 0.2.1 → 0.3.0

package/native/macos/Sources/Helper/main.swift

@@ -6,7 +6,7 @@ import Darwin
 import Foundation
 import ScreenCaptureKit
 
-private let helperVersion = "0.2.1"
+private let helperVersion = "0.3.0"
 
 private struct HelperError: Error {
     let code: String
@@ -860,7 +860,10 @@ private func actionResult(
     ]
 }
 
-private func performAction(_ request: [String: Any]) throws -> [String: Any] {
+private func performAction(
+    _ request: [String: Any],
+    dragStartBarrier: (() throws -> Void)? = nil
+) throws -> [String: Any] {
     let appIdentity = try dictionary(request["app"], "request.app")
     let selector: [String: Any] = [
         "bundleId": try string(appIdentity["bundleId"], "app.bundleId"),
@@ -1023,9 +1026,25 @@ private func performAction(_ request: [String: Any]) throws -> [String: Any] {
         let coordinateSpace = action["coordinateSpace"] as? String ?? "window"
         let from = try windowPoint(action, window: current.snapshot.windowJSON, xKey: "fromX", yKey: "fromY", coordinateSpace: coordinateSpace)
         let to = try windowPoint(action, window: current.snapshot.windowJSON, xKey: "toX", yKey: "toY", coordinateSpace: coordinateSpace)
+        let cursorSpeed = try double(interaction["cursorSpeedPxPerSecond"], "request.interaction.cursorSpeedPxPerSecond")
+        let cursorAcceleration = try double(
+            interaction["cursorAccelerationPxPerSecondSquared"],
+            "request.interaction.cursorAccelerationPxPerSecondSquared"
+        )
+        guard cursorSpeed.isFinite, cursorSpeed >= 100, cursorSpeed <= 50_000,
+              cursorAcceleration.isFinite, cursorAcceleration >= 100, cursorAcceleration <= 500_000 else {
+            throw fail("COMPUTER_PROVIDER_FAILURE", "request.interaction cursor motion is outside the supported range")
+        }
         let target = try pointerTarget(app: app, window: current.snapshot.windowJSON, at: from)
+        try dragStartBarrier?()
         try pointerAction {
-            try targetedDrag(from: from, to: to, target: target)
+            try targetedDrag(
+                from: from,
+                to: to,
+                target: target,
+                speedPxPerSecond: cursorSpeed,
+                accelerationPxPerSecondSquared: cursorAcceleration
+            )
         }
         return actionResult(channel: "coordinates", activation: current.activation, pointerInput: true, pointerRouting: "target-process")
     case "perform-action":
@@ -1060,7 +1079,10 @@ private func performAction(_ request: [String: Any]) throws -> [String: Any] {
     }
 }
 
-private func handle(_ request: [String: Any]) async throws -> Any {
+private func handle(
+    _ request: [String: Any],
+    dragStartBarrier: (() throws -> Void)? = nil
+) async throws -> Any {
     guard (request["protocolVersion"] as? NSNumber)?.intValue == 1 else {
         throw fail("COMPUTER_PROVIDER_FAILURE", "unsupported helper protocol version")
     }
@@ -1112,8 +1134,36 @@ private func handle(_ request: [String: Any]) async throws -> Any {
             screenshot = try await captureWindow(snapshot, path: path, required: mode == "required")
         }
         return observationJSON(snapshot, screenshot: screenshot)
+    case "activate-for-cursor":
+        let appIdentity = try dictionary(request["app"], "app")
+        let app = try resolveApp([
+            "bundleId": try string(appIdentity["bundleId"], "app.bundleId"),
+            "pid": try int(appIdentity["pid"], "app.pid"),
+        ])
+        let options = try dictionary(request["options"], "options")
+        let snapshot = try observeSnapshot(app: app, limits: options)
+        let expected = try string(request["expectedStateHash"], "expectedStateHash")
+        guard snapshot.stateHash == expected else {
+            throw fail("COMPUTER_STALE_OBSERVATION", "the application UI changed before foreground activation")
+        }
+        if app.isActive {
+            return ["observation": observationJSON(snapshot, screenshot: nil), "activation": "already-frontmost"]
+        }
+        let actionTimeoutMs = try int(request["actionTimeoutMs"], "actionTimeoutMs")
+        guard actionTimeoutMs >= 1_000 && actionTimeoutMs <= 120_000 else {
+            throw fail("COMPUTER_PROVIDER_FAILURE", "actionTimeoutMs must be between 1000 and 120000")
+        }
+        try activate(app, timeoutMs: actionTimeoutMs)
+        let refreshed = try observeSnapshot(app: app, limits: options)
+        guard activationStateMatches(snapshot, current: refreshed) else {
+            throw fail("COMPUTER_STALE_OBSERVATION", "the application UI changed while the target application was activated")
+        }
+        return ["observation": observationJSON(refreshed, screenshot: nil), "activation": "activated"]
     case "act":
-        return try performAction(try dictionary(request["request"], "request"))
+        return try performAction(
+            try dictionary(request["request"], "request"),
+            dragStartBarrier: dragStartBarrier
+        )
     default:
         throw fail("COMPUTER_PROVIDER_FAILURE", "unknown helper command")
     }
@@ -1126,6 +1176,13 @@ private func emit(_ payload: [String: Any], exitCode: Int32) -> Never {
     Darwin.exit(exitCode)
 }
 
+private func emitFrame(_ payload: [String: Any]) {
+    let data = (try? JSONSerialization.data(withJSONObject: payload, options: [.sortedKeys]))
+        ?? Data("{\"ok\":false,\"error\":{\"code\":\"COMPUTER_PROVIDER_FAILURE\",\"message\":\"response serialization failed\"}}".utf8)
+    FileHandle.standardOutput.write(data)
+    FileHandle.standardOutput.write(Data("\n".utf8))
+}
+
 @main
 private struct HelperMain {
     @MainActor
@@ -1138,6 +1195,24 @@ private struct HelperMain {
                 CursorOverlayRuntime.run()
                 return
             }
+            if ProcessInfo.processInfo.arguments.contains("--drag-action") {
+                guard let line = readLine(),
+                      let data = line.data(using: .utf8),
+                      let request = try JSONSerialization.jsonObject(with: data) as? [String: Any],
+                      (request["command"] as? String) == "act",
+                      let actionRequest = request["request"] as? [String: Any],
+                      let action = actionRequest["action"] as? [String: Any],
+                      (action["kind"] as? String) == "drag" else {
+                    throw fail("COMPUTER_PROVIDER_FAILURE", "drag helper stdin must contain one drag action request")
+                }
+                let value = try await handle(request, dragStartBarrier: {
+                    emitFrame(["ok": true, "event": "drag-ready"])
+                    guard readLine() == "START" else {
+                        throw fail("COMPUTER_CANCELLED", "drag action was cancelled before native mouse-down")
+                    }
+                })
+                emit(["ok": true, "value": value], exitCode: 0)
+            }
             guard let data = try FileHandle.standardInput.readToEnd(), !data.isEmpty,
                   let request = try JSONSerialization.jsonObject(with: data) as? [String: Any] else {
                 throw fail("COMPUTER_PROVIDER_FAILURE", "stdin must contain one JSON request")

package/native/macos/Sources/Monitor/main.swift

@@ -54,6 +54,8 @@ private var maximumCursorDistance = 0.0
 private var observedFrontmostPids = Set<Int32>()
 private var maximumMatchingWindowCount = 0
 private var matchingWindowFrames: [[String: Any]] = []
+private var matchingWindowNumbers: [Int] = []
+private var seenWindowFrames = Set<String>()
 private var monitoredSourcePointerEvents = 0
 private var pointerEventSourceCounts: [String: Int] = [:]
 private var samples = 0
@@ -110,7 +112,16 @@ while DispatchTime.now().uptimeNanoseconds < deadline {
     maximumMatchingWindowCount = max(maximumMatchingWindowCount, windows.count)
     if let first = windows.first,
        let bounds = first[kCGWindowBounds as String] as? [String: Any] {
-        matchingWindowFrames = [bounds]
+        let frameKey = ["X", "Y", "Width", "Height"]
+            .map { String(describing: bounds[$0] ?? "") }
+            .joined(separator: ",")
+        if seenWindowFrames.insert(frameKey).inserted {
+            matchingWindowFrames.append(bounds)
+        }
+        if let number = (first[kCGWindowNumber as String] as? NSNumber)?.intValue,
+           !matchingWindowNumbers.contains(number) {
+            matchingWindowNumbers.append(number)
+        }
     }
     samples += 1
     if eventTapSource != nil {
@@ -121,15 +132,18 @@ while DispatchTime.now().uptimeNanoseconds < deadline {
 }
 
 let finalCursor = cursorLocation()
+let finalFrontmostPid = frontmostPid()
 let result: [String: Any] = [
     "baselineCursor": ["x": baselineCursor.x, "y": baselineCursor.y],
     "finalCursor": ["x": finalCursor.x, "y": finalCursor.y],
     "maximumCursorDistance": maximumCursorDistance,
     "baselineFrontmostPid": baselineFrontmostPid.map(Int.init) as Any,
     "observedFrontmostPids": observedFrontmostPids.sorted().map(Int.init),
+    "finalFrontmostPid": finalFrontmostPid.map(Int.init) as Any,
     "samples": samples,
     "maximumMatchingWindowCount": maximumMatchingWindowCount,
     "matchingWindowFrames": matchingWindowFrames,
+    "matchingWindowNumbers": matchingWindowNumbers,
     "eventTapAvailable": eventTap != nil,
     "monitoredSourcePointerEvents": monitoredSourcePointerEvents,
     "pointerEventSourceCounts": pointerEventSourceCounts,

package/native/macos/manifest.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": 1,
-  "helperVersion": "0.2.1",
-  "sourceSha256": "c6939cc42fbe2f393390b3d15bf3a92ae4be4d1811d55427de3de8bed6628136",
+  "helperVersion": "0.3.0",
+  "sourceSha256": "f82877b40aefe9c5b49ca5aac743267e57cf7e87be623c975d535e4af03a788a",
   "binary": {
     "path": "bin/dsh-computer-use-helper",
-    "sha256": "b29e2fb87995d70fe0a046e5d90998a23447c67a121c3e4de5b9ec9d9951435f",
+    "sha256": "91fc66597ecb05a74123b5fde5d0c648963cbebad72ace2cfe6e5004852dd0cc",
     "architectures": [
       "arm64",
       "x86_64"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anionex/dsh-computer-use",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Accessibility-first macOS Computer Use capability for DeepSeek Harness with stale-observation protection, app leases, confirmations, screenshots, and Web diagnostics",
   "keywords": [
     "deepseek",
@@ -18,7 +18,6 @@
     "url": "https://github.com/Anionex/dsh-computer-use/issues"
   },
   "type": "module",
-  "packageManager": "pnpm@11.20.0",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
   },
@@ -58,20 +57,6 @@
     "README.zh.md",
     "LICENSE"
   ],
-  "scripts": {
-    "native:build": "node scripts/build-native.mjs",
-    "check:native": "node scripts/check-native.mjs",
-    "build": "pnpm run native:build && tsc -p tsconfig.json && tsc -p tsconfig.client.json && node scripts/build-client.mjs",
-    "prepack": "pnpm run build",
-    "test": "pnpm run build && vitest run tests",
-    "test:model": "node scripts/model-e2e.mjs",
-    "test:watch": "vitest tests",
-    "validate": "node scripts/validate.mjs --lane all",
-    "validate:local": "node scripts/validate.mjs --lane local",
-    "validate:profile": "node scripts/validate.mjs --lane profile",
-    "validate:model": "node scripts/model-e2e.mjs",
-    "validate:release": "pnpm run validate && pnpm run validate:model"
-  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -124,5 +109,18 @@
   "dependencies": {
     "zod": "^4.4.3"
   },
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "native:build": "node scripts/build-native.mjs",
+    "check:native": "node scripts/check-native.mjs",
+    "build": "pnpm run native:build && tsc -p tsconfig.json && tsc -p tsconfig.client.json && node scripts/build-client.mjs",
+    "test": "pnpm run build && vitest run tests",
+    "test:model": "node scripts/model-e2e.mjs",
+    "test:watch": "vitest tests",
+    "validate": "node scripts/validate.mjs --lane all",
+    "validate:local": "node scripts/validate.mjs --lane local",
+    "validate:profile": "node scripts/validate.mjs --lane profile",
+    "validate:model": "node scripts/model-e2e.mjs",
+    "validate:release": "pnpm run validate && pnpm run validate:model"
+  }
+}

package/src/backend.ts

@@ -74,6 +74,19 @@ export interface BackendActionResult {
 export interface CursorVisibility {
   readonly visible: boolean
   readonly reason?: string
+  readonly reasonCode?: 'target-not-frontmost' | 'target-invalid'
+}
+
+/** Fresh state after a host-authorized foreground activation for cursor sequencing. */
+export interface BackendCursorActivation {
+  readonly observation: BackendObservation
+  readonly activation: 'already-frontmost' | 'activated'
+}
+
+/** Native drag input and its Agent-cursor endpoint tracking result. */
+export interface BackendTrackedDragResult {
+  readonly action: BackendActionResult
+  readonly cursor: CursorVisibility
 }
 
 export interface BackendCursorAction {
@@ -105,14 +118,16 @@ export interface ComputerUseBackend {
   resolveApp(selector: ComputerAppSelector, signal: AbortSignal): Promise<ComputerAppIdentity>
   listApps(signal: AbortSignal): Promise<ComputerAppSummary[]>
   observe(app: ComputerAppIdentity, options: BackendObserveOptions, signal: AbortSignal): Promise<BackendObservation>
+  activateForCursor(app: ComputerAppIdentity, expectedStateHash: string, options: BackendObserveOptions, signal: AbortSignal): Promise<BackendCursorActivation>
   act(request: BackendActionRequest, signal: AbortSignal): Promise<BackendActionResult>
+  actDragWithCursor(request: BackendActionRequest, cursor: BackendCursorAction & { kind: 'drag' }, signal: AbortSignal): Promise<BackendTrackedDragResult>
   /**
    * Drive the agent cursor for one action.
    * @returns whether the cursor is on screen afterwards, plus why not when it
-   * is hidden. A hidden cursor is not an error — native input is unaffected —
-   * but the caller must be able to report that the user cannot see the agent.
+   * is hidden. The Service permits intentional background hiding but fails
+   * closed for foreground placement, transport, and target-validation failures.
    */
-  visualizeCursor(action: BackendCursorAction, phase: 'before' | 'after', signal: AbortSignal): Promise<CursorVisibility>
+  visualizeCursor(action: BackendCursorAction, phase: 'before' | 'during' | 'after', signal: AbortSignal): Promise<CursorVisibility>
   dispose(): Promise<void>
   health(signal: AbortSignal): Promise<BackendHealth>
   openSettings(kind: 'accessibility' | 'screen-recording', signal: AbortSignal): Promise<void>

package/src/client/index.tsx

@@ -8,6 +8,7 @@ import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
 import type {} from '@deepseek-ai/dsh-client-locale/client'
 import type {} from '@deepseek-ai/dsh-settings/types'
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
+import { integerInRange } from './settings-validation.js'
 
 const NS = 'computer-use'
 const ROUTE = '/_dsh/computer-use/settings'
@@ -22,7 +23,7 @@ const en = {
   accessHint: 'Choose whether Computer Use may work with every app. Exact per-app rules remain available under Advanced settings.',
   advanced: 'Advanced options',
   advancedHint: 'Limits, helper path, cursor timing, and application grants.',
-  cursorTiming: 'Cursor timing',
+  cursorTiming: 'Agent cursor motion',
   helper: 'Native helper',
   helperUnknown: 'Unknown',
   ready: 'Ready',
@@ -62,7 +63,9 @@ const en = {
   cursorVisualization: 'Agent cursor',
   cursorVisible: 'Show a separate click-through Agent cursor',
   cursorHidden: 'Hide the Agent cursor',
-  cursorMotion: 'Cursor travel (ms)',
+  cursorSpeed: 'Requested maximum cursor speed (px/s)',
+  cursorAcceleration: 'Cursor acceleration/deceleration (px/s²)',
+  cursorClickDelay: 'Delay after arrival before click (ms)',
   cursorAutoHide: 'Cursor auto-hide (ms; 0 = stay visible)',
   grants: 'Application grants',
   grantsHint: 'One exact bundle id per line, followed by read or read,control. Wildcards are rejected.',
@@ -74,6 +77,7 @@ const en = {
   readOnly: 'The current Settings provider is read-only.',
   loading: 'Loading Computer Use settings...',
   retry: 'Retry',
+  numberRange: '{field} must be an integer from {min} to {max}.',
 } as const
 
 type LocaleKey = keyof typeof en
@@ -87,7 +91,7 @@ const zh: Record<LocaleKey, string> = {
   accessHint: '日常使用只需决定是否允许操作所有应用；指定应用规则可在高级设置中配置。',
   advanced: '高级设置',
   advancedHint: '操作方式、性能限制、光标效果、指定应用规则和运行组件。一般无需修改。',
-  cursorTiming: '光标效果',
+  cursorTiming: '智能体光标移动',
   helper: '运行组件版本',
   helperUnknown: '未提供',
   ready: '已就绪',
@@ -127,7 +131,9 @@ const zh: Record<LocaleKey, string> = {
   cursorVisualization: '智能体光标',
   cursorVisible: '显示单独的智能体光标',
   cursorHidden: '隐藏智能体光标',
-  cursorMotion: '光标移动时长（毫秒）',
+  cursorSpeed: '光标期望最大速度（像素/秒）',
+  cursorAcceleration: '光标加/减速度（像素/秒²）',
+  cursorClickDelay: '到达后点击延迟（毫秒）',
   cursorAutoHide: '光标自动隐藏（毫秒；0 = 保持显示）',
   grants: '指定应用规则',
   grantsHint: '每行填写一个应用标识，后接 read 或 read,control。应用标识必须完整，不能使用通配符。',
@@ -139,6 +145,7 @@ const zh: Record<LocaleKey, string> = {
   readOnly: '当前配置为只读，无法在这里修改。',
   loading: '正在加载电脑操作设置...',
   retry: '重试',
+  numberRange: '{field}必须是 {min} 到 {max} 之间的整数。',
 }
 
 type Translate = (key: LocaleKey, params?: Record<string, string | number>) => string
@@ -161,6 +168,9 @@ interface ConfigValue {
     pointerInputPolicy?: 'deny' | 'targeted'
     cursorVisualization?: 'hidden' | 'visible'
     cursorMotionMs?: number
+    cursorSpeedPxPerSecond?: number
+    cursorAccelerationPxPerSecondSquared?: number
+    cursorClickDelayMs?: number
     cursorAutoHideMs?: number
   }
   allowAllApps?: boolean
@@ -284,7 +294,9 @@ interface Draft {
   keyboardPolicy: 'preserve' | 'activate'
   pointerInputPolicy: 'deny' | 'targeted'
   cursorVisualization: 'hidden' | 'visible'
-  cursorMotionMs: string
+  cursorSpeedPxPerSecond: string
+  cursorAccelerationPxPerSecondSquared: string
+  cursorClickDelayMs: string
   cursorAutoHideMs: string
   allowAllApps: boolean
   grants: string
@@ -308,7 +320,9 @@ function draftOf(value: ConfigValue): Draft {
     keyboardPolicy: value.interaction?.keyboardPolicy ?? 'preserve',
     pointerInputPolicy: value.interaction?.pointerInputPolicy ?? 'targeted',
     cursorVisualization: value.interaction?.cursorVisualization ?? 'visible',
-    cursorMotionMs: String(value.interaction?.cursorMotionMs ?? 180),
+    cursorSpeedPxPerSecond: String(value.interaction?.cursorSpeedPxPerSecond ?? 1600),
+    cursorAccelerationPxPerSecondSquared: String(value.interaction?.cursorAccelerationPxPerSecondSquared ?? 6000),
+    cursorClickDelayMs: String(value.interaction?.cursorClickDelayMs ?? 90),
     cursorAutoHideMs: String(value.interaction?.cursorAutoHideMs ?? 0),
     allowAllApps: value.allowAllApps ?? false,
     grants: (value.grants ?? []).map(grant => `${grant.bundleId} ${grant.control === true ? 'read,control' : 'read'}`).join('\n'),
@@ -321,7 +335,8 @@ function integer(value: string, name: string): number {
   return parsed
 }
 
-function configOf(draft: Draft): ConfigValue {
+function configOf(draft: Draft, t: Translate): ConfigValue {
+  const rangeError = (field: string, min: number, max: number): string => t('numberRange', { field, min, max })
   const grants = draft.grants.split(/\r?\n/u).map(line => line.trim()).filter(Boolean).map((line) => {
     const [bundleId, rawScopes, ...extra] = line.split(/\s+/u)
     if (bundleId === undefined || rawScopes === undefined || extra.length > 0) throw new Error(`invalid grant line: ${line}`)
@@ -349,8 +364,10 @@ function configOf(draft: Draft): ConfigValue {
       keyboardPolicy: draft.keyboardPolicy,
       pointerInputPolicy: draft.pointerInputPolicy,
       cursorVisualization: draft.cursorVisualization,
-      cursorMotionMs: integer(draft.cursorMotionMs, 'interaction.cursorMotionMs'),
-      cursorAutoHideMs: integer(draft.cursorAutoHideMs, 'interaction.cursorAutoHideMs'),
+      cursorSpeedPxPerSecond: integerInRange(draft.cursorSpeedPxPerSecond, t('cursorSpeed'), 100, 50000, rangeError),
+      cursorAccelerationPxPerSecondSquared: integerInRange(draft.cursorAccelerationPxPerSecondSquared, t('cursorAcceleration'), 100, 500000, rangeError),
+      cursorClickDelayMs: integerInRange(draft.cursorClickDelayMs, t('cursorClickDelay'), 0, 1000, rangeError),
+      cursorAutoHideMs: integerInRange(draft.cursorAutoHideMs, t('cursorAutoHide'), 0, 30000, rangeError),
     },
     allowAllApps: draft.allowAllApps,
     grants,
@@ -396,12 +413,16 @@ function LoadedSettings({ controller, t }: { controller: ComputerUseSettingsCont
   const save = (): void => {
     try {
       setDraftError(undefined)
-      void controller.action('save', { expectedRevision: snapshot.settings.revision, value: configOf(draft) }, 'save')
+      void controller.action('save', { expectedRevision: snapshot.settings.revision, value: configOf(draft, t) }, 'save')
     } catch (error) {
       setDraftError(error instanceof Error ? error.message : String(error))
     }
   }
-  const numberField = (key: keyof Draft, label: string) => <Field label={label}><Input value={String(draft[key])} onChange={event => update(key, event.target.value as never)} /></Field>
+  const numberField = (key: keyof Draft, label: string, bounds: { min?: number; max?: number } = {}) => (
+    <Field label={label}>
+      <Input type="number" min={bounds.min ?? 0} max={bounds.max} step={1} value={String(draft[key])} onChange={event => update(key, event.target.value as never)} />
+    </Field>
+  )
   return <div className="dcu-settings">
     {snapshot.provider.lastError === undefined ? null : <div className="dcu-alert error">{snapshot.provider.lastError}</div>}
     {!snapshot.writable ? <div className="dcu-alert warning">{t('readOnly')}</div> : null}
@@ -469,8 +490,10 @@ function LoadedSettings({ controller, t }: { controller: ComputerUseSettingsCont
         <section className="dcu-panel">
           <div className="dcu-panel-title"><h3>{t('cursorTiming')}</h3></div>
           <div className="dcu-grid">
-            {numberField('cursorMotionMs', t('cursorMotion'))}
-            {numberField('cursorAutoHideMs', t('cursorAutoHide'))}
+            {numberField('cursorSpeedPxPerSecond', t('cursorSpeed'), { min: 100, max: 50000 })}
+            {numberField('cursorAccelerationPxPerSecondSquared', t('cursorAcceleration'), { min: 100, max: 500000 })}
+            {numberField('cursorClickDelayMs', t('cursorClickDelay'), { max: 1000 })}
+            {numberField('cursorAutoHideMs', t('cursorAutoHide'), { max: 30000 })}
           </div>
         </section>
         <section className="dcu-panel">

package/src/client/settings-validation.ts

@@ -0,0 +1,14 @@
+/** Parse one bounded integer using caller-owned localized error copy. */
+export function integerInRange(
+  value: string,
+  field: string,
+  min: number,
+  max: number,
+  formatError: (field: string, min: number, max: number) => string,
+): number {
+  const parsed = Number(value)
+  if (!Number.isSafeInteger(parsed) || parsed < min || parsed > max) {
+    throw new Error(formatError(field, min, max))
+  }
+  return parsed
+}

package/src/config.ts

@@ -21,7 +21,11 @@ export interface ComputerUseInteractionConfig {
   keyboardPolicy?: 'preserve' | 'activate'
   pointerInputPolicy?: 'deny' | 'targeted'
   cursorVisualization?: 'hidden' | 'visible'
+  /** @deprecated Accepted for 0.2.x settings compatibility; physical motion replaces fixed duration. */
   cursorMotionMs?: number
+  cursorSpeedPxPerSecond?: number
+  cursorAccelerationPxPerSecondSquared?: number
+  cursorClickDelayMs?: number
   cursorAutoHideMs?: number
 }
 
@@ -67,7 +71,10 @@ export const Config: Schema<ComputerUseConfig> = z.object({
     keyboardPolicy: z.union(['preserve', 'activate']).default('preserve'),
     pointerInputPolicy: z.union(['deny', 'targeted']).default('targeted'),
     cursorVisualization: z.union(['hidden', 'visible']).default('visible'),
-    cursorMotionMs: z.number().default(180),
+    cursorMotionMs: z.number(),
+    cursorSpeedPxPerSecond: z.number().default(1600),
+    cursorAccelerationPxPerSecondSquared: z.number().default(6000),
+    cursorClickDelayMs: z.number().default(90),
     cursorAutoHideMs: z.number().default(0),
   }),
   allowAllApps: z.boolean().default(false),
@@ -99,7 +106,9 @@ export interface ResolvedComputerUseConfig {
     keyboardPolicy: 'preserve' | 'activate'
     pointerInputPolicy: 'deny' | 'targeted'
     cursorVisualization: 'hidden' | 'visible'
-    cursorMotionMs: number
+    cursorSpeedPxPerSecond: number
+    cursorAccelerationPxPerSecondSquared: number
+    cursorClickDelayMs: number
     cursorAutoHideMs: number
   }
   allowAllApps: boolean
@@ -151,7 +160,12 @@ export function resolveConfig(config: ComputerUseConfig = {}): ResolvedComputerU
   const keyboardPolicy = option('interaction.keyboardPolicy', config.interaction?.keyboardPolicy ?? 'preserve', ['preserve', 'activate'] as const)
   const pointerInputPolicy = option('interaction.pointerInputPolicy', config.interaction?.pointerInputPolicy ?? 'targeted', ['deny', 'targeted'] as const)
   const cursorVisualization = option('interaction.cursorVisualization', config.interaction?.cursorVisualization ?? 'visible', ['hidden', 'visible'] as const)
-  const cursorMotionMs = integer('interaction.cursorMotionMs', config.interaction?.cursorMotionMs ?? 180, 0, 2000)
+  if (config.interaction?.cursorMotionMs !== undefined) {
+    integer('interaction.cursorMotionMs', config.interaction.cursorMotionMs, 0, 2000)
+  }
+  const cursorSpeedPxPerSecond = integer('interaction.cursorSpeedPxPerSecond', config.interaction?.cursorSpeedPxPerSecond ?? 1600, 100, 50000)
+  const cursorAccelerationPxPerSecondSquared = integer('interaction.cursorAccelerationPxPerSecondSquared', config.interaction?.cursorAccelerationPxPerSecondSquared ?? 6000, 100, 500000)
+  const cursorClickDelayMs = integer('interaction.cursorClickDelayMs', config.interaction?.cursorClickDelayMs ?? 90, 0, 1000)
   const cursorAutoHideMs = integer('interaction.cursorAutoHideMs', config.interaction?.cursorAutoHideMs ?? 0, 0, 30000)
   const allowAllApps = config.allowAllApps ?? false
   const seen = new Set<string>()
@@ -187,7 +201,9 @@ export function resolveConfig(config: ComputerUseConfig = {}): ResolvedComputerU
       keyboardPolicy,
       pointerInputPolicy,
       cursorVisualization,
-      cursorMotionMs,
+      cursorSpeedPxPerSecond,
+      cursorAccelerationPxPerSecondSquared,
+      cursorClickDelayMs,
       cursorAutoHideMs,
     },
     allowAllApps,