Function resolvePrepareCapture

src/utils/computerUse/executor.ts:427–466

(opts: {
      allowedBundleIds: string[]
      preferredDisplayId?: number
      autoResolve: boolean
      doHide?: boolean
    })

    },

    async resolvePrepareCapture(opts: {
      allowedBundleIds: string[]
      preferredDisplayId?: number
      autoResolve: boolean
      doHide?: boolean
    }): Promise<ResolvePrepareCaptureResult> {
      const d = cu.display.getSize(opts.preferredDisplayId)
      const [targetW, targetH] = computeTargetDims(
        d.width,
        d.height,
        d.scaleFactor,
      )
      const raw = await drainRunLoop(() =>
        cu.resolvePrepareCapture(
          withoutTerminal(opts.allowedBundleIds),
          surrogateHost,
          SCREENSHOT_JPEG_QUALITY,
          targetW,
          targetH,
          opts.preferredDisplayId,
        ),
      )
      // Ensure the result has fields expected by toolCalls.ts (hidden, displayId).
      // macOS native returns these from Swift; our cross-platform ComputerUseAPI
      // returns {base64, width, height} — fill in the missing fields.
      const baseResult = raw as Partial<ResolvePrepareCaptureResult> & {
        width?: number
        height?: number
      }
      return {
        ...raw,
        displayWidth: baseResult.displayWidth ?? baseResult.width,
        displayHeight: baseResult.displayHeight ?? baseResult.height,
        originX: baseResult.originX ?? 0,
        originY: baseResult.originY ?? 0,
        hidden: baseResult.hidden ?? [],
        displayId:
          baseResult.displayId ?? opts.preferredDisplayId ?? d.displayId,
      } as ResolvePrepareCaptureResult
    },

    /**
     * Pre-size to `targetImageSize` output so the API transcoder's early-return