mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-11-15 18:59:33 +01:00
94 lines
3.2 KiB
TypeScript
94 lines
3.2 KiB
TypeScript
|
/**
|
|||
|
|
* @fileoverview Scheduled Jobs (cron-style scheduler) type definitions.
|
|||
|
|
*
|
|||
|
|
* NOTE: This is intentionally distinct from the existing `ScheduledRun` concept
|
|||
|
|
* (see src/web/ports/infra-port.ts), which is a run-now, duration-bounded
|
|||
|
|
* autonomous loop. A `ScheduledJob` is a SAVED, NAMED job with a recurring
|
|||
|
|
* schedule (once/interval/daily/weekly), enable/disable, next-run calculation,
|
|||
|
|
* and a history of `ScheduledJobRun` records. The two do not interact.
|
|||
|
|
*
|
|||
|
|
* Persisted to `~/.codeman/state.json` via StateStore (see AppState).
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
import type { SessionMode } from './session.js';
|
|||
|
|
|
|||
|
|
/** How a job's fire times are computed. */
|
|||
|
|
export type ScheduleType = 'once' | 'interval' | 'daily' | 'weekly';
|
|||
|
|
|
|||
|
|
/** Where the prompt text comes from. */
|
|||
|
|
export type PromptMode = 'inline_text' | 'prompt_file_path';
|
|||
|
|
|
|||
|
|
/** How the prompt is delivered into the session. */
|
|||
|
|
export type InputMode = 'paste' | 'typed';
|
|||
|
|
|
|||
|
|
/** Lifecycle status of a single job execution. */
|
|||
|
|
export type ScheduledJobRunStatus = 'created' | 'session_started' | 'prompt_sent' | 'failed';
|
|||
|
|
|
|||
|
|
/** What triggered a run. */
|
|||
|
|
export type TriggerType = 'scheduled' | 'manual_run_now';
|
|||
|
|
|
|||
|
|
/** What to do for an AUTOMATIC run when sessions of the same agent already exist. */
|
|||
|
|
export type ConcurrencyPolicy = 'warn_only' | 'skip_if_same_agent_running';
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* A saved, named scheduled job.
|
|||
|
|
*/
|
|||
|
|
export interface ScheduledJob {
|
|||
|
|
id: string;
|
|||
|
|
name: string;
|
|||
|
|
/** Reuses Codeman's existing session modes; 'shell' covers Terminal/custom. */
|
|||
|
|
agentType: SessionMode;
|
|||
|
|
workingDir: string;
|
|||
|
|
/** Optional custom launch command (only meaningful for 'shell' mode). */
|
|||
|
|
launchCommand?: string;
|
|||
|
|
|
|||
|
|
promptMode: PromptMode;
|
|||
|
|
promptText?: string;
|
|||
|
|
promptFilePath?: string;
|
|||
|
|
inputMode: InputMode;
|
|||
|
|
|
|||
|
|
scheduleType: ScheduleType;
|
|||
|
|
/** once: absolute epoch-ms fire time. */
|
|||
|
|
runAt?: number;
|
|||
|
|
/** interval: minutes between fires. */
|
|||
|
|
intervalMinutes?: number;
|
|||
|
|
/** daily: 'HH:MM' (24h, server-local time). */
|
|||
|
|
dailyTime?: string;
|
|||
|
|
/** weekly: weekdays 0–6 (0=Sunday). */
|
|||
|
|
weeklyDays?: number[];
|
|||
|
|
/** weekly: 'HH:MM' (24h, server-local time). */
|
|||
|
|
weeklyTime?: string;
|
|||
|
|
|
|||
|
|
enabled: boolean;
|
|||
|
|
notes?: string;
|
|||
|
|
/** Applies to automatic (scheduled) runs only. Manual Run Now always warns client-side. */
|
|||
|
|
concurrencyPolicy: ConcurrencyPolicy;
|
|||
|
|
|
|||
|
|
// ── Bookkeeping (server-maintained) ─────────────────────────────────────
|
|||
|
|
createdAt: number;
|
|||
|
|
updatedAt: number;
|
|||
|
|
lastRunAt: number | null;
|
|||
|
|
nextRunAt: number | null;
|
|||
|
|
lastStatus: ScheduledJobRunStatus | null;
|
|||
|
|
/** Duplicate-launch guard: identifies the most recent due-time consumed. */
|
|||
|
|
lastDueKey: string | null;
|
|||
|
|
/** True once a 'once' job has fired (it is also disabled). */
|
|||
|
|
completedOnce?: boolean;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* A single execution of a scheduled job (history record).
|
|||
|
|
*/
|
|||
|
|
export interface ScheduledJobRun {
|
|||
|
|
id: string;
|
|||
|
|
scheduledJobId: string;
|
|||
|
|
sessionId: string | null;
|
|||
|
|
sessionName: string | null;
|
|||
|
|
startedAt: number;
|
|||
|
|
finishedAt: number | null;
|
|||
|
|
status: ScheduledJobRunStatus;
|
|||
|
|
errorMessage?: string;
|
|||
|
|
triggerType: TriggerType;
|
|||
|
|
/** Best-effort deep link to the created session in the web UI. */
|
|||
|
|
createdSessionUrl: string | null;
|
|||
|
|
}
|