sessions

type RolloverPolicy struct {
	// IdleTimeout rolls a session over when more than this duration has
	// passed since its last update. Zero disables idle rollover.
	IdleTimeout time.Duration

	// Daily rolls a session over when a calendar-day boundary has been
	// crossed since its last update.
	Daily bool

	// Location resolves the day boundary for Daily rollovers. Nil falls
	// back to the caller's timezone (the agent uses its configured user
	// timezone, defaulting to UTC).
	Location *time.Location
}

type RolloverReason string

type Session struct {
	ID        string             `json:"id"`
	AgentID   string             `json:"agent_id,omitempty"`
	Messages  []provider.Message `json:"messages"`
	CreatedAt time.Time          `json:"created_at"`
	UpdatedAt time.Time          `json:"updated_at"`
	Metadata  map[string]any     `json:"metadata,omitempty"`

	// ToolOverrides scopes the tool set for this session's turns.
	// Nil means no overrides. Changes take effect on the next turn.
	ToolOverrides *ToolOverrides `json:"tool_overrides,omitempty"`

	// Model overrides the agent's default model for this session's turns.
	// Empty uses the agent default. Changes take effect on the next turn.
	Model string `json:"model,omitempty"`
}

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

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

type StoreConfig struct {
	// Backend is the KVS storage backend.
	Backend kvs.Store

	// TTL is the session time-to-live. Zero means no expiration.
	TTL time.Duration
}

type ToolOverrides struct {
	// Tools maps individual tool names to enabled (true) or disabled
	// (false). Tools absent from the map keep their default availability.
	// This covers skill-provided tools and built-ins (e.g. web search) —
	// they are all addressed by registered tool name.
	Tools map[string]bool `json:"tools,omitempty"`

	// MCPServers maps MCP server names to enabled/disabled. Disabling a
	// server removes all of its tools for this session.
	MCPServers map[string]bool `json:"mcp_servers,omitempty"`

	// MCPToolsDeny lists denied tool names per MCP server, using the
	// tool's original name on that server.
	MCPToolsDeny map[string][]string `json:"mcp_tools_deny,omitempty"`
}