@xopcai/xopc 0.0.110 → 0.0.112

package/dist/src/cron/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","names":["uuidv4"],"sources":["../../../src/cron/service.ts"],"sourcesContent":["// CronService - Optimized with async I/O, caching, and execution tracking\nimport nodeCron from 'node-cron';\nimport { CronExpressionParser } from 'cron-parser';\nimport { v4 as uuidv4 } from 'uuid';\nimport { Config } from '../config/index.js';\nimport { resolveCronJobsPath } from '../config/paths.js';\nimport { createLogger } from '../utils/logger.js';\nimport { CronPersistence } from './persistence.js';\nimport { DefaultJobExecutor } from './executor.js';\nimport { CronRunLogStore } from './run-log-store.js';\nimport { z } from 'zod';\nimport { AddJobRequestSchema, UpdateJobRequestSchema } from './validation.js';\nimport type {\n  JobData,\n  JobExecution,\n  JobExecutorDeps,\n  CronMetrics,\n  CronHealth,\n  AddJobOptions,\n  JobWithNextRun,\n  CronRunHistoryRow,\n} from './types.js';\n\nconst log = createLogger('CronService');\n\ninterface ScheduledTask {\n  stop: () => void;\n}\n\nexport interface CronServiceConfig {\n  filePath?: string;\n  agentService?: any;\n  messageBus?: any;\n  /** Override SQLite database path (tests). */\n  dbPath?: string;\n}\n\nexport class CronService {\n  private persistence: CronPersistence;\n  private executor: DefaultJobExecutor;\n  private runLogStore: CronRunLogStore;\n  private tasks: Map<string, ScheduledTask> = new Map();\n  private initialized = false;\n  private agentService: any = null;\n  private messageBus: any = null;\n\n  constructor(config?: CronServiceConfig) {\n    const filePath = config?.filePath || resolveCronJobsPath();\n    this.persistence = new CronPersistence(filePath);\n    this.executor = new DefaultJobExecutor();\n    this.runLogStore = new CronRunLogStore(config?.dbPath);\n    this.executor.setRunLogStore(this.runLogStore);\n\n    // Set dependencies if provided\n    if (config?.agentService || config?.messageBus) {\n      this.setDeps({\n        agentService: config.agentService,\n        messageBus: config.messageBus,\n      });\n    }\n  }\n\n  /**\n   * Set dependencies for the executor\n   */\n  setDeps(deps: JobExecutorDeps): void {\n    this.agentService = deps.agentService;\n    this.messageBus = deps.messageBus;\n    this.executor.setDeps(deps);\n    log.debug('CronService dependencies set');\n  }\n\n  /**\n   * Initialize the service and load all jobs\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    await this.persistence.initialize();\n    await this.loadAllJobs();\n\n    this.initialized = true;\n    log.debug('CronService initialized');\n  }\n\n  /**\n   * Add a new job\n   */\n  async addJob(schedule: string, options: AddJobOptions): Promise<{ id: string; schedule: string }> {\n    const validationResult = AddJobRequestSchema.safeParse({\n      schedule,\n      ...options,\n    });\n\n    if (!validationResult.success) {\n      const errorMsg = (validationResult as { error?: { errors: z.ZodIssue[] } }).error?.errors.map((e) => e.message).join(', ') || 'Unknown validation error';\n      throw new Error(`Validation failed: ${errorMsg}`);\n    }\n\n    const data = validationResult.data;\n    const id = uuidv4().slice(0, 8);\n    const now = new Date().toISOString();\n    const sessionTarget = data.sessionTarget ?? 'main';\n\n    const job: JobData = {\n      id,\n      name: data.name,\n      schedule: data.schedule,\n      enabled: true,\n      timezone: data.timezone,\n      maxRetries: data.maxRetries ?? 3,\n      timeout: data.timeout ?? 60000,\n      created_at: now,\n      updated_at: now,\n      sessionTarget,\n      ...(data.agentId ? { agentId: data.agentId } : {}),\n      ...(data.workingDirectory ? { workingDirectory: data.workingDirectory } : {}),\n      payload: data.payload,\n      delivery: data.delivery,\n      model: data.model,\n    };\n\n    // Save to persistence\n    await this.persistence.addJob(job);\n\n    // Schedule the job\n    this.scheduleJob(job);\n\n    log.info({ jobId: id, name: data.name, sessionTarget }, 'Job added');\n    return { id, schedule: data.schedule };\n  }\n\n  /**\n   * List all jobs with next run time\n   */\n  async listJobs(): Promise<JobWithNextRun[]> {\n    const jobs = await this.persistence.getJobs();\n\n    return jobs.map((job) => {\n      let nextRun: string | undefined;\n\n      if (job.enabled) {\n        try {\n          const options = job.timezone ? { tz: job.timezone } : undefined;\n          const interval = CronExpressionParser.parse(job.schedule, options);\n          nextRun = interval.next().toISOString();\n        } catch (err) {\n          log.debug({ jobId: job.id, err: err as Error }, 'Failed to parse cron for next run');\n        }\n      }\n\n      return {\n        id: job.id,\n        name: job.name,\n        schedule: job.schedule,\n        enabled: job.enabled,\n        timezone: job.timezone,\n        maxRetries: job.maxRetries,\n        timeout: job.timeout,\n        sessionTarget: job.sessionTarget,\n        ...(job.agentId ? { agentId: job.agentId } : {}),\n        ...(job.workingDirectory ? { workingDirectory: job.workingDirectory } : {}),\n        payload: job.payload,\n        delivery: job.delivery,\n        model: job.model,\n        next_run: nextRun,\n      };\n    });\n  }\n\n  /**\n   * Get a single job\n   */\n  async getJob(id: string): Promise<JobData | null> {\n    return this.persistence.getJob(id);\n  }\n\n  /**\n   * Update a job\n   */\n  async updateJob(id: string, updates: Partial<Omit<JobData, 'id' | 'created_at' | 'updated_at'>>): Promise<boolean> {\n    // Validate updates\n    const validationResult = UpdateJobRequestSchema.safeParse(updates);\n    if (!validationResult.success) {\n      const errorMsg = (validationResult as { error?: { errors: z.ZodIssue[] } }).error?.errors.map((e) => e.message).join(', ') || 'Unknown validation error';\n      throw new Error(`Validation failed: ${errorMsg}`);\n    }\n\n    const job = await this.persistence.getJob(id);\n    if (!job) return false;\n\n    const validated = validationResult.data;\n    const { agentId: agentIdPatch, workingDirectory: workingDirectoryPatch, ...rest } = validated;\n    const patch: Partial<JobData> = { ...rest };\n    let clearAgentId = false;\n    if (agentIdPatch === null) {\n      clearAgentId = true;\n    } else if (agentIdPatch !== undefined) {\n      patch.agentId = agentIdPatch;\n    }\n\n    let clearWorkingDirectory = false;\n    if (workingDirectoryPatch === null) {\n      clearWorkingDirectory = true;\n    } else if (workingDirectoryPatch !== undefined) {\n      patch.workingDirectory = workingDirectoryPatch;\n    }\n\n    // Cancel existing task if schedule changes\n    if (patch.schedule && patch.schedule !== job.schedule) {\n      this.cancelTask(id);\n    }\n\n    // Update persistence\n    await this.persistence.updateJob(id, patch, { clearAgentId, clearWorkingDirectory });\n\n    // Re-schedule if needed\n    const updated = await this.persistence.getJob(id);\n    if (updated && updated.enabled) {\n      this.scheduleJob(updated);\n    }\n\n    log.info({ jobId: id }, 'Job updated');\n    return true;\n  }\n\n  /**\n   * Remove a job\n   */\n  async removeJob(id: string): Promise<boolean> {\n    // Cancel task\n    this.cancelTask(id);\n\n    // Remove from persistence\n    const removed = await this.persistence.removeJob(id);\n\n    if (removed) {\n      await this.runLogStore.deleteJobRuns(id);\n      log.info({ jobId: id }, 'Job removed');\n    }\n\n    return removed;\n  }\n\n  /**\n   * Toggle job enabled state\n   */\n  async toggleJob(id: string, enabled: boolean): Promise<boolean> {\n    const job = await this.persistence.getJob(id);\n    if (!job) return false;\n\n    await this.persistence.updateJob(id, { enabled });\n\n    if (enabled) {\n      const updated = await this.persistence.getJob(id);\n      if (updated) this.scheduleJob(updated);\n    } else {\n      this.cancelTask(id);\n    }\n\n    log.info({ jobId: id, enabled }, 'Job toggled');\n    return true;\n  }\n\n  /**\n   * Execution history for one job: merged in-memory (incl. running) + persisted SQLite rows.\n   */\n  async getJobHistory(jobId: string, limit?: number): Promise<JobExecution[]> {\n    const cap = Math.min(Math.max(limit ?? 10, 1), 500);\n    const [disk, memory] = await Promise.all([\n      this.runLogStore.readJobHistory(jobId, cap * 2),\n      Promise.resolve(this.executor.getHistory(jobId, cap * 2)),\n    ]);\n    const byId = new Map<string, JobExecution>();\n    for (const e of memory) {\n      byId.set(e.id, e);\n    }\n    for (const e of disk) {\n      if (!byId.has(e.id)) {\n        byId.set(e.id, e);\n      }\n    }\n    const merged = [...byId.values()].sort(\n      (a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime()\n    );\n    return merged.slice(0, cap);\n  }\n\n  /**\n   * Latest runs across all jobs (persisted rows + optional job name).\n   */\n  async getAllRunsHistory(limit?: number): Promise<CronRunHistoryRow[]> {\n    const cap = Math.min(Math.max(limit ?? 50, 1), 500);\n    const jobs = await this.persistence.getJobs();\n    const jobNames = new Map<string, string | undefined>(jobs.map((j) => [j.id, j.name] as const));\n    return this.runLogStore.readAllRuns(cap, jobNames);\n  }\n\n  /**\n   * Get service metrics\n   */\n  async getMetrics(): Promise<CronMetrics> {\n    const jobs = await this.persistence.getJobs();\n    const enabled = jobs.filter((j) => j.enabled);\n\n    let nextScheduledJob: CronMetrics['nextScheduledJob'] | undefined;\n\n    for (const job of enabled) {\n      try {\n        const options = job.timezone ? { tz: job.timezone } : undefined;\n        const interval = CronExpressionParser.parse(job.schedule, options);\n        const next = interval.next();\n\n        if (!nextScheduledJob || next.getTime() < nextScheduledJob.runAt.getTime()) {\n          nextScheduledJob = {\n            id: job.id,\n            name: job.name,\n            runAt: next.toDate(),\n          };\n        }\n      } catch {\n        // Skip invalid schedules\n      }\n    }\n\n    return {\n      totalJobs: jobs.length,\n      runningJobs: this.tasks.size,\n      enabledJobs: enabled.length,\n      failedLastHour: 0, // TODO: track from executor\n      avgExecutionTime: 0, // TODO: track from executor\n      nextScheduledJob,\n    };\n  }\n\n  /**\n   * Update config (hot reload)\n   */\n  updateConfig(_config: Config): void {\n    log.debug('Cron config updated (jobs managed separately via addJob/removeJob)');\n  }\n\n  /**\n   * Health check\n   */\n  async healthCheck(): Promise<CronHealth> {\n    const issues: string[] = [];\n\n    // Check if initialized\n    if (!this.initialized) {\n      issues.push('Service not initialized');\n    }\n\n    // Check for jobs with invalid schedules\n    const jobs = await this.persistence.getJobs();\n    for (const job of jobs) {\n      if (!nodeCron.validate(job.schedule)) {\n        issues.push(`Job ${job.id} has invalid schedule`);\n      }\n    }\n\n    // Check if agent service is configured for isolated jobs\n    for (const job of jobs) {\n      if (job.enabled && job.sessionTarget === 'isolated' && !this.agentService) {\n        issues.push(`Job ${job.id} requires agent service but none configured`);\n        break;\n      }\n    }\n\n    // Determine status\n    let status: CronHealth['status'] = 'healthy';\n    if (issues.length > 0) {\n      status = issues.length > 5 ? 'unhealthy' : 'degraded';\n    }\n\n    return { status, issues };\n  }\n\n  /**\n   * Run a job immediately (manual trigger)\n   */\n  async runJobNow(id: string): Promise<void> {\n    const job = await this.persistence.getJob(id);\n    if (!job) throw new Error(`Job not found: ${id}`);\n    if (!job.enabled) throw new Error(`Job is disabled: ${id}`);\n\n    await this.executeJob(job);\n  }\n\n  /**\n   * Stop all jobs and cleanup\n   */\n  async stop(options?: { waitForRunning?: boolean; timeout?: number }): Promise<void> {\n    const timeout = options?.timeout ?? 30000;\n\n    // Cancel all scheduled tasks\n    for (const [id, task] of this.tasks) {\n      task.stop();\n\n      // Cancel running executions\n      this.executor.cancelJob(id);\n    }\n    this.tasks.clear();\n\n    // Wait for running jobs if requested\n    if (options?.waitForRunning) {\n      const start = Date.now();\n      while (Date.now() - start < timeout) {\n        const running = this.executor.getRunningExecutions();\n        if (running.length === 0) break;\n        await new Promise((r) => setTimeout(r, 100));\n      }\n    }\n\n    // Flush any pending writes\n    await this.persistence.flush();\n\n    log.info('CronService stopped');\n  }\n\n  /**\n   * Load and schedule all enabled jobs\n   */\n  private async loadAllJobs(): Promise<void> {\n    const jobs = await this.persistence.getJobs();\n\n    for (const job of jobs) {\n      if (job.enabled) {\n        this.scheduleJob(job);\n      }\n    }\n\n    log.debug({ count: this.tasks.size }, 'Jobs loaded');\n  }\n\n  /**\n   * Schedule a job with node-cron\n   */\n  private scheduleJob(job: JobData): void {\n    // Cancel existing if any\n    this.cancelTask(job.id);\n\n    // Validate schedule\n    if (!nodeCron.validate(job.schedule)) {\n      log.error({ jobId: job.id, schedule: job.schedule }, 'Invalid cron expression');\n      return;\n    }\n\n    const options = job.timezone ? { timezone: job.timezone } : undefined;\n\n    const task = nodeCron.schedule(\n      job.schedule,\n      async () => {\n        await this.executeJob(job);\n      },\n      options\n    );\n\n    this.tasks.set(job.id, task);\n    log.debug({ jobId: job.id, schedule: job.schedule }, 'Job scheduled');\n  }\n\n  /**\n   * Execute a job with retry logic\n   */\n  private async executeJob(job: JobData): Promise<void> {\n    // Prevent overlapping executions\n    if (this.executor.isRunning(job.id)) {\n      log.warn({ jobId: job.id }, 'Job already running, skipping');\n      return;\n    }\n\n    const controller = new AbortController();\n\n    try {\n      await this.executor.execute(job, controller.signal);\n    } catch (error) {\n      log.error({ jobId: job.id, err: error as Error }, 'Job execution failed');\n      // Retry logic can be added here based on error type\n    }\n  }\n\n  /**\n   * Cancel a scheduled task\n   */\n  private cancelTask(id: string): void {\n    const task = this.tasks.get(id);\n    if (task) {\n      task.stop();\n      this.tasks.delete(id);\n      log.debug({ jobId: id }, 'Task cancelled');\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/cron/service.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { createLogger } from '../utils/logger.js';\nimport type { Config } from '../config/schema.js';\nimport { DEFAULT_AGENT_ID, normalizeAgentId } from '../agent/agent-scope.js';\nimport { buildSessionKey } from '../routing/session-key.js';\nimport {\n  deleteCronJob,\n  getCronJob,\n  listCronJobs,\n  saveCronJob,\n  saveCronJobs,\n} from '../storage/sqlite/index.js';\nimport { DefaultJobExecutor } from './executor.js';\nimport { CronRunLogStore } from './run-log-store.js';\nimport {\n  computeNextRunAtMs,\n  describeSchedule,\n  timerDelayUntil,\n} from './schedule.js';\nimport type {\n  AddJobOptions,\n  CronHealth,\n  CronJobCreate,\n  CronJobPatch,\n  CronMetrics,\n  CronRunHistoryRow,\n  JobData,\n  JobExecution,\n  JobExecutorDeps,\n} from './types.js';\nimport {\n  AddJobRequestSchema,\n  JobDataSchema,\n  UpdateJobRequestSchema,\n} from './validation.js';\n\nconst log = createLogger('CronService');\n\nexport interface CronServiceConfig {\n  dbPath?: string;\n  agentService?: unknown;\n  messageBus?: unknown;\n  maxConcurrentJobs?: number;\n  missedJobStaggerMs?: number;\n}\n\ntype TimerHandle = ReturnType<typeof setTimeout> & { unref?: () => void };\n\nconst DEFAULT_MAX_CONCURRENT_JOBS = 5;\nconst DEFAULT_MISSED_JOB_STAGGER_MS = 5_000;\n\nexport class CronJobAlreadyRunningError extends Error {\n  readonly jobId: string;\n  readonly runningSessionKey?: string;\n\n  constructor(jobId: string, runningSessionKey?: string) {\n    super(`Job is already running: ${jobId}`);\n    this.name = 'CronJobAlreadyRunningError';\n    this.jobId = jobId;\n    this.runningSessionKey = runningSessionKey;\n  }\n}\n\nexport interface CronJobRunNowResult {\n  job: JobData;\n  history: JobExecution[];\n}\n\nfunction nowMs(): number {\n  return Date.now();\n}\n\nfunction runStatusFromExecution(status: JobExecution['status']): 'ok' | 'error' | 'skipped' {\n  if (status === 'success') return 'ok';\n  if (status === 'cancelled' || status === 'skipped') return 'skipped';\n  return 'error';\n}\n\nasync function postFailureWebhook(url: string, payload: unknown): Promise<void> {\n  const res = await fetch(url, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    body: JSON.stringify(payload),\n  });\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n    throw new Error(`Cron failure webhook failed: HTTP ${res.status}${text ? ` ${text.slice(0, 200)}` : ''}`);\n  }\n}\n\nfunction inferJobName(input: Pick<CronJobCreate, 'name' | 'payload' | 'schedule'>): string {\n  if (input.name?.trim()) return input.name.trim();\n  if (input.payload.kind === 'agentTurn') return input.payload.message.slice(0, 60) || 'Agent task';\n  if (input.payload.kind === 'systemEvent') return input.payload.text.slice(0, 60) || 'System event';\n  if (input.payload.kind === 'workflowRun') return `Workflow ${input.payload.definitionId}`;\n  if (input.payload.kind === 'goalContinue') return `Goal ${input.payload.goalId}`;\n  return describeSchedule(input.schedule);\n}\n\nfunction resolveRunningSessionKey(job: JobData, deps: JobExecutorDeps): string | undefined {\n  if (job.payload.kind !== 'agentTurn') return undefined;\n  if (job.sessionTarget.startsWith('session:')) {\n    return job.sessionTarget.slice('session:'.length).trim() || undefined;\n  }\n  if (job.sessionTarget === 'current') {\n    return job.sessionKey?.trim() || undefined;\n  }\n  if (job.sessionTarget !== 'isolated') {\n    return undefined;\n  }\n  const aid = job.agentId?.trim();\n  const fallbackAgentId = deps.getDefaultCronAgentId?.() ?? DEFAULT_AGENT_ID;\n  return buildSessionKey({\n    agentId: normalizeAgentId(aid || fallbackAgentId),\n    source: 'cron',\n    accountId: 'default',\n    peerKind: 'dm',\n    peerId: `${job.id}-${randomUUID().slice(0, 8)}`,\n  });\n}\n\nexport class CronService {\n  private executor = new DefaultJobExecutor();\n  private runLogStore: CronRunLogStore;\n  private initialized = false;\n  private stopped = false;\n  private running = false;\n  private timer: TimerHandle | null = null;\n  private deps: JobExecutorDeps = {};\n  private maxConcurrentJobs: number;\n  private missedJobStaggerMs: number;\n\n  constructor(config?: CronServiceConfig) {\n    this.runLogStore = new CronRunLogStore(config?.dbPath);\n    this.executor.setRunLogStore(this.runLogStore);\n    this.maxConcurrentJobs = Math.max(1, Math.floor(config?.maxConcurrentJobs ?? DEFAULT_MAX_CONCURRENT_JOBS));\n    this.missedJobStaggerMs = Math.max(0, Math.floor(config?.missedJobStaggerMs ?? DEFAULT_MISSED_JOB_STAGGER_MS));\n    if (config?.agentService || config?.messageBus) {\n      this.setDeps({ agentService: config.agentService, messageBus: config.messageBus });\n    }\n  }\n\n  setDeps(deps: JobExecutorDeps): void {\n    this.deps = { ...this.deps, ...deps };\n    this.executor.setDeps(this.deps);\n    log.debug('CronService dependencies set');\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    this.stopped = false;\n    await this.recomputeAllNextRuns({ catchUp: true });\n    this.initialized = true;\n    this.armTimer();\n    log.info('CronService initialized');\n  }\n\n  async addJob(scheduleOrInput: AddJobOptions['schedule'], options?: Omit<AddJobOptions, 'schedule'>): Promise<{ id: string; schedule: AddJobOptions['schedule'] }> {\n    const raw = options ? { ...options, schedule: scheduleOrInput } : scheduleOrInput;\n    const parsed = AddJobRequestSchema.parse(raw) as AddJobOptions;\n    const ts = nowMs();\n    const id = parsed.id?.trim() || randomUUID().slice(0, 12);\n    const job = JobDataSchema.parse({\n      ...parsed,\n      id,\n      name: inferJobName(parsed),\n      enabled: parsed.enabled ?? true,\n      deleteAfterRun: parsed.deleteAfterRun ?? parsed.schedule.kind === 'at',\n      createdAtMs: ts,\n      updatedAtMs: ts,\n      sessionTarget: parsed.sessionTarget ?? (parsed.payload.kind === 'systemEvent' ? 'main' : 'isolated'),\n      wakeMode: parsed.wakeMode ?? 'now',\n      state: {\n        ...(parsed.state ?? {}),\n      },\n    }) as JobData;\n    job.state.nextRunAtMs = computeNextRunAtMs(job, ts);\n    saveCronJob(job);\n    this.armTimer();\n    log.info({ jobId: job.id, name: job.name, schedule: job.schedule }, 'Cron job added');\n    return { id: job.id, schedule: job.schedule };\n  }\n\n  async listJobs(): Promise<JobData[]> {\n    return listCronJobs();\n  }\n\n  async getJob(id: string): Promise<JobData | null> {\n    return getCronJob(id);\n  }\n\n  async updateJob(id: string, updates: CronJobPatch): Promise<boolean> {\n    const parsed = UpdateJobRequestSchema.parse(updates) as CronJobPatch;\n    const current = getCronJob(id);\n    if (!current) return false;\n    const ts = nowMs();\n    const next = JobDataSchema.parse({\n      ...current,\n      ...parsed,\n      id: current.id,\n      createdAtMs: current.createdAtMs,\n      updatedAtMs: ts,\n      state: {\n        ...current.state,\n        ...(parsed.state ?? {}),\n      },\n    }) as JobData;\n    if ('schedule' in parsed || 'enabled' in parsed) {\n      next.state.nextRunAtMs = computeNextRunAtMs(next, ts);\n      delete next.state.runningAtMs;\n    }\n    if ('agentId' in updates && updates.agentId?.trim() === '') {\n      delete next.agentId;\n    }\n    if ('workingDirectory' in updates && updates.workingDirectory?.trim() === '') {\n      delete next.workingDirectory;\n    }\n    saveCronJob(next);\n    this.armTimer();\n    log.info({ jobId: id }, 'Cron job updated');\n    return true;\n  }\n\n  async removeJob(id: string): Promise<boolean> {\n    const removed = deleteCronJob(id);\n    if (removed) {\n      this.executor.cancelJob(id);\n      await this.runLogStore.deleteJobRuns(id);\n      this.armTimer();\n      log.info({ jobId: id }, 'Cron job removed');\n    }\n    return removed;\n  }\n\n  async toggleJob(id: string, enabled: boolean): Promise<boolean> {\n    return this.updateJob(id, { enabled });\n  }\n\n  async getJobHistory(jobId: string, limit?: number): Promise<JobExecution[]> {\n    return this.runLogStore.readJobHistory(jobId, Math.min(Math.max(limit ?? 10, 1), 500));\n  }\n\n  async getAllRunsHistory(limit?: number): Promise<CronRunHistoryRow[]> {\n    const cap = Math.min(Math.max(limit ?? 50, 1), 500);\n    const jobs = listCronJobs();\n    const names = new Map(jobs.map((job) => [job.id, job.name] as const));\n    return this.runLogStore.readAllRuns(cap, names);\n  }\n\n  async getMetrics(): Promise<CronMetrics> {\n    const jobs = listCronJobs();\n    const enabled = jobs.filter((job) => job.enabled);\n    const next = enabled\n      .filter((job) => job.state.nextRunAtMs != null)\n      .toSorted((a, b) => (a.state.nextRunAtMs ?? 0) - (b.state.nextRunAtMs ?? 0))[0];\n    return {\n      totalJobs: jobs.length,\n      runningJobs: jobs.filter((job) => job.state.runningAtMs != null).length,\n      enabledJobs: enabled.length,\n      failedLastHour: jobs.filter(\n        (job) => job.state.lastRunStatus === 'error' && (job.state.lastRunAtMs ?? 0) >= nowMs() - 60 * 60_000,\n      ).length,\n      avgExecutionTime: 0,\n      nextScheduledJob: next?.state.nextRunAtMs\n        ? { id: next.id, name: next.name, runAt: new Date(next.state.nextRunAtMs) }\n        : undefined,\n    };\n  }\n\n  updateConfig(config: Config): void {\n    this.maxConcurrentJobs = Math.max(1, Math.floor(config.cron?.maxConcurrentJobs ?? DEFAULT_MAX_CONCURRENT_JOBS));\n    this.armTimer();\n  }\n\n  async healthCheck(): Promise<CronHealth> {\n    const issues: string[] = [];\n    if (!this.initialized) issues.push('Service not initialized');\n    for (const job of listCronJobs()) {\n      const parsed = JobDataSchema.safeParse(job);\n      if (!parsed.success) issues.push(`Job ${job.id} is invalid`);\n      if (job.enabled && job.state.nextRunAtMs == null && job.schedule.kind !== 'at') {\n        issues.push(`Job ${job.id} has no next run`);\n      }\n    }\n    return {\n      status: issues.length === 0 ? 'healthy' : issues.length > 5 ? 'unhealthy' : 'degraded',\n      issues,\n    };\n  }\n\n  async runJobNow(id: string): Promise<CronJobRunNowResult> {\n    const job = getCronJob(id);\n    if (!job) throw new Error(`Job not found: ${id}`);\n    if (job.state.runningAtMs != null) {\n      throw new CronJobAlreadyRunningError(id, job.state.runningSessionKey);\n    }\n    const started = this.startSingleJob(job, { manual: true });\n    return { job: started, history: await this.getJobHistory(id, 20) };\n  }\n\n  async stop(options?: { waitForRunning?: boolean; timeout?: number }): Promise<void> {\n    this.stopped = true;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n    for (const job of listCronJobs()) {\n      this.executor.cancelJob(job.id);\n    }\n    if (options?.waitForRunning) {\n      const started = nowMs();\n      const timeout = options.timeout ?? 30_000;\n      while (nowMs() - started < timeout) {\n        if (listCronJobs().every((job) => job.state.runningAtMs == null)) break;\n        await new Promise((resolve) => setTimeout(resolve, 100));\n      }\n    }\n    log.info('CronService stopped');\n  }\n\n  private async recomputeAllNextRuns(opts?: { catchUp?: boolean }): Promise<void> {\n    const ts = nowMs();\n    const jobs = listCronJobs().map((job, index) => {\n      const next = { ...job, state: { ...job.state } };\n      if (next.state.runningAtMs != null) {\n        next.state.lastRunStatus = 'error';\n        next.state.lastError = 'Interrupted by gateway restart';\n        next.state.consecutiveErrors = (next.state.consecutiveErrors ?? 0) + 1;\n        delete next.state.runningAtMs;\n      }\n      if (next.enabled) {\n        const existingNext = next.state.nextRunAtMs;\n        if (opts?.catchUp && existingNext != null && existingNext <= ts) {\n          next.state.nextRunAtMs = ts + index * this.missedJobStaggerMs;\n        } else {\n          next.state.nextRunAtMs = computeNextRunAtMs(next, ts);\n        }\n      } else {\n        next.state.nextRunAtMs = undefined;\n      }\n      return next;\n    });\n    saveCronJobs(jobs);\n  }\n\n  private armTimer(): void {\n    if (this.stopped) return;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n    const next = listCronJobs()\n      .filter((job) => job.enabled && job.state.nextRunAtMs != null)\n      .toSorted((a, b) => (a.state.nextRunAtMs ?? 0) - (b.state.nextRunAtMs ?? 0))[0];\n    if (!next?.state.nextRunAtMs) return;\n    this.timer = setTimeout(() => {\n      void this.onTimer();\n    }, timerDelayUntil(next.state.nextRunAtMs)) as TimerHandle;\n    this.timer.unref?.();\n  }\n\n  private async onTimer(): Promise<void> {\n    if (this.stopped) return;\n    if (this.running) {\n      this.armTimer();\n      return;\n    }\n    this.running = true;\n    try {\n      const ts = nowMs();\n      const jobs = listCronJobs();\n      const due = jobs\n        .filter((job) => job.enabled && job.state.nextRunAtMs != null && job.state.nextRunAtMs <= ts && job.state.runningAtMs == null)\n        .slice(0, this.maxConcurrentJobs);\n      if (due.length === 0) return;\n      const reserved = due.map((job) => ({\n        ...job,\n        state: { ...job.state, runningAtMs: ts },\n      }));\n      saveCronJobs(reserved);\n      await Promise.all(reserved.map((job) => this.runSingleJob(job)));\n    } finally {\n      this.running = false;\n      this.armTimer();\n    }\n  }\n\n  private startSingleJob(job: JobData, opts?: { manual?: boolean }): JobData {\n    const started = nowMs();\n    const runningSessionKey = resolveRunningSessionKey(job, this.deps);\n    const reserved: JobData = {\n      ...job,\n      state: { ...job.state, runningAtMs: started, ...(runningSessionKey ? { runningSessionKey } : {}) },\n    };\n    saveCronJob(reserved);\n    void this.runReservedJob(reserved, started, runningSessionKey, opts).catch((err) => {\n      log.error({ err, jobId: job.id }, `Background cron job failed: ${err instanceof Error ? err.message : String(err)}`);\n    });\n    return reserved;\n  }\n\n  private async runSingleJob(job: JobData, opts?: { manual?: boolean }): Promise<void> {\n    const started = nowMs();\n    const runningSessionKey = resolveRunningSessionKey(job, this.deps);\n    const reserved: JobData = {\n      ...job,\n      state: { ...job.state, runningAtMs: started, ...(runningSessionKey ? { runningSessionKey } : {}) },\n    };\n    saveCronJob(reserved);\n    await this.runReservedJob(reserved, started, runningSessionKey, opts);\n  }\n\n  private async runReservedJob(\n    reserved: JobData,\n    started: number,\n    runningSessionKey: string | undefined,\n    opts?: { manual?: boolean },\n  ): Promise<void> {\n    const controller = new AbortController();\n    await this.executor.execute(\n      runningSessionKey ? { ...reserved, sessionKey: runningSessionKey } : reserved,\n      controller.signal,\n      this.deps,\n    );\n    const latestRun = (await this.getJobHistory(reserved.id, 1))[0];\n    const finished = nowMs();\n    const status = latestRun ? runStatusFromExecution(latestRun.status) : 'error';\n    const latest = getCronJob(reserved.id);\n    if (!latest) return;\n\n    const next: JobData = {\n      ...latest,\n      state: {\n        ...latest.state,\n        lastRunAtMs: finished,\n        lastRunStatus: status,\n        lastError: latestRun?.error,\n        lastDurationMs: finished - started,\n        consecutiveErrors: status === 'error' ? (latest.state.consecutiveErrors ?? 0) + 1 : 0,\n        consecutiveSkipped: status === 'skipped' ? (latest.state.consecutiveSkipped ?? 0) + 1 : 0,\n        lastDeliveryStatus: latest.delivery?.mode && latest.delivery.mode !== 'none' ? 'unknown' : 'not-requested',\n      },\n    };\n    delete next.state.runningAtMs;\n    delete next.state.runningSessionKey;\n    if (!opts?.manual && next.deleteAfterRun && status === 'ok') {\n      await this.removeJob(next.id);\n      return;\n    }\n    next.state.nextRunAtMs = computeNextRunAtMs(next, finished);\n    saveCronJob(next);\n    await this.maybeEmitFailureAlert(next);\n  }\n\n  private async maybeEmitFailureAlert(job: JobData): Promise<void> {\n    if (!job.failureAlert) return;\n    if (job.state.lastRunStatus !== 'error') return;\n    const threshold = job.failureAlert.after ?? 1;\n    if ((job.state.consecutiveErrors ?? 0) < threshold) return;\n    const ts = nowMs();\n    const cooldownMs = job.failureAlert.cooldownMs ?? 60 * 60_000;\n    if (job.state.lastFailureAlertAtMs && ts - job.state.lastFailureAlertAtMs < cooldownMs) return;\n    const channel = job.failureAlert.channel || job.delivery?.channel;\n    const to = job.failureAlert.to || job.delivery?.to;\n    if (!to) return;\n    if (job.failureAlert.mode === 'webhook') {\n      await postFailureWebhook(to, {\n        jobId: job.id,\n        jobName: job.name,\n        status: job.state.lastRunStatus,\n        error: job.state.lastError ?? 'Unknown error',\n        consecutiveErrors: job.state.consecutiveErrors ?? 0,\n        lastRunAtMs: job.state.lastRunAtMs,\n      });\n      job.state.lastFailureAlertAtMs = ts;\n      saveCronJob(job);\n      return;\n    }\n    if (!this.deps.messageBus || !channel) return;\n    await this.deps.messageBus.publishOutbound({\n      channel,\n      chat_id: to,\n      type: 'message',\n      content: `Cron job failed: ${job.name}\\n${job.state.lastError ?? 'Unknown error'}`,\n    });\n    job.state.lastFailureAlertAtMs = ts;\n    saveCronJob(job);\n  }\n}\n"],"mappings":"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"}

package/dist/src/cron/types.d.ts

@@ -2,12 +2,39 @@ import type { SessionStore } from '../session/store.js';
 import type { WorkflowRunInputEnvelope, WorkflowRunSource, WorkflowRunView } from '../workflows/domain/index.js';
 import type { StartWorkflowRunServiceParams, WorkflowRunServiceResult } from '../workflows/service/workflow-run-service.types.js';
 export type { CronRunHistoryRow, CronRunOutcome, CronRunStatus, CronUsageSummary, JobExecution, } from './execution-types.js';
-export type CronDeliveryMode = 'none' | 'announce' | 'direct';
+export type CronSchedule = {
+    kind: 'at';
+    at: string;
+} | {
+    kind: 'every';
+    everyMs: number;
+    anchorMs?: number;
+} | {
+    kind: 'cron';
+    expr: string;
+    tz?: string;
+    staggerMs?: number;
+};
+export type CronSessionTarget = 'main' | 'isolated' | 'current' | `session:${string}`;
+export type CronWakeMode = 'now' | 'next-heartbeat';
+export type CronDeliveryMode = 'none' | 'announce' | 'webhook';
 export interface CronDelivery {
     mode: CronDeliveryMode;
     channel?: string;
     to?: string;
+    accountId?: string;
+    threadId?: string | number;
     bestEffort?: boolean;
+    completionDestination?: {
+        mode: 'webhook';
+        to: string;
+    };
+    failureDestination?: {
+        mode?: 'announce' | 'webhook';
+        channel?: string;
+        to?: string;
+        accountId?: string;
+    };
 }
 export type CronPayload = {
     kind: 'systemEvent';
@@ -16,8 +43,16 @@ export type CronPayload = {
     kind: 'agentTurn';
     message: string;
     model?: string;
+    thinking?: string;
+    toolsAllow?: string[];
     timeoutSeconds?: number;
-} | CronWorkflowRunPayload;
+} | CronGoalContinuePayload | CronWorkflowRunPayload;
+export interface CronGoalContinuePayload {
+    kind: 'goalContinue';
+    goalId: string;
+    message?: string;
+    maxRetries?: number;
+}
 export interface CronWorkflowRunPayload {
     kind: 'workflowRun';
     definitionId: string;
@@ -26,46 +61,67 @@ export interface CronWorkflowRunPayload {
     goal?: string;
     agentId?: string;
     sessionKey?: string;
-    /** When true (default), cron waits for terminal workflow status before marking the job result. */
+    maxRetries?: number;
     waitForCompletion?: boolean;
     source?: Partial<Extract<WorkflowRunSource, {
         kind: 'cron';
     }>>;
 }
-export type CronSessionTarget = 'main' | 'isolated';
-export interface JobData {
-    id: string;
-    name?: string;
-    schedule: string;
-    enabled: boolean;
-    timezone?: string;
-    maxRetries: number;
-    timeout: number;
-    created_at: string;
-    updated_at: string;
-    sessionTarget?: CronSessionTarget;
-    /** When set, isolated agent runs use this agent id in the session key (multi-agent). */
-    agentId?: string;
-    /**
-     * Optional absolute workspace root for isolated agent runs (same semantics as chat working directory).
-     * Omit to use the effective agent profile default workspace.
-     */
-    workingDirectory?: string;
-    payload: CronPayload;
-    delivery?: CronDelivery;
-    model?: string;
-    state?: JobState;
+export type CronRunStatusValue = 'ok' | 'error' | 'skipped';
+export type CronDeliveryStatus = 'delivered' | 'not-delivered' | 'unknown' | 'not-requested';
+export interface CronFailureAlert {
+    after?: number;
+    cooldownMs?: number;
+    includeSkipped?: boolean;
+    mode?: 'announce' | 'webhook';
+    channel?: string;
+    to?: string;
+    accountId?: string;
 }
 export interface JobState {
     nextRunAtMs?: number;
     runningAtMs?: number;
+    runningSessionKey?: string;
     lastRunAtMs?: number;
-    lastStatus?: 'ok' | 'error' | 'skipped';
+    lastRunStatus?: CronRunStatusValue;
     lastError?: string;
     lastDurationMs?: number;
     consecutiveErrors?: number;
-    scheduleErrorCount?: number;
+    consecutiveSkipped?: number;
+    lastDeliveryStatus?: CronDeliveryStatus;
+    lastDeliveryError?: string;
+    lastFailureAlertAtMs?: number;
 }
+export interface JobData {
+    id: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    deleteAfterRun?: boolean;
+    createdAtMs: number;
+    updatedAtMs: number;
+    schedule: CronSchedule;
+    sessionTarget: CronSessionTarget;
+    wakeMode: CronWakeMode;
+    agentId?: string;
+    sessionKey?: string;
+    workingDirectory?: string;
+    payload: CronPayload;
+    delivery?: CronDelivery;
+    failureAlert?: CronFailureAlert | false;
+    state: JobState;
+}
+export type CronJobCreate = Omit<JobData, 'id' | 'createdAtMs' | 'updatedAtMs' | 'state' | 'enabled' | 'sessionTarget' | 'wakeMode' | 'name'> & {
+    id?: string;
+    name?: string;
+    enabled?: boolean;
+    sessionTarget?: CronSessionTarget;
+    wakeMode?: CronWakeMode;
+    state?: Partial<JobState>;
+};
+export type CronJobPatch = Partial<Omit<JobData, 'id' | 'createdAtMs' | 'updatedAtMs' | 'state'>> & {
+    state?: Partial<JobState>;
+};
 export interface CronWorkflowRunStarter {
     startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
     readWorkflowRunView?(agentId: string, runId: string): Promise<WorkflowRunView | null>;
@@ -74,7 +130,6 @@ export interface CronWorkflowRunStarter {
         runId: string;
     }): Promise<WorkflowRunServiceResult>;
 }
-/** Optional hook after a successful cron run (e.g. wake gateway heartbeat). */
 export interface HeartbeatWakeSink {
     requestNow(opts?: {
         reason?: string;
@@ -84,14 +139,21 @@ export interface JobExecutorDeps {
     agentService?: any;
     messageBus?: any;
     heartbeatService?: HeartbeatWakeSink;
-    /** When set, weixin cron `delivery.to` may be a bare ilink user id; accountId is inferred from sessions. */
     sessionStore?: SessionStore;
-    /**
-     * When a job has no `agentId`, isolated cron runs use this id for the session key
-     * (same as {@link JobData.agentId} set to the default agent). Typically `getDefaultAgentId(config)`.
-     */
     getDefaultCronAgentId?: () => string;
     workflowRunService?: CronWorkflowRunStarter;
+    goalRunner?: {
+        enqueue(goalId: string, options?: {
+            message?: string;
+            maxRetries?: number;
+            source?: 'api' | 'cron' | 'workflow' | 'system';
+        }): {
+            id: string;
+            goalId: string;
+            status: string;
+            sessionKey?: string;
+        };
+    };
 }
 export interface JobExecutor {
     execute(job: JobData, signal: AbortSignal, deps?: JobExecutorDeps): Promise<void>;
@@ -113,21 +175,7 @@ export interface CronHealth {
     issues: string[];
     lastError?: string;
 }
-export interface AddJobOptions {
-    name?: string;
-    timezone?: string;
-    maxRetries?: number;
-    timeout?: number;
-    sessionTarget?: CronSessionTarget;
-    agentId?: string;
-    workingDirectory?: string;
-    payload: CronPayload;
-    delivery?: CronDelivery;
-    model?: string;
-}
-export interface JobWithNextRun extends Omit<JobData, 'created_at' | 'updated_at' | 'state'> {
-    next_run?: string;
-}
+export type AddJobOptions = CronJobCreate;
 export interface JobHistoryQuery {
     jobId: string;
     limit?: number;