[Go] Make dotprompt take in jsonschema.Schema instead of map[string]any for better ergonomics.

[apascal07]

Description here...

Checklist (if applicable):

• Tested (manually, unit tested, etc.)
• Changelog updated
• Docs updated

[jba]

My main concern here is making github.com/invopop/jsonschema.Schema part of the API. I don't know if we do that anywhere else, but we shouldn't.

The problem is that that package is broken. It doesn't handle all JSONSchemas, and it probably never will. It's bad enough that we use it internally, but at least we can change that. If it's part of the API, replacing it will be a breaking change.

[apascal07]

My main concern here is making github.com/invopop/jsonschema.Schema part of the API. I don't know if we do that anywhere else, but we shouldn't.

The problem is that that package is broken. It doesn't handle all JSONSchemas, and it probably never will. It's bad enough that we use it internally, but at least we can change that. If it's part of the API, replacing it will be a breaking change.

Valid concern but we do have jsonschema.Schema part of the API already. Right above, we use it for InputSchema.

[jba]

Oh yeah. Well that's too bad.

I think replacing that package should block going to v1.0. Unfortunately it won't be easy.