session

type AgentEntry struct {
	Name             string            `json:"name"`
	Provider         string            `json:"provider"`
	CLISessionID     string            `json:"cli_session_id,omitempty"`
	Status           string            `json:"status"`
	CreatedAt        time.Time         `json:"created_at"`
	LastActive       time.Time         `json:"last_active,omitempty"`
	ProviderSessions map[string]string `json:"provider_sessions,omitempty"`
	// MaxTurns caps agentic turns on the next spawn (--max-turns).
	// 0 = unlimited (provider default). Set per workflow agent node.
	MaxTurns int `json:"max_turns,omitempty"`
	// ThinkingTokens is the resolved MAX_THINKING_TOKENS env value applied on
	// the next spawn (claude). Empty = unset (provider default, thinking on);
	// "0" = disabled; "<n>" = budget. Set per workflow agent node from its
	// thinking + max_thinking_tokens inputs.
	ThinkingTokens string `json:"thinking_tokens,omitempty"`
}

type CreateOptions struct {
	ID        string
	ProjectID string
	Origin    Origin
	ChannelID string
	// Preset is the preset name to associate with this session.
	// Stored in meta.json; factory loads content from presets/<name>/agent.md on spawn.
	Preset string
	// UserID is the wick user who is creating this session. Stored in
	// meta.json for ownership checks in MCP handlers.
	UserID string
}

type Meta struct {
	// ProjectID references the project this session belongs to. Empty =
	// unscoped (pool falls back to the tools-config default project).
	ProjectID    string    `json:"project_id,omitempty"`
	Origin       Origin    `json:"origin"`
	ChannelID    string    `json:"channel_id,omitempty"`
	ActiveAgent  string    `json:"active_agent,omitempty"`
	Status       Status    `json:"status"`
	CreatedAt    time.Time `json:"created_at"`
	LastActive   time.Time `json:"last_active"`
	PendingInput []string  `json:"pending_input,omitempty"`
	// Label is the session title shown in the sidebar. By default it is
	// the first user message truncated to 60 runes (see
	// pool.setLabelIfEmpty), cached here so sidebar rendering never needs
	// to open conversation.jsonl. Once a human or the agent sets an
	// explicit title (TitleCustom=true) the auto-derived label no longer
	// overwrites it.
	Label string `json:"label,omitempty"`
	// TitleCustom marks Label as an explicit title set by a human or the
	// agent (via the wick_set_title MCP tool), as opposed to the
	// auto-derived first-message label. When true, the first-user-message
	// auto-label is skipped so it never clobbers the chosen title.
	TitleCustom bool `json:"title_custom,omitempty"`
	// Preset is the name of the preset active for this session.
	// Factory reads the preset content from presets/<name>/agent.md on
	// every spawn so edits to the preset take effect on next respawn.
	Preset string `json:"preset,omitempty"`
	// Subscribers is the list of user IDs that opted in to receive
	// browser push notifications for this session's lifecycle
	// transitions (queue → working → idle). Persisted in meta.json so
	// the subscription survives wick restart. Sessions are shared
	// across users (anyone can open them) but pushes target only the
	// IDs in this list — no auto-subscribe on session create.
	Subscribers []string `json:"subscribers,omitempty"`
	// UserID is the wick user ID that created this session. Empty for
	// legacy sessions created before ownership tracking was added.
	// When non-empty, only the owning user (or app owner) may access it.
	UserID string `json:"user_id,omitempty"`
}

type Origin string

type Session struct {
	ID     string       `json:"id"`
	Meta   Meta         `json:"meta"`
	Agents []AgentEntry `json:"agents"`
}

type Status string