schedule

type CreateRequest struct {
	Name        string      `json:"name"`
	Description string      `json:"description"`
	Pattern     string      `json:"pattern"`
	MaxCalls    NullableInt `json:"max_calls,omitempty"`
	Command     string      `json:"command"`
	Enabled     *bool       `json:"enabled,omitempty"`
	ExecutionConfig
}

type ExecutionConfig struct {
	// MaxRunSeconds is the execution budget (300-86400 seconds); zero uses one hour.
	MaxRunSeconds int `json:"max_run_seconds,omitempty"`
	// RunTarget is new_session (default) or existing_session.
	RunTarget string `json:"run_target,omitempty"`
	// TargetSessionID names the session reused by existing_session mode.
	TargetSessionID string `json:"target_session_id,omitempty"`
	// RuntimeType selects the runtime for new sessions: "" or "model" for
	// the native model runtime, "acp_agent" for an ACP agent. Must be empty
	// in existing_session mode (inherited from the target session).
	RuntimeType string `json:"runtime_type,omitempty"`
	// BotAgentID selects one persisted BotAgent for a new session. Empty means
	// the built-in Native runtime (or the legacy ACP fields below).
	BotAgentID string `json:"bot_agent_id,omitempty"`
	// ACPAgentID names the ACP agent when RuntimeType is acp_agent.
	ACPAgentID string `json:"acp_agent_id,omitempty"`
	// ModelID is a native model UUID override (models.id).
	ModelID string `json:"model_id,omitempty"`
	// ACPModelID is an agent-reported model identifier override for External
	// Agent runs. Mutually exclusive with ModelID.
	ACPModelID string `json:"acp_model_id,omitempty"`
	// ReasoningEffort overrides the reasoning effort for this schedule.
	ReasoningEffort string `json:"reasoning_effort,omitempty"`
	// WorkdirID binds new sessions to a bot workdir. Must be empty in
	// existing_session mode (inherited from the target session).
	WorkdirID string `json:"workdir_id,omitempty"`
}

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

type ListLogsResponse struct {
	Items      []Log `json:"items"`
	TotalCount int64 `json:"total_count"`
}

type ListResponse struct {
	Items []Schedule `json:"items"`
}

type ListRunSessionsResponse struct {
	Items      []RunSession `json:"items"`
	NextCursor string       `json:"next_cursor"`
}

type Log struct {
	ID         string `json:"id"`
	ScheduleID string `json:"schedule_id"`
	BotID      string `json:"bot_id"`
	SessionID  string `json:"session_id,omitempty"`
	Status     string `json:"status"`
	ResultText string `json:"result_text"`
	// ErrorMessage is the text an earlier server stored; new failures set
	// ErrorCode and leave it empty.
	ErrorMessage string     `json:"error_message"`
	ErrorCode    string     `json:"error_code,omitempty"`
	Usage        any        `json:"usage,omitempty"`
	StartedAt    time.Time  `json:"started_at"`
	CompletedAt  *time.Time `json:"completed_at,omitempty"`
}

type NullableInt struct {
	Value *int
	Set   bool
}

type Rule string

type RunSession struct {
	// LogID identifies the fire (schedule_logs.id).
	LogID string `json:"log_id"`
	// SessionID is empty when the fire failed before any session existed.
	SessionID string `json:"session_id"`
	// Title is the session title, empty when there is no session.
	Title string `json:"title"`
	// Status is running while the fire has not completed, then ok or error.
	Status    string    `json:"status" enums:"running,ok,error"`
	ErrorCode string    `json:"error_code"`
	StartedAt time.Time `json:"started_at"`
	// CompletedAt is null while the fire is still running.
	CompletedAt *time.Time `json:"completed_at" extensions:"x-nullable"`
}

type Schedule struct {
	ID           string    `json:"id"`
	Name         string    `json:"name"`
	Description  string    `json:"description"`
	Pattern      string    `json:"pattern"`
	MaxCalls     *int      `json:"max_calls,omitempty"`
	CurrentCalls int       `json:"current_calls"`
	CreatedAt    time.Time `json:"created_at"`
	UpdatedAt    time.Time `json:"updated_at"`
	Enabled      bool      `json:"enabled"`
	Command      string    `json:"command"`
	BotID        string    `json:"bot_id"`
	ExecutionConfig
}

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

type SessionCreator interface {
	CreateSession(ctx context.Context, botID, sessionType string) (string, error)
	// CreateScheduleSession creates the user-visible session one fire of a
	// schedule runs in, honoring the schedule's runtime and workdir.
	CreateScheduleSession(ctx context.Context, spec SessionSpec) (string, error)
}

type SessionSpec struct {
	BotID string
	// BotAgentID is empty for Native and set for a persisted Agent selection.
	BotAgentID string
	// Title labels the session in user-facing lists (the schedule name).
	Title string
	// RuntimeType selects the Native or External Agent runtime.
	RuntimeType string
	// ACPAgentID names the agent when RuntimeType is RuntimeACPAgent.
	ACPAgentID string
	// WorkdirID optionally binds the session to a bot workdir.
	WorkdirID string
	// OwnerUserID becomes the session creator and, for External Agent sessions, the
	// runtime owner account.
	OwnerUserID string
}

type TriggerPayload struct {
	FireID      string
	ID          string
	Name        string
	Description string
	Pattern     string
	MaxCalls    *int
	Command     string
	OwnerUserID string
	SessionID   string
	// ModelID / RuntimeModelID / ReasoningEffort are the schedule's per-run
	// overrides. Which runtime executes the run is decided by the session
	// itself (its runtime_type and metadata), never by the payload.
	ModelID         string
	RuntimeModelID  string
	ReasoningEffort string
}

type TriggerResult struct {
	Status     string
	Text       string
	UsageBytes []byte
	ModelID    string
}

type Triggerer interface {
	TriggerSchedule(ctx context.Context, botID string, payload TriggerPayload, token string) (TriggerResult, error)
}

type UpdateRequest struct {
	Name        *string     `json:"name,omitempty"`
	Description *string     `json:"description,omitempty"`
	Pattern     *string     `json:"pattern,omitempty"`
	MaxCalls    NullableInt `json:"max_calls,omitempty"`
	Command     *string     `json:"command,omitempty"`
	Enabled     *bool       `json:"enabled,omitempty"`
	// Execution replaces the whole execution parameter block when present.
	// Field-level patching is deliberately not offered: the block carries
	// cross-field constraints (run target vs runtime vs workdir), so
	// callers send the full desired state and the service validates it as
	// one unit.
	Execution *ExecutionConfig `json:"execution,omitempty"`
}

type WorkdirValidator interface {
	RequireActive(ctx context.Context, botID, workdirID string) (workdir.Workdir, error)
}