spec

type AllBundles struct {
	Bundles map[bundleitemutils.BundleID]PromptBundle `json:"bundles"`
}

type BundlePageToken struct {
	BundleIDs       []bundleitemutils.BundleID `json:"ids,omitempty"` //nolint:tagliatelle // Pagetoken specific. optional filter
	IncludeDisabled bool                       `json:"d,omitempty"`   //nolint:tagliatelle // Pagetoken specific. include disabled bundles?
	PageSize        int                        `json:"s"`             //nolint:tagliatelle // Pagetoken specific. page size
	CursorMod       string                     `json:"t,omitempty"`   //nolint:tagliatelle // Pagetoken specific. RFC-3339-nano
	CursorID        bundleitemutils.BundleID   `json:"id,omitempty"`  //nolint:tagliatelle // Pagetoken specific.
}

type DeletePromptBundleRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
}

type DeletePromptBundleResponse struct{}

type DeletePromptTemplateRequest struct {
	BundleID     bundleitemutils.BundleID    `path:"bundleID"     required:"true"`
	TemplateSlug bundleitemutils.ItemSlug    `path:"templateSlug" required:"true"`
	Version      bundleitemutils.ItemVersion `path:"version"      required:"true"`
}

type DeletePromptTemplateResponse struct{}

type GetPromptTemplateRequest struct {
	BundleID     bundleitemutils.BundleID    `path:"bundleID"     required:"true"`
	TemplateSlug bundleitemutils.ItemSlug    `path:"templateSlug" required:"true"`
	Version      bundleitemutils.ItemVersion `path:"version"      required:"true"`
}

type GetPromptTemplateResponse struct{ Body *PromptTemplate }

type ListPromptBundlesRequest struct {
	BundleIDs       []bundleitemutils.BundleID `query:"bundleIDs"`
	IncludeDisabled bool                       `query:"includeDisabled"`
	PageSize        int                        `query:"pageSize"`
	PageToken       string                     `query:"pageToken"`
}

type ListPromptBundlesResponse struct {
	Body *ListPromptBundlesResponseBody
}

type ListPromptBundlesResponseBody struct {
	PromptBundles []PromptBundle `json:"promptBundles"`
	NextPageToken *string        `json:"nextPageToken,omitempty"`
}

type ListPromptTemplatesRequest struct {
	BundleIDs           []bundleitemutils.BundleID `query:"bundleIDs"`
	Tags                []string                   `query:"tags"`
	Kinds               []PromptTemplateKind       `query:"kinds"`
	OnlyResolved        bool                       `query:"onlyResolved"`
	IncludeDisabled     bool                       `query:"includeDisabled"`
	RecommendedPageSize int                        `query:"recommendedPageSize"`
	PageToken           string                     `query:"pageToken"`
}

type ListPromptTemplatesResponse struct {
	Body *ListPromptTemplatesResponseBody
}

type ListPromptTemplatesResponseBody struct {
	PromptTemplateListItems []PromptTemplateListItem `json:"promptTemplateListItems"`
	NextPageToken           *string                  `json:"nextPageToken,omitempty"`
}

type MessageBlock struct {
	ID      MessageBlockID `json:"id"`
	Role    PromptRoleEnum `json:"role"`
	Content string         `json:"content"`
}

type MessageBlockID string

type PatchPromptBundleRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	Body     *PatchPromptBundleRequestBody
}

type PatchPromptBundleRequestBody struct {
	IsEnabled bool `json:"isEnabled" required:"true"`
}

type PatchPromptBundleResponse struct{}

type PatchPromptTemplateRequest struct {
	BundleID     bundleitemutils.BundleID    `path:"bundleID"     required:"true"`
	TemplateSlug bundleitemutils.ItemSlug    `path:"templateSlug" required:"true"`
	Version      bundleitemutils.ItemVersion `path:"version"      required:"true"`
	Body         *PatchPromptTemplateRequestBody
}

type PatchPromptTemplateRequestBody struct {
	IsEnabled bool `json:"isEnabled" required:"true"`
}

type PatchPromptTemplateResponse struct{}

type PromptBundle struct {
	SchemaVersion string                     `json:"schemaVersion"`
	ID            bundleitemutils.BundleID   `json:"id"`
	Slug          bundleitemutils.BundleSlug `json:"slug"`

	DisplayName string `json:"displayName,omitempty"`
	Description string `json:"description,omitempty"`

	IsEnabled     bool       `json:"isEnabled"`
	CreatedAt     time.Time  `json:"createdAt"`
	ModifiedAt    time.Time  `json:"modifiedAt"`
	IsBuiltIn     bool       `json:"isBuiltIn"`
	SoftDeletedAt *time.Time `json:"softDeletedAt,omitempty"`
}

type PromptRoleEnum string

type PromptTemplate struct {
	SchemaVersion string             `json:"schemaVersion"`
	Kind          PromptTemplateKind `json:"kind"`

	ID        bundleitemutils.ItemID   `json:"id"`
	Slug      bundleitemutils.ItemSlug `json:"slug"`
	IsEnabled bool                     `json:"isEnabled"`

	DisplayName string   `json:"displayName"`
	Description string   `json:"description,omitempty"`
	Tags        []string `json:"tags,omitempty"`

	// Ordered list of blocks that form the final prompt.
	Blocks []MessageBlock `json:"blocks"`
	// Declared placeholders.
	Variables []PromptVariable `json:"variables,omitempty"`

	// IsResolved is a backend-computed persisted property.
	//
	// True means all placeholders used by this template can be resolved using template-local variable information only,
	// with no external caller/user input required.
	//
	// Current resolution rules:
	//   - SourceStatic => resolved iff StaticVal is non-empty
	//   - SourceUser   => resolved iff Default is non-nil
	//
	// This field is computed and enforced by backend validation on put/read flows.
	IsResolved bool `json:"isResolved"`

	Version    bundleitemutils.ItemVersion `json:"version"`
	CreatedAt  time.Time                   `json:"createdAt"`
	ModifiedAt time.Time                   `json:"modifiedAt"`
	IsBuiltIn  bool                        `json:"isBuiltIn"`
}

type PromptTemplateKind string

type PromptTemplateListItem struct {
	BundleID        bundleitemutils.BundleID    `json:"bundleID"`
	BundleSlug      bundleitemutils.BundleSlug  `json:"bundleSlug"`
	TemplateSlug    bundleitemutils.ItemSlug    `json:"templateSlug"`
	TemplateVersion bundleitemutils.ItemVersion `json:"templateVersion"`
	Kind            PromptTemplateKind          `json:"kind"`
	IsResolved      bool                        `json:"isResolved"`
	IsBuiltIn       bool                        `json:"isBuiltIn"`
}

type PromptTemplateRef struct {
	BundleID        bundleitemutils.BundleID    `json:"bundleID"`
	TemplateSlug    bundleitemutils.ItemSlug    `json:"templateSlug"`
	TemplateVersion bundleitemutils.ItemVersion `json:"templateVersion"`
}

type PromptVariable struct {
	Name        string    `json:"name"`
	Type        VarType   `json:"type"`
	Required    bool      `json:"required"`
	Source      VarSource `json:"source"`
	Description string    `json:"description,omitempty"`

	// SourceStatic.
	StaticVal string `json:"staticVal,omitempty"`
	// VarEnum.
	EnumValues []string `json:"enumValues,omitempty"`

	// Optional default for the var.
	Default *string `json:"default,omitempty"`
}

type PutPromptBundleRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	Body     *PutPromptBundleRequestBody
}

type PutPromptBundleRequestBody struct {
	Slug        bundleitemutils.BundleSlug `json:"slug"                  required:"true"`
	DisplayName string                     `json:"displayName"           required:"true"`
	IsEnabled   bool                       `json:"isEnabled"             required:"true"`
	Description string                     `json:"description,omitempty"`
}

type PutPromptBundleResponse struct{}

type PutPromptTemplateRequest struct {
	BundleID     bundleitemutils.BundleID    `path:"bundleID"     required:"true"`
	TemplateSlug bundleitemutils.ItemSlug    `path:"templateSlug" required:"true"`
	Version      bundleitemutils.ItemVersion `path:"version"      required:"true"`
	Body         *PutPromptTemplateRequestBody
}

type PutPromptTemplateRequestBody struct {
	// Auto populate template id internally.
	Kind        PromptTemplateKind `json:"kind"                  required:"true"`
	DisplayName string             `json:"displayName"           required:"true"`
	IsEnabled   bool               `json:"isEnabled"             required:"true"`
	Description string             `json:"description,omitempty"`

	Blocks    []MessageBlock   `json:"blocks"              required:"true"`
	Tags      []string         `json:"tags,omitempty"`
	Variables []PromptVariable `json:"variables,omitempty"`

	IsResolved bool `json:"isResolved" required:"true"`
}

type PutPromptTemplateResponse struct{}

type TemplatePageToken struct {
	RecommendedPageSize int                        `json:"ps,omitempty"`   //nolint:tagliatelle // PageToken specific.
	IncludeDisabled     bool                       `json:"d,omitempty"`    //nolint:tagliatelle // PageToken specific.
	BundleIDs           []bundleitemutils.BundleID `json:"ids,omitempty"`  //nolint:tagliatelle // PageToken specific.
	Tags                []string                   `json:"tags,omitempty"` //nolint:tagliatelle // PageToken specific.
	BuiltInDone         bool                       `json:"bd,omitempty"`   //nolint:tagliatelle // PageToken specific.
	DirTok              string                     `json:"dt,omitempty"`   //nolint:tagliatelle // PageToken specific.
	Kinds               []PromptTemplateKind       `json:"k,omitempty"`    //nolint:tagliatelle // PageToken specific.
	OnlyResolved        bool                       `json:"r,omitempty"`    //nolint:tagliatelle // PageToken specific.
}

type VarSource string

type VarType string