Schedules API

// List schedules and show when each will next fire
const schedules: Schedule[] = await fetch('/api/schedules').then(r => r.json());

const active = schedules.filter(s => s.status === 'active');
active.forEach(s => {
const next = s.nextFireAt ? new Date(s.nextFireAt).toLocaleString() : 'none';
console.log(`${s.name} — next: ${next} (fired ${s.firingCount}x)`);
});

// Create a schedule with natural language interval
const schedule: Schedule = await fetch('/api/schedules', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
  name: 'Daily standup summary',
  prompt: 'Review all open tasks, summarize blockers, and draft a standup message',
  interval: 'every weekday at 9am',
  projectId: 'proj-8f3a-4b2c',
  assignedAgent: 'claude-code',
  agentProfile: 'project-manager',
}),
}).then(r => r.json());

console.log(schedule.cronExpression); // "0 9 * * 1-5"
console.log(schedule.nextFireAt);     // "2026-04-04T09:00:00.000Z"

const heartbeat: Schedule = await fetch('/api/schedules', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
  name: 'Production health check',
  type: 'heartbeat',
  interval: '30m',
  assignedAgent: 'claude-code',
  agentProfile: 'devops-engineer',
  heartbeatChecklist: [
    { id: 'uptime', instruction: 'Check that all API endpoints return 200', priority: 1 },
    { id: 'errors', instruction: 'Check error rate is below 1%', priority: 1 },
    { id: 'latency', instruction: 'Check P95 latency is under 500ms', priority: 2 },
  ],
  activeHoursStart: 8,
  activeHoursEnd: 22,
  activeTimezone: 'America/New_York',
  heartbeatBudgetPerDay: 5.00,
}),
}).then(r => r.json());

// Get schedule detail with full firing history
const schedule: ScheduleDetail = await fetch('/api/schedules/sched-e7b2-1f4a')
.then(r => r.json());

console.log(`${schedule.name} — ${schedule.firingCount} firings`);

// Show recent firing results
schedule.firingHistory.slice(0, 5).forEach(task => {
console.log(`  [${task.status}] ${task.title} — ${new Date(task.createdAt).toLocaleDateString()}`);
});

// Pause a schedule — nextFireAt becomes null
await fetch('/api/schedules/sched-e7b2-1f4a', {
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ status: 'paused' }),
});

// Later, resume it — nextFireAt is recomputed
await fetch('/api/schedules/sched-e7b2-1f4a', {
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ status: 'active' }),
});

// Delete a schedule — child tasks remain intact
await fetch('/api/schedules/sched-e7b2-1f4a', { method: 'DELETE' });

// Preview different interval formats before creating a schedule
const formats: string[] = ['every weekday at 9am', '30m', '0 */4 * * *'];

for (const expression of formats) {
const result: ParseResult = await fetch('/api/schedules/parse', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ expression }),
}).then(r => r.json());

console.log(`"${expression}" → ${result.cronExpression}`);
console.log(`  ${result.description} (confidence: ${result.confidence})`);
console.log(`  Next: ${result.nextFireTimes[0]}`);
}

// Review heartbeat history to tune monitoring sensitivity
const { history, stats }: HeartbeatHistory = await fetch('/api/schedules/sched-hb-3c9d/heartbeat-history')
.then(r => r.json());

// Calculate suppression ratio
const ratio: number = stats.suppressionCount / stats.firingCount;
console.log(`Action rate: ${((1 - ratio) * 100).toFixed(0)}%`);
console.log(`Budget: $${stats.heartbeatSpentToday.toFixed(2)} / $${stats.heartbeatBudgetPerDay?.toFixed(2) ?? 'unlimited'}`);

// Show recent entries
history.slice(0, 5).forEach(entry => {
const icon = entry.event === 'heartbeat_action' ? 'ACT' : 'SKIP';
console.log(`  [${icon}] ${new Date(entry.timestamp).toLocaleTimeString()}`);
});