chore: deprecate text based way of generating JSON

[monilpat]

Relates to:

N/A prevent future folks from using the untyped version generateObject so folks use generateObjectV2 which is typesafe. Just a rename for now to reduce risk of regression. We will clean up old usages separately.

Risks

Low

• Existing functionality will continue to work but will display a deprecation warning.
• No impact on downstream systems expected.
• Risk is isolated to developers relying on raw text-based JSON generation.

Background

What does this PR do?

This PR deprecates the text-based way of generating JSON objects using LLMs and so folks use generatedObjectV2 with typesafe structured outputs. Method isn't removed yet it is deprecated.

What kind of change is this?

• Improvements: Transitioning to a more robust way of handling JSON outputs.
• Chore: Deprecation of legacy behavior.

Why are we doing this? Any context or related work?

Text-based generation of JSON using LLMs is prone to errors like missing brackets, invalid types, or inconsistent structures. Moving to a typesafe structured output guarantees that JSON complies with predefined schemas, improving both developer experience and system stability.

Documentation changes needed?

• My changes require a change to the project documentation.
• Updated docs to:
  • Reflect new structured output implementation.
  • Mark text-based generation as deprecated.

Testing

Where should a reviewer start?

Detailed testing steps

N/A just a rename

Deploy Notes

No special deployment steps required.

Database changes

None.

Deployment instructions

Standard deployment process applies.

Discord username

0x8664

---