headless

type TaskSpec struct {
	Prompt string `json:"prompt"`
	// Script is a workspace-relative path to a bash script executed directly.
	Script string `json:"script,omitempty"`
	// Cron, when set, turns this task into a scheduled job instead of a
	// run-once-at-startup task.
	Cron string `json:"cron,omitempty"`
	// ID names the job in the registry and in logs. Defaults to task-<n>.
	ID string `json:"id,omitempty"`
	// Note is free-form context stored with the job.
	Note string `json:"note,omitempty"`
}

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

type TimerConfig struct {
	// EverySeconds is the tick interval. Required.
	EverySeconds int `json:"everySeconds"`
	// Prompt is the task text sent on every tick. Required.
	Prompt string `json:"prompt"`
	// Immediate fires the first tick at startup instead of waiting a full
	// interval. Defaults to true, so a restart does useful work right away.
	Immediate *bool `json:"immediate"`
	// MaxRuns bounds the number of ticks; 0 means run until shutdown.
	MaxRuns int `json:"maxRuns"`
	// SessionMode is fresh (default) or fixed.
	SessionMode string `json:"sessionMode"`
	// SessionID is the id used in fixed mode, and the prefix in fresh mode.
	SessionID string `json:"sessionId"`
	// Output is text (default) or json, one event object per line.
	Output string `json:"output"`
	// Stream echoes assistant deltas as they arrive.
	Stream bool `json:"stream"`
}

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

type WorkerConfig struct {
	// Tasks each run as one turn. Entries without a cron run once at startup, in
	// order; entries with a cron are registered as scheduled jobs. Positional
	// command-line arguments override this list.
	Tasks []TaskSpec `json:"tasks"`
	// Prompt is the single-task shorthand, used when Tasks is empty.
	Prompt string `json:"prompt"`
	// SessionMode is fresh (default) or fixed.
	SessionMode string `json:"sessionMode"`
	// SessionID is the id used in fixed mode, and the prefix in fresh mode.
	SessionID string `json:"sessionId"`
	// Output is text (default) or json, one event object per line.
	Output string `json:"output"`
	// Stream echoes assistant deltas as they arrive. Off by default: an
	// unattended run wants the result, not the typing.
	Stream bool `json:"stream"`
	// PollSeconds is how often the cron loop re-reads the registry, which is what
	// bounds the delay before a job the agent just scheduled is noticed.
	// Defaults to 30.
	PollSeconds int `json:"pollSeconds"`
}

type WorkerDeps struct {
	// Schedule enables cron mode. Without it, cron-bearing tasks are a config
	// error rather than a silently ignored setting.
	Schedule schedule.Registry `json:"schedule,omitempty"`
	// Workspace resolves script paths. Required when any task uses script.
	Workspace workspace.Service `json:"workspace,omitempty"`
	// Shell runs script tasks. Required when any task uses script.
	Shell shell.Executor `json:"shell,omitempty"`
}