Files
promptkit/docs/releases/v0.20.0.md

2.8 KiB

Promptkit v0.20.0

This minor release adds generically renderable resource inspection and typed prompt source construction. The Go consumer minimum remains 1.27.0 and ConfigKit remains at v1.1.0.

Compatibility And Migration

InspectProfile now returns the resolved profile resource instead of the backend-completed EffectiveModelParams. Replace accesses to that field with the optional profile fields; use Prepare or PreparedExecution.Details for completed request settings. InspectPrompt now includes captured messages and uses optional pointers for presence-sensitive fields, including default profile, inputs, input metadata, and output settings. Check pointers before dereferencing. All three resource reports support ordinary JSON and YAML rendering without per-field adapters. See the consumer guidance.

After configuration composition and inheritance, profile null endpoint, API-key source, and whole provider map now permit backend defaults during execution as well as appearing absent in resource inspection. Use explicit empty strings to clear endpoint or API-key source. There is no replacement for profile-level suppression of an entire backend provider map; edit backend defaults through composition instead. The required-key rule still applies. See defaults and overrides for the migration example and retained ConfigKit null provenance.

Resource Inspection And Sources

InspectBackend reports the resolved backend and configured diagnostics without contacting a provider or deriving diagnostic destinations. Prompt and profile inspection likewise report selected resources independently of request readiness; configuration provenance, requirement analysis, and preparation remain separate. PromptSource adds typed programmatic prompt definitions, and BackendConfig supports sibling inheritance. ConfigKit continues to own source composition, snapshotting, and relative message-file contexts.

The source helpers' GoDoc and backend configuration API describe programmatic construction.

Refinements

Package GoDoc and migration guidance now consistently describe the resource inspection contract, and the full package overview is visible in generated documentation. Prompt inspection avoids repeating the same metadata lookup for each declared input.

Upgrade

After adapting affected inspection consumers and reviewing profile null usage:

go get go.maximumdirect.net/promptkit@v0.20.0

COPYRIGHT | LICENSE | ATTRIBUTION