api

type AcceptTransfer204Response struct {
}

type AcceptTransfer403JSONResponse struct{ ErrorJSONResponse }

type AcceptTransfer404JSONResponse struct{ NotFoundJSONResponse }

type AcceptTransferRequestObject struct {
	TransferId openapi_types.UUID `json:"transferId"`
}

type AcceptTransferResponseObject interface {
	VisitAcceptTransferResponse(w http.ResponseWriter) error
}

type AcceptTransferdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type AccessLevel string

type AdminSubscribeEvents200TexteventStreamResponse struct {
	Body          io.Reader
	ContentLength int64
}

type AdminSubscribeEvents400Response struct {
}

type AdminSubscribeEvents401Response struct {
}

type AdminSubscribeEvents403Response 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 AppendConversationEntry201JSONResponse Entry

type AppendConversationEntry404JSONResponse struct{ NotFoundJSONResponse }

type AppendConversationEntryJSONRequestBody = CreateEntryRequest

type AppendConversationEntryRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Body           *AppendConversationEntryJSONRequestBody
}

type AppendConversationEntryResponseObject interface {
	VisitAppendConversationEntryResponse(w http.ResponseWriter) error
}

type AppendConversationEntrydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type Attachment struct {
	// AttachmentId ID of a previously uploaded attachment (from POST /v1/attachments).
	// When the entry is created, this is replaced with an href.
	AttachmentId *string `json:"attachmentId,omitempty"`

	// ContentType MIME type of the attachment (e.g., "image/jpeg", "audio/mp3"). Required when href is provided directly.
	ContentType *string `json:"contentType,omitempty"`

	// Description Optional alt text or description.
	Description *string `json:"description,omitempty"`

	// Href URL to the attachment resource (external or server-relative).
	Href *string `json:"href,omitempty"`

	// Name Optional display name for the attachment.
	Name *string `json:"name,omitempty"`

	// Sha256 SHA-256 hash of the file content (set by server for uploaded attachments).
	Sha256 *string `json:"sha256,omitempty"`

	// Size File size in bytes (set by server for uploaded attachments).
	Size *int64 `json:"size,omitempty"`
}

type AttachmentDownloadUrlResponse struct {
	// ExpiresIn Number of seconds until the URL expires.
	ExpiresIn *int `json:"expiresIn,omitempty"`

	// Url The signed download URL. May be an absolute S3 URL or a server-relative path.
	Url *string `json:"url,omitempty"`
}

type AttachmentUploadResponse struct {
	// ContentType MIME type of the uploaded file.
	ContentType *string `json:"contentType,omitempty"`

	// ExpiresAt When this unlinked attachment will expire and be deleted.
	ExpiresAt *time.Time `json:"expiresAt,omitempty"`

	// Filename Original filename of the uploaded file.
	Filename *string `json:"filename,omitempty"`

	// Href Server-relative URL to retrieve the attachment.
	Href *string `json:"href,omitempty"`

	// Id Unique identifier for the uploaded attachment.
	Id *openapi_types.UUID `json:"id,omitempty"`

	// Sha256 SHA-256 hash of the file content (null for URL-created attachments until download completes).
	Sha256 *string `json:"sha256,omitempty"`

	// Size File size in bytes (null for URL-created attachments until download completes).
	Size *int64 `json:"size,omitempty"`

	// SourceUrl Original source URL (only present for URL-created attachments).
	SourceUrl *string `json:"sourceUrl,omitempty"`

	// Status Current status of the attachment:
	// - `uploading` - Multipart upload created but not yet completed
	// - `downloading` - Server is downloading content from sourceUrl
	// - `ready` - Content is available for retrieval
	// - `failed` - Download from sourceUrl failed
	Status *AttachmentUploadResponseStatus `json:"status,omitempty"`
}

type AttachmentUploadResponseStatus string

type CapabilitiesAuth struct {
	AdminJustificationRequired bool `json:"admin_justification_required"`
	ApiKeyEnabled              bool `json:"api_key_enabled"`
	OidcEnabled                bool `json:"oidc_enabled"`
}

type CapabilitiesFeatures struct {
	CorsEnabled               bool `json:"cors_enabled"`
	FulltextSearchEnabled     bool `json:"fulltext_search_enabled"`
	ManagementListenerEnabled bool `json:"management_listener_enabled"`
	OutboxEnabled             bool `json:"outbox_enabled"`
	PrivateSourceUrlsEnabled  bool `json:"private_source_urls_enabled"`
	S3DirectDownloadEnabled   bool `json:"s3_direct_download_enabled"`
	SemanticSearchEnabled     bool `json:"semantic_search_enabled"`
}

type CapabilitiesResponse struct {
	Auth     CapabilitiesAuth     `json:"auth"`
	Features CapabilitiesFeatures `json:"features"`
	Security CapabilitiesSecurity `json:"security"`
	Tech     CapabilitiesTech     `json:"tech"`
	Version  string               `json:"version"`
}

type CapabilitiesSecurity struct {
	AttachmentEncryptionEnabled bool `json:"attachment_encryption_enabled"`
	DbEncryptionEnabled         bool `json:"db_encryption_enabled"`
	EncryptionEnabled           bool `json:"encryption_enabled"`
}

type CapabilitiesTech struct {
	Attachments string `json:"attachments"`
	Cache       string `json:"cache"`
	Embedder    string `json:"embedder"`
	EventBus    string `json:"event_bus"`
	Store       string `json:"store"`
	Vector      string `json:"vector"`
}

type Channel string

type ChildConversationSummary 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 Conversation struct {
	// AccessLevel Access level of a user for a conversation.
	AccessLevel *AccessLevel `json:"accessLevel,omitempty"`

	// AgentId Optional logical agent associated with this conversation.
	AgentId *string `json:"agentId,omitempty"`

	// Archived Synthetic archive flag derived from the internal archived timestamp.
	Archived  *bool      `json:"archived,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 Parent conversation that started this child conversation.
	StartedByConversationId *openapi_types.UUID `json:"startedByConversationId,omitempty"`

	// StartedByEntryId Parent entry that started this child conversation.
	StartedByEntryId *openapi_types.UUID `json:"startedByEntryId,omitempty"`
	Title            *string             `json:"title,omitempty"`
	UpdatedAt        *time.Time          `json:"updatedAt,omitempty"`
}

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 ConversationSummary 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 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 CreateConversation201JSONResponse Conversation

type CreateConversationJSONRequestBody = CreateConversationRequest

type CreateConversationRequest struct {
	// AgentId Optional logical agent to associate with the new conversation.
	AgentId *string `json:"agentId,omitempty"`

	// Id Optional client-supplied UUID for the conversation. When provided, the server creates the conversation with exactly this ID instead of generating one. Useful for agents that need a deterministic conversation ID derived from an external thread identifier.
	Id       *openapi_types.UUID     `json:"id,omitempty"`
	Metadata *map[string]interface{} `json:"metadata,omitempty"`
	Title    *string                 `json:"title,omitempty"`
}

type CreateConversationRequestObject struct {
	Body *CreateConversationJSONRequestBody
}

type CreateConversationResponseObject interface {
	VisitCreateConversationResponse(w http.ResponseWriter) error
}

type CreateConversationdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type CreateEntryRequest struct {
	// AgentId Optional logical agent to associate with the conversation when this request auto-creates a new conversation. Ignored for existing conversations.
	AgentId *string `json:"agentId,omitempty"`

	// Channel Logical channel of the entry within the conversation.
	Channel *Channel `json:"channel,omitempty"`

	// Content For history channel entries (contentType: `"history"` or `"history/<subtype>"`), each block
	// contains `role` and at least one of `text`, `events`, or `attachments`.
	Content []interface{} `json:"content"`

	// ContentType Describes the schema/format of the content array.
	//
	// **History channel entries must use `"history"` or `"history/<subtype>"` as the contentType.**
	//
	// Supported content types:
	// - `history` - Simple text-only history entries
	// - `history/lc4j` - LangChain4j rich event format (Quarkus)
	//
	// The content array for history entries must contain exactly 1 object with:
	// - `role` (string, required): Either `"USER"` or `"AI"`.
	// - `text` (string, optional): The message text. At least one of `text`, `events`, or `attachments` must be present.
	// - `events` (array, optional): Rich event objects for streaming details.
	//   Event structure is not validated by the server. For `history/lc4j`, events use an `eventType` field:
	//   - `PartialResponse`: Text chunk (`{eventType, chunk}`)
	//   - `PartialThinking`: Reasoning chunk (`{eventType, chunk}`)
	//   - `BeforeToolExecution`: Before tool call (`{eventType, toolName, input}`)
	//   - `ToolExecuted`: Tool result (`{eventType, toolName, output}`)
	// - `attachments` (array, optional): Array of `Attachment` objects referencing external resources (images, audio, video, documents).
	//
	// Other contentTypes (e.g., `"LC4J"`, `"SpringAI"`) may be used for
	// agent context entries.
	ContentType string `json:"contentType"`

	// ForkedAtConversationId If the target conversation doesn't exist yet, auto-create it as a fork of this conversation. Ignored when the conversation already exists.
	ForkedAtConversationId *openapi_types.UUID `json:"forkedAtConversationId,omitempty"`

	// ForkedAtEntryId Entry ID marking the fork point. Entries before this point are inherited; entries at and after this point are excluded. Optional; when unset, all entries are excluded. New messages added will show up as the first message of the fork.
	ForkedAtEntryId *openapi_types.UUID `json:"forkedAtEntryId,omitempty"`

	// IndexedContent Optional text to index for search. Only valid for entries in the history
	// channel. If provided, the entry will be indexed for search immediately
	// after creation. Returns 400 Bad Request if specified for non-history channels.
	IndexedContent *string `json:"indexedContent,omitempty"`

	// StartedByConversationId If the target conversation does not exist yet, auto-create it as a child conversation started from this parent conversation.
	StartedByConversationId *openapi_types.UUID `json:"startedByConversationId,omitempty"`

	// StartedByEntryId Optional parent entry that caused this child conversation to be started.
	StartedByEntryId *openapi_types.UUID `json:"startedByEntryId,omitempty"`

	// UserId Human user this entry is associated with.
	// For history entries authored by a user, this is the sender.
	// For agent entries, this is the user the agent is responding to.
	UserId *string `json:"userId,omitempty"`
}

type CreateFromUrlRequest struct {
	// ContentType MIME type of the content. Defaults to application/octet-stream.
	ContentType *string `json:"contentType,omitempty"`

	// Name Display name for the attachment.
	Name *string `json:"name,omitempty"`

	// SourceUrl URL of the content to download and store as an attachment.
	SourceUrl string `json:"sourceUrl"`
}

type CreateOwnershipTransfer201JSONResponse OwnershipTransfer

type CreateOwnershipTransfer400JSONResponse struct{ ErrorJSONResponse }

type CreateOwnershipTransfer403JSONResponse ErrorResponse

type CreateOwnershipTransfer404JSONResponse struct{ NotFoundJSONResponse }

type CreateOwnershipTransfer409JSONResponse struct {
	Code  *string `json:"code,omitempty"`
	Error *string `json:"error,omitempty"`

	// ExistingTransferId ID of the existing pending transfer
	ExistingTransferId *openapi_types.UUID `json:"existingTransferId,omitempty"`
}

type CreateOwnershipTransferJSONRequestBody = CreateOwnershipTransferRequest

type CreateOwnershipTransferRequest struct {
	// ConversationId The conversation to transfer ownership of.
	ConversationId openapi_types.UUID `json:"conversationId"`

	// NewOwnerUserId User ID of the proposed new owner. Must be an existing member.
	NewOwnerUserId string `json:"newOwnerUserId"`
}

type CreateOwnershipTransferRequestObject struct {
	Body *CreateOwnershipTransferJSONRequestBody
}

type CreateOwnershipTransferResponseObject interface {
	VisitCreateOwnershipTransferResponse(w http.ResponseWriter) error
}

type CreateOwnershipTransferdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type DeleteAttachment204Response struct {
}

type DeleteAttachment403JSONResponse struct{ ErrorJSONResponse }

type DeleteAttachment404JSONResponse struct{ NotFoundJSONResponse }

type DeleteAttachment409JSONResponse ErrorResponse

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

type DeleteAttachmentResponseObject interface {
	VisitDeleteAttachmentResponse(w http.ResponseWriter) error
}

type DeleteAttachmentdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type DeleteConversationMembership204Response struct {
}

type DeleteConversationMembership404JSONResponse struct{ NotFoundJSONResponse }

type DeleteConversationMembershipRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	UserId         string             `json:"userId"`
}

type DeleteConversationMembershipResponseObject interface {
	VisitDeleteConversationMembershipResponse(w http.ResponseWriter) error
}

type DeleteConversationMembershipdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type DeleteConversationResponse200Response struct {
}

type DeleteConversationResponse404JSONResponse struct{ NotFoundJSONResponse }

type DeleteConversationResponse409JSONResponse struct{ ErrorJSONResponse }

type DeleteConversationResponseRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
}

type DeleteConversationResponseResponseObject interface {
	VisitDeleteConversationResponseResponse(w http.ResponseWriter) error
}

type DeleteConversationResponsedefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type DeleteTransfer204Response struct {
}

type DeleteTransfer403JSONResponse struct{ ErrorJSONResponse }

type DeleteTransfer404JSONResponse struct{ NotFoundJSONResponse }

type DeleteTransferRequestObject struct {
	TransferId openapi_types.UUID `json:"transferId"`
}

type DeleteTransferResponseObject interface {
	VisitDeleteTransferResponse(w http.ResponseWriter) error
}

type DeleteTransferdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type DownloadAttachmentByToken200ApplicationoctetStreamResponse struct {
	Body          io.Reader
	Headers       DownloadAttachmentByToken200ResponseHeaders
	ContentLength int64
}

type DownloadAttachmentByToken200ResponseHeaders struct {
	CacheControl *string
}

type DownloadAttachmentByToken403Response struct {
}

type DownloadAttachmentByToken404JSONResponse struct{ NotFoundJSONResponse }

type DownloadAttachmentByTokenRequestObject struct {
	Token    string `json:"token"`
	Filename string `json:"filename"`
}

type DownloadAttachmentByTokenResponseObject interface {
	VisitDownloadAttachmentByTokenResponse(w http.ResponseWriter) error
}

type DownloadAttachmentByTokendefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type Entry struct {
	// Channel Logical channel of the entry within the conversation.
	Channel Channel `json:"channel"`

	// Content Opaque, agent-defined content blocks.
	// Different agents may use different schemas; the memory-service
	// stores and returns them without interpretation.
	//
	// For history channel entries (contentType: `"history"`), each block
	// contains `role` and at least one of `text`, `events`, or `attachments`.
	Content []interface{} `json:"content"`

	// ContentType Describes the schema/format of the content array.
	//
	// **History channel entries must use `"history"` or `"history/<subtype>"` as the contentType.**
	//
	// Supported content types:
	// - `history` - Simple text-only history entries
	// - `history/lc4j` - LangChain4j rich event format (Quarkus)
	//
	// The content array for history entries contains objects with:
	// - `role` (string, required): Either `"USER"` or `"AI"`.
	// - `text` (string, optional): The message text. At least one of `text`, `events`, or `attachments` must be present.
	// - `events` (array, optional): Rich event objects for streaming details.
	//   Event structure is not validated by the server. For `history/lc4j`, events use an `eventType` field:
	//   - `PartialResponse`: Text chunk (`{eventType, chunk}`)
	//   - `PartialThinking`: Reasoning chunk (`{eventType, chunk}`)
	//   - `BeforeToolExecution`: Before tool call (`{eventType, toolName, input}`)
	//   - `ToolExecuted`: Tool result (`{eventType, toolName, output}`)
	// - `attachments` (array, optional): Array of `Attachment` objects referencing external resources (images, audio, video, documents).
	//
	// Other contentTypes (e.g., `"LC4J"`, `"SpringAI"`) may be used for
	// agent context entries.
	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 Logical context epoch this entry belongs to.
	// For history entries this is typically null. For context entries,
	// the agent increments the epoch when starting a new context version.
	Epoch *int64 `json:"epoch,omitempty"`

	// Id Unique identifier for the entry.
	Id openapi_types.UUID `json:"id"`

	// UserId Human user this entry is associated with.
	// For history entries authored by a user, this is the sender.
	// For agent entries, this is the user the agent is responding to.
	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 GetAttachment200ApplicationoctetStreamResponse struct {
	Body          io.Reader
	Headers       GetAttachment200ResponseHeaders
	ContentLength int64
}

type GetAttachment200ResponseHeaders struct {
	CacheControl *string
}

type GetAttachment302Response struct {
	Headers GetAttachment302ResponseHeaders
}

type GetAttachment302ResponseHeaders struct {
	CacheControl *string
}

type GetAttachment403JSONResponse struct{ ErrorJSONResponse }

type GetAttachment404JSONResponse struct{ NotFoundJSONResponse }

type GetAttachmentDownloadUrl200JSONResponse AttachmentDownloadUrlResponse

type GetAttachmentDownloadUrl403JSONResponse struct{ ErrorJSONResponse }

type GetAttachmentDownloadUrl404JSONResponse struct{ NotFoundJSONResponse }

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

type GetAttachmentDownloadUrlResponseObject interface {
	VisitGetAttachmentDownloadUrlResponse(w http.ResponseWriter) error
}

type GetAttachmentDownloadUrldefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type GetAttachmentResponseObject interface {
	VisitGetAttachmentResponse(w http.ResponseWriter) error
}

type GetAttachmentdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetCapabilities200JSONResponse CapabilitiesResponse

type GetCapabilities401Response struct {
}

type GetCapabilities403Response struct {
}

type GetCapabilitiesRequestObject struct {
}

type GetCapabilitiesResponseObject interface {
	VisitGetCapabilitiesResponse(w http.ResponseWriter) error
}

type GetCapabilitiesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetConversation200JSONResponse Conversation

type GetConversation404JSONResponse struct{ NotFoundJSONResponse }

type GetConversationRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
}

type GetConversationResponseObject interface {
	VisitGetConversationResponse(w http.ResponseWriter) error
}

type GetConversationdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetMemory200JSONResponse MemoryItem

type GetMemory404JSONResponse struct{ NotFoundJSONResponse }

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

	// IncludeUsage Include usage counters for the requested memory.
	IncludeUsage *bool `form:"include_usage,omitempty" json:"include_usage,omitempty"`

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

type GetMemoryParamsArchived string

type GetMemoryRequestObject struct {
	Params GetMemoryParams
}

type GetMemoryResponseObject interface {
	VisitGetMemoryResponse(w http.ResponseWriter) error
}

type GetMemorydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type GetTransfer200JSONResponse OwnershipTransfer

type GetTransfer404JSONResponse struct{ NotFoundJSONResponse }

type GetTransferRequestObject struct {
	TransferId openapi_types.UUID `json:"transferId"`
}

type GetTransferResponseObject interface {
	VisitGetTransferResponse(w http.ResponseWriter) error
}

type GetTransferdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type IndexConversations200JSONResponse IndexConversationsResponse

type IndexConversations403JSONResponse struct{ ErrorJSONResponse }

type IndexConversations404JSONResponse struct{ NotFoundJSONResponse }

type IndexConversationsJSONBody = []IndexEntryRequest

type IndexConversationsJSONRequestBody = IndexConversationsJSONBody

type IndexConversationsRequestObject struct {
	Body *IndexConversationsJSONRequestBody
}

type IndexConversationsResponse struct {
	// Indexed Number of entries processed. These entries have their indexed content
	// stored and will be searchable. If vector store indexing failed for some
	// entries, they will become searchable asynchronously via background retry.
	Indexed *int `json:"indexed,omitempty"`
}

type IndexConversationsResponseObject interface {
	VisitIndexConversationsResponse(w http.ResponseWriter) error
}

type IndexConversationsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type IndexEntryRequest struct {
	// ConversationId The conversation containing the entry.
	ConversationId openapi_types.UUID `json:"conversationId"`

	// EntryId The entry ID to index.
	EntryId openapi_types.UUID `json:"entryId"`

	// IndexedContent The searchable text for this entry.
	IndexedContent string `json:"indexedContent"`
}

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

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

type ListConversationChildrenRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Params         ListConversationChildrenParams
}

type ListConversationChildrenResponseObject interface {
	VisitListConversationChildrenResponse(w http.ResponseWriter) error
}

type ListConversationChildrendefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type ListConversationEntries404JSONResponse struct{ NotFoundJSONResponse }

type ListConversationEntriesParams struct {
	// AfterCursor Cursor for pagination; returns entries after this entry id (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 caller-visible conversation order are
	// returned. This is useful with `channel=context` and `epoch` to
	// reconstruct the agent context as of a specific history entry.
	UpToEntryId *openapi_types.UUID `form:"upToEntryId,omitempty" json:"upToEntryId,omitempty"`
	Limit       *int                `form:"limit,omitempty" json:"limit,omitempty"`

	// Channel Channel of entries to return. Defaults to `history` for the
	// user-visible conversation; `context` returns agent-managed context entries
	// scoped to the calling client id.
	Channel *Channel `form:"channel,omitempty" json:"channel,omitempty"`

	// Epoch Optional epoch filter when listing the `context` channel. Valid values
	// are `latest`, `all`, or a numeric epoch identifier. Defaults to
	// `latest` when not provided. The epoch selection is scoped to the
	// calling client id.
	Epoch *string `form:"epoch,omitempty" json:"epoch,omitempty"`

	// Forks Controls which fork entries to include. `none` (default) follows the
	// fork ancestry path, returning entries from the target conversation
	// and its ancestors up to fork points. `all` returns entries from all
	// forks in the conversation group, useful for debugging or getting a
	// complete picture of all activity across forks.
	Forks *ListConversationEntriesParamsForks `form:"forks,omitempty" json:"forks,omitempty"`
}

type ListConversationEntriesParamsForks string

type ListConversationEntriesRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Params         ListConversationEntriesParams
}

type ListConversationEntriesResponseObject interface {
	VisitListConversationEntriesResponse(w http.ResponseWriter) error
}

type ListConversationEntriesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type ListConversationForks404JSONResponse struct{ NotFoundJSONResponse }

type ListConversationForksParams 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"`
}

type ListConversationForksRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Params         ListConversationForksParams
}

type ListConversationForksResponseObject interface {
	VisitListConversationForksResponse(w http.ResponseWriter) error
}

type ListConversationForksdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type ListConversationMemberships404JSONResponse struct{ NotFoundJSONResponse }

type ListConversationMembershipsParams 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"`
}

type ListConversationMembershipsRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Params         ListConversationMembershipsParams
}

type ListConversationMembershipsResponseObject interface {
	VisitListConversationMembershipsResponse(w http.ResponseWriter) error
}

type ListConversationMembershipsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type ListConversationsParams struct {
	// Mode Listing mode for conversations. Controls which conversations are returned
	// from each fork tree (conversation group).
	// - `all`: include all conversations the user can access (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 *ListConversationsParamsMode `form:"mode,omitempty" json:"mode,omitempty"`

	// Ancestry Started-conversation ancestry filter.
	// - `roots`: include only top-level conversations not started from another conversation.
	// - `children`: include only conversations started from another conversation.
	// - `all`: include both root and child conversations.
	Ancestry *ListConversationsParamsAncestry `form:"ancestry,omitempty" json:"ancestry,omitempty"`

	// 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 conversations to return.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Query Optional text query for basic title/metadata search.
	Query *string `form:"query,omitempty" json:"query,omitempty"`

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

type ListConversationsParamsAncestry string

type ListConversationsParamsArchived string

type ListConversationsParamsMode string

type ListConversationsRequestObject struct {
	Params ListConversationsParams
}

type ListConversationsResponseObject interface {
	VisitListConversationsResponse(w http.ResponseWriter) error
}

type ListConversationsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ListMemoryEvents200JSONResponse ListMemoryEventsResponse

type ListMemoryEventsParams struct {
	// Ns Namespace prefix segments. Repeat once per segment.
	Ns *[]string `form:"ns,omitempty" json:"ns,omitempty"`

	// Kinds Filter by event kind. Repeat to include multiple. Values: add, update, expired.
	Kinds *[]ListMemoryEventsParamsKinds `form:"kinds,omitempty" json:"kinds,omitempty"`

	// After Return events with occurred_at strictly after this ISO 8601 timestamp.
	After *time.Time `form:"after,omitempty" json:"after,omitempty"`

	// Before Return events with occurred_at strictly before this ISO 8601 timestamp.
	Before *time.Time `form:"before,omitempty" json:"before,omitempty"`

	// AfterCursor Opaque cursor from a previous response for pagination.
	AfterCursor *string `form:"after_cursor,omitempty" json:"after_cursor,omitempty"`
	Limit       *int    `form:"limit,omitempty" json:"limit,omitempty"`
}

type ListMemoryEventsParamsKinds string

type ListMemoryEventsRequestObject struct {
	Params ListMemoryEventsParams
}

type ListMemoryEventsResponse struct {
	AfterCursor *string            `json:"after_cursor,omitempty"`
	Events      *[]MemoryEventItem `json:"events,omitempty"`
}

type ListMemoryEventsResponseObject interface {
	VisitListMemoryEventsResponse(w http.ResponseWriter) error
}

type ListMemoryEventsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ListMemoryNamespaces200JSONResponse ListMemoryNamespacesResponse

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

	// Suffix Namespace suffix segments. Repeat once per segment.
	Suffix   *[]string `form:"suffix,omitempty" json:"suffix,omitempty"`
	MaxDepth *int      `form:"max_depth,omitempty" json:"max_depth,omitempty"`

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

type ListMemoryNamespacesParamsArchived string

type ListMemoryNamespacesRequestObject struct {
	Params ListMemoryNamespacesParams
}

type ListMemoryNamespacesResponse struct {
	Namespaces *[][]string `json:"namespaces,omitempty"`
}

type ListMemoryNamespacesResponseObject interface {
	VisitListMemoryNamespacesResponse(w http.ResponseWriter) error
}

type ListMemoryNamespacesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type ListPendingTransfersParams struct {
	// Role Filter by user's role in the transfer.
	Role *ListPendingTransfersParamsRole `form:"role,omitempty" json:"role,omitempty"`

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

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

type ListPendingTransfersParamsRole string

type ListPendingTransfersRequestObject struct {
	Params ListPendingTransfersParams
}

type ListPendingTransfersResponseObject interface {
	VisitListPendingTransfersResponse(w http.ResponseWriter) error
}

type ListPendingTransfersdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type ListUnindexedEntries200JSONResponse UnindexedEntriesResponse

type ListUnindexedEntries403JSONResponse struct{ ErrorJSONResponse }

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

	// AfterCursor Pagination cursor from previous response.
	AfterCursor *string `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`
}

type ListUnindexedEntriesRequestObject struct {
	Params ListUnindexedEntriesParams
}

type ListUnindexedEntriesResponseObject interface {
	VisitListUnindexedEntriesResponse(w http.ResponseWriter) error
}

type ListUnindexedEntriesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type MemoryEventItem struct {
	Attributes *map[string]interface{} `json:"attributes,omitempty"`
	ExpiresAt  *time.Time              `json:"expires_at,omitempty"`
	Id         *openapi_types.UUID     `json:"id,omitempty"`
	Key        *string                 `json:"key,omitempty"`
	Kind       *MemoryEventItemKind    `json:"kind,omitempty"`
	Namespace  *[]string               `json:"namespace,omitempty"`
	OccurredAt *time.Time              `json:"occurred_at,omitempty"`
	Value      *map[string]interface{} `json:"value,omitempty"`
}

type MemoryEventItemKind string

type MemoryItem struct {
	// Archived Synthetic archive flag derived from the internal archived timestamp.
	Archived   *bool                   `json:"archived,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"`
	Score      *float64                `json:"score,omitempty"`
	Usage      *MemoryUsage            `json:"usage,omitempty"`
	Value      *map[string]interface{} `json:"value,omitempty"`
}

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

type MemoryWriteResult struct {
	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"`
}

type MiddlewareFunc func(c *gin.Context)

type NotFound = ErrorResponse

type NotFoundJSONResponse ErrorResponse

type OwnershipTransfer struct {
	// ConversationId The conversation being transferred.
	ConversationId openapi_types.UUID `json:"conversationId"`

	// ConversationTitle Title of the conversation (for display purposes).
	ConversationTitle *string `json:"conversationTitle,omitempty"`

	// CreatedAt When the transfer was initiated.
	CreatedAt time.Time `json:"createdAt"`

	// FromUserId Current owner initiating the transfer.
	FromUserId string `json:"fromUserId"`

	// Id Unique identifier for the transfer.
	Id openapi_types.UUID `json:"id"`

	// ToUserId Proposed new owner (recipient).
	ToUserId string `json:"toUserId"`
}

type PutMemory200JSONResponse MemoryWriteResult

type PutMemoryJSONRequestBody = PutMemoryRequest

type PutMemoryRequest struct {
	Index      *map[string]string     `json:"index,omitempty"`
	Key        string                 `json:"key"`
	Namespace  []string               `json:"namespace"`
	TtlSeconds *int                   `json:"ttl_seconds,omitempty"`
	Value      map[string]interface{} `json:"value"`
}

type PutMemoryRequestObject struct {
	Body *PutMemoryJSONRequestBody
}

type PutMemoryResponseObject interface {
	VisitPutMemoryResponse(w http.ResponseWriter) error
}

type PutMemorydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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

type SearchConversations501JSONResponse struct {
	SearchTypeUnavailableJSONResponse
}

type SearchConversationsJSONRequestBody = SearchConversationsRequest

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

	// GroupByConversation When true (default), groups results by conversation and returns only
	// the highest-scoring entry per conversation. When false, returns all
	// matching entries ordered by score.
	GroupByConversation *bool `json:"groupByConversation,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"`

	// SearchType The search method(s) to use:
	// - `auto` (default): Try semantic (vector) search first, fall back to full-text if no results or unavailable
	// - `semantic`: Use only vector/embedding-based semantic search
	// - `fulltext`: Use only PostgreSQL full-text search with GIN index
	//
	// `searchType` may be provided as either a single string or an array of concrete types.
	// When an array is provided (for example `["semantic","fulltext"]`), each type executes
	// independently and `limit` is applied per type. The combined response may therefore contain
	// up to `limit * number_of_requested_types` entries.
	//
	// If the requested search type is not available on the server, a 501 (Not Implemented)
	// error is returned with details about which search types are available.
	SearchType *SearchConversationsRequest_SearchType `json:"searchType,omitempty"`
}

type SearchConversationsRequestObject struct {
	Body *SearchConversationsJSONRequestBody
}

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

type SearchConversationsResponseObject interface {
	VisitSearchConversationsResponse(w http.ResponseWriter) error
}

type SearchConversationsSearchTypeList = []string

type SearchConversationsSearchTypeSingle string

type SearchConversationsdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type SearchMemories200JSONResponse SearchMemoriesResponse

type SearchMemoriesJSONRequestBody = SearchMemoriesRequest

type SearchMemoriesRequest struct {
	Archived        *SearchMemoriesRequestArchived `json:"archived,omitempty"`
	Filter          *map[string]interface{}        `json:"filter,omitempty"`
	IncludeUsage    *bool                          `json:"include_usage,omitempty"`
	Limit           *int                           `json:"limit,omitempty"`
	NamespacePrefix []string                       `json:"namespace_prefix"`
	Query           *string                        `json:"query,omitempty"`
}

type SearchMemoriesRequestArchived string

type SearchMemoriesRequestObject struct {
	Body *SearchMemoriesJSONRequestBody
}

type SearchMemoriesResponse struct {
	Items *[]MemoryItem `json:"items,omitempty"`
}

type SearchMemoriesResponseObject interface {
	VisitSearchMemoriesResponse(w http.ResponseWriter) error
}

type SearchMemoriesdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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"`

	// Kind Identifies which search backend produced the score (e.g. `postgres`, `mongo`, `qdrant`, `pgvector`).
	Kind *SearchResultKind `json:"kind,omitempty"`

	// Score Relevance score. Higher is more relevant.
	Score *float32 `json:"score,omitempty"`
}

type SearchResultKind string

type SearchTypeUnavailable = SearchTypeUnavailableError

type SearchTypeUnavailableError struct {
	// AvailableTypes List of search types that are available on this server.
	AvailableTypes *[]string `json:"availableTypes,omitempty"`

	// Error Error code.
	Error *string `json:"error,omitempty"`

	// Message Human-readable error message.
	Message *string `json:"message,omitempty"`
}

type SearchTypeUnavailableJSONResponse SearchTypeUnavailableError

type ServerInterface interface {
	// Subscribe to all real-time events (admin SSE)
	// (GET /v1/admin/events)
	AdminSubscribeEvents(c *gin.Context, params AdminSubscribeEventsParams)
	// Upload or create an attachment
	// (POST /v1/attachments)
	UploadAttachment(c *gin.Context, params UploadAttachmentParams)
	// Download an attachment via signed token
	// (GET /v1/attachments/download/{token}/{filename})
	DownloadAttachmentByToken(c *gin.Context, token string, filename string)
	// Delete an unlinked attachment
	// (DELETE /v1/attachments/{id})
	DeleteAttachment(c *gin.Context, id openapi_types.UUID)
	// Retrieve an attachment
	// (GET /v1/attachments/{id})
	GetAttachment(c *gin.Context, id openapi_types.UUID)
	// Get a signed download URL for an attachment
	// (GET /v1/attachments/{id}/download-url)
	GetAttachmentDownloadUrl(c *gin.Context, id openapi_types.UUID)
	// Get server capabilities for the authenticated caller
	// (GET /v1/capabilities)
	GetCapabilities(c *gin.Context)
	// List conversations visible to current user
	// (GET /v1/conversations)
	ListConversations(c *gin.Context, params ListConversationsParams)
	// Create a conversation
	// (POST /v1/conversations)
	CreateConversation(c *gin.Context)
	// Index conversation entries
	// (POST /v1/conversations/index)
	IndexConversations(c *gin.Context)
	// Semantic search across conversations
	// (POST /v1/conversations/search)
	SearchConversations(c *gin.Context)
	// List entries needing indexing
	// (GET /v1/conversations/unindexed)
	ListUnindexedEntries(c *gin.Context, params ListUnindexedEntriesParams)
	// Get a conversation
	// (GET /v1/conversations/{conversationId})
	GetConversation(c *gin.Context, conversationId openapi_types.UUID)
	// Update a conversation
	// (PATCH /v1/conversations/{conversationId})
	UpdateConversation(c *gin.Context, conversationId openapi_types.UUID)
	// List direct child conversations
	// (GET /v1/conversations/{conversationId}/children)
	ListConversationChildren(c *gin.Context, conversationId openapi_types.UUID, params ListConversationChildrenParams)
	// List conversation entries
	// (GET /v1/conversations/{conversationId}/entries)
	ListConversationEntries(c *gin.Context, conversationId openapi_types.UUID, params ListConversationEntriesParams)
	// Append an entry
	// (POST /v1/conversations/{conversationId}/entries)
	AppendConversationEntry(c *gin.Context, conversationId openapi_types.UUID)
	// Synchronize the agent context epoch
	// (POST /v1/conversations/{conversationId}/entries/sync)
	SyncConversationContext(c *gin.Context, conversationId openapi_types.UUID)
	// List forks for a conversation
	// (GET /v1/conversations/{conversationId}/forks)
	ListConversationForks(c *gin.Context, conversationId openapi_types.UUID, params ListConversationForksParams)
	// List conversation memberships
	// (GET /v1/conversations/{conversationId}/memberships)
	ListConversationMemberships(c *gin.Context, conversationId openapi_types.UUID, params ListConversationMembershipsParams)
	// Share conversation with another user
	// (POST /v1/conversations/{conversationId}/memberships)
	ShareConversation(c *gin.Context, conversationId openapi_types.UUID)
	// Remove a member from the conversation
	// (DELETE /v1/conversations/{conversationId}/memberships/{userId})
	DeleteConversationMembership(c *gin.Context, conversationId openapi_types.UUID, userId string)
	// Update a member's access level
	// (PATCH /v1/conversations/{conversationId}/memberships/{userId})
	UpdateConversationMembership(c *gin.Context, conversationId openapi_types.UUID, userId string)
	// Cancel an in-progress response
	// (DELETE /v1/conversations/{conversationId}/response)
	DeleteConversationResponse(c *gin.Context, conversationId openapi_types.UUID)
	// Subscribe to real-time events (SSE)
	// (GET /v1/events)
	SubscribeEvents(c *gin.Context, params SubscribeEventsParams)
	// Get a memory item
	// (GET /v1/memories)
	GetMemory(c *gin.Context, params GetMemoryParams)
	// Update a memory item
	// (PATCH /v1/memories)
	UpdateMemory(c *gin.Context, params UpdateMemoryParams)
	// Upsert a memory item
	// (PUT /v1/memories)
	PutMemory(c *gin.Context)
	// List memory lifecycle events
	// (GET /v1/memories/events)
	ListMemoryEvents(c *gin.Context, params ListMemoryEventsParams)
	// List memory namespaces
	// (GET /v1/memories/namespaces)
	ListMemoryNamespaces(c *gin.Context, params ListMemoryNamespacesParams)
	// Search memory items
	// (POST /v1/memories/search)
	SearchMemories(c *gin.Context)
	// List pending ownership transfers
	// (GET /v1/ownership-transfers)
	ListPendingTransfers(c *gin.Context, params ListPendingTransfersParams)
	// Request ownership transfer
	// (POST /v1/ownership-transfers)
	CreateOwnershipTransfer(c *gin.Context)
	// Cancel or reject ownership transfer
	// (DELETE /v1/ownership-transfers/{transferId})
	DeleteTransfer(c *gin.Context, transferId openapi_types.UUID)
	// Get transfer details
	// (GET /v1/ownership-transfers/{transferId})
	GetTransfer(c *gin.Context, transferId openapi_types.UUID)
	// Accept ownership transfer
	// (POST /v1/ownership-transfers/{transferId}/accept)
	AcceptTransfer(c *gin.Context, transferId openapi_types.UUID)
}

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

type ShareConversation201JSONResponse ConversationMembership

type ShareConversation404JSONResponse struct{ NotFoundJSONResponse }

type ShareConversationJSONRequestBody = ShareConversationRequest

type ShareConversationRequest struct {
	// AccessLevel Access level of a user for a conversation.
	AccessLevel AccessLevel `json:"accessLevel"`
	CreatedAt   *time.Time  `json:"createdAt,omitempty"`
	UserId      string      `json:"userId"`
}

type ShareConversationRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Body           *ShareConversationJSONRequestBody
}

type ShareConversationResponseObject interface {
	VisitShareConversationResponse(w http.ResponseWriter) error
}

type ShareConversationdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

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 {
	// Subscribe to all real-time events (admin SSE)
	// (GET /v1/admin/events)
	AdminSubscribeEvents(ctx context.Context, request AdminSubscribeEventsRequestObject) (AdminSubscribeEventsResponseObject, error)
	// Upload or create an attachment
	// (POST /v1/attachments)
	UploadAttachment(ctx context.Context, request UploadAttachmentRequestObject) (UploadAttachmentResponseObject, error)
	// Download an attachment via signed token
	// (GET /v1/attachments/download/{token}/{filename})
	DownloadAttachmentByToken(ctx context.Context, request DownloadAttachmentByTokenRequestObject) (DownloadAttachmentByTokenResponseObject, error)
	// Delete an unlinked attachment
	// (DELETE /v1/attachments/{id})
	DeleteAttachment(ctx context.Context, request DeleteAttachmentRequestObject) (DeleteAttachmentResponseObject, error)
	// Retrieve an attachment
	// (GET /v1/attachments/{id})
	GetAttachment(ctx context.Context, request GetAttachmentRequestObject) (GetAttachmentResponseObject, error)
	// Get a signed download URL for an attachment
	// (GET /v1/attachments/{id}/download-url)
	GetAttachmentDownloadUrl(ctx context.Context, request GetAttachmentDownloadUrlRequestObject) (GetAttachmentDownloadUrlResponseObject, error)
	// Get server capabilities for the authenticated caller
	// (GET /v1/capabilities)
	GetCapabilities(ctx context.Context, request GetCapabilitiesRequestObject) (GetCapabilitiesResponseObject, error)
	// List conversations visible to current user
	// (GET /v1/conversations)
	ListConversations(ctx context.Context, request ListConversationsRequestObject) (ListConversationsResponseObject, error)
	// Create a conversation
	// (POST /v1/conversations)
	CreateConversation(ctx context.Context, request CreateConversationRequestObject) (CreateConversationResponseObject, error)
	// Index conversation entries
	// (POST /v1/conversations/index)
	IndexConversations(ctx context.Context, request IndexConversationsRequestObject) (IndexConversationsResponseObject, error)
	// Semantic search across conversations
	// (POST /v1/conversations/search)
	SearchConversations(ctx context.Context, request SearchConversationsRequestObject) (SearchConversationsResponseObject, error)
	// List entries needing indexing
	// (GET /v1/conversations/unindexed)
	ListUnindexedEntries(ctx context.Context, request ListUnindexedEntriesRequestObject) (ListUnindexedEntriesResponseObject, error)
	// Get a conversation
	// (GET /v1/conversations/{conversationId})
	GetConversation(ctx context.Context, request GetConversationRequestObject) (GetConversationResponseObject, error)
	// Update a conversation
	// (PATCH /v1/conversations/{conversationId})
	UpdateConversation(ctx context.Context, request UpdateConversationRequestObject) (UpdateConversationResponseObject, error)
	// List direct child conversations
	// (GET /v1/conversations/{conversationId}/children)
	ListConversationChildren(ctx context.Context, request ListConversationChildrenRequestObject) (ListConversationChildrenResponseObject, error)
	// List conversation entries
	// (GET /v1/conversations/{conversationId}/entries)
	ListConversationEntries(ctx context.Context, request ListConversationEntriesRequestObject) (ListConversationEntriesResponseObject, error)
	// Append an entry
	// (POST /v1/conversations/{conversationId}/entries)
	AppendConversationEntry(ctx context.Context, request AppendConversationEntryRequestObject) (AppendConversationEntryResponseObject, error)
	// Synchronize the agent context epoch
	// (POST /v1/conversations/{conversationId}/entries/sync)
	SyncConversationContext(ctx context.Context, request SyncConversationContextRequestObject) (SyncConversationContextResponseObject, error)
	// List forks for a conversation
	// (GET /v1/conversations/{conversationId}/forks)
	ListConversationForks(ctx context.Context, request ListConversationForksRequestObject) (ListConversationForksResponseObject, error)
	// List conversation memberships
	// (GET /v1/conversations/{conversationId}/memberships)
	ListConversationMemberships(ctx context.Context, request ListConversationMembershipsRequestObject) (ListConversationMembershipsResponseObject, error)
	// Share conversation with another user
	// (POST /v1/conversations/{conversationId}/memberships)
	ShareConversation(ctx context.Context, request ShareConversationRequestObject) (ShareConversationResponseObject, error)
	// Remove a member from the conversation
	// (DELETE /v1/conversations/{conversationId}/memberships/{userId})
	DeleteConversationMembership(ctx context.Context, request DeleteConversationMembershipRequestObject) (DeleteConversationMembershipResponseObject, error)
	// Update a member's access level
	// (PATCH /v1/conversations/{conversationId}/memberships/{userId})
	UpdateConversationMembership(ctx context.Context, request UpdateConversationMembershipRequestObject) (UpdateConversationMembershipResponseObject, error)
	// Cancel an in-progress response
	// (DELETE /v1/conversations/{conversationId}/response)
	DeleteConversationResponse(ctx context.Context, request DeleteConversationResponseRequestObject) (DeleteConversationResponseResponseObject, error)
	// Subscribe to real-time events (SSE)
	// (GET /v1/events)
	SubscribeEvents(ctx context.Context, request SubscribeEventsRequestObject) (SubscribeEventsResponseObject, error)
	// Get a memory item
	// (GET /v1/memories)
	GetMemory(ctx context.Context, request GetMemoryRequestObject) (GetMemoryResponseObject, error)
	// Update a memory item
	// (PATCH /v1/memories)
	UpdateMemory(ctx context.Context, request UpdateMemoryRequestObject) (UpdateMemoryResponseObject, error)
	// Upsert a memory item
	// (PUT /v1/memories)
	PutMemory(ctx context.Context, request PutMemoryRequestObject) (PutMemoryResponseObject, error)
	// List memory lifecycle events
	// (GET /v1/memories/events)
	ListMemoryEvents(ctx context.Context, request ListMemoryEventsRequestObject) (ListMemoryEventsResponseObject, error)
	// List memory namespaces
	// (GET /v1/memories/namespaces)
	ListMemoryNamespaces(ctx context.Context, request ListMemoryNamespacesRequestObject) (ListMemoryNamespacesResponseObject, error)
	// Search memory items
	// (POST /v1/memories/search)
	SearchMemories(ctx context.Context, request SearchMemoriesRequestObject) (SearchMemoriesResponseObject, error)
	// List pending ownership transfers
	// (GET /v1/ownership-transfers)
	ListPendingTransfers(ctx context.Context, request ListPendingTransfersRequestObject) (ListPendingTransfersResponseObject, error)
	// Request ownership transfer
	// (POST /v1/ownership-transfers)
	CreateOwnershipTransfer(ctx context.Context, request CreateOwnershipTransferRequestObject) (CreateOwnershipTransferResponseObject, error)
	// Cancel or reject ownership transfer
	// (DELETE /v1/ownership-transfers/{transferId})
	DeleteTransfer(ctx context.Context, request DeleteTransferRequestObject) (DeleteTransferResponseObject, error)
	// Get transfer details
	// (GET /v1/ownership-transfers/{transferId})
	GetTransfer(ctx context.Context, request GetTransferRequestObject) (GetTransferResponseObject, error)
	// Accept ownership transfer
	// (POST /v1/ownership-transfers/{transferId}/accept)
	AcceptTransfer(ctx context.Context, request AcceptTransferRequestObject) (AcceptTransferResponseObject, error)
}

type SubscribeEvents200TexteventStreamResponse struct {
	Body          io.Reader
	ContentLength int64
}

type SubscribeEvents401Response struct {
}

type SubscribeEvents429Response struct {
}

type SubscribeEventsParams struct {
	// Kinds Comma-separated event kinds to filter (conversation, entry, response, membership).
	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 *SubscribeEventsParamsDetail `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 SubscribeEventsParamsDetail string

type SubscribeEventsRequestObject struct {
	Params SubscribeEventsParams
}

type SubscribeEventsResponseObject interface {
	VisitSubscribeEventsResponse(w http.ResponseWriter) error
}

type SyncConversationContext200JSONResponse SyncEntryResponse

type SyncConversationContext404JSONResponse struct{ NotFoundJSONResponse }

type SyncConversationContextJSONRequestBody = CreateEntryRequest

type SyncConversationContextRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Body           *SyncConversationContextJSONRequestBody
}

type SyncConversationContextResponseObject interface {
	VisitSyncConversationContextResponse(w http.ResponseWriter) error
}

type SyncConversationContextdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type SyncEntryResponse struct {
	// Entry The entry that was appended during this sync, or null if no-op.
	Entry *Entry `json:"entry,omitempty"`

	// Epoch The epoch number that now reflects the stored context state.
	Epoch *int64 `json:"epoch,omitempty"`

	// EpochIncremented True when the provided list diverged and a new epoch was started.
	EpochIncremented *bool `json:"epochIncremented,omitempty"`

	// NoOp True when the request resulted in no stored changes.
	NoOp *bool `json:"noOp,omitempty"`
}

type UnindexedEntriesResponse struct {
	// AfterCursor Cursor for fetching next page. Null when no more results.
	AfterCursor *string           `json:"afterCursor,omitempty"`
	Data        *[]UnindexedEntry `json:"data,omitempty"`
}

type UnindexedEntry struct {
	ConversationId *openapi_types.UUID `json:"conversationId,omitempty"`
	Entry          *Entry              `json:"entry,omitempty"`
}

type UpdateConversation200JSONResponse Conversation

type UpdateConversation404JSONResponse struct{ NotFoundJSONResponse }

type UpdateConversationJSONRequestBody = UpdateConversationRequest

type UpdateConversationMembership200JSONResponse ConversationMembership

type UpdateConversationMembership404JSONResponse struct{ NotFoundJSONResponse }

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

type UpdateConversationMembershipJSONRequestBody UpdateConversationMembershipJSONBody

type UpdateConversationMembershipRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	UserId         string             `json:"userId"`
	Body           *UpdateConversationMembershipJSONRequestBody
}

type UpdateConversationMembershipResponseObject interface {
	VisitUpdateConversationMembershipResponse(w http.ResponseWriter) error
}

type UpdateConversationMembershipdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type UpdateConversationRequest struct {
	// Archived Set to `true` to archive the conversation and its fork tree.
	Archived *bool   `json:"archived,omitempty"`
	Title    *string `json:"title,omitempty"`
}

type UpdateConversationRequestObject struct {
	ConversationId openapi_types.UUID `json:"conversationId"`
	Body           *UpdateConversationJSONRequestBody
}

type UpdateConversationResponseObject interface {
	VisitUpdateConversationResponse(w http.ResponseWriter) error
}

type UpdateConversationdefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type UpdateMemory204Response struct {
}

type UpdateMemoryJSONRequestBody = UpdateMemoryRequest

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

type UpdateMemoryRequest struct {
	// Archived Set to `true` to archive the active memory item.
	Archived *bool `json:"archived,omitempty"`
}

type UpdateMemoryRequestObject struct {
	Params UpdateMemoryParams
	Body   *UpdateMemoryJSONRequestBody
}

type UpdateMemoryResponseObject interface {
	VisitUpdateMemoryResponse(w http.ResponseWriter) error
}

type UpdateMemorydefaultJSONResponse struct {
	Body       ErrorResponse
	StatusCode int
}

type UploadAttachment201JSONResponse AttachmentUploadResponse

type UploadAttachment400JSONResponse struct{ ErrorJSONResponse }

type UploadAttachment413JSONResponse ErrorResponse

type UploadAttachmentJSONRequestBody = CreateFromUrlRequest