apiclient

type AcceptTransferResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON403      *Error
	JSON404      *NotFound
	JSONDefault  *Error
}

type AccessLevel string

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 AdminSubscribeEventsResp struct {
	Body         []byte
	HTTPResponse *http.Response
}

type AppendConversationEntryJSONRequestBody = CreateEntryRequest

type AppendConversationEntryResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON201      *Entry
	JSON404      *NotFound
	JSON409      *Error
	JSONDefault  *Error
}

type Attachment struct {
	// AttachmentId ID of a previously uploaded attachment (from POST /v1/attachments).
	// When the entry is created, this is preserved as the stable server-stored
	// attachment reference.
	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 BadRequest = ErrorResponse

type CapabilitiesAuth struct {
	AdminJustificationRequired bool `json:"admin_justification_required"`
	ApiKeyEnabled              bool `json:"api_key_enabled"`
	OidcEnabled                bool `json:"oidc_enabled"`
	UserIdAssertionEnabled     bool `json:"user_id_assertion_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                 *string             `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 Client struct {
	// The endpoint of the server conforming to this interface, with scheme,
	// https://api.deepmap.com for example. This can contain a path relative
	// to the server, such as https://api.deepmap.com/dev-test, and all the
	// paths in the swagger spec will be appended to the server.
	Server string

	// Doer for performing requests, typically a *http.Client with any
	// customized settings, such as certificate chains.
	Client HttpRequestDoer

	// A list of callbacks for modifying requests which are generated before sending over
	// the network.
	RequestEditors []RequestEditorFn
}

type ClientInterface interface {
	// AdminSubscribeEvents request
	AdminSubscribeEvents(ctx context.Context, params *AdminSubscribeEventsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UploadAttachmentWithBody request with any body
	UploadAttachmentWithBody(ctx context.Context, params *UploadAttachmentParams, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	UploadAttachment(ctx context.Context, params *UploadAttachmentParams, body UploadAttachmentJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DownloadAttachmentByToken request
	DownloadAttachmentByToken(ctx context.Context, token string, filename string, params *DownloadAttachmentByTokenParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteAttachment request
	DeleteAttachment(ctx context.Context, id openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetAttachment request
	GetAttachment(ctx context.Context, id openapi_types.UUID, params *GetAttachmentParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetAttachmentDownloadUrl request
	GetAttachmentDownloadUrl(ctx context.Context, id openapi_types.UUID, params *GetAttachmentDownloadUrlParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetCapabilities request
	GetCapabilities(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListConversations request
	ListConversations(ctx context.Context, params *ListConversationsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// CreateConversationWithBody request with any body
	CreateConversationWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	CreateConversation(ctx context.Context, body CreateConversationJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// IndexConversationsWithBody request with any body
	IndexConversationsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	IndexConversations(ctx context.Context, body IndexConversationsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// SearchConversationsWithBody request with any body
	SearchConversationsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	SearchConversations(ctx context.Context, body SearchConversationsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListUnindexedEntries request
	ListUnindexedEntries(ctx context.Context, params *ListUnindexedEntriesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetConversation request
	GetConversation(ctx context.Context, conversationId string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateConversationWithBody request with any body
	UpdateConversationWithBody(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	UpdateConversation(ctx context.Context, conversationId string, body UpdateConversationJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListConversationChildren request
	ListConversationChildren(ctx context.Context, conversationId string, params *ListConversationChildrenParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListConversationEntries request
	ListConversationEntries(ctx context.Context, conversationId string, params *ListConversationEntriesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// AppendConversationEntryWithBody request with any body
	AppendConversationEntryWithBody(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	AppendConversationEntry(ctx context.Context, conversationId string, body AppendConversationEntryJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// SyncConversationContextWithBody request with any body
	SyncConversationContextWithBody(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	SyncConversationContext(ctx context.Context, conversationId string, body SyncConversationContextJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListConversationForks request
	ListConversationForks(ctx context.Context, conversationId string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListConversationMemberships request
	ListConversationMemberships(ctx context.Context, conversationId string, params *ListConversationMembershipsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ShareConversationWithBody request with any body
	ShareConversationWithBody(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ShareConversation(ctx context.Context, conversationId string, body ShareConversationJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteConversationMembership request
	DeleteConversationMembership(ctx context.Context, conversationId string, userId string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateConversationMembershipWithBody request with any body
	UpdateConversationMembershipWithBody(ctx context.Context, conversationId string, userId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	UpdateConversationMembership(ctx context.Context, conversationId string, userId string, body UpdateConversationMembershipJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteConversationResponse request
	DeleteConversationResponse(ctx context.Context, conversationId string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// SubscribeEvents request
	SubscribeEvents(ctx context.Context, params *SubscribeEventsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetMemory request
	GetMemory(ctx context.Context, params *GetMemoryParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateMemoryWithBody request with any body
	UpdateMemoryWithBody(ctx context.Context, params *UpdateMemoryParams, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	UpdateMemory(ctx context.Context, params *UpdateMemoryParams, body UpdateMemoryJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutMemoryWithBody request with any body
	PutMemoryWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	PutMemory(ctx context.Context, body PutMemoryJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListMemoryEvents request
	ListMemoryEvents(ctx context.Context, params *ListMemoryEventsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListMemoryNamespaces request
	ListMemoryNamespaces(ctx context.Context, params *ListMemoryNamespacesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// SearchMemoriesWithBody request with any body
	SearchMemoriesWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	SearchMemories(ctx context.Context, body SearchMemoriesJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListPendingTransfers request
	ListPendingTransfers(ctx context.Context, params *ListPendingTransfersParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// CreateOwnershipTransferWithBody request with any body
	CreateOwnershipTransferWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	CreateOwnershipTransfer(ctx context.Context, body CreateOwnershipTransferJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteTransfer request
	DeleteTransfer(ctx context.Context, transferId openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetTransfer request
	GetTransfer(ctx context.Context, transferId openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)

	// AcceptTransfer request
	AcceptTransfer(ctx context.Context, transferId openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)
}

type ClientOption func(*Client) error

type ClientWithResponses struct {
	ClientInterface
}

type ClientWithResponsesInterface interface {
	// AdminSubscribeEventsWithResponse request
	AdminSubscribeEventsWithResponse(ctx context.Context, params *AdminSubscribeEventsParams, reqEditors ...RequestEditorFn) (*AdminSubscribeEventsResp, error)

	// UploadAttachmentWithBodyWithResponse request with any body
	UploadAttachmentWithBodyWithResponse(ctx context.Context, params *UploadAttachmentParams, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UploadAttachmentResp, error)

	UploadAttachmentWithResponse(ctx context.Context, params *UploadAttachmentParams, body UploadAttachmentJSONRequestBody, reqEditors ...RequestEditorFn) (*UploadAttachmentResp, error)

	// DownloadAttachmentByTokenWithResponse request
	DownloadAttachmentByTokenWithResponse(ctx context.Context, token string, filename string, params *DownloadAttachmentByTokenParams, reqEditors ...RequestEditorFn) (*DownloadAttachmentByTokenResp, error)

	// DeleteAttachmentWithResponse request
	DeleteAttachmentWithResponse(ctx context.Context, id openapi_types.UUID, reqEditors ...RequestEditorFn) (*DeleteAttachmentResp, error)

	// GetAttachmentWithResponse request
	GetAttachmentWithResponse(ctx context.Context, id openapi_types.UUID, params *GetAttachmentParams, reqEditors ...RequestEditorFn) (*GetAttachmentResp, error)

	// GetAttachmentDownloadUrlWithResponse request
	GetAttachmentDownloadUrlWithResponse(ctx context.Context, id openapi_types.UUID, params *GetAttachmentDownloadUrlParams, reqEditors ...RequestEditorFn) (*GetAttachmentDownloadUrlResp, error)

	// GetCapabilitiesWithResponse request
	GetCapabilitiesWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetCapabilitiesResp, error)

	// ListConversationsWithResponse request
	ListConversationsWithResponse(ctx context.Context, params *ListConversationsParams, reqEditors ...RequestEditorFn) (*ListConversationsResp, error)

	// CreateConversationWithBodyWithResponse request with any body
	CreateConversationWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*CreateConversationResp, error)

	CreateConversationWithResponse(ctx context.Context, body CreateConversationJSONRequestBody, reqEditors ...RequestEditorFn) (*CreateConversationResp, error)

	// IndexConversationsWithBodyWithResponse request with any body
	IndexConversationsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*IndexConversationsResp, error)

	IndexConversationsWithResponse(ctx context.Context, body IndexConversationsJSONRequestBody, reqEditors ...RequestEditorFn) (*IndexConversationsResp, error)

	// SearchConversationsWithBodyWithResponse request with any body
	SearchConversationsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*SearchConversationsResp, error)

	SearchConversationsWithResponse(ctx context.Context, body SearchConversationsJSONRequestBody, reqEditors ...RequestEditorFn) (*SearchConversationsResp, error)

	// ListUnindexedEntriesWithResponse request
	ListUnindexedEntriesWithResponse(ctx context.Context, params *ListUnindexedEntriesParams, reqEditors ...RequestEditorFn) (*ListUnindexedEntriesResp, error)

	// GetConversationWithResponse request
	GetConversationWithResponse(ctx context.Context, conversationId string, reqEditors ...RequestEditorFn) (*GetConversationResp, error)

	// UpdateConversationWithBodyWithResponse request with any body
	UpdateConversationWithBodyWithResponse(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpdateConversationResp, error)

	UpdateConversationWithResponse(ctx context.Context, conversationId string, body UpdateConversationJSONRequestBody, reqEditors ...RequestEditorFn) (*UpdateConversationResp, error)

	// ListConversationChildrenWithResponse request
	ListConversationChildrenWithResponse(ctx context.Context, conversationId string, params *ListConversationChildrenParams, reqEditors ...RequestEditorFn) (*ListConversationChildrenResp, error)

	// ListConversationEntriesWithResponse request
	ListConversationEntriesWithResponse(ctx context.Context, conversationId string, params *ListConversationEntriesParams, reqEditors ...RequestEditorFn) (*ListConversationEntriesResp, error)

	// AppendConversationEntryWithBodyWithResponse request with any body
	AppendConversationEntryWithBodyWithResponse(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*AppendConversationEntryResp, error)

	AppendConversationEntryWithResponse(ctx context.Context, conversationId string, body AppendConversationEntryJSONRequestBody, reqEditors ...RequestEditorFn) (*AppendConversationEntryResp, error)

	// SyncConversationContextWithBodyWithResponse request with any body
	SyncConversationContextWithBodyWithResponse(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*SyncConversationContextResp, error)

	SyncConversationContextWithResponse(ctx context.Context, conversationId string, body SyncConversationContextJSONRequestBody, reqEditors ...RequestEditorFn) (*SyncConversationContextResp, error)

	// ListConversationForksWithResponse request
	ListConversationForksWithResponse(ctx context.Context, conversationId string, reqEditors ...RequestEditorFn) (*ListConversationForksResp, error)

	// ListConversationMembershipsWithResponse request
	ListConversationMembershipsWithResponse(ctx context.Context, conversationId string, params *ListConversationMembershipsParams, reqEditors ...RequestEditorFn) (*ListConversationMembershipsResp, error)

	// ShareConversationWithBodyWithResponse request with any body
	ShareConversationWithBodyWithResponse(ctx context.Context, conversationId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ShareConversationResp, error)

	ShareConversationWithResponse(ctx context.Context, conversationId string, body ShareConversationJSONRequestBody, reqEditors ...RequestEditorFn) (*ShareConversationResp, error)

	// DeleteConversationMembershipWithResponse request
	DeleteConversationMembershipWithResponse(ctx context.Context, conversationId string, userId string, reqEditors ...RequestEditorFn) (*DeleteConversationMembershipResp, error)

	// UpdateConversationMembershipWithBodyWithResponse request with any body
	UpdateConversationMembershipWithBodyWithResponse(ctx context.Context, conversationId string, userId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpdateConversationMembershipResp, error)

	UpdateConversationMembershipWithResponse(ctx context.Context, conversationId string, userId string, body UpdateConversationMembershipJSONRequestBody, reqEditors ...RequestEditorFn) (*UpdateConversationMembershipResp, error)

	// DeleteConversationResponseWithResponse request
	DeleteConversationResponseWithResponse(ctx context.Context, conversationId string, reqEditors ...RequestEditorFn) (*DeleteConversationResponseResp, error)

	// SubscribeEventsWithResponse request
	SubscribeEventsWithResponse(ctx context.Context, params *SubscribeEventsParams, reqEditors ...RequestEditorFn) (*SubscribeEventsResp, error)

	// GetMemoryWithResponse request
	GetMemoryWithResponse(ctx context.Context, params *GetMemoryParams, reqEditors ...RequestEditorFn) (*GetMemoryResp, error)

	// UpdateMemoryWithBodyWithResponse request with any body
	UpdateMemoryWithBodyWithResponse(ctx context.Context, params *UpdateMemoryParams, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpdateMemoryResp, error)

	UpdateMemoryWithResponse(ctx context.Context, params *UpdateMemoryParams, body UpdateMemoryJSONRequestBody, reqEditors ...RequestEditorFn) (*UpdateMemoryResp, error)

	// PutMemoryWithBodyWithResponse request with any body
	PutMemoryWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PutMemoryResp, error)

	PutMemoryWithResponse(ctx context.Context, body PutMemoryJSONRequestBody, reqEditors ...RequestEditorFn) (*PutMemoryResp, error)

	// ListMemoryEventsWithResponse request
	ListMemoryEventsWithResponse(ctx context.Context, params *ListMemoryEventsParams, reqEditors ...RequestEditorFn) (*ListMemoryEventsResp, error)

	// ListMemoryNamespacesWithResponse request
	ListMemoryNamespacesWithResponse(ctx context.Context, params *ListMemoryNamespacesParams, reqEditors ...RequestEditorFn) (*ListMemoryNamespacesResp, error)

	// SearchMemoriesWithBodyWithResponse request with any body
	SearchMemoriesWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*SearchMemoriesResp, error)

	SearchMemoriesWithResponse(ctx context.Context, body SearchMemoriesJSONRequestBody, reqEditors ...RequestEditorFn) (*SearchMemoriesResp, error)

	// ListPendingTransfersWithResponse request
	ListPendingTransfersWithResponse(ctx context.Context, params *ListPendingTransfersParams, reqEditors ...RequestEditorFn) (*ListPendingTransfersResp, error)

	// CreateOwnershipTransferWithBodyWithResponse request with any body
	CreateOwnershipTransferWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*CreateOwnershipTransferResp, error)

	CreateOwnershipTransferWithResponse(ctx context.Context, body CreateOwnershipTransferJSONRequestBody, reqEditors ...RequestEditorFn) (*CreateOwnershipTransferResp, error)

	// DeleteTransferWithResponse request
	DeleteTransferWithResponse(ctx context.Context, transferId openapi_types.UUID, reqEditors ...RequestEditorFn) (*DeleteTransferResp, error)

	// GetTransferWithResponse request
	GetTransferWithResponse(ctx context.Context, transferId openapi_types.UUID, reqEditors ...RequestEditorFn) (*GetTransferResp, error)

	// AcceptTransferWithResponse request
	AcceptTransferWithResponse(ctx context.Context, transferId openapi_types.UUID, reqEditors ...RequestEditorFn) (*AcceptTransferResp, error)
}

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 *string `json:"forkedAtConversationId,omitempty"`

	// ForkedAtEntryId First parent entry excluded by this fork. Valid fork anchors are history entries and journal entries visible to the same authenticated client; context entries cannot be fork anchors. 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                 *string `json:"id,omitempty"`
	LastMessagePreview *string `json:"lastMessagePreview,omitempty"`
	OwnerUserId        *string `json:"ownerUserId,omitempty"`

	// StartedByConversationId Parent conversation that started this child conversation.
	StartedByConversationId *string `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 ConversationForkNavigation struct {
	ConversationIds []string                `json:"conversationIds"`
	ForkPoints      []ConversationForkPoint `json:"forkPoints"`
}

type ConversationForkOption struct {
	ConversationId string    `json:"conversationId"`
	CreatedAt      time.Time `json:"createdAt"`

	// EntryId Equivalent display entry for this continuation; null for an empty fork.
	EntryId *openapi_types.UUID `json:"entryId,omitempty"`
	Preview *string             `json:"preview,omitempty"`
	Title   string              `json:"title"`
}

type ConversationForkPoint struct {
	// EntryId Visible entry in the requested conversation where the fork selector is rendered.
	EntryId openapi_types.UUID       `json:"entryId"`
	Options []ConversationForkOption `json:"options"`
}

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

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

	// ForkedAtEntryId First parent entry excluded by this fork. Valid fork anchors are history entries and journal entries visible to the same authenticated client; context entries cannot be fork anchors. 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 *string    `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                      *string             `json:"id,omitempty"`
	LastMessagePreview      *string             `json:"lastMessagePreview,omitempty"`
	OwnerUserId             *string             `json:"ownerUserId,omitempty"`
	StartedByConversationId *string             `json:"startedByConversationId,omitempty"`
	StartedByEntryId        *openapi_types.UUID `json:"startedByEntryId,omitempty"`
	Title                   *string             `json:"title,omitempty"`
	UpdatedAt               *time.Time          `json:"updatedAt,omitempty"`
}

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 conversation ID. 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       *string                 `json:"id,omitempty"`
	Metadata *map[string]interface{} `json:"metadata,omitempty"`
	Title    *string                 `json:"title,omitempty"`
}

type CreateConversationResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON201      *Conversation
	JSONDefault  *Error
}

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 *string `json:"forkedAtConversationId,omitempty"`

	// ForkedAtEntryId Entry ID marking the fork point. Entries before this point are inherited; entries at and after this point are excluded. Valid fork anchors are history entries and journal entries visible to the same authenticated client; context entries cannot be fork anchors. 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"`

	// Seq Optional client-assigned sequence number. Must be unique within the
	// conversation. Must be >= 0. Returns 409 Conflict if a duplicate seq is
	// submitted. Returns 400 Bad Request if the value is negative or exceeds
	// 4294967295.
	Seq *int `json:"seq,omitempty"`

	// StartedByConversationId If the target conversation does not exist yet, auto-create it as a child conversation started from this parent conversation.
	StartedByConversationId *string `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 CreateOwnershipTransferJSONRequestBody = CreateOwnershipTransferRequest

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

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

type CreateOwnershipTransferResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON201      *OwnershipTransfer
	JSON400      *Error
	JSON403      *Error
	JSON404      *NotFound
	JSON409      *struct {
		Code string `json:"code"`

		// Details Structured non-sensitive error details.
		Details *map[string]interface{} `json:"details,omitempty"`
		Error   string                  `json:"error"`

		// RequestId Request correlation identifier, also returned in the X-Request-ID header.
		RequestId string `json:"requestId"`
	}
	JSONDefault *Error
}

type DeleteAttachmentResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON403      *Error
	JSON404      *NotFound
	JSON409      *Error
	JSONDefault  *Error
}

type DeleteConversationMembershipResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON404      *NotFound
	JSONDefault  *Error
}

type DeleteConversationResponseResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON404      *NotFound
	JSON409      *Error
	JSONDefault  *Error
}

type DeleteTransferResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON403      *Error
	JSON404      *NotFound
	JSONDefault  *Error
}

type DownloadAttachmentByTokenParams struct {
	// Disposition Controls the Content-Disposition header. Use `inline` to display the attachment
	// in the browser (e.g., images, PDFs), or `attachment` to force download.
	// If not specified, the Content-Disposition header is not set, allowing the browser
	// to use its default behavior based on content type.
	Disposition *DownloadAttachmentByTokenParamsDisposition `form:"disposition,omitempty" json:"disposition,omitempty"`
}

type DownloadAttachmentByTokenParamsDisposition string

type DownloadAttachmentByTokenResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON404      *NotFound
	JSONDefault  *Error
}

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

	// Seq Optional client-assigned sequence number, unique within the conversation.
	// Default listing uses seq only as a createdAt tie-breaker, with entries
	// without seq sorted before sequenced entries at the same timestamp. Gaps
	// are permitted.
	Seq *int `json:"seq,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 Error = ErrorResponse

type ErrorResponse struct {
	// Code Stable machine-readable error code.
	Code string `json:"code"`

	// Details Structured non-sensitive error details.
	Details *map[string]interface{} `json:"details,omitempty"`

	// Error Safe human-readable error message.
	Error string `json:"error"`

	// RequestId Request correlation identifier, also returned in the X-Request-ID header.
	RequestId string `json:"requestId"`
}

type GetAttachmentDownloadUrlParams struct {
	// Disposition Controls the Content-Disposition header on the returned download URL.
	// Use `inline` to display the attachment in the browser (e.g., images, PDFs),
	// or `attachment` to force download. If not specified, the
	// Content-Disposition header is not set, allowing the browser to use its
	// default behavior based on content type.
	Disposition *GetAttachmentDownloadUrlParamsDisposition `form:"disposition,omitempty" json:"disposition,omitempty"`
}

type GetAttachmentDownloadUrlParamsDisposition string

type GetAttachmentDownloadUrlResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *AttachmentDownloadUrlResponse
	JSON403      *Error
	JSON404      *NotFound
	JSONDefault  *Error
}

type GetAttachmentParams struct {
	// Disposition Controls the Content-Disposition header. Use `inline` to display the attachment
	// in the browser (e.g., images, PDFs), or `attachment` to force download.
	// If not specified, the Content-Disposition header is not set, allowing the browser
	// to use its default behavior based on content type.
	Disposition *GetAttachmentParamsDisposition `form:"disposition,omitempty" json:"disposition,omitempty"`
}

type GetAttachmentParamsDisposition string

type GetAttachmentResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON403      *Error
	JSON404      *NotFound
	JSONDefault  *Error
}

type GetCapabilitiesResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *CapabilitiesResponse
	JSONDefault  *Error
}

type GetConversationResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *Conversation
	JSON404      *NotFound
	JSONDefault  *Error
}

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 GetMemoryResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *MemoryItem
	JSON404      *NotFound
	JSONDefault  *Error
}

type GetTransferResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *OwnershipTransfer
	JSON404      *NotFound
	JSONDefault  *Error
}

type HttpRequestDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type IndexConversationsJSONBody = []IndexEntryRequest

type IndexConversationsJSONRequestBody = IndexConversationsJSONBody

type IndexConversationsResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *IndexConversationsResponse
	JSON403      *Error
	JSON404      *NotFound
	JSONDefault  *Error
}

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 IndexEntryRequest struct {
	// ConversationId The conversation containing the entry.
	ConversationId string `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 ListConversationChildrenParams struct {
	AfterCursor *string `form:"afterCursor,omitempty" json:"afterCursor,omitempty"`
	Limit       *int    `form:"limit,omitempty" json:"limit,omitempty"`
}

type ListConversationChildrenResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *struct {
		AfterCursor *string                     `json:"afterCursor,omitempty"`
		Data        *[]ChildConversationSummary `json:"data,omitempty"`
	}
	JSONDefault *Error
}

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

	// BeforeCursor Cursor for backward pagination; returns up to `limit` entries strictly
	// before this entry in the caller-visible order. Results remain chronological
	// (ascending). Mutually exclusive with `afterCursor` and `tail=true`.
	BeforeCursor *openapi_types.UUID `form:"beforeCursor,omitempty" json:"beforeCursor,omitempty"`

	// Tail When `true`, returns the last `limit` entries in the caller-visible order
	// (newest page). Results remain chronological (ascending). Mutually exclusive
	// with `afterCursor` and `beforeCursor`.
	Tail *bool `form:"tail,omitempty" json:"tail,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"`

	// FromSeq When set, return only entries with `seq >= fromSeq`, ordered by `seq` ASC.
	// Entries without a `seq` are excluded. When omitted the default
	// ordering is `createdAt` ASC, `seq` ASC NULLS FIRST, then `id` ASC.
	FromSeq *int64 `form:"fromSeq,omitempty" json:"fromSeq,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 ListConversationEntriesResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *struct {
		// AfterCursor Pass as afterCursor to fetch the adjacent newer page. Null when no newer entries exist.
		AfterCursor *openapi_types.UUID `json:"afterCursor,omitempty"`

		// BeforeCursor Pass as beforeCursor to fetch the adjacent older page. Null when no older entries exist.
		BeforeCursor *openapi_types.UUID `json:"beforeCursor,omitempty"`
		Data         *[]Entry            `json:"data,omitempty"`
	}
	JSON400     *BadRequest
	JSON404     *NotFound
	JSONDefault *Error
}

type ListConversationForksResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *ConversationForkNavigation
	JSON404      *NotFound
	JSONDefault  *Error
}

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 ListConversationMembershipsResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *struct {
		AfterCursor *string                   `json:"afterCursor,omitempty"`
		Data        *[]ConversationMembership `json:"data,omitempty"`
	}
	JSON404     *NotFound
	JSONDefault *Error
}

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.
	AfterCursor *string `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 ListConversationsResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *struct {
		AfterCursor *string                `json:"afterCursor,omitempty"`
		Data        *[]ConversationSummary `json:"data,omitempty"`
	}
	JSONDefault *Error
}

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 ListMemoryEventsResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *ListMemoryEventsResponse
	JSONDefault  *Error
}

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

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 ListMemoryNamespacesResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *ListMemoryNamespacesResponse
	JSONDefault  *Error
}

type ListMemoryNamespacesResponse struct {
	Namespaces *[][]string `json:"namespaces,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 ListPendingTransfersResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *struct {
		AfterCursor *string              `json:"afterCursor,omitempty"`
		Data        *[]OwnershipTransfer `json:"data,omitempty"`
	}
	JSONDefault *Error
}

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 ListUnindexedEntriesResp struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *UnindexedEntriesResponse
	JSON403      *Error
	JSONDefault  *Error
}

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

	// MatchedQueries Attribution — purposes (or texts) of all queries that matched this item. Present only in multi-query responses.
	MatchedQueries *[]string               `json:"matchedQueries,omitempty"`
	Namespace      *[]string               `json:"namespace,omitempty"`
	Score          *float64                `json:"score,omitempty"`
	Usage          *MemoryUsage            `json:"usage,omitempty"`
	Value          *map[string]interface{} `json:"value,omitempty"`
}