improvement: the template resolver now resolves unions

[armandobelardo]

Fixes FER-2589

Short description of the changes made

This adds logic to the template resolver to evaluate undiscriminated union templates

This needs:

• The SDKs to generate the union templates if they are not already
• The FE to pass in an API definition (ideally) when resolving the snippet

Of note: Resolve needs an API definition to resolve union templates

• .resolve() now optionally takes in an API definition in order to keep the function sync (and not break anyone)
• .getApiDefinitionAndResolve() has been introduced as an async function that will fetch the API definition
• .resolveWithFormatting() optionally takes in a definition, but fetches one otherwise since the function was already async

What was the motivation & context behind this PR?

This was a gap in the original implementation in order to move fast and release something for Octo

How has this PR been tested?

Unit tests

[linear]

FER-2589 [Humanloop] Snippet templates for union types

Jordan said:

Bug: looks like the content in the messages on the SDKs are not getting populated

see:

https://humanloop-preview-6c73a526-03e9-4389-b96b-0f79be9c3302.docs.buildwithfern.com/docs/api-reference/prompts/lo[…]7381346%3Aendpoint_prompts.log

https://github.com/humanloop/humanloop-docs/pull/30

Humanloop Documentation and API Reference

[vercel]

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

Name	Status	Preview	Comments	Updated (UTC)
fern-dashboard-dev	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 31, 2024 0:38am
fern-dev	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 31, 2024 0:38am
fern-prod	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 31, 2024 0:38am

3 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
fern-dashboard	⬜️ Ignored (Inspect)			Jul 31, 2024 0:38am
fontawesome-cdn	⬜️ Ignored (Inspect)	Visit Preview		Jul 31, 2024 0:38am
private-docs	⬜️ Ignored (Inspect)			Jul 31, 2024 0:38am

[github-actions]

PR Preview

• docs.cable.tech
• docs.givechariot.com
• developers.awork.com
• secure.docs.propexo.com
• www.intern.mavenagi.com
• docs.schematichq.com
• plantstore.dev
• www.plantstore.dev
• docs.boundaryml.com
• docs.qlty.ai
• docs.rightbrain.ai
• docs.getkard.com
• docs.syndicate.io
• docs.qlty.us
• hume.ferndocs.com
• docs.stack-auth.com
• gemini2.ferndocs.com
• docs.darwincloud.xyz
• docs.kota.io
• mongodb.ferndocs.com
• gemini.ferndocs.com
• api.labelstud.io
• docs.fluidstack.io
• docs.fileforge.com
• docs.instabase.com
• docs.reka.ai
• docs.aiaplatform.com.au
• fern.ssoready.com
• docs.anterior.com
• developers.beehiiv.com
• docs.scorecard.io
• fern.humanloop.com
• docs.goldenbasis.com
• developers.mavenagi.com
• docs.subconscious.ai
• docs.mavenagi.com
• docs.sphinxbio.com
• help.getzep.com
• api.qdrant.tech
• developers.upwardli.com
• docs.darwinbio.io
• dev.documentation.sayari.com
• fern.assemblyai.com
• docs.usebridge.com
• fern.uploadcare.com
• docs.impiloplatform.com
• docs.multion.ai
• developer.projectmanager.com
• dev.hume.ai
• docs.predictionguard.com

[github-actions]

🌿 Preview your docs: https://fern-preview-c2489869-d95c-48b5-b58b-035ac82fe5f1.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-1f733947-4150-4e55-a7b8-bd4a34e6f3f5.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-f654f434-1d97-45da-bb2e-7975626e77f3.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-a6d078dd-cb15-454c-986f-d2ad9f2e2d98.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-cf4bcfae-d29e-4319-8668-1404671e1fe9.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-499d381c-01e4-47b6-a0eb-5726e94962ce.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-d29fa13b-5e72-48fa-a1ce-7b0c415b48c8.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-443214d1-69b6-4630-9543-1d5c0b6cd34e.docs.buildwithfern.com

[github-actions]

🌿 Preview your docs: https://fern-preview-3511991d-d436-4da2-a3bf-5f4d7bba6d58.docs.buildwithfern.com