client

type APIError struct {
	// StatusCode is the HTTP status code returned by the server.
	StatusCode int
	// Code is the machine-readable error code from the API response body (e.g. "not_found").
	Code string
	// Message is the human-readable error message.
	Message string
	// RequestID is the value of the X-Request-ID response header, if present.
	// Include this in bug reports and support tickets.
	RequestID string
	// Body is the raw response body, preserved for debugging.
	Body string
}

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

type CreateTenantRequest struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type CreateTenantResponse struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	CreatedAt time.Time `json:"created_at"`
}

type HealthResponse struct {
	Status string `json:"status"`
	Time   string `json:"time"`
}

type IngestMemoryResponse struct {
	IngestID   string    `json:"ingest_id"`
	MemoryIDs  []string  `json:"memory_ids"`
	JobIDs     []string  `json:"job_ids"`
	AcceptedAt time.Time `json:"accepted_at"`
}

type ListPostprocessJobsRequest struct {
	TenantID string
	Statuses []string
	Types    []string
	Limit    int
}

type ListPostprocessJobsResponse struct {
	Items []PostprocessJobResponse `json:"items"`
}

type MemoryClient interface {
	StoreMemory(ctx context.Context, req StoreMemoryRequest) (StoreMemoryResponse, error)
	StoreMemoryBatch(ctx context.Context, req StoreMemoryBatchRequest) (StoreMemoryBatchResponse, error)
	SearchMemory(ctx context.Context, req SearchMemoryRequest) (SearchMemoryResponse, error)
	DeleteMemory(ctx context.Context, tenantID, memoryID string) error
}

type MemoryResponse struct {
	ID             string    `json:"id"`
	TenantID       string    `json:"tenant_id"`
	Content        string    `json:"content"`
	Tier           string    `json:"tier"`
	Tags           []string  `json:"tags"`
	Source         string    `json:"source"`
	CreatedBy      string    `json:"created_by"`
	Kind           string    `json:"kind"`
	RecallCount    int       `json:"recall_count"`
	CreatedAt      time.Time `json:"created_at"`
	UpdatedAt      time.Time `json:"updated_at"`
	LastAccessedAt time.Time `json:"last_accessed_at"`
	LastRecalledAt time.Time `json:"last_recalled_at"`
}

type Option func(*Client)

type PostprocessJobResponse struct {
	ID          string    `json:"id"`
	IngestID    string    `json:"ingest_id"`
	TenantID    string    `json:"tenant_id"`
	MemoryID    string    `json:"memory_id"`
	Type        string    `json:"type"`
	Status      string    `json:"status"`
	Attempts    int       `json:"attempts"`
	MaxAttempts int       `json:"max_attempts"`
	AvailableAt time.Time `json:"available_at"`
	LeaseOwner  string    `json:"lease_owner,omitempty"`
	LeasedUntil time.Time `json:"leased_until,omitempty"`
	LastError   string    `json:"last_error,omitempty"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

type SearchMemoryDebug struct {
	Plan    SearchPlanDebug      `json:"plan"`
	Ranking []SearchRankingDebug `json:"ranking,omitempty"`
}

type SearchMemoryRequest struct {
	TenantID      string   `json:"tenant_id"`
	Query         string   `json:"query"`
	TopK          int      `json:"top_k"`
	MinScore      float64  `json:"min_score,omitempty"`
	Tiers         []string `json:"tiers,omitempty"`
	Kinds         []string `json:"kinds,omitempty"`
	RetrievalKind string   `json:"retrieval_kind,omitempty"`
	DisableTouch  bool     `json:"disable_touch,omitempty"`
	Debug         bool     `json:"debug,omitempty"`
}

type SearchMemoryResponse struct {
	Items []MemoryResponse   `json:"items"`
	Debug *SearchMemoryDebug `json:"debug,omitempty"`
}

type SearchPlanDebug struct {
	Intent           string   `json:"intent"`
	Confidence       float64  `json:"confidence"`
	AnswerType       string   `json:"answer_type,omitempty"`
	Entities         []string `json:"entities,omitempty"`
	Relations        []string `json:"relations,omitempty"`
	TimeConstraints  []string `json:"time_constraints,omitempty"`
	RequiredEvidence string   `json:"required_evidence,omitempty"`
	FallbackPath     []string `json:"fallback_path,omitempty"`
}

type SearchRankingDebug struct {
	Rank         int     `json:"rank"`
	MemoryID     string  `json:"memory_id"`
	Kind         string  `json:"kind"`
	Tier         string  `json:"tier"`
	LexicalScore float64 `json:"lexical_score"`
	QueryOverlap float64 `json:"query_overlap"`
	RouteFit     float64 `json:"route_fit"`
}

type StoreMemoryBatchRequest struct {
	Items []StoreMemoryRequest `json:"items"`
}

type StoreMemoryBatchResponse struct {
	Items []StoreMemoryResponse `json:"items"`
}

type StoreMemoryRequest struct {
	TenantID  string   `json:"tenant_id"`
	Content   string   `json:"content"`
	Tags      []string `json:"tags"`
	Tier      string   `json:"tier"`
	Kind      string   `json:"kind,omitempty"`
	Source    string   `json:"source,omitempty"`
	CreatedBy string   `json:"created_by,omitempty"`
}

type StoreMemoryResponse struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"created_at"`
}

type TenantStatsResponse struct {
	TenantID    string `json:"tenant_id"`
	MemoryCount int64  `json:"memory_count"`
}