feat: agent.action.transform can now transform images to text descriptions

[snorrees]

Read README/TSDoc changes for what this does.

The above fields was generated for the image using this request:

//Populate multiple descriptions for the same image with different insturctions
client.agent.action.transform({
  schemaId,
  documentId,
  instruction: 'describe the image in great detail',
  target: [
    {path: ['image', 'alt'], operation: {type: 'image-description'}},
    {
      path: ['image', 'wrapper', 'alt'],
      operation: {type: 'image-description'},
      instruction: 'super short description',
    },
    {
      path: ['image', 'wrapper', 'description'],
      operation: {type: 'image-description'},
      instruction:
        'Describe the image in great detail. Use headings, paragraohs and formatting to structure the description.',
    },
  ],
})

npm i @sanity/client@agent-actions
7.4.0-agent-actions.2

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

1 Skipped Deployment

Name	Status	Preview	Comments	Updated (UTC)
tsdocs-client	⬜️ Ignored (Inspect)			Jun 2, 2025 9:02pm

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🔵	Lines	88.52%	3488 / 3940
🔵	Statements	88.52%	3488 / 3940
🔵	Functions	87.57%	289 / 330
🔵	Branches	89.11%	1032 / 1158

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
src/types.ts	0%	0%	0%	0%
src/agent/actions/transform.ts	100%	100%	100%	100%

Generated in workflow #3416 for commit 3967c96 by the Vitest Coverage Report Action

[robinpyon]

LGTM! (Assuming sourcePath on image-description is coming later)

[snorrees]

LGTM! (Assuming sourcePath on image-description is coming later)

I think I might just change it, and not keep the string version, just so sourcePath is more discoverable when you look for image-description

[markmichon]

Suggested change

	- `target: {path: ['description'], operation: operation: {type: 'image-description', sourcePath: ['image', 'asset'] }`
	- `target: {path: ['description'], operation: {type: 'image-description', sourcePath: ['image', 'asset'] }`