Function resolvePrepareCapture

src/utils/computerUse/executor.ts:473–505

(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,
          opts.autoResolve,
          opts.doHide,
        ),
      )
      // 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.
      return {
        ...raw,
        hidden: (raw as any).hidden ?? [],
        displayId: (raw as any).displayId ?? opts.preferredDisplayId ?? d.displayId,
      }
    },

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