eric/promptkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clarify collection contracts and migration docs

Browse Source
This commit is contained in:
Eric Rakestraw
2026-10-17 06:35:56 +00:00
parent 29f104fbc0
commit dfd8da843e
16 changed files with 236 additions and 102 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
smoke_diagnostics.go
View File

@@ -35,11 +35,13 @@ type SmokeTestRequest struct {
// selection otherwise needs a profile. A selected profile determines its own
// effective backend identity.
BackendID string
// PromptID selects the prompt's default profile when ProfileID is empty. The
// prompt's messages, inputs, templates, and output contract are not executed.
// PromptID selects the prompt's default profile when ProfileID is empty. A
// namespace-scoped engine view qualifies a slashless caller ID. The prompt's
// messages, inputs, templates, and output contract are not executed.
PromptID string
// ProfileID explicitly selects a profile and takes precedence over a prompt's
// default profile and a backend's configured diagnostic default.
// ProfileID explicitly selects a profile; a namespace-scoped view qualifies
// a slashless caller ID. It takes precedence over a prompt's default profile
// and a backend's configured diagnostic default.
ProfileID string
// Execution overrides applicable target settings using the same semantics as
// ordinary execution. HTTP probes do not require a model setting.
@@ -115,9 +117,10 @@ type SmokeTestTarget struct {
BackendID string
// ProfileID is the selected profile, if any.
ProfileID string
// PromptID identifies the selected prompt; PromptVersion carries its
// descriptive version label. Nil means absent while a non-nil empty string is
// explicit. The pointer belongs to this returned target.
// PromptID identifies the selected prompt; PromptVersion carries optional
// descriptive metadata and never participates in selection. Nil means absent
// while a non-nil empty string is explicit. The pointer belongs to this
// returned target.
PromptID string
PromptVersion *string
// DefaultSourceBackendID identifies the backend whose configured default
@@ -225,8 +228,10 @@ const (
// SmokeTest runs one built-in diagnostic against the engine's captured
// configuration.
//
// Selection prefers an explicit ProfileID, then the profile selected by
// PromptID, then a configured backend default profile when
// On a namespace-scoped view, slashless caller-supplied prompt, profile, and
// backend IDs are qualified before selection; captured defaults and references
// remain unchanged. Selection prefers an explicit ProfileID, then the profile
// selected by PromptID, then a configured backend default profile when
// inference requires one. For backend-only probes, a selected profile supplies
// its backend metadata; otherwise BackendID selects a backend directly without
// resolving its default inference profile. A selected profile determines its