session

type CreateRequest struct {
	AppName   string
	UserID    string
	SessionID string // Optional - generated if empty
	State     map[string]any
}

type CreateResponse struct {
	Session Session
}

type DeleteRequest struct {
	AppName   string
	UserID    string
	SessionID string
}

type GetRequest struct {
	AppName   string
	UserID    string
	SessionID string

	// NumRecentEvents returns at most N most recent events.
	// Optional: if zero, returns all events.
	NumRecentEvents int

	// AfterEventID returns events after the event with this ID (by sequence_num).
	// Optional: if empty, returns all events.
	AfterEventID string
}

type GetResponse struct {
	Session Session
}

type ListRequest struct {
	AppName   string
	UserID    string
	PageSize  int
	PageToken string
}

type ListResponse struct {
	Sessions      []Session
	NextPageToken string
}

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

type Service interface {
	// Get retrieves an existing session.
	Get(ctx context.Context, req *GetRequest) (*GetResponse, error)

	// Create creates a new session.
	Create(ctx context.Context, req *CreateRequest) (*CreateResponse, error)

	// AppendEvent adds an event to the session history.
	AppendEvent(ctx context.Context, session Session, event *agent.Event) error

	// ReplaceEvents replaces all events in the session with the given events.
	// This is used by summary_buffer strategy to compact the session after summarization.
	ReplaceEvents(ctx context.Context, session Session, events []*agent.Event) error

	// List returns sessions matching the filter criteria.
	List(ctx context.Context, req *ListRequest) (*ListResponse, error)

	// Delete removes a session.
	Delete(ctx context.Context, req *DeleteRequest) error

	// DeleteByApp removes all sessions and associated data for a specific app.
	DeleteByApp(ctx context.Context, appName string) error
}

type Session interface {
	// ID returns the unique session identifier.
	ID() string

	// AppName returns the application name.
	AppName() string

	// UserID returns the user identifier.
	UserID() string

	// State returns the session state store.
	State() agent.State

	// Events returns the session event history.
	Events() agent.Events

	// LastUpdateTime returns when the session was last modified.
	LastUpdateTime() time.Time
}