api

type BrowseMemories200JSONResponse MemoryPage

type BrowseMemories400JSONResponse Error

type BrowseMemoriesParams struct {
	Limit  *Limit  `form:"limit,omitempty" json:"limit,omitempty"`
	Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type BrowseMemoriesRequestObject struct {
	Params BrowseMemoriesParams
}

type BrowseMemoriesResponseObject interface {
	VisitBrowseMemoriesResponse(w http.ResponseWriter) error
}

type CostEstimate struct {
	AmountUsd   float64 `json:"amount_usd"`
	Basis       string  `json:"basis"`
	PricingDate *string `json:"pricing_date,omitempty"`
	PricingUrl  *string `json:"pricing_url,omitempty"`
}

type Cursor = string

type DeleteMemory204Response struct {
}

type DeleteMemory404JSONResponse Error

type DeleteMemoryRequestObject struct {
	MemoryId MemoryId `json:"memoryId"`
}

type DeleteMemoryResponseObject interface {
	VisitDeleteMemoryResponse(w http.ResponseWriter) error
}

type DerivedContent struct {
	BlobHash string `json:"blob_hash"`
	ByteSize int64  `json:"byte_size"`

	// Content Literal UTF-8 text content.
	Content     string             `json:"content"`
	ContentType string             `json:"content_type"`
	Id          openapi_types.UUID `json:"id"`

	// Provenance Optional opaque plugin-defined JSON metadata.
	Provenance interface{} `json:"provenance,omitempty"`

	// Scope Optional opaque plugin-defined JSON metadata.
	Scope interface{} `json:"scope,omitempty"`
}

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

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

	// ExistingMemory Present on a duplicate import conflict so clients can recover.
	ExistingMemory *DuplicateMemory `json:"existing_memory,omitempty"`
	Message        string           `json:"message"`
}

type GetLiveness200JSONResponse HealthResponse

type GetLivenessRequestObject struct {
}

type GetLivenessResponseObject interface {
	VisitGetLivenessResponse(w http.ResponseWriter) error
}

type GetMemory200JSONResponse MemoryDetail

type GetMemory404JSONResponse Error

type GetMemoryContent200AsteriskResponse struct {
	Body          io.Reader
	Headers       GetMemoryContent200ResponseHeaders
	ContentType   string
	ContentLength int64
}

type GetMemoryContent200ResponseHeaders struct {
	ContentDisposition *string
	ETag               *string
}

type GetMemoryContent404JSONResponse Error

type GetMemoryContent500JSONResponse Error

type GetMemoryContent507JSONResponse Error

type GetMemoryContentRequestObject struct {
	MemoryId MemoryId `json:"memoryId"`
}

type GetMemoryContentResponseObject interface {
	VisitGetMemoryContentResponse(w http.ResponseWriter) error
}

type GetMemoryRequestObject struct {
	MemoryId MemoryId `json:"memoryId"`
}

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

type GetReadiness200JSONResponse HealthResponse

type GetReadinessRequestObject struct {
}

type GetReadinessResponseObject interface {
	VisitGetReadinessResponse(w http.ResponseWriter) error
}

type GetRebuildStatus200JSONResponse struct {
	Body    RebuildStatus
	Headers GetRebuildStatus200ResponseHeaders
}

type GetRebuildStatus200ResponseHeaders struct {
	CacheControl *string
}

type GetRebuildStatus404JSONResponse struct {
	Body    Error
	Headers GetRebuildStatus404ResponseHeaders
}

type GetRebuildStatus404ResponseHeaders struct {
	CacheControl *string
}

type GetRebuildStatusRequestObject struct {
	RebuildId openapi_types.UUID `json:"rebuildId"`
}

type GetRebuildStatusResponseObject interface {
	VisitGetRebuildStatusResponse(w http.ResponseWriter) error
}

type HealthResponse struct {
	Status  HealthResponseStatus `json:"status"`
	Version *string              `json:"version,omitempty"`
}

type HealthResponseStatus string

type ImportContext struct {
	FilesystemCreatedAt  *time.Time `json:"filesystem_created_at,omitempty"`
	FilesystemModifiedAt *time.Time `json:"filesystem_modified_at,omitempty"`
	FullPath             *string    `json:"full_path,omitempty"`
	OriginalFilename     string     `json:"original_filename"`
	RelativePath         *string    `json:"relative_path,omitempty"`
}

type ImportContextInput struct {
	FilesystemCreatedAt  *time.Time `json:"filesystem_created_at,omitempty"`
	FilesystemModifiedAt *time.Time `json:"filesystem_modified_at,omitempty"`
	FullPath             *string    `json:"full_path,omitempty"`
	RelativePath         *string    `json:"relative_path,omitempty"`
}

type ImportMemory201JSONResponse MemorySummary

type ImportMemory400JSONResponse Error

type ImportMemory409JSONResponse Error

type ImportMemory413JSONResponse Error

type ImportMemory500JSONResponse Error

type ImportMemoryMultipartRequestBody = ImportMultipart

type ImportMemoryRequestObject struct {
	Body *multipart.Reader
}

type ImportMemoryResponseObject interface {
	VisitImportMemoryResponse(w http.ResponseWriter) error
}

type ImportMultipart struct {
	// File One Blob of at most 100 MiB with a nonblank filename in
	// Content-Disposition. The server detects its Media Type from content
	// first and may fall back to a valid, specific part Content-Type.
	File openapi_types.File `json:"file"`

	// ImportContext Optional client-observed provenance sent as one application/json
	// multipart part. The original filename comes from the Blob part. Omitted
	// values remain unknown; malformed timestamps reject the import.
	ImportContext *ImportContextInput `json:"import_context,omitempty"`
}

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type Limit = int32

type MemoryDetail struct {
	// ContentUrl Relative URL of the content download endpoint.
	ContentUrl *string `json:"content_url,omitempty"`

	// ImportContext Stored provenance from the first successful import.
	ImportContext ImportContext        `json:"import_context"`
	Memory        MemorySummary        `json:"memory"`
	Understanding UnderstandingDetails `json:"understanding"`
}

type MemoryId = openapi_types.UUID

type MemoryPage struct {
	Items      []MemorySummary `json:"items"`
	NextCursor *string         `json:"next_cursor,omitempty"`
}

type MemorySummary struct {
	// BlobHash Canonical SHA-256 Blobref of the immutable Blob.
	BlobHash           string             `json:"blob_hash"`
	ByteSize           int64              `json:"byte_size"`
	Id                 openapi_types.UUID `json:"id"`
	ImportedAt         time.Time          `json:"imported_at"`
	MediaType          string             `json:"media_type"`
	OriginalCreatedAt  *time.Time         `json:"original_created_at,omitempty"`
	OriginalFilename   string             `json:"original_filename"`
	OriginalModifiedAt *time.Time         `json:"original_modified_at,omitempty"`
}

type MiddlewareFunc func(http.Handler) http.Handler

type RebuildMemory202JSONResponse struct {
	Body    RebuildStatus
	Headers RebuildMemory202ResponseHeaders
}

type RebuildMemory202ResponseHeaders struct {
	CacheControl *string
}

type RebuildMemory400TextResponse string

type RebuildMemory404JSONResponse Error

type RebuildMemory409JSONResponse struct {
	Body    RebuildStatus
	Headers RebuildMemory409ResponseHeaders
}

type RebuildMemory409ResponseHeaders struct {
	CacheControl *string
}

type RebuildMemory503JSONResponse Error

type RebuildMemoryJSONRequestBody = RebuildRequest

type RebuildMemoryRequestObject struct {
	MemoryId MemoryId `json:"memoryId"`
	Body     *RebuildMemoryJSONRequestBody
}

type RebuildMemoryResponseObject interface {
	VisitRebuildMemoryResponse(w http.ResponseWriter) error
}

type RebuildRequest struct {
	// UserNote Optional owner guidance; null reuses the saved note, empty string clears it.
	UserNote *string `json:"user_note,omitempty"`
}

type RebuildStatus struct {
	Attempt   UnderstandingAttempt `json:"attempt"`
	MemoryId  openapi_types.UUID   `json:"memory_id"`
	StatusUrl string               `json:"status_url"`
}

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type SearchExcerptPart struct {
	Match bool   `json:"match"`
	Text  string `json:"text"`
}

type SearchHit struct {
	Excerpt []SearchExcerptPart `json:"excerpt"`

	// MatchTier 0 for complete whole-word/stem matches; 1 for fragment-dependent matches. Lower tiers sort first.
	MatchTier int           `json:"match_tier"`
	Memory    MemorySummary `json:"memory"`

	// Score SQLite BM25 from the word index for tier 0 and trigram index for tier 1. When no indexed fragments match, tier 1 falls back to word-index BM25 or 0. Lower scores sort first within each match tier; ties sort by Memory ID. Scores from different indexes are not comparable across tiers.
	Score float64 `json:"score"`
}

type SearchLimit = int64

type SearchMemories200JSONResponse struct {
	Body    SearchPage
	Headers SearchMemories200ResponseHeaders
}

type SearchMemories200ResponseHeaders struct {
	CacheControl *string
}

type SearchMemories400JSONResponse struct {
	Body    Error
	Headers SearchMemories400ResponseHeaders
}

type SearchMemories400ResponseHeaders struct {
	CacheControl *string
}

type SearchMemoriesParams struct {
	Query  SearchQuery  `form:"query" json:"query"`
	Limit  *SearchLimit `form:"limit,omitempty" json:"limit,omitempty"`
	Cursor *Cursor      `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type SearchMemoriesRequestObject struct {
	Params SearchMemoriesParams
}

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

type SearchPage struct {
	Items      []SearchHit     `json:"items"`
	NextCursor *string         `json:"next_cursor,omitempty"`
	QueryPlan  SearchQueryPlan `json:"query_plan"`
	Total      int64           `json:"total"`
}

type SearchQuery = string

type SearchQueryPlan struct {
	Query string   `json:"query"`
	Terms []string `json:"terms"`
}

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

type ServerInterface interface {
	// GetLiveness Check whether the process is alive
	// (GET /livez)
	GetLiveness(w http.ResponseWriter, r *http.Request)
	// BrowseMemories Browse committed Memories
	// (GET /memories)
	BrowseMemories(w http.ResponseWriter, r *http.Request, params BrowseMemoriesParams)
	// ImportMemory Durably import one Blob as a Memory
	// (POST /memories/import)
	ImportMemory(w http.ResponseWriter, r *http.Request)
	// SearchMemories Search committed Memories
	// (GET /memories/search)
	SearchMemories(w http.ResponseWriter, r *http.Request, params SearchMemoriesParams)
	// DeleteMemory Delete one Memory and its Blob
	// (DELETE /memories/{memoryId})
	DeleteMemory(w http.ResponseWriter, r *http.Request, memoryId MemoryId)
	// GetMemory Get committed Memory details
	// (GET /memories/{memoryId})
	GetMemory(w http.ResponseWriter, r *http.Request, memoryId MemoryId)
	// GetMemoryContent Download and verify a Memory's immutable Blob
	// (GET /memories/{memoryId}/content)
	GetMemoryContent(w http.ResponseWriter, r *http.Request, memoryId MemoryId)
	// RebuildMemory Request a Memory Rebuild
	// (POST /memories/{memoryId}/rebuild)
	RebuildMemory(w http.ResponseWriter, r *http.Request, memoryId MemoryId)
	// GetReadiness Check whether the server can accept requests
	// (GET /readyz)
	GetReadiness(w http.ResponseWriter, r *http.Request)
	// GetRebuildStatus Poll a retained process-local Rebuild
	// (GET /rebuild-status/{rebuildId})
	GetRebuildStatus(w http.ResponseWriter, r *http.Request, rebuildId openapi_types.UUID)
}

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

type Statistics struct {
	Usage *TokenUsage `json:"usage,omitempty"`
}

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

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

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

type StrictMiddlewareFunc func(f StrictHandlerFunc, operationID string) StrictHandlerFunc

type StrictServerInterface interface {
	// GetLiveness Check whether the process is alive
	// (GET /livez)
	GetLiveness(ctx context.Context, request GetLivenessRequestObject) (GetLivenessResponseObject, error)
	// BrowseMemories Browse committed Memories
	// (GET /memories)
	BrowseMemories(ctx context.Context, request BrowseMemoriesRequestObject) (BrowseMemoriesResponseObject, error)
	// ImportMemory Durably import one Blob as a Memory
	// (POST /memories/import)
	ImportMemory(ctx context.Context, request ImportMemoryRequestObject) (ImportMemoryResponseObject, error)
	// SearchMemories Search committed Memories
	// (GET /memories/search)
	SearchMemories(ctx context.Context, request SearchMemoriesRequestObject) (SearchMemoriesResponseObject, error)
	// DeleteMemory Delete one Memory and its Blob
	// (DELETE /memories/{memoryId})
	DeleteMemory(ctx context.Context, request DeleteMemoryRequestObject) (DeleteMemoryResponseObject, error)
	// GetMemory Get committed Memory details
	// (GET /memories/{memoryId})
	GetMemory(ctx context.Context, request GetMemoryRequestObject) (GetMemoryResponseObject, error)
	// GetMemoryContent Download and verify a Memory's immutable Blob
	// (GET /memories/{memoryId}/content)
	GetMemoryContent(ctx context.Context, request GetMemoryContentRequestObject) (GetMemoryContentResponseObject, error)
	// RebuildMemory Request a Memory Rebuild
	// (POST /memories/{memoryId}/rebuild)
	RebuildMemory(ctx context.Context, request RebuildMemoryRequestObject) (RebuildMemoryResponseObject, error)
	// GetReadiness Check whether the server can accept requests
	// (GET /readyz)
	GetReadiness(ctx context.Context, request GetReadinessRequestObject) (GetReadinessResponseObject, error)
	// GetRebuildStatus Poll a retained process-local Rebuild
	// (GET /rebuild-status/{rebuildId})
	GetRebuildStatus(ctx context.Context, request GetRebuildStatusRequestObject) (GetRebuildStatusResponseObject, error)
}

type TokenUsage struct {
	CacheWriteInputTokens *int64 `json:"cache_write_input_tokens,omitempty"`
	CachedInputTokens     *int64 `json:"cached_input_tokens,omitempty"`
	InputTokens           *int64 `json:"input_tokens,omitempty"`
	OutputTokens          *int64 `json:"output_tokens,omitempty"`
	ReasoningOutputTokens *int64 `json:"reasoning_output_tokens,omitempty"`
	TotalTokens           *int64 `json:"total_tokens,omitempty"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnderstandingAttempt struct {
	CompletedAt *time.Time                `json:"completed_at,omitempty"`
	Diagnostics *UnderstandingDiagnostics `json:"diagnostics,omitempty"`
	Id          openapi_types.UUID        `json:"id"`

	// PluginId Configured plugin ID; empty when no plugin is selected.
	PluginId  string                    `json:"plugin_id"`
	QueuedAt  time.Time                 `json:"queued_at"`
	StartedAt *time.Time                `json:"started_at,omitempty"`
	Status    UnderstandingAttemptState `json:"status"`
}

type UnderstandingAttemptState string

type UnderstandingDetails struct {
	// ActiveRun The last complete successful Run; failed attempts do not replace it.
	ActiveRun     *UnderstandingRun          `json:"active_run"`
	LatestAttempt *UnderstandingAttempt      `json:"latest_attempt"`
	Status        UnderstandingDetailsStatus `json:"status"`

	// StatusUrl Process-local polling URL; absent for durable history after restart.
	StatusUrl *string `json:"status_url,omitempty"`

	// UserNote Latest saved owner guidance for this Memory; empty when absent or cleared.
	UserNote string `json:"user_note"`
}

type UnderstandingDetailsStatus string

type UnderstandingDiagnostics struct {
	Error    string `json:"error"`
	ExitCode *int   `json:"exit_code,omitempty"`

	// Stderr Captured plugin diagnostics; may contain private source content.
	Stderr string `json:"stderr"`

	// Stdout Captured plugin stdout, including invalid protocol output.
	Stdout string `json:"stdout"`
}

type UnderstandingRun struct {
	Artifacts   []DerivedContent   `json:"artifacts"`
	AttemptId   openapi_types.UUID `json:"attempt_id"`
	CompletedAt time.Time          `json:"completed_at"`

	// CostEstimate Optional API-equivalent estimate, not subscription charges.
	CostEstimate  *CostEstimate      `json:"cost_estimate,omitempty"`
	CreatedAt     time.Time          `json:"created_at"`
	Id            openapi_types.UUID `json:"id"`
	PluginId      string             `json:"plugin_id"`
	PluginVersion string             `json:"plugin_version"`
	SourceBlobref string             `json:"source_blobref"`

	// Statistics Optional plugin-reported Run totals.
	Statistics *Statistics `json:"statistics,omitempty"`

	// UserNote Owner guidance captured by this successful Run; empty when absent.
	UserNote string   `json:"user_note"`
	Warnings []string `json:"warnings"`
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}