feat: add images support to the Codex Typescript SDK

[needs]

Extend TurnOptions with an optional images field. This new field is an array of strings that is fed to the CLI through the --image parameter.

await thread.run("describe the images", { 
  images: ["foo.png", "bar.png"] 
});

Ends up launching the CLI with:

codex exec --image foo.png --image bar.png "describe the images" 

This brings the Codex SDK closer to feature parity with the CLI. Adresses #5280 .

[github-actions]

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

[needs]

I have read the CLA Document and I hereby sign the CLA

[pakrym-oai]

Hi! Thank you for the contribution.

If you don't mind let's implement this by changing input: string on run and runStreamed to be of string | UserInput[] type.

where UserInput is

type UserInput = {
   type: "text",
   text: string,
} | {
   type: "local_image",
   path: string
}

We combine all text parts into the prompt and turn all images into --image parameter.

[needs]

Hi! Thanks for your feedback.

The Input type has been extended the suggested way. Texts parts are combined with two newlines. This is done through the new normalizeInput function which returns a combined prompt and a list of image paths.

Added a second test that make sure text parts are combined the expected way.

Available for any follow ups!