admin

type AccessLevel string

type AdminActionRequest struct {
	// Justification Reason for the admin action (for audit log).
	Justification *string `json:"justification,omitempty"`
}

type AdminArchivedTotalStats struct {
	Archived int64 `json:"archived"`

	// OldestArchivedAt Oldest archive timestamp for that resource type.
	OldestArchivedAt *time.Time `json:"oldestArchivedAt,omitempty"`
	Total            int64      `json:"total"`
}

type AdminAttachment struct {
	// Archived Synthetic archive flag derived from the internal archived timestamp.
	Archived    *bool               `json:"archived,omitempty"`
	ContentType *string             `json:"contentType,omitempty"`
	CreatedAt   *time.Time          `json:"createdAt,omitempty"`
	EntryId     *openapi_types.UUID `json:"entryId,omitempty"`
	ExpiresAt   *time.Time          `json:"expiresAt,omitempty"`
	Filename    *string             `json:"filename,omitempty"`
	Id          *openapi_types.UUID `json:"id,omitempty"`

	// RefCount Number of attachment records sharing the same storage blob.
	RefCount   *int    `json:"refCount,omitempty"`
	Sha256     *string `json:"sha256,omitempty"`
	Size       *int64  `json:"size,omitempty"`
	StorageKey *string `json:"storageKey,omitempty"`
	UserId     *string `json:"userId,omitempty"`
}

type AdminCheckpoint struct {
	ClientId    string    `json:"clientId"`
	ContentType string    `json:"contentType"`
	UpdatedAt   time.Time `json:"updatedAt"`

	// Value Processor-defined JSON payload for this client checkpoint. Stored encrypted at rest.
	Value interface{} `json:"value"`
}

type AdminCheckpointPutRequest struct {
	ContentType string `json:"contentType"`

	// Value Processor-defined JSON payload to persist for this client checkpoint. Stored encrypted at rest.
	Value interface{} `json:"value"`
}

type AdminChildConversationSummary struct {
	// AccessLevel Access level of a user for a conversation.
	AccessLevel *AccessLevel `json:"accessLevel,omitempty"`

	// Archived Synthetic archive flag derived from the internal archived timestamp.
	Archived  *bool      `json:"archived,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty"`

	// Id Unique identifier for the child conversation.
	Id                 *openapi_types.UUID `json:"id,omitempty"`
	LastMessagePreview *string             `json:"lastMessagePreview,omitempty"`
	OwnerUserId        *string             `json:"ownerUserId,omitempty"`
	StartedByEntryId   *openapi_types.UUID `json:"startedByEntryId,omitempty"`
	Title              *string             `json:"title,omitempty"`
	UpdatedAt          *time.Time          `json:"updatedAt,omitempty"`
}

type AdminConversation struct {
	// AccessLevel Access level of a user for a conversation.
	AccessLevel *AccessLevel `json:"accessLevel,omitempty"`
	AgentId     *string      `json:"agentId,omitempty"`

	// Archived Synthetic archive flag derived from the internal archived timestamp.
	Archived  *bool      `json:"archived,omitempty"`
	ClientId  *string    `json:"clientId,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty"`

	// ForkedAtConversationId Conversation ID from which this conversation was forked.
	ForkedAtConversationId *openapi_types.UUID `json:"forkedAtConversationId,omitempty"`

	// ForkedAtEntryId First parent entry excluded by this fork. Null for root conversations and blank-slate forks that inherit no parent entries.
	ForkedAtEntryId *openapi_types.UUID `json:"forkedAtEntryId,omitempty"`

	// Id Unique identifier for the conversation.
	Id                      *openapi_types.UUID `json:"id,omitempty"`
	LastMessagePreview      *string             `json:"lastMessagePreview,omitempty"`
	OwnerUserId             *string             `json:"ownerUserId,omitempty"`
	StartedByConversationId *openapi_types.UUID `json:"startedByConversationId,omitempty"`
	StartedByEntryId        *openapi_types.UUID `json:"startedByEntryId,omitempty"`
	Title                   *string             `json:"title,omitempty"`
	UpdatedAt               *time.Time          `json:"updatedAt,omitempty"`
}

type AdminConversationGroupStats struct {
	Archived int64 `json:"archived"`

	// OldestArchivedAt Oldest `updatedAt` timestamp among archived conversations.
	OldestArchivedAt *time.Time `json:"oldestArchivedAt,omitempty"`
	Total            int64      `json:"total"`
}

type AdminConversationSummary struct {
	// AccessLevel Access level of a user for a conversation.
	AccessLevel *AccessLevel `json:"accessLevel,omitempty"`
	AgentId     *string      `json:"agentId,omitempty"`

	// Archived Synthetic archive flag derived from the internal archived timestamp.
	Archived  *bool      `json:"archived,omitempty"`
	ClientId  *string    `json:"clientId,omitempty"`
	CreatedAt *time.Time `json:"createdAt,omitempty"`

	// Id Unique identifier for the conversation.
	Id                      *openapi_types.UUID `json:"id,omitempty"`
	LastMessagePreview      *string             `json:"lastMessagePreview,omitempty"`
	OwnerUserId             *string             `json:"ownerUserId,omitempty"`
	StartedByConversationId *openapi_types.UUID `json:"startedByConversationId,omitempty"`
	StartedByEntryId        *openapi_types.UUID `json:"startedByEntryId,omitempty"`
	Title                   *string             `json:"title,omitempty"`
	UpdatedAt               *time.Time          `json:"updatedAt,omitempty"`
}

type AdminDeleteAttachment204Response struct {
}

type AdminDeleteAttachment404JSONResponse struct{ NotFoundJSONResponse }

type AdminDeleteAttachmentJSONRequestBody = AdminActionRequest

type AdminDeleteAttachmentRequestObject struct {
	Id   openapi_types.UUID `json:"id"`
	Body *AdminDeleteAttachmentJSONRequestBody
}

type AdminDeleteAttachmentResponseObject interface {
	VisitAdminDeleteAttachmentResponse(w http.ResponseWriter) error
}

type AdminDeleteAttachmentdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminDeleteMemory204Response struct {
}

type AdminDeleteMemoryRequestObject struct {
	Id openapi_types.UUID `json:"id"`
}

type AdminDeleteMemoryResponseObject interface {
	VisitAdminDeleteMemoryResponse(w http.ResponseWriter) error
}

type AdminDeleteMemorydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminDownloadUrlResponse struct {
	// ExpiresIn URL validity duration in seconds.
	ExpiresIn *int `json:"expiresIn,omitempty"`

	// Url Time-limited signed URL for downloading the attachment.
	Url *string `json:"url,omitempty"`
}

type AdminEvict200TexteventStreamResponse struct {
	Body          io.Reader
	ContentLength int64
}

type AdminEvict204Response struct {
}

type AdminEvict400JSONResponse ErrorResponse

type AdminEvictJSONRequestBody = EvictRequest

type AdminEvictParams struct {
	// Async Stream progress updates via SSE instead of blocking until complete.
	Async *bool `form:"async,omitempty" json:"async,omitempty"`
}

type AdminEvictRequestObject struct {
	Params AdminEvictParams
	Body   *AdminEvictJSONRequestBody
}

type AdminEvictResponseObject interface {
	VisitAdminEvictResponse(w http.ResponseWriter) error
}

type AdminEvictdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetAttachment200JSONResponse AdminAttachment

type AdminGetAttachment404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetAttachmentContent200ApplicationoctetStreamResponse struct {
	Body          io.Reader
	Headers       AdminGetAttachmentContent200ResponseHeaders
	ContentLength int64
}

type AdminGetAttachmentContent200ResponseHeaders struct {
	CacheControl *string
}

type AdminGetAttachmentContent302Response struct {
	Headers AdminGetAttachmentContent302ResponseHeaders
}

type AdminGetAttachmentContent302ResponseHeaders struct {
	CacheControl *string
}

type AdminGetAttachmentContent404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetAttachmentContentParams struct {
	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminGetAttachmentContentRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetAttachmentContentParams
}

type AdminGetAttachmentContentResponseObject interface {
	VisitAdminGetAttachmentContentResponse(w http.ResponseWriter) error
}

type AdminGetAttachmentContentdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetAttachmentDownloadUrl200JSONResponse AdminDownloadUrlResponse

type AdminGetAttachmentDownloadUrl404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetAttachmentDownloadUrlParams struct {
	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminGetAttachmentDownloadUrlRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetAttachmentDownloadUrlParams
}

type AdminGetAttachmentDownloadUrlResponseObject interface {
	VisitAdminGetAttachmentDownloadUrlResponse(w http.ResponseWriter) error
}

type AdminGetAttachmentDownloadUrldefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetAttachmentParams struct {
	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminGetAttachmentRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetAttachmentParams
}

type AdminGetAttachmentResponseObject interface {
	VisitAdminGetAttachmentResponse(w http.ResponseWriter) error
}

type AdminGetAttachmentdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetCheckpoint200JSONResponse AdminCheckpoint

type AdminGetCheckpoint401Response struct {
}

type AdminGetCheckpoint403Response struct {
}

type AdminGetCheckpoint404JSONResponse ErrorResponse

type AdminGetCheckpointRequestObject struct {
	ClientId string `json:"clientId"`
}

type AdminGetCheckpointResponseObject interface {
	VisitAdminGetCheckpointResponse(w http.ResponseWriter) error
}

type AdminGetConversation200JSONResponse AdminConversation

type AdminGetConversation404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetConversationParams struct {
	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminGetConversationRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetConversationParams
}

type AdminGetConversationResponseObject interface {
	VisitAdminGetConversationResponse(w http.ResponseWriter) error
}

type AdminGetConversationdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetEntries200JSONResponse struct {
	AfterCursor *string  `json:"afterCursor,omitempty"`
	Data        *[]Entry `json:"data,omitempty"`
}

type AdminGetEntries404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetEntriesParams struct {
	// AfterCursor Cursor for pagination (UUID format).
	AfterCursor *openapi_types.UUID `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`

	// Limit Maximum number of entries to return.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Channel Filter by entry channel.
	Channel *Channel `form:"channel,omitempty" json:"channel,omitempty"`

	// Epoch Optional epoch filter. Valid values are `latest`, `all`, or a numeric epoch identifier.
	Epoch *string `form:"epoch,omitempty" json:"epoch,omitempty"`

	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`

	// Forks Controls which fork entries to include. `none` (default) follows
	// the fork ancestry path. `all` returns entries from all forks.
	Forks *AdminGetEntriesParamsForks `form:"forks,omitempty" json:"forks,omitempty"`
}

type AdminGetEntriesParamsForks string

type AdminGetEntriesRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetEntriesParams
}

type AdminGetEntriesResponseObject interface {
	VisitAdminGetEntriesResponse(w http.ResponseWriter) error
}

type AdminGetEntriesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetEntry200JSONResponse Entry

type AdminGetEntry404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetEntryParams struct {
	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminGetEntryRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetEntryParams
}

type AdminGetEntryResponseObject interface {
	VisitAdminGetEntryResponse(w http.ResponseWriter) error
}

type AdminGetEntrydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetMemberships200JSONResponse struct {
	AfterCursor *string                   `json:"afterCursor,omitempty"`
	Data        *[]ConversationMembership `json:"data,omitempty"`
}

type AdminGetMemberships404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetMembershipsParams struct {
	// AfterCursor Cursor for pagination; returns items after this user id.
	AfterCursor *string `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`

	// Limit Maximum number of memberships to return.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminGetMembershipsRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetMembershipsParams
}

type AdminGetMembershipsResponseObject interface {
	VisitAdminGetMembershipsResponse(w http.ResponseWriter) error
}

type AdminGetMembershipsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetMemory200JSONResponse AdminMemoryItem

type AdminGetMemory404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetMemoryIndexStatus200JSONResponse MemoryIndexStatusResponse

type AdminGetMemoryIndexStatusRequestObject struct {
}

type AdminGetMemoryIndexStatusResponseObject interface {
	VisitAdminGetMemoryIndexStatusResponse(w http.ResponseWriter) error
}

type AdminGetMemoryIndexStatusdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetMemoryParams struct {
	IncludeUsage  *bool   `form:"includeUsage,omitempty" json:"includeUsage,omitempty"`
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminGetMemoryPolicies200JSONResponse MemoryPolicyBundle

type AdminGetMemoryPoliciesRequestObject struct {
}

type AdminGetMemoryPoliciesResponseObject interface {
	VisitAdminGetMemoryPoliciesResponse(w http.ResponseWriter) error
}

type AdminGetMemoryPoliciesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetMemoryRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminGetMemoryParams
}

type AdminGetMemoryResponseObject interface {
	VisitAdminGetMemoryResponse(w http.ResponseWriter) error
}

type AdminGetMemoryUsage200JSONResponse MemoryUsageResponse

type AdminGetMemoryUsage404JSONResponse struct{ NotFoundJSONResponse }

type AdminGetMemoryUsageParams struct {
	// Ns Namespace segments. Repeat once per segment.
	Ns  []string `form:"ns" json:"ns"`
	Key string   `form:"key" json:"key"`
}

type AdminGetMemoryUsageRequestObject struct {
	Params AdminGetMemoryUsageParams
}

type AdminGetMemoryUsageResponseObject interface {
	VisitAdminGetMemoryUsageResponse(w http.ResponseWriter) error
}

type AdminGetMemoryUsagedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminGetMemorydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminListAttachments200JSONResponse struct {
	AfterCursor *string            `json:"afterCursor,omitempty"`
	Data        *[]AdminAttachment `json:"data,omitempty"`
}

type AdminListAttachmentsParams struct {
	// UserId Filter by uploader user ID.
	UserId *string `form:"userId,omitempty" json:"userId,omitempty"`

	// EntryId Filter by linked entry ID.
	EntryId *openapi_types.UUID `form:"entryId,omitempty" json:"entryId,omitempty"`

	// Status Filter by status: linked, unlinked, expired, or all.
	Status *AdminListAttachmentsParamsStatus `form:"status,omitempty" json:"status,omitempty"`

	// AfterCursor Cursor for pagination (UUID of last item).
	AfterCursor *openapi_types.UUID `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`

	// Limit Maximum number of attachments to return (max 200).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminListAttachmentsParamsStatus string

type AdminListAttachmentsRequestObject struct {
	Params AdminListAttachmentsParams
}

type AdminListAttachmentsResponseObject interface {
	VisitAdminListAttachmentsResponse(w http.ResponseWriter) error
}

type AdminListAttachmentsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminListChildConversations200JSONResponse struct {
	AfterCursor *string                          `json:"afterCursor,omitempty"`
	Data        *[]AdminChildConversationSummary `json:"data,omitempty"`
}

type AdminListChildConversationsParams struct {
	AfterCursor *openapi_types.UUID `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`
	Limit       *int                `form:"limit,omitempty" json:"limit,omitempty"`
}

type AdminListChildConversationsRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminListChildConversationsParams
}

type AdminListChildConversationsResponseObject interface {
	VisitAdminListChildConversationsResponse(w http.ResponseWriter) error
}

type AdminListChildConversationsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminListConversations200JSONResponse struct {
	AfterCursor *string                     `json:"afterCursor,omitempty"`
	Data        *[]AdminConversationSummary `json:"data,omitempty"`
}

type AdminListConversationsParams struct {
	// Mode Listing mode for conversations. Controls which conversations are returned
	// from each fork tree (conversation group).
	// - `all`: include all conversations (roots and forks).
	// - `roots`: only include root conversations (conversations that are not forks).
	// - `latest-fork`: include only the most recently updated conversation per fork tree.
	//   This is useful for showing a single representative conversation from each tree.
	Mode     *AdminListConversationsParamsMode     `form:"mode,omitempty" json:"mode,omitempty"`
	Ancestry *AdminListConversationsParamsAncestry `form:"ancestry,omitempty" json:"ancestry,omitempty"`

	// UserId Filter conversations owned by this user.
	UserId *string `form:"userId,omitempty" json:"userId,omitempty"`

	// Archived Controls whether archived conversations are excluded, included, or returned exclusively.
	Archived *AdminListConversationsParamsArchived `form:"archived,omitempty" json:"archived,omitempty"`

	// ArchivedAfter Filter: archived at or after this time (ISO 8601).
	ArchivedAfter *time.Time `form:"archivedAfter,omitempty" json:"archivedAfter,omitempty"`

	// ArchivedBefore Filter: archived before this time (ISO 8601).
	ArchivedBefore *time.Time `form:"archivedBefore,omitempty" json:"archivedBefore,omitempty"`

	// AfterCursor Cursor for pagination (UUID format).
	AfterCursor *openapi_types.UUID `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`

	// UpToEntryId Upper-bound entry id (UUID format). When set, only entries at or
	// before this entry in the admin-visible conversation order are
	// returned.
	UpToEntryId *openapi_types.UUID `form:"upToEntryId,omitempty" json:"upToEntryId,omitempty"`

	// Limit Maximum number of conversations to return.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminListConversationsParamsAncestry string

type AdminListConversationsParamsArchived string

type AdminListConversationsParamsMode string

type AdminListConversationsRequestObject struct {
	Params AdminListConversationsParams
}

type AdminListConversationsResponseObject interface {
	VisitAdminListConversationsResponse(w http.ResponseWriter) error
}

type AdminListConversationsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminListForks200JSONResponse struct {
	AfterCursor *string                    `json:"afterCursor,omitempty"`
	Data        *[]ConversationForkSummary `json:"data,omitempty"`
}

type AdminListForks404JSONResponse struct{ NotFoundJSONResponse }

type AdminListForksParams struct {
	// AfterCursor Cursor for pagination; returns items after this conversation id (UUID format).
	AfterCursor *openapi_types.UUID `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`

	// Limit Maximum number of forks to return.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminListForksRequestObject struct {
	Id     openapi_types.UUID `json:"id"`
	Params AdminListForksParams
}

type AdminListForksResponseObject interface {
	VisitAdminListForksResponse(w http.ResponseWriter) error
}

type AdminListForksdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminListMemories200JSONResponse AdminListMemoriesResponse

type AdminListMemoriesParams struct {
	// NamespacePrefix Namespace prefix segments. Repeat once per segment.
	NamespacePrefix *[]string                        `form:"namespacePrefix,omitempty" json:"namespacePrefix,omitempty"`
	KeyPrefix       *string                          `form:"keyPrefix,omitempty" json:"keyPrefix,omitempty"`
	Archived        *AdminListMemoriesParamsArchived `form:"archived,omitempty" json:"archived,omitempty"`
	CreatedAfter    *time.Time                       `form:"createdAfter,omitempty" json:"createdAfter,omitempty"`
	CreatedBefore   *time.Time                       `form:"createdBefore,omitempty" json:"createdBefore,omitempty"`
	ExpiresBefore   *time.Time                       `form:"expiresBefore,omitempty" json:"expiresBefore,omitempty"`
	IncludeUsage    *bool                            `form:"includeUsage,omitempty" json:"includeUsage,omitempty"`
	Limit           *int                             `form:"limit,omitempty" json:"limit,omitempty"`
	AfterCursor     *string                          `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`
	Justification   *string                          `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminListMemoriesParamsArchived string

type AdminListMemoriesRequestObject struct {
	Params AdminListMemoriesParams
}

type AdminListMemoriesResponse struct {
	AfterCursor *string            `json:"afterCursor,omitempty"`
	Items       *[]AdminMemoryItem `json:"items,omitempty"`
}

type AdminListMemoriesResponseObject interface {
	VisitAdminListMemoriesResponse(w http.ResponseWriter) error
}

type AdminListMemoriesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminListMemoryNamespaces200JSONResponse AdminListMemoryNamespacesResponse

type AdminListMemoryNamespacesParams struct {
	// NamespacePrefix Namespace prefix segments. Repeat once per segment.
	NamespacePrefix *[]string `form:"namespacePrefix,omitempty" json:"namespacePrefix,omitempty"`

	// Suffix Namespace suffix segments. Repeat once per segment.
	Suffix        *[]string                                `form:"suffix,omitempty" json:"suffix,omitempty"`
	MaxDepth      *int                                     `form:"maxDepth,omitempty" json:"maxDepth,omitempty"`
	Archived      *AdminListMemoryNamespacesParamsArchived `form:"archived,omitempty" json:"archived,omitempty"`
	Limit         *int                                     `form:"limit,omitempty" json:"limit,omitempty"`
	AfterCursor   *string                                  `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`
	Justification *string                                  `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminListMemoryNamespacesParamsArchived string

type AdminListMemoryNamespacesRequestObject struct {
	Params AdminListMemoryNamespacesParams
}

type AdminListMemoryNamespacesResponse struct {
	AfterCursor *string                 `json:"afterCursor,omitempty"`
	Namespaces  *[]AdminMemoryNamespace `json:"namespaces,omitempty"`
}

type AdminListMemoryNamespacesResponseObject interface {
	VisitAdminListMemoryNamespacesResponse(w http.ResponseWriter) error
}

type AdminListMemoryNamespacesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminListTopMemoryUsage200JSONResponse ListTopMemoryUsageResponse

type AdminListTopMemoryUsageParams struct {
	// Prefix Namespace prefix segments. Repeat once per segment.
	Prefix *[]string                          `form:"prefix,omitempty" json:"prefix,omitempty"`
	Sort   *AdminListTopMemoryUsageParamsSort `form:"sort,omitempty" json:"sort,omitempty"`
	Limit  *int                               `form:"limit,omitempty" json:"limit,omitempty"`
}

type AdminListTopMemoryUsageParamsSort string

type AdminListTopMemoryUsageRequestObject struct {
	Params AdminListTopMemoryUsageParams
}

type AdminListTopMemoryUsageResponseObject interface {
	VisitAdminListTopMemoryUsageResponse(w http.ResponseWriter) error
}

type AdminListTopMemoryUsagedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminMemoryItem struct {
	Archived   *bool                   `json:"archived,omitempty"`
	ArchivedAt *time.Time              `json:"archivedAt,omitempty"`
	Attributes *map[string]interface{} `json:"attributes,omitempty"`
	CreatedAt  *time.Time              `json:"createdAt,omitempty"`
	ExpiresAt  *time.Time              `json:"expiresAt,omitempty"`
	Id         *openapi_types.UUID     `json:"id,omitempty"`
	Key        *string                 `json:"key,omitempty"`
	Namespace  *[]string               `json:"namespace,omitempty"`
	Revision   *int64                  `json:"revision,omitempty"`
	Score      *float64                `json:"score,omitempty"`
	Usage      *MemoryUsageResponse    `json:"usage,omitempty"`
	Value      *map[string]interface{} `json:"value,omitempty"`
}

type AdminMemoryNamespace struct {
	Segments *[]string `json:"segments,omitempty"`
}

type AdminOutboxStats struct {
	// OldestAt Oldest retained outbox event timestamp.
	OldestAt *time.Time `json:"oldestAt"`
	Total    int64      `json:"total"`
}

type AdminPutCheckpoint200JSONResponse AdminCheckpoint

type AdminPutCheckpoint400JSONResponse ErrorResponse

type AdminPutCheckpoint401Response struct {
}

type AdminPutCheckpoint403Response struct {
}

type AdminPutCheckpointJSONRequestBody = AdminCheckpointPutRequest

type AdminPutCheckpointRequestObject struct {
	ClientId string `json:"clientId"`
	Body     *AdminPutCheckpointJSONRequestBody
}

type AdminPutCheckpointResponseObject interface {
	VisitAdminPutCheckpointResponse(w http.ResponseWriter) error
}

type AdminPutMemoryPolicies204Response struct {
}

type AdminPutMemoryPoliciesJSONRequestBody = MemoryPolicyBundle

type AdminPutMemoryPoliciesRequestObject struct {
	Body *AdminPutMemoryPoliciesJSONRequestBody
}

type AdminPutMemoryPoliciesResponseObject interface {
	VisitAdminPutMemoryPoliciesResponse(w http.ResponseWriter) error
}

type AdminPutMemoryPoliciesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminSearchConversations200JSONResponse struct {
	AfterCursor *string         `json:"afterCursor,omitempty"`
	Data        *[]SearchResult `json:"data,omitempty"`
}

type AdminSearchConversationsJSONRequestBody = AdminSearchEntriesRequest

type AdminSearchConversationsParams struct {
	// Justification Reason for this admin action (for audit log).
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`
}

type AdminSearchConversationsRequestObject struct {
	Params AdminSearchConversationsParams
	Body   *AdminSearchConversationsJSONRequestBody
}

type AdminSearchConversationsResponseObject interface {
	VisitAdminSearchConversationsResponse(w http.ResponseWriter) error
}

type AdminSearchConversationsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminSearchEntriesRequest struct {
	// AfterCursor Cursor for pagination; returns items after this result.
	AfterCursor *string `json:"afterCursor,omitempty"`

	// IncludeArchived Include entries from archived conversations.
	IncludeArchived *bool `json:"includeArchived,omitempty"`

	// IncludeEntry Whether to include the full entry in results. Set to false to reduce response size when only metadata is needed.
	IncludeEntry *bool `json:"includeEntry,omitempty"`

	// Limit Maximum number of results to return.
	Limit *int `json:"limit,omitempty"`

	// Query Natural language query.
	Query string `json:"query"`

	// UserId Filter search to conversations owned by this user.
	UserId *string `json:"userId,omitempty"`
}

type AdminSearchMemories200JSONResponse AdminSearchMemoriesResponse

type AdminSearchMemoriesJSONRequestBody = AdminSearchMemoriesRequest

type AdminSearchMemoriesRequest struct {
	Archived        *AdminSearchMemoriesRequestArchived `json:"archived,omitempty"`
	AsUserId        *string                             `json:"as_user_id,omitempty"`
	Filter          *map[string]interface{}             `json:"filter,omitempty"`
	IncludeUsage    *bool                               `json:"include_usage,omitempty"`
	Justification   *string                             `json:"justification,omitempty"`
	KeyPrefix       *string                             `json:"key_prefix,omitempty"`
	Limit           *int                                `json:"limit,omitempty"`
	NamespacePrefix *[]string                           `json:"namespace_prefix,omitempty"`
	Query           *string                             `json:"query,omitempty"`
}

type AdminSearchMemoriesRequestArchived string

type AdminSearchMemoriesRequestObject struct {
	Body *AdminSearchMemoriesJSONRequestBody
}

type AdminSearchMemoriesResponse struct {
	Items *[]AdminMemoryItem `json:"items,omitempty"`
}

type AdminSearchMemoriesResponseObject interface {
	VisitAdminSearchMemoriesResponse(w http.ResponseWriter) error
}

type AdminSearchMemoriesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminStatsSummaryResponse struct {
	ConversationGroups AdminConversationGroupStats `json:"conversationGroups"`
	Conversations      AdminTotalStats             `json:"conversations"`
	Entries            AdminTotalStats             `json:"entries"`
	Memories           AdminArchivedTotalStats     `json:"memories"`
	OutboxEvents       *AdminOutboxStats           `json:"outboxEvents"`
}

type AdminSubscribeEvents200TexteventStreamResponse struct {
	Body          io.Reader
	ContentLength int64
}

type AdminSubscribeEvents400Response struct {
}

type AdminSubscribeEvents401Response struct {
}

type AdminSubscribeEvents403Response struct {
}

type AdminSubscribeEvents501Response struct {
}

type AdminSubscribeEventsParams struct {
	// Justification Optional reason for subscribing, logged for audit when present. Servers configured to require admin justifications reject requests without one.
	Justification *string `form:"justification,omitempty" json:"justification,omitempty"`

	// Kinds Comma-separated event kinds to filter.
	Kinds *string `form:"kinds,omitempty" json:"kinds,omitempty"`

	// After Replay events after the provided durable cursor. Requires the outbox feature to be enabled.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Detail Event payload detail level.
	Detail *AdminSubscribeEventsParamsDetail `form:"detail,omitempty" json:"detail,omitempty"`

	// EntryChannels Comma-separated entry channels to deliver for entry events. Defaults to history.
	EntryChannels *string `form:"entry_channels,omitempty" json:"entry_channels,omitempty"`

	// EntryContentTypes Comma-separated entry content types to deliver for entry events. Omit to allow any.
	EntryContentTypes *string `form:"entry_content_types,omitempty" json:"entry_content_types,omitempty"`

	// EntryRoles Comma-separated entry roles to deliver for entry events. Omit to allow any.
	EntryRoles *string `form:"entry_roles,omitempty" json:"entry_roles,omitempty"`
}

type AdminSubscribeEventsParamsDetail string

type AdminSubscribeEventsRequestObject struct {
	Params AdminSubscribeEventsParams
}

type AdminSubscribeEventsResponseObject interface {
	VisitAdminSubscribeEventsResponse(w http.ResponseWriter) error
}

type AdminTotalStats struct {
	Total int64 `json:"total"`
}

type AdminTriggerMemoryIndex200JSONResponse MemoryIndexTriggerResponse

type AdminTriggerMemoryIndexRequestObject struct {
}

type AdminTriggerMemoryIndexResponseObject interface {
	VisitAdminTriggerMemoryIndexResponse(w http.ResponseWriter) error
}

type AdminTriggerMemoryIndexdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AdminUpdateConversation200JSONResponse AdminConversation

type AdminUpdateConversation404JSONResponse struct{ NotFoundJSONResponse }

type AdminUpdateConversationJSONRequestBody = AdminUpdateConversationRequest

type AdminUpdateConversationRequest struct {
	// Archived Set to `true` to archive or `false` to unarchive the conversation fork tree.
	Archived *bool `json:"archived,omitempty"`

	// Justification Reason for the admin action (for audit log).
	Justification *string `json:"justification,omitempty"`
}

type AdminUpdateConversationRequestObject struct {
	Id   openapi_types.UUID `json:"id"`
	Body *AdminUpdateConversationJSONRequestBody
}

type AdminUpdateConversationResponseObject interface {
	VisitAdminUpdateConversationResponse(w http.ResponseWriter) error
}

type AdminUpdateConversationdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type Channel string

type ConversationForkSummary struct {
	// ConversationId Unique identifier for the forked conversation.
	ConversationId *openapi_types.UUID `json:"conversationId,omitempty"`
	CreatedAt      *time.Time          `json:"createdAt,omitempty"`

	// ForkedAtConversationId Conversation ID where the fork occurred.
	ForkedAtConversationId *openapi_types.UUID `json:"forkedAtConversationId,omitempty"`

	// ForkedAtEntryId First parent entry excluded by this fork. Null for blank-slate forks that inherit no parent entries.
	ForkedAtEntryId *openapi_types.UUID `json:"forkedAtEntryId,omitempty"`
	Title           *string             `json:"title,omitempty"`
}

type ConversationMembership struct {
	// AccessLevel Access level of a user for a conversation.
	AccessLevel *AccessLevel `json:"accessLevel,omitempty"`

	// ConversationId Unique identifier for the conversation.
	ConversationId *openapi_types.UUID `json:"conversationId,omitempty"`
	CreatedAt      *time.Time          `json:"createdAt,omitempty"`
	UserId         *string             `json:"userId,omitempty"`
}

type Entry struct {
	// Channel Logical channel of the entry within the conversation.
	Channel Channel       `json:"channel"`
	Content []interface{} `json:"content"`

	// ContentType Describes the schema/format of the content array.
	// Examples: "message", "LC4J", "SpringAI"
	ContentType string `json:"contentType"`

	// ConversationId Unique identifier for the conversation this entry belongs to.
	ConversationId openapi_types.UUID `json:"conversationId"`
	CreatedAt      time.Time          `json:"createdAt"`
	Epoch          *int64             `json:"epoch,omitempty"`

	// Id Unique identifier for the entry.
	Id     openapi_types.UUID `json:"id"`
	UserId *string            `json:"userId,omitempty"`
}

type Error = ErrorResponse

type ErrorJSONResponse ErrorResponse

type ErrorResponse struct {
	Code    *string                 `json:"code,omitempty"`
	Details *map[string]interface{} `json:"details,omitempty"`
	Error   *string                 `json:"error,omitempty"`
}

type EvictErrorEvent struct {
	// Error Error message describing what went wrong.
	Error *string `json:"error,omitempty"`
}

type EvictProgressEvent struct {
	// Progress Percentage of eviction completed (0-100).
	Progress *int `json:"progress,omitempty"`
}

type EvictRequest struct {
	// Justification Reason for the eviction (for audit log).
	Justification *string `json:"justification,omitempty"`

	// ResourceTypes Which resource types to evict.
	// - conversations: Archived conversations past retention.
	ResourceTypes []EvictRequestResourceTypes `json:"resourceTypes"`

	// RetentionPeriod ISO 8601 duration. Resources archived longer than this are hard-deleted.
	// Examples: P90D (90 days), P1Y (1 year), PT24H (24 hours).
	RetentionPeriod string `json:"retentionPeriod"`
}

type EvictRequestResourceTypes string

type GetCacheHitRate200JSONResponse TimeSeriesResponse

type GetCacheHitRate501JSONResponse ErrorResponse

type GetCacheHitRate503JSONResponse ErrorResponse

type GetCacheHitRateParams struct {
	// Start Start of time range (ISO 8601 timestamp). Defaults to 1 hour ago.
	Start *StatsStart `form:"start,omitempty" json:"start,omitempty"`

	// End End of time range (ISO 8601 timestamp). Defaults to now.
	End *StatsEnd `form:"end,omitempty" json:"end,omitempty"`

	// Step Resolution step for the time series (e.g., "60s", "5m"). Defaults to "60s".
	Step *StatsStep `form:"step,omitempty" json:"step,omitempty"`
}

type GetCacheHitRateRequestObject struct {
	Params GetCacheHitRateParams
}

type GetCacheHitRateResponseObject interface {
	VisitGetCacheHitRateResponse(w http.ResponseWriter) error
}

type GetCacheHitRatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetDbPoolUtilization200JSONResponse TimeSeriesResponse

type GetDbPoolUtilization501JSONResponse ErrorResponse

type GetDbPoolUtilization503JSONResponse ErrorResponse

type GetDbPoolUtilizationParams struct {
	// Start Start of time range (ISO 8601 timestamp). Defaults to 1 hour ago.
	Start *StatsStart `form:"start,omitempty" json:"start,omitempty"`

	// End End of time range (ISO 8601 timestamp). Defaults to now.
	End *StatsEnd `form:"end,omitempty" json:"end,omitempty"`

	// Step Resolution step for the time series (e.g., "60s", "5m"). Defaults to "60s".
	Step *StatsStep `form:"step,omitempty" json:"step,omitempty"`
}

type GetDbPoolUtilizationRequestObject struct {
	Params GetDbPoolUtilizationParams
}

type GetDbPoolUtilizationResponseObject interface {
	VisitGetDbPoolUtilizationResponse(w http.ResponseWriter) error
}

type GetDbPoolUtilizationdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetErrorRate200JSONResponse TimeSeriesResponse

type GetErrorRate501JSONResponse ErrorResponse

type GetErrorRate503JSONResponse ErrorResponse

type GetErrorRateParams struct {
	// Start Start of time range (ISO 8601 timestamp). Defaults to 1 hour ago.
	Start *StatsStart `form:"start,omitempty" json:"start,omitempty"`

	// End End of time range (ISO 8601 timestamp). Defaults to now.
	End *StatsEnd `form:"end,omitempty" json:"end,omitempty"`

	// Step Resolution step for the time series (e.g., "60s", "5m"). Defaults to "60s".
	Step *StatsStep `form:"step,omitempty" json:"step,omitempty"`
}

type GetErrorRateRequestObject struct {
	Params GetErrorRateParams
}

type GetErrorRateResponseObject interface {
	VisitGetErrorRateResponse(w http.ResponseWriter) error
}

type GetErrorRatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetHealth200JSONResponse struct {
	Status *string `json:"status,omitempty"`
}

type GetHealthRequestObject struct {
}

type GetHealthResponseObject interface {
	VisitGetHealthResponse(w http.ResponseWriter) error
}

type GetHealthdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetLatencyP95Params struct {
	// Start Start of time range (ISO 8601 timestamp). Defaults to 1 hour ago.
	Start *StatsStart `form:"start,omitempty" json:"start,omitempty"`

	// End End of time range (ISO 8601 timestamp). Defaults to now.
	End *StatsEnd `form:"end,omitempty" json:"end,omitempty"`

	// Step Resolution step for the time series (e.g., "60s", "5m"). Defaults to "60s".
	Step *StatsStep `form:"step,omitempty" json:"step,omitempty"`
}

type GetLatencyP95RequestObject struct {
	Params GetLatencyP95Params
}

type GetLatencyP95ResponseObject interface {
	VisitGetLatencyP95Response(w http.ResponseWriter) error
}

type GetLatencyP95defaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetLatencyP95200JSONResponse TimeSeriesResponse

type GetLatencyP95501JSONResponse ErrorResponse

type GetLatencyP95503JSONResponse ErrorResponse

type GetRequestRate200JSONResponse TimeSeriesResponse

type GetRequestRate501JSONResponse ErrorResponse

type GetRequestRate503JSONResponse ErrorResponse

type GetRequestRateParams struct {
	// Start Start of time range (ISO 8601 timestamp). Defaults to 1 hour ago.
	Start *StatsStart `form:"start,omitempty" json:"start,omitempty"`

	// End End of time range (ISO 8601 timestamp). Defaults to now.
	End *StatsEnd `form:"end,omitempty" json:"end,omitempty"`

	// Step Resolution step for the time series (e.g., "60s", "5m"). Defaults to "60s".
	Step *StatsStep `form:"step,omitempty" json:"step,omitempty"`
}

type GetRequestRateRequestObject struct {
	Params GetRequestRateParams
}

type GetRequestRateResponseObject interface {
	VisitGetRequestRateResponse(w http.ResponseWriter) error
}

type GetRequestRatedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetStatsSummary200JSONResponse AdminStatsSummaryResponse

type GetStatsSummary501JSONResponse ErrorResponse

type GetStatsSummaryRequestObject struct {
}

type GetStatsSummaryResponseObject interface {
	VisitGetStatsSummaryResponse(w http.ResponseWriter) error
}

type GetStatsSummarydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetStoreLatencyP95Params struct {
	// Start Start of time range (ISO 8601 timestamp). Defaults to 1 hour ago.
	Start *StatsStart `form:"start,omitempty" json:"start,omitempty"`

	// End End of time range (ISO 8601 timestamp). Defaults to now.
	End *StatsEnd `form:"end,omitempty" json:"end,omitempty"`

	// Step Resolution step for the time series (e.g., "60s", "5m"). Defaults to "60s".
	Step *StatsStep `form:"step,omitempty" json:"step,omitempty"`
}

type GetStoreLatencyP95RequestObject struct {
	Params GetStoreLatencyP95Params
}

type GetStoreLatencyP95ResponseObject interface {
	VisitGetStoreLatencyP95Response(w http.ResponseWriter) error
}

type GetStoreLatencyP95defaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetStoreLatencyP95200JSONResponse MultiSeriesResponse

type GetStoreLatencyP95501JSONResponse ErrorResponse

type GetStoreLatencyP95503JSONResponse ErrorResponse

type GetStoreThroughput200JSONResponse MultiSeriesResponse

type GetStoreThroughput501JSONResponse ErrorResponse

type GetStoreThroughput503JSONResponse ErrorResponse

type GetStoreThroughputParams struct {
	// Start Start of time range (ISO 8601 timestamp). Defaults to 1 hour ago.
	Start *StatsStart `form:"start,omitempty" json:"start,omitempty"`

	// End End of time range (ISO 8601 timestamp). Defaults to now.
	End *StatsEnd `form:"end,omitempty" json:"end,omitempty"`

	// Step Resolution step for the time series (e.g., "60s", "5m"). Defaults to "60s".
	Step *StatsStep `form:"step,omitempty" json:"step,omitempty"`
}

type GetStoreThroughputRequestObject struct {
	Params GetStoreThroughputParams
}

type GetStoreThroughputResponseObject interface {
	VisitGetStoreThroughputResponse(w http.ResponseWriter) error
}

type GetStoreThroughputdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GinServerOptions struct {
	BaseURL      string
	Middlewares  []MiddlewareFunc
	ErrorHandler func(*gin.Context, error, int)
}

type LabeledTimeSeries struct {
	// Data Time series data points for this label.
	Data []TimeSeriesDataPoint `json:"data"`

	// Label Label identifying this series (e.g., operation name).
	Label string `json:"label"`
}

type ListTopMemoryUsageResponse struct {
	Items *[]TopMemoryUsageItem `json:"items,omitempty"`
}

type MemoryIndexRunStats struct {
	Embedded           *int `json:"embedded,omitempty"`
	Failures           *int `json:"failures,omitempty"`
	Pending            *int `json:"pending,omitempty"`
	Processed          *int `json:"processed,omitempty"`
	SkippedNoEmbedding *int `json:"skipped_no_embedding,omitempty"`
	VectorDeletes      *int `json:"vector_deletes,omitempty"`
	VectorUpserts      *int `json:"vector_upserts,omitempty"`
}

type MemoryIndexStatusResponse struct {
	// Pending Number of memories where `indexed_at` is null.
	Pending *int64 `json:"pending,omitempty"`
}

type MemoryIndexTriggerResponse struct {
	Stats     *MemoryIndexRunStats `json:"stats,omitempty"`
	Triggered *bool                `json:"triggered,omitempty"`
}

type MemoryPolicyBundle struct {
	// Attributes Rego source for `package memories.attributes`.
	Attributes string `json:"attributes"`

	// Authz Rego source for `package memories.authz`.
	Authz string `json:"authz"`

	// Filter Rego source for `package memories.filter`.
	Filter string `json:"filter"`
}

type MemoryUsageResponse struct {
	FetchCount    *int64     `json:"fetchCount,omitempty"`
	LastFetchedAt *time.Time `json:"lastFetchedAt,omitempty"`
}

type MiddlewareFunc func(c *gin.Context)

type MultiSeriesResponse struct {
	// Metric Metric identifier (e.g., "store_latency_p95", "store_throughput").
	Metric string `json:"metric"`

	// Series Multiple time series, each with a label identifying the group.
	Series []LabeledTimeSeries `json:"series"`

	// Unit Unit of measurement (e.g., "seconds", "operations/sec").
	Unit string `json:"unit"`
}

type NotFound = ErrorResponse

type NotFoundJSONResponse ErrorResponse

type SearchResult struct {
	// ConversationId Unique identifier of the conversation containing this entry.
	ConversationId *openapi_types.UUID `json:"conversationId,omitempty"`

	// ConversationTitle Title of the conversation containing this entry.
	ConversationTitle *string `json:"conversationTitle,omitempty"`

	// Entry The matched entry. Only included when includeEntry is true in the request.
	Entry *Entry `json:"entry,omitempty"`

	// EntryId ID of the matched entry. Always present for deep-linking.
	EntryId    *openapi_types.UUID `json:"entryId,omitempty"`
	Highlights *string             `json:"highlights,omitempty"`
	Score      *float32            `json:"score,omitempty"`
}

type ServerInterface interface {
	// List episodic memories across users
	// (GET /admin/v1/memories)
	AdminListMemories(c *gin.Context, params AdminListMemoriesParams)
	// Search episodic memories across users
	// (POST /admin/v1/memories/search)
	AdminSearchMemories(c *gin.Context)
	// Force-delete an episodic memory by ID
	// (DELETE /admin/v1/memories/{id})
	AdminDeleteMemory(c *gin.Context, id openapi_types.UUID)
	// Get an episodic memory by ID
	// (GET /admin/v1/memories/{id})
	AdminGetMemory(c *gin.Context, id openapi_types.UUID, params AdminGetMemoryParams)
	// Get episodic memory indexing queue status
	// (GET /admin/v1/memory-index/status)
	AdminGetMemoryIndexStatus(c *gin.Context)
	// Trigger one episodic memory indexing cycle
	// (POST /admin/v1/memory-index/trigger)
	AdminTriggerMemoryIndex(c *gin.Context)
	// List episodic memory namespaces across users
	// (GET /admin/v1/memory-namespaces)
	AdminListMemoryNamespaces(c *gin.Context, params AdminListMemoryNamespacesParams)
	// Download active episodic memory policy bundle
	// (GET /admin/v1/memory-policies)
	AdminGetMemoryPolicies(c *gin.Context)
	// Upload episodic memory policy bundle
	// (PUT /admin/v1/memory-policies)
	AdminPutMemoryPolicies(c *gin.Context)
	// Get episodic memory usage for a single key
	// (GET /admin/v1/memory-usage)
	AdminGetMemoryUsage(c *gin.Context, params AdminGetMemoryUsageParams)
	// List top episodic memory usage rows under a namespace prefix
	// (GET /admin/v1/memory-usage/top)
	AdminListTopMemoryUsage(c *gin.Context, params AdminListTopMemoryUsageParams)
	// List all attachments across users (admin/auditor)
	// (GET /v1/admin/attachments)
	AdminListAttachments(c *gin.Context, params AdminListAttachmentsParams)
	// Delete any attachment (admin only)
	// (DELETE /v1/admin/attachments/{id})
	AdminDeleteAttachment(c *gin.Context, id openapi_types.UUID)
	// Get attachment metadata (admin/auditor)
	// (GET /v1/admin/attachments/{id})
	AdminGetAttachment(c *gin.Context, id openapi_types.UUID, params AdminGetAttachmentParams)
	// Download attachment content (admin/auditor)
	// (GET /v1/admin/attachments/{id}/content)
	AdminGetAttachmentContent(c *gin.Context, id openapi_types.UUID, params AdminGetAttachmentContentParams)
	// Get signed download URL for any attachment (admin/auditor)
	// (GET /v1/admin/attachments/{id}/download-url)
	AdminGetAttachmentDownloadUrl(c *gin.Context, id openapi_types.UUID, params AdminGetAttachmentDownloadUrlParams)
	// Get an admin client checkpoint
	// (GET /v1/admin/checkpoints/{clientId})
	AdminGetCheckpoint(c *gin.Context, clientId string)
	// Upsert an admin client checkpoint
	// (PUT /v1/admin/checkpoints/{clientId})
	AdminPutCheckpoint(c *gin.Context, clientId string)
	// List all conversations (admin/auditor)
	// (GET /v1/admin/conversations)
	AdminListConversations(c *gin.Context, params AdminListConversationsParams)
	// System-wide semantic search (admin/auditor)
	// (POST /v1/admin/conversations/search)
	AdminSearchConversations(c *gin.Context, params AdminSearchConversationsParams)
	// Get any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id})
	AdminGetConversation(c *gin.Context, id openapi_types.UUID, params AdminGetConversationParams)
	// Update any conversation (admin only)
	// (PATCH /v1/admin/conversations/{id})
	AdminUpdateConversation(c *gin.Context, id openapi_types.UUID)
	// List direct child conversations
	// (GET /v1/admin/conversations/{id}/children)
	AdminListChildConversations(c *gin.Context, id openapi_types.UUID, params AdminListChildConversationsParams)
	// Get entries from any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id}/entries)
	AdminGetEntries(c *gin.Context, id openapi_types.UUID, params AdminGetEntriesParams)
	// List forks for any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id}/forks)
	AdminListForks(c *gin.Context, id openapi_types.UUID, params AdminListForksParams)
	// Get memberships for any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id}/memberships)
	AdminGetMemberships(c *gin.Context, id openapi_types.UUID, params AdminGetMembershipsParams)
	// Get any entry by ID (admin/auditor)
	// (GET /v1/admin/entries/{id})
	AdminGetEntry(c *gin.Context, id openapi_types.UUID, params AdminGetEntryParams)
	// Subscribe to all real-time events (admin SSE)
	// (GET /v1/admin/events)
	AdminSubscribeEvents(c *gin.Context, params AdminSubscribeEventsParams)
	// Hard-delete archived resources past retention period
	// (POST /v1/admin/evict)
	AdminEvict(c *gin.Context, params AdminEvictParams)
	// Get cache hit rate percentage over time
	// (GET /v1/admin/stats/cache-hit-rate)
	GetCacheHitRate(c *gin.Context, params GetCacheHitRateParams)
	// Get database connection pool utilization over time
	// (GET /v1/admin/stats/db-pool-utilization)
	GetDbPoolUtilization(c *gin.Context, params GetDbPoolUtilizationParams)
	// Get 5xx error rate percentage over time
	// (GET /v1/admin/stats/error-rate)
	GetErrorRate(c *gin.Context, params GetErrorRateParams)
	// Get P95 response latency over time
	// (GET /v1/admin/stats/latency-p95)
	GetLatencyP95(c *gin.Context, params GetLatencyP95Params)
	// Get HTTP request rate over time
	// (GET /v1/admin/stats/request-rate)
	GetRequestRate(c *gin.Context, params GetRequestRateParams)
	// Get P95 store operation latency by operation type
	// (GET /v1/admin/stats/store-latency-p95)
	GetStoreLatencyP95(c *gin.Context, params GetStoreLatencyP95Params)
	// Get store operation throughput by operation type
	// (GET /v1/admin/stats/store-throughput)
	GetStoreThroughput(c *gin.Context, params GetStoreThroughputParams)
	// Get current datastore-backed admin inventory summary
	// (GET /v1/admin/stats/summary)
	GetStatsSummary(c *gin.Context)
	// Health check
	// (GET /v1/health)
	GetHealth(c *gin.Context)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandler       func(*gin.Context, error, int)
}

type StatsEnd = time.Time

type StatsStart = time.Time

type StatsStep = string

type StrictGinServerOptions struct {
	// RequestErrorHandlerFunc is called when a request cannot be parsed or
	// decoded. It is invoked for JSON bind failures, form parse/bind errors,
	// multipart reader errors, media type parse errors, missing multipart
	// boundaries, and request body read errors. The default returns 400.
	RequestErrorHandlerFunc func(ctx *gin.Context, err error)
	// HandlerErrorFunc is called when the application handler (or any
	// middleware wrapping it) returns a non-nil error. The default returns 500.
	HandlerErrorFunc func(ctx *gin.Context, err error)
	// ResponseErrorHandlerFunc is called when the response object fails to
	// serialize (Visit*Response returns an error) or when the handler returns
	// an unexpected response type. The default returns 500.
	ResponseErrorHandlerFunc func(ctx *gin.Context, err error)
}

type StrictHandlerFunc func(ctx *gin.Context, request any) (any, error)

type StrictMiddlewareFunc func(f StrictHandlerFunc, operationID string) StrictHandlerFunc

type StrictServerInterface interface {
	// List episodic memories across users
	// (GET /admin/v1/memories)
	AdminListMemories(ctx context.Context, request AdminListMemoriesRequestObject) (AdminListMemoriesResponseObject, error)
	// Search episodic memories across users
	// (POST /admin/v1/memories/search)
	AdminSearchMemories(ctx context.Context, request AdminSearchMemoriesRequestObject) (AdminSearchMemoriesResponseObject, error)
	// Force-delete an episodic memory by ID
	// (DELETE /admin/v1/memories/{id})
	AdminDeleteMemory(ctx context.Context, request AdminDeleteMemoryRequestObject) (AdminDeleteMemoryResponseObject, error)
	// Get an episodic memory by ID
	// (GET /admin/v1/memories/{id})
	AdminGetMemory(ctx context.Context, request AdminGetMemoryRequestObject) (AdminGetMemoryResponseObject, error)
	// Get episodic memory indexing queue status
	// (GET /admin/v1/memory-index/status)
	AdminGetMemoryIndexStatus(ctx context.Context, request AdminGetMemoryIndexStatusRequestObject) (AdminGetMemoryIndexStatusResponseObject, error)
	// Trigger one episodic memory indexing cycle
	// (POST /admin/v1/memory-index/trigger)
	AdminTriggerMemoryIndex(ctx context.Context, request AdminTriggerMemoryIndexRequestObject) (AdminTriggerMemoryIndexResponseObject, error)
	// List episodic memory namespaces across users
	// (GET /admin/v1/memory-namespaces)
	AdminListMemoryNamespaces(ctx context.Context, request AdminListMemoryNamespacesRequestObject) (AdminListMemoryNamespacesResponseObject, error)
	// Download active episodic memory policy bundle
	// (GET /admin/v1/memory-policies)
	AdminGetMemoryPolicies(ctx context.Context, request AdminGetMemoryPoliciesRequestObject) (AdminGetMemoryPoliciesResponseObject, error)
	// Upload episodic memory policy bundle
	// (PUT /admin/v1/memory-policies)
	AdminPutMemoryPolicies(ctx context.Context, request AdminPutMemoryPoliciesRequestObject) (AdminPutMemoryPoliciesResponseObject, error)
	// Get episodic memory usage for a single key
	// (GET /admin/v1/memory-usage)
	AdminGetMemoryUsage(ctx context.Context, request AdminGetMemoryUsageRequestObject) (AdminGetMemoryUsageResponseObject, error)
	// List top episodic memory usage rows under a namespace prefix
	// (GET /admin/v1/memory-usage/top)
	AdminListTopMemoryUsage(ctx context.Context, request AdminListTopMemoryUsageRequestObject) (AdminListTopMemoryUsageResponseObject, error)
	// List all attachments across users (admin/auditor)
	// (GET /v1/admin/attachments)
	AdminListAttachments(ctx context.Context, request AdminListAttachmentsRequestObject) (AdminListAttachmentsResponseObject, error)
	// Delete any attachment (admin only)
	// (DELETE /v1/admin/attachments/{id})
	AdminDeleteAttachment(ctx context.Context, request AdminDeleteAttachmentRequestObject) (AdminDeleteAttachmentResponseObject, error)
	// Get attachment metadata (admin/auditor)
	// (GET /v1/admin/attachments/{id})
	AdminGetAttachment(ctx context.Context, request AdminGetAttachmentRequestObject) (AdminGetAttachmentResponseObject, error)
	// Download attachment content (admin/auditor)
	// (GET /v1/admin/attachments/{id}/content)
	AdminGetAttachmentContent(ctx context.Context, request AdminGetAttachmentContentRequestObject) (AdminGetAttachmentContentResponseObject, error)
	// Get signed download URL for any attachment (admin/auditor)
	// (GET /v1/admin/attachments/{id}/download-url)
	AdminGetAttachmentDownloadUrl(ctx context.Context, request AdminGetAttachmentDownloadUrlRequestObject) (AdminGetAttachmentDownloadUrlResponseObject, error)
	// Get an admin client checkpoint
	// (GET /v1/admin/checkpoints/{clientId})
	AdminGetCheckpoint(ctx context.Context, request AdminGetCheckpointRequestObject) (AdminGetCheckpointResponseObject, error)
	// Upsert an admin client checkpoint
	// (PUT /v1/admin/checkpoints/{clientId})
	AdminPutCheckpoint(ctx context.Context, request AdminPutCheckpointRequestObject) (AdminPutCheckpointResponseObject, error)
	// List all conversations (admin/auditor)
	// (GET /v1/admin/conversations)
	AdminListConversations(ctx context.Context, request AdminListConversationsRequestObject) (AdminListConversationsResponseObject, error)
	// System-wide semantic search (admin/auditor)
	// (POST /v1/admin/conversations/search)
	AdminSearchConversations(ctx context.Context, request AdminSearchConversationsRequestObject) (AdminSearchConversationsResponseObject, error)
	// Get any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id})
	AdminGetConversation(ctx context.Context, request AdminGetConversationRequestObject) (AdminGetConversationResponseObject, error)
	// Update any conversation (admin only)
	// (PATCH /v1/admin/conversations/{id})
	AdminUpdateConversation(ctx context.Context, request AdminUpdateConversationRequestObject) (AdminUpdateConversationResponseObject, error)
	// List direct child conversations
	// (GET /v1/admin/conversations/{id}/children)
	AdminListChildConversations(ctx context.Context, request AdminListChildConversationsRequestObject) (AdminListChildConversationsResponseObject, error)
	// Get entries from any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id}/entries)
	AdminGetEntries(ctx context.Context, request AdminGetEntriesRequestObject) (AdminGetEntriesResponseObject, error)
	// List forks for any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id}/forks)
	AdminListForks(ctx context.Context, request AdminListForksRequestObject) (AdminListForksResponseObject, error)
	// Get memberships for any conversation (admin/auditor)
	// (GET /v1/admin/conversations/{id}/memberships)
	AdminGetMemberships(ctx context.Context, request AdminGetMembershipsRequestObject) (AdminGetMembershipsResponseObject, error)
	// Get any entry by ID (admin/auditor)
	// (GET /v1/admin/entries/{id})
	AdminGetEntry(ctx context.Context, request AdminGetEntryRequestObject) (AdminGetEntryResponseObject, error)
	// Subscribe to all real-time events (admin SSE)
	// (GET /v1/admin/events)
	AdminSubscribeEvents(ctx context.Context, request AdminSubscribeEventsRequestObject) (AdminSubscribeEventsResponseObject, error)
	// Hard-delete archived resources past retention period
	// (POST /v1/admin/evict)
	AdminEvict(ctx context.Context, request AdminEvictRequestObject) (AdminEvictResponseObject, error)
	// Get cache hit rate percentage over time
	// (GET /v1/admin/stats/cache-hit-rate)
	GetCacheHitRate(ctx context.Context, request GetCacheHitRateRequestObject) (GetCacheHitRateResponseObject, error)
	// Get database connection pool utilization over time
	// (GET /v1/admin/stats/db-pool-utilization)
	GetDbPoolUtilization(ctx context.Context, request GetDbPoolUtilizationRequestObject) (GetDbPoolUtilizationResponseObject, error)
	// Get 5xx error rate percentage over time
	// (GET /v1/admin/stats/error-rate)
	GetErrorRate(ctx context.Context, request GetErrorRateRequestObject) (GetErrorRateResponseObject, error)
	// Get P95 response latency over time
	// (GET /v1/admin/stats/latency-p95)
	GetLatencyP95(ctx context.Context, request GetLatencyP95RequestObject) (GetLatencyP95ResponseObject, error)
	// Get HTTP request rate over time
	// (GET /v1/admin/stats/request-rate)
	GetRequestRate(ctx context.Context, request GetRequestRateRequestObject) (GetRequestRateResponseObject, error)
	// Get P95 store operation latency by operation type
	// (GET /v1/admin/stats/store-latency-p95)
	GetStoreLatencyP95(ctx context.Context, request GetStoreLatencyP95RequestObject) (GetStoreLatencyP95ResponseObject, error)
	// Get store operation throughput by operation type
	// (GET /v1/admin/stats/store-throughput)
	GetStoreThroughput(ctx context.Context, request GetStoreThroughputRequestObject) (GetStoreThroughputResponseObject, error)
	// Get current datastore-backed admin inventory summary
	// (GET /v1/admin/stats/summary)
	GetStatsSummary(ctx context.Context, request GetStatsSummaryRequestObject) (GetStatsSummaryResponseObject, error)
	// Health check
	// (GET /v1/health)
	GetHealth(ctx context.Context, request GetHealthRequestObject) (GetHealthResponseObject, error)
}

type TimeSeriesDataPoint struct {
	// Timestamp Timestamp of the data point.
	Timestamp time.Time `json:"timestamp"`

	// Value Value at this timestamp.
	Value float64 `json:"value"`
}

type TimeSeriesResponse struct {
	// Data Time series data points.
	Data []TimeSeriesDataPoint `json:"data"`

	// Metric Metric identifier (e.g., "request_rate", "error_rate").
	Metric string `json:"metric"`

	// Unit Unit of measurement (e.g., "requests/sec", "percent", "seconds").
	Unit string `json:"unit"`
}

type TopMemoryUsageItem struct {
	Key       *string              `json:"key,omitempty"`
	Namespace *[]string            `json:"namespace,omitempty"`
	Usage     *MemoryUsageResponse `json:"usage,omitempty"`
}