prompt

type Ident string

type InMemoryStore struct {
	// contains filtered or unexported fields
}

type Override struct {
	// PromptID identifies which baseline prompt this override targets.
	PromptID Ident
	// Scope constrains where the override applies.
	Scope Scope
	// Template is the override template source.
	Template string
	// Version is the version assigned to the override.
	Version string
	// CreatedAt records when this override was persisted.
	CreatedAt time.Time
	// Metadata carries optional caller-defined attributes (for example,
	// experiment identifiers).
	Metadata map[string]string
}

type PromptContent struct {
	// Text is the rendered prompt text.
	Text string
	// Ref identifies which prompt/version produced Text.
	Ref PromptRef
}

type PromptRef struct {
	// ID is the prompt identifier.
	ID Ident
	// Version is the resolved version used for rendering.
	Version string
}

type PromptRole string

type PromptSpec struct {
	// ID is the globally unique prompt identifier.
	ID Ident
	// AgentID identifies the owning agent.
	AgentID string
	// Role identifies how the prompt is used (system/user/tool/synthesis).
	Role PromptRole
	// Description is optional human-readable metadata.
	Description string
	// Template is the baseline template source.
	Template string
	// Version identifies the baseline prompt version. If empty, registries may
	// derive a deterministic version from Template content.
	Version string
	// Funcs is the template function map used when rendering this prompt.
	Funcs template.FuncMap
}

type Registry struct {
	// contains filtered or unexported fields
}

type RenderEvent struct {
	PromptID Ident
	Version  string
	Scope    Scope
}

type RenderObserver func(ctx context.Context, event RenderEvent)

type Scope struct {
	SessionID string
	Labels    map[string]string
}

type Store interface {
	// Resolve returns the highest-precedence override for promptID within scope.
	// Returns (nil, nil) when no override exists.
	Resolve(ctx context.Context, promptID Ident, scope Scope) (*Override, error)
	// Set persists a new override record.
	Set(ctx context.Context, promptID Ident, scope Scope, template string, metadata map[string]string) error
	// History returns override records for promptID ordered newest-first.
	History(ctx context.Context, promptID Ident) ([]*Override, error)
	// List returns all override records ordered newest-first.
	List(ctx context.Context) ([]*Override, error)
}