spec

type AllBundles struct {
	SchemaVersion string                                             `json:"schemaVersion"`
	Bundles       map[bundleitemutils.BundleID]AssistantPresetBundle `json:"bundles"`
}

type AssistantPreset struct {
	SchemaVersion string `json:"schemaVersion"`

	ID          bundleitemutils.ItemID      `json:"id"`
	Slug        bundleitemutils.ItemSlug    `json:"slug"`
	Version     bundleitemutils.ItemVersion `json:"version"`
	DisplayName string                      `json:"displayName"`
	Description string                      `json:"description,omitempty"`

	IsEnabled bool `json:"isEnabled"`
	IsBuiltIn bool `json:"isBuiltIn"`

	// StartingText is optional initial composer/editor draft text.
	// It is stored verbatim, including whitespace and newlines.
	StartingText string `json:"startingText,omitempty"`

	StartingModelPresetRef *modelpresetSpec.ModelPresetRef `json:"startingModelPresetRef,omitempty"`

	// Validation rules:
	//   - systemPrompt must be nil
	//   - capabilitiesOverride must be nil
	StartingModelPresetPatch *modelpresetSpec.ModelPresetPatch `json:"startingModelPresetPatch,omitempty"`

	// Nil means the preset does not express a preference.
	StartingIncludeModelSystemPrompt *bool `json:"startingIncludeModelSystemPrompt,omitempty"`

	// Ordered tool selections.
	StartingToolSelections []toolSpec.ToolSelection `json:"startingToolSelections,omitempty"`

	// Ordered skill selections. PreLoadAsActive is only valid for argumentless "insert=instructions" skills,
	// "insert=user-message" skills behave like user-message templates.
	StartingSkillSelections []skillSpec.SkillSelection `json:"startingSkillSelections,omitempty"`

	// StartingMCPContext is copied into the first user turn when this preset is applied.
	StartingMCPContext *mcpSpec.MCPConversationContext `json:"startingMCPContext,omitempty"`

	CreatedAt  time.Time `json:"createdAt"`
	ModifiedAt time.Time `json:"modifiedAt"`
}

type AssistantPresetBundle struct {
	SchemaVersion string `json:"schemaVersion"`

	ID            bundleitemutils.BundleID   `json:"id"`
	Slug          bundleitemutils.BundleSlug `json:"slug"`
	DisplayName   string                     `json:"displayName"`
	Description   string                     `json:"description,omitempty"`
	IsEnabled     bool                       `json:"isEnabled"`
	IsBuiltIn     bool                       `json:"isBuiltIn"`
	CreatedAt     time.Time                  `json:"createdAt"`
	ModifiedAt    time.Time                  `json:"modifiedAt"`
	SoftDeletedAt *time.Time                 `json:"softDeletedAt,omitempty"`
}

type AssistantPresetListItem struct {
	BundleID               bundleitemutils.BundleID    `json:"bundleID"`
	BundleSlug             bundleitemutils.BundleSlug  `json:"bundleSlug"`
	AssistantPresetSlug    bundleitemutils.ItemSlug    `json:"assistantPresetSlug"`
	AssistantPresetVersion bundleitemutils.ItemVersion `json:"assistantPresetVersion"`
	DisplayName            string                      `json:"displayName"`
	Description            string                      `json:"description,omitempty"`
	IsEnabled              bool                        `json:"isEnabled"`
	IsBuiltIn              bool                        `json:"isBuiltIn"`
	ModifiedAt             *time.Time                  `json:"modifiedAt,omitempty"`
}

type AssistantPresetPageToken struct {
	RecommendedPageSize int                        `json:"s,omitempty"`   //nolint:tagliatelle // Page token encoding.
	IncludeDisabled     bool                       `json:"d,omitempty"`   //nolint:tagliatelle // Page token encoding.
	BundleIDs           []bundleitemutils.BundleID `json:"ids,omitempty"` //nolint:tagliatelle // Page token encoding.
	DirTok              string                     `json:"dt,omitempty"`  //nolint:tagliatelle // Directory scan token.
	BuiltInDone         bool                       `json:"bi,omitempty"`  //nolint:tagliatelle // Page token encoding.
	BuiltInOffset       int                        `json:"bo,omitempty"`  //nolint:tagliatelle // Page token encoding.
}

type BundlePageToken struct {
	BundleIDs       []bundleitemutils.BundleID `json:"ids,omitempty"` //nolint:tagliatelle // Page token encoding.
	IncludeDisabled bool                       `json:"d,omitempty"`   //nolint:tagliatelle // Page token encoding.
	PageSize        int                        `json:"s,omitempty"`   //nolint:tagliatelle // Page token encoding.
	CursorMod       string                     `json:"t,omitempty"`   //nolint:tagliatelle // RFC3339Nano.
	CursorID        bundleitemutils.BundleID   `json:"id,omitempty"`  //nolint:tagliatelle // Page token encoding.
}

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

type DeleteAssistantPresetBundleResponse struct{}

type DeleteAssistantPresetRequest struct {
	BundleID            bundleitemutils.BundleID    `path:"bundleID"            required:"true"`
	AssistantPresetSlug bundleitemutils.ItemSlug    `path:"assistantPresetSlug" required:"true"`
	Version             bundleitemutils.ItemVersion `path:"version"             required:"true"`
}

type DeleteAssistantPresetResponse struct{}

type GetAssistantPresetRequest struct {
	BundleID            bundleitemutils.BundleID    `path:"bundleID"            required:"true"`
	AssistantPresetSlug bundleitemutils.ItemSlug    `path:"assistantPresetSlug" required:"true"`
	Version             bundleitemutils.ItemVersion `path:"version"             required:"true"`
}

type GetAssistantPresetResponse struct {
	Body *AssistantPreset
}

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

type ListAssistantPresetBundlesResponse struct {
	Body *ListAssistantPresetBundlesResponseBody
}

type ListAssistantPresetBundlesResponseBody struct {
	AssistantPresetBundles []AssistantPresetBundle `json:"assistantPresetBundles"`
	NextPageToken          *string                 `json:"nextPageToken,omitempty"`
}

type ListAssistantPresetsRequest struct {
	BundleIDs           []bundleitemutils.BundleID `query:"bundleIDs"`
	IncludeDisabled     bool                       `query:"includeDisabled"`
	RecommendedPageSize int                        `query:"recommendedPageSize"`
	PageToken           string                     `query:"pageToken"`
}

type ListAssistantPresetsResponse struct {
	Body *ListAssistantPresetsResponseBody
}

type ListAssistantPresetsResponseBody struct {
	AssistantPresetListItems []AssistantPresetListItem `json:"assistantPresetListItems"`
	NextPageToken            *string                   `json:"nextPageToken,omitempty"`
}

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

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

type PatchAssistantPresetBundleResponse struct{}

type PatchAssistantPresetRequest struct {
	BundleID            bundleitemutils.BundleID    `path:"bundleID"            required:"true"`
	AssistantPresetSlug bundleitemutils.ItemSlug    `path:"assistantPresetSlug" required:"true"`
	Version             bundleitemutils.ItemVersion `path:"version"             required:"true"`
	Body                *PatchAssistantPresetRequestBody
}

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

type PatchAssistantPresetResponse struct{}

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

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

type PutAssistantPresetBundleResponse struct{}

type PutAssistantPresetRequest struct {
	BundleID            bundleitemutils.BundleID    `path:"bundleID"            required:"true"`
	AssistantPresetSlug bundleitemutils.ItemSlug    `path:"assistantPresetSlug" required:"true"`
	Version             bundleitemutils.ItemVersion `path:"version"             required:"true"`
	Body                *PutAssistantPresetRequestBody
}

type PutAssistantPresetRequestBody struct {
	DisplayName string `json:"displayName"           required:"true"`
	Description string `json:"description,omitempty"`
	IsEnabled   bool   `json:"isEnabled"             required:"true"`

	StartingText           string                          `json:"startingText,omitempty"`
	StartingModelPresetRef *modelpresetSpec.ModelPresetRef `json:"startingModelPresetRef,omitempty"`

	// Validation rules:
	//   - systemPrompt must be nil
	//   - capabilitiesOverride must be nil
	StartingModelPresetPatch *modelpresetSpec.ModelPresetPatch `json:"startingModelPresetPatch,omitempty"`

	StartingIncludeModelSystemPrompt *bool                           `json:"startingIncludeModelSystemPrompt,omitempty"`
	StartingToolSelections           []toolSpec.ToolSelection        `json:"startingToolSelections,omitempty"`
	StartingSkillSelections          []skillSpec.SkillSelection      `json:"startingSkillSelections,omitempty"`
	StartingMCPContext               *mcpSpec.MCPConversationContext `json:"startingMCPContext,omitempty"`
}

type PutAssistantPresetResponse struct{}