api

type Block struct {
	// Data Block-type-specific payload.
	Data map[string]interface{} `json:"data"`

	// Type heading | text | list | table | keyvalue | metric | code | chart.
	Type string `json:"type"`
}

type CreateTemplate200JSONResponse Template

type CreateTemplateJSONRequestBody = TemplateInput

type CreateTemplateRequestObject struct {
	Body *CreateTemplateJSONRequestBody
}

type CreateTemplateResponseObject interface {
	VisitCreateTemplateResponse(w http.ResponseWriter) error
}

type CreateTemplatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type DeleteTemplate204Response struct {
}

type DeleteTemplateRequestObject struct {
	Id TemplateIdPathParam `json:"id"`
}

type DeleteTemplateResponseObject interface {
	VisitDeleteTemplateResponse(w http.ResponseWriter) error
}

type DeleteTemplatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type Document = []Block

type Error = ErrorResponse

type ErrorJSONResponse ErrorResponse

type ErrorResponse struct {
	// Code Machine-readable error code, UPPER_SNAKE_CASE.
	Code    string                  `json:"code"`
	Details *map[string]interface{} `json:"details,omitempty"`
	Message string                  `json:"message"`
}

type Event struct {
	Additions *int    `json:"additions,omitempty"`
	Branch    *string `json:"branch,omitempty"`
	Deletions *int    `json:"deletions,omitempty"`

	// Id Stable id: "{type}:{owner}/{repo}:{sha|number}".
	Id string `json:"id"`

	// Number PR/issue number.
	Number *int    `json:"number,omitempty"`
	Owner  string  `json:"owner"`
	Repo   string  `json:"repo"`
	Sha    *string `json:"sha,omitempty"`

	// Title Commit subject / PR title.
	Title *string `json:"title,omitempty"`

	// Ts Unix seconds.
	Ts   int64     `json:"ts"`
	Type EventType `json:"type"`
	Url  *string   `json:"url,omitempty"`
}

type EventType string

type EventTypeQueryParam = EventType

type ExportDocument200ApplicationoctetStreamResponse struct {
	Body          io.Reader
	ContentLength int64
}

type ExportDocumentJSONRequestBody = ExportRequest

type ExportDocumentRequestObject struct {
	Body *ExportDocumentJSONRequestBody
}

type ExportDocumentResponseObject interface {
	VisitExportDocumentResponse(w http.ResponseWriter) error
}

type ExportDocumentdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ExportFormat string

type ExportRequest struct {
	// Document An ordered list of display blocks.
	Document *Document `json:"document,omitempty"`

	// Filter Timeline filter selecting the range/scope to operate on.
	Filter     *Filter                 `json:"filter,omitempty"`
	FormValues *map[string]interface{} `json:"formValues,omitempty"`
	Format     ExportFormat            `json:"format"`
	TemplateId *string                 `json:"templateId,omitempty"`
}

type Filter struct {
	From  *int64     `json:"from,omitempty"`
	Owner *string    `json:"owner,omitempty"`
	Repo  *string    `json:"repo,omitempty"`
	To    *int64     `json:"to,omitempty"`
	Type  *EventType `json:"type,omitempty"`
}

type FormField struct {
	// Default Default value, if any. Shape matches `type`.
	Default  interface{} `json:"default,omitempty"`
	Label    *string     `json:"label,omitempty"`
	Name     string      `json:"name"`
	Required *bool       `json:"required,omitempty"`

	// Type Form field kind, e.g. string, number, boolean, date, select.
	Type string `json:"type"`
}

type FromQueryParam = int64

type GapQueryParam = int64

type GenerateTemplate200JSONResponse Template

type GenerateTemplateJSONRequestBody = GenerateTemplateRequest

type GenerateTemplateRequest struct {
	Prompt string `json:"prompt"`
}

type GenerateTemplateRequestObject struct {
	Body *GenerateTemplateJSONRequestBody
}

type GenerateTemplateResponseObject interface {
	VisitGenerateTemplateResponse(w http.ResponseWriter) error
}

type GenerateTemplatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetSyncStatus200JSONResponse SyncStatus

type GetSyncStatusRequestObject struct {
}

type GetSyncStatusResponseObject interface {
	VisitGetSyncStatusResponse(w http.ResponseWriter) error
}

type GetSyncStatusdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type ListOwners200JSONResponse []string

type ListOwnersRequestObject struct {
}

type ListOwnersResponseObject interface {
	VisitListOwnersResponse(w http.ResponseWriter) error
}

type ListOwnersdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ListRepos200JSONResponse []string

type ListReposParams struct {
	// Owner Owner/org to list repos for.
	Owner OwnerQueryParamRequired `form:"owner" json:"owner"`
}

type ListReposRequestObject struct {
	Params ListReposParams
}

type ListReposResponseObject interface {
	VisitListReposResponse(w http.ResponseWriter) error
}

type ListReposdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ListSessions200JSONResponse SessionsResponse

type ListSessionsParams struct {
	// Owner Filter by owner/org.
	Owner *OwnerQueryParam `form:"owner,omitempty" json:"owner,omitempty"`

	// From Range start, unix seconds (inclusive).
	From *FromQueryParam `form:"from,omitempty" json:"from,omitempty"`

	// To Range end, unix seconds (exclusive).
	To *ToQueryParam `form:"to,omitempty" json:"to,omitempty"`

	// Gap Inter-event gap threshold, in seconds, overriding GITRAKZ_SESSION_GAP for this request's sessionization.
	Gap *GapQueryParam `form:"gap,omitempty" json:"gap,omitempty"`
}

type ListSessionsRequestObject struct {
	Params ListSessionsParams
}

type ListSessionsResponseObject interface {
	VisitListSessionsResponse(w http.ResponseWriter) error
}

type ListSessionsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ListTemplates200JSONResponse []Template

type ListTemplatesRequestObject struct {
}

type ListTemplatesResponseObject interface {
	VisitListTemplatesResponse(w http.ResponseWriter) error
}

type ListTemplatesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ListTimeline200JSONResponse TimelinePage

type ListTimelineParams struct {
	// Owner Filter by owner/org.
	Owner *OwnerQueryParam `form:"owner,omitempty" json:"owner,omitempty"`

	// Repo Filter by repo.
	Repo *RepoQueryParam `form:"repo,omitempty" json:"repo,omitempty"`

	// Type Filter by event type.
	Type *EventTypeQueryParam `form:"type,omitempty" json:"type,omitempty"`

	// From Range start, unix seconds (inclusive).
	From *FromQueryParam `form:"from,omitempty" json:"from,omitempty"`

	// To Range end, unix seconds (exclusive).
	To *ToQueryParam `form:"to,omitempty" json:"to,omitempty"`

	// Page 1-indexed page number.
	Page *PageQueryParam `form:"page,omitempty" json:"page,omitempty"`

	// PerPage Page size.
	PerPage *PerPageQueryParam `form:"per_page,omitempty" json:"per_page,omitempty"`
}

type ListTimelineRequestObject struct {
	Params ListTimelineParams
}

type ListTimelineResponseObject interface {
	VisitListTimelineResponse(w http.ResponseWriter) error
}

type ListTimelinedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type MiddlewareFunc func(http.Handler) http.Handler

type OwnerQueryParam = string

type OwnerQueryParamRequired = string

type PageQueryParam = int

type PerPageQueryParam = int

type RepoQueryParam = string

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type RunRequest struct {
	// Filter Timeline filter selecting the range/scope to operate on.
	Filter *Filter `json:"filter,omitempty"`

	// FormValues Values keyed by the template's form field names.
	FormValues *map[string]interface{} `json:"formValues,omitempty"`
	TemplateId string                  `json:"templateId"`
}

type RunTemplate200JSONResponse Document

type RunTemplateJSONRequestBody = RunRequest

type RunTemplateRequestObject struct {
	Body *RunTemplateJSONRequestBody
}

type RunTemplateResponseObject interface {
	VisitRunTemplateResponse(w http.ResponseWriter) error
}

type RunTemplatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ServeMux interface {
	HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))
	http.Handler
}

type ServerInterface interface {
	// ExportDocument Export a document (or a template run) to a file
	// (POST /export)
	ExportDocument(w http.ResponseWriter, r *http.Request)
	// ListOwners List distinct owners/orgs
	// (GET /owners)
	ListOwners(w http.ResponseWriter, r *http.Request)
	// ListRepos List repos under an owner
	// (GET /repos)
	ListRepos(w http.ResponseWriter, r *http.Request, params ListReposParams)
	// RunTemplate Run a template's transform pipeline over a filtered range
	// (POST /run)
	RunTemplate(w http.ResponseWriter, r *http.Request)
	// ListSessions Derived, sessionized view of the timeline
	// (GET /sessions)
	ListSessions(w http.ResponseWriter, r *http.Request, params ListSessionsParams)
	// TriggerSync Trigger an incremental sync of activity from `gh`
	// (POST /sync)
	TriggerSync(w http.ResponseWriter, r *http.Request)
	// GetSyncStatus Current sync status
	// (GET /sync/status)
	GetSyncStatus(w http.ResponseWriter, r *http.Request)
	// ListTemplates List templates (built-in + custom)
	// (GET /templates)
	ListTemplates(w http.ResponseWriter, r *http.Request)
	// CreateTemplate Create a custom template
	// (POST /templates)
	CreateTemplate(w http.ResponseWriter, r *http.Request)
	// GenerateTemplate LLM-compose a template draft from a description
	// (POST /templates/generate)
	GenerateTemplate(w http.ResponseWriter, r *http.Request)
	// DeleteTemplate Delete a custom template
	// (DELETE /templates/{id})
	DeleteTemplate(w http.ResponseWriter, r *http.Request, id TemplateIdPathParam)
	// UpdateTemplate Edit a template
	// (PUT /templates/{id})
	UpdateTemplate(w http.ResponseWriter, r *http.Request, id TemplateIdPathParam)
	// ListTimeline Paginated, filterable event timeline
	// (GET /timeline)
	ListTimeline(w http.ResponseWriter, r *http.Request, params ListTimelineParams)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type Session struct {
	// Day Owner-local calendar day this session is grouped under.
	Day *openapi_types.Date `json:"day,omitempty"`

	// DurationHours (endTs - startTs) + lead-in padding, in hours.
	DurationHours float64 `json:"durationHours"`
	EndTs         int64   `json:"endTs"`
	Events        []Event `json:"events"`
	Owner         string  `json:"owner"`
	StartTs       int64   `json:"startTs"`
}

type SessionsResponse struct {
	Sessions []Session `json:"sessions"`
}

type StdHTTPServerOptions struct {
	BaseURL          string
	BaseRouter       ServeMux
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type StrictHTTPServerOptions struct {
	RequestErrorHandlerFunc  func(w http.ResponseWriter, r *http.Request, err error)
	ResponseErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type StrictHandlerFunc func(ctx context.Context, w http.ResponseWriter, r *http.Request, request any) (any, error)

type StrictMiddlewareFunc func(f StrictHandlerFunc, operationID string) StrictHandlerFunc

type StrictServerInterface interface {
	// ExportDocument Export a document (or a template run) to a file
	// (POST /export)
	ExportDocument(ctx context.Context, request ExportDocumentRequestObject) (ExportDocumentResponseObject, error)
	// ListOwners List distinct owners/orgs
	// (GET /owners)
	ListOwners(ctx context.Context, request ListOwnersRequestObject) (ListOwnersResponseObject, error)
	// ListRepos List repos under an owner
	// (GET /repos)
	ListRepos(ctx context.Context, request ListReposRequestObject) (ListReposResponseObject, error)
	// RunTemplate Run a template's transform pipeline over a filtered range
	// (POST /run)
	RunTemplate(ctx context.Context, request RunTemplateRequestObject) (RunTemplateResponseObject, error)
	// ListSessions Derived, sessionized view of the timeline
	// (GET /sessions)
	ListSessions(ctx context.Context, request ListSessionsRequestObject) (ListSessionsResponseObject, error)
	// TriggerSync Trigger an incremental sync of activity from `gh`
	// (POST /sync)
	TriggerSync(ctx context.Context, request TriggerSyncRequestObject) (TriggerSyncResponseObject, error)
	// GetSyncStatus Current sync status
	// (GET /sync/status)
	GetSyncStatus(ctx context.Context, request GetSyncStatusRequestObject) (GetSyncStatusResponseObject, error)
	// ListTemplates List templates (built-in + custom)
	// (GET /templates)
	ListTemplates(ctx context.Context, request ListTemplatesRequestObject) (ListTemplatesResponseObject, error)
	// CreateTemplate Create a custom template
	// (POST /templates)
	CreateTemplate(ctx context.Context, request CreateTemplateRequestObject) (CreateTemplateResponseObject, error)
	// GenerateTemplate LLM-compose a template draft from a description
	// (POST /templates/generate)
	GenerateTemplate(ctx context.Context, request GenerateTemplateRequestObject) (GenerateTemplateResponseObject, error)
	// DeleteTemplate Delete a custom template
	// (DELETE /templates/{id})
	DeleteTemplate(ctx context.Context, request DeleteTemplateRequestObject) (DeleteTemplateResponseObject, error)
	// UpdateTemplate Edit a template
	// (PUT /templates/{id})
	UpdateTemplate(ctx context.Context, request UpdateTemplateRequestObject) (UpdateTemplateResponseObject, error)
	// ListTimeline Paginated, filterable event timeline
	// (GET /timeline)
	ListTimeline(ctx context.Context, request ListTimelineRequestObject) (ListTimelineResponseObject, error)
}

type SyncJob struct {
	JobId string `json:"jobId"`
}

type SyncStatus struct {
	InProgress bool `json:"inProgress"`

	// LastSyncedTs Unix seconds of the most recent completed sync.
	LastSyncedTs int64 `json:"lastSyncedTs"`

	// PerOwner Per-owner sync counts/state, keyed by owner name.
	PerOwner map[string]interface{} `json:"perOwner"`
}

type Template struct {
	Description *string        `json:"description,omitempty"`
	Exports     []ExportFormat `json:"exports"`
	Form        []FormField    `json:"form"`
	Id          string         `json:"id"`
	Layout      []Block        `json:"layout"`

	// Model Only meaningful when the layout has an LLM-backed block.
	Model     *string         `json:"model,omitempty"`
	Name      string          `json:"name"`
	Transform []TransformStep `json:"transform"`
}

type TemplateIdPathParam = string

type TemplateInput struct {
	Description *string        `json:"description,omitempty"`
	Exports     []ExportFormat `json:"exports"`
	Form        []FormField    `json:"form"`
	Layout      []Block        `json:"layout"`

	// Model Only meaningful when the layout has an LLM-backed block.
	Model     *string         `json:"model,omitempty"`
	Name      string          `json:"name"`
	Transform []TransformStep `json:"transform"`
}

type TimelinePage struct {
	HasMore bool    `json:"hasMore"`
	Items   []Event `json:"items"`
}

type ToQueryParam = int64

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type TransformStep struct {
	// Params Primitive-specific parameters.
	Params *map[string]interface{} `json:"params,omitempty"`

	// Primitive sessionize | exclude-off-time | split-by-active-days | aggregate | group-by | rate | describe-work | passthrough.
	Primitive string `json:"primitive"`
}

type TriggerSync202JSONResponse SyncJob

type TriggerSyncRequestObject struct {
}

type TriggerSyncResponseObject interface {
	VisitTriggerSyncResponse(w http.ResponseWriter) error
}

type TriggerSyncdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type UpdateTemplate200JSONResponse Template

type UpdateTemplateJSONRequestBody = TemplateInput

type UpdateTemplateRequestObject struct {
	Id   TemplateIdPathParam `json:"id"`
	Body *UpdateTemplateJSONRequestBody
}

type UpdateTemplateResponseObject interface {
	VisitUpdateTemplateResponse(w http.ResponseWriter) error
}

type UpdateTemplatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}