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"`
	// ModelID pins a specific model id this agent uses on its next spawn,
	// scoped to whichever provider Provider currently points at. Empty =
	// use that provider instance's own default-model resolution. Currently
	// only meaningful for wick (WickModel.ID); other provider types ignore
	// it. Cleared on switching to a provider type that doesn't recognize
	// it, so a later switch back doesn't resurrect a stale/foreign pin.
	ModelID string `json:"model_id,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
	// ParentSessionID marks this session as a delegated sub-agent's
	// isolated context. See Meta.ParentSessionID.
	ParentSessionID string
}

type Goal struct {
	Goal      string     `json:"goal"`
	Status    GoalStatus `json:"status"`
	Note      string     `json:"note,omitempty"`
	UpdatedAt time.Time  `json:"updated_at"`
}

type GoalStatus 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"`
	// SystemAddon is free-text system-prompt content appended after the
	// preset on every spawn. Unlike Preset it is not a named file, so it
	// carries prompt text that belongs to THIS session and has no reason
	// to appear in the shared preset list — a sub-agent role's system
	// prompt, or a project's default addon.
	//
	// Read by the pool on each spawn, so an edit takes effect on the next
	// respawn exactly like a preset edit does.
	SystemAddon string `json:"system_addon,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"`
	// AutoReply marks a Slack channel thread as auto-reply: while true,
	// replies in the thread are dispatched to the agent without an
	// @mention. Set when the thread is created (the bot also drops a 🤖
	// marker on the parent) and toggled by adding/removing that marker.
	// Persisted here so the switch survives a wick restart even though
	// the channel's in-memory state is lost. Only meaningful for Slack
	// channel sessions; absent/false everywhere else.
	AutoReply bool `json:"auto_reply,omitempty"`
	// ParentSessionID links a sub-agent's isolated session back to the
	// session that delegated it. Non-empty = this is a child: hidden
	// from the conversation list and surfaced in the parent's Sub-agents
	// rail panel instead.
	//
	// This relation is the ONLY marker of "is a child" — there is
	// deliberately no separate `type: subagent` field, because two
	// sources of truth for the same fact can disagree. Absent on every
	// session created before sub-agents existed, which reads correctly
	// as "not a child".
	ParentSessionID string `json:"parent_session_id,omitempty"`
}

type Origin string

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

type Status string