@roackb2/heddle 0.0.10 → 0.0.13

package/dist/src/runtime/heartbeat-lucid.d.ts

@@ -0,0 +1,42 @@
+import type { HeartbeatSchedulerEvent, HeartbeatTaskStatus } from './heartbeat-scheduler.js';
+import type { HeartbeatRunView, HeartbeatTaskView } from './heartbeat-views.js';
+export type LucidAgentStatus = 'running' | 'paused' | 'asleep' | 'terminated' | 'blocked' | 'failed';
+export type LucidAgentStatusNotification = {
+    agent_id: string;
+    status: string;
+    timestamp: string;
+};
+export type LucidAgentProgressNotification = {
+    agent_id: string;
+    progress: string;
+    timestamp: string;
+};
+export type LucidAgentResponseNotification = {
+    agent_id: string;
+    response: string;
+    timestamp: string;
+};
+export type LucidAgentMessage = {
+    event: 'agent_status';
+    data: {
+        status: LucidAgentStatusNotification;
+    };
+} | {
+    event: 'agent_progress';
+    data: {
+        progress: LucidAgentProgressNotification;
+    };
+} | {
+    event: 'agent_response';
+    data: {
+        response: LucidAgentResponseNotification;
+    };
+};
+export type LucidAdapterOptions = {
+    taskIdToAgentId?: (taskId: string) => string;
+};
+export declare function heartbeatTaskStatusToLucidStatus(status: HeartbeatTaskStatus): LucidAgentStatus;
+export declare function heartbeatTaskViewToLucidMessages(task: HeartbeatTaskView, options?: LucidAdapterOptions): LucidAgentMessage[];
+export declare function heartbeatRunViewToLucidMessages(run: HeartbeatRunView, options?: LucidAdapterOptions): LucidAgentMessage[];
+export declare function heartbeatSchedulerEventToLucidMessages(event: HeartbeatSchedulerEvent, options?: LucidAdapterOptions): LucidAgentMessage[];
+//# sourceMappingURL=heartbeat-lucid.d.ts.map

package/dist/src/runtime/heartbeat-lucid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-lucid.d.ts","sourceRoot":"","sources":["../../../src/runtime/heartbeat-lucid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErG,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE;QAAE,MAAM,EAAE,4BAA4B,CAAA;KAAE,CAAA;CAAE,GACzE;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GAC/E;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,CAc9F;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,EAAE,CA2CrB;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,EAAE,CAyCrB;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,EAAE,CA0FrB"}

package/dist/src/runtime/heartbeat-lucid.js

@@ -0,0 +1,188 @@
+export function heartbeatTaskStatusToLucidStatus(status) {
+    switch (status) {
+        case 'running':
+            return 'running';
+        case 'waiting':
+        case 'idle':
+            return 'asleep';
+        case 'complete':
+            return 'terminated';
+        case 'blocked':
+            return 'blocked';
+        case 'failed':
+            return 'failed';
+    }
+}
+export function heartbeatTaskViewToLucidMessages(task, options = {}) {
+    const agentId = resolveAgentId(task.taskId, options);
+    const timestamp = task.lastRunAt ?? task.nextRunAt ?? new Date().toISOString();
+    const messages = [
+        {
+            event: 'agent_status',
+            data: {
+                status: {
+                    agent_id: agentId,
+                    status: heartbeatTaskStatusToLucidStatus(task.status),
+                    timestamp,
+                },
+            },
+        },
+    ];
+    if (task.progress) {
+        messages.push({
+            event: 'agent_progress',
+            data: {
+                progress: {
+                    agent_id: agentId,
+                    progress: task.progress,
+                    timestamp,
+                },
+            },
+        });
+    }
+    if (task.summary) {
+        messages.push({
+            event: 'agent_response',
+            data: {
+                response: {
+                    agent_id: agentId,
+                    response: task.summary,
+                    timestamp,
+                },
+            },
+        });
+    }
+    return messages;
+}
+export function heartbeatRunViewToLucidMessages(run, options = {}) {
+    const agentId = resolveAgentId(run.taskId, options);
+    const timestamp = run.createdAt;
+    const messages = [
+        {
+            event: 'agent_status',
+            data: {
+                status: {
+                    agent_id: agentId,
+                    status: heartbeatTaskStatusToLucidStatus(run.status),
+                    timestamp,
+                },
+            },
+        },
+    ];
+    if (run.progress) {
+        messages.push({
+            event: 'agent_progress',
+            data: {
+                progress: {
+                    agent_id: agentId,
+                    progress: run.progress,
+                    timestamp,
+                },
+            },
+        });
+    }
+    messages.push({
+        event: 'agent_response',
+        data: {
+            response: {
+                agent_id: agentId,
+                response: run.summary,
+                timestamp,
+            },
+        },
+    });
+    return messages;
+}
+export function heartbeatSchedulerEventToLucidMessages(event, options = {}) {
+    if (event.type === 'heartbeat.scheduler.started' || event.type === 'heartbeat.scheduler.stopped') {
+        return [];
+    }
+    const agentId = resolveAgentId(event.taskId, options);
+    switch (event.type) {
+        case 'heartbeat.task.due':
+            return [];
+        case 'heartbeat.task.started':
+            return [
+                {
+                    event: 'agent_status',
+                    data: {
+                        status: {
+                            agent_id: agentId,
+                            status: heartbeatTaskStatusToLucidStatus(event.status),
+                            timestamp: event.timestamp,
+                        },
+                    },
+                },
+                {
+                    event: 'agent_progress',
+                    data: {
+                        progress: {
+                            agent_id: agentId,
+                            progress: event.progress,
+                            timestamp: event.timestamp,
+                        },
+                    },
+                },
+            ];
+        case 'heartbeat.task.finished':
+            return [
+                {
+                    event: 'agent_status',
+                    data: {
+                        status: {
+                            agent_id: agentId,
+                            status: heartbeatTaskStatusToLucidStatus(event.status),
+                            timestamp: event.timestamp,
+                        },
+                    },
+                },
+                {
+                    event: 'agent_progress',
+                    data: {
+                        progress: {
+                            agent_id: agentId,
+                            progress: event.progress,
+                            timestamp: event.timestamp,
+                        },
+                    },
+                },
+                {
+                    event: 'agent_response',
+                    data: {
+                        response: {
+                            agent_id: agentId,
+                            response: event.summary,
+                            timestamp: event.timestamp,
+                        },
+                    },
+                },
+            ];
+        case 'heartbeat.task.failed':
+            return [
+                {
+                    event: 'agent_status',
+                    data: {
+                        status: {
+                            agent_id: agentId,
+                            status: heartbeatTaskStatusToLucidStatus(event.status),
+                            timestamp: event.timestamp,
+                        },
+                    },
+                },
+                {
+                    event: 'agent_progress',
+                    data: {
+                        progress: {
+                            agent_id: agentId,
+                            progress: `${event.progress}${event.error ? ` Error: ${event.error}` : ''}`,
+                            timestamp: event.timestamp,
+                        },
+                    },
+                },
+            ];
+    }
+}
+function resolveAgentId(taskId, options) {
+    return options.taskIdToAgentId?.(taskId) ?? taskId;
+}
+//# sourceMappingURL=heartbeat-lucid.js.map

package/dist/src/runtime/heartbeat-lucid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-lucid.js","sourceRoot":"","sources":["../../../src/runtime/heartbeat-lucid.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/heartbeat-scheduler.d.ts

@@ -0,0 +1,124 @@
+import type { AgentHeartbeatResult, HeartbeatDecision, RunAgentHeartbeatOptions } from './heartbeat.js';
+import type { AgentLoopCheckpoint, AgentLoopState } from './events.js';
+import type { LlmUsage } from '../llm/types.js';
+export type HeartbeatTask = {
+    id: string;
+    task: string;
+    name?: string;
+    enabled: boolean;
+    intervalMs: number;
+    nextRunAt?: string;
+    checkpointPath?: string;
+    model?: string;
+    maxSteps?: number;
+    workspaceRoot?: string;
+    stateDir?: string;
+    memoryDir?: string;
+    searchIgnoreDirs?: string[];
+    systemContext?: string;
+    lastRunAt?: string;
+    status?: HeartbeatTaskStatus;
+    lastProgress?: string;
+    lastRunId?: string;
+    lastLoadedCheckpoint?: boolean;
+    resumable?: boolean;
+    lastUsage?: LlmUsage;
+    lastDecision?: HeartbeatDecision;
+    lastOutcome?: string;
+    lastSummary?: string;
+    lastError?: string;
+    updatedAt?: string;
+};
+export type HeartbeatTaskStatus = 'idle' | 'running' | 'waiting' | 'blocked' | 'complete' | 'failed';
+export type HeartbeatTaskRunRecord = {
+    task: HeartbeatTask;
+    result: AgentHeartbeatResult;
+    loadedCheckpoint: boolean;
+};
+export type HeartbeatTaskRunRecordEntry = {
+    id: string;
+    path: string;
+    taskId: string;
+    runId: string;
+    createdAt: string;
+    record: HeartbeatTaskRunRecord;
+};
+export type HeartbeatTaskStore = {
+    listTasks: () => Promise<HeartbeatTask[]>;
+    saveTask: (task: HeartbeatTask) => Promise<void>;
+    loadCheckpoint: (task: HeartbeatTask) => Promise<AgentLoopCheckpoint | undefined>;
+    saveCheckpoint: (task: HeartbeatTask, checkpoint: AgentLoopCheckpoint) => Promise<void>;
+    saveRunRecord?: (record: HeartbeatTaskRunRecord) => Promise<void>;
+    listRunRecords?: (options?: {
+        taskId?: string;
+        limit?: number;
+    }) => Promise<HeartbeatTaskRunRecordEntry[]>;
+    loadRunRecord?: (id: string) => Promise<HeartbeatTaskRunRecordEntry | undefined>;
+};
+export type FileHeartbeatTaskStoreOptions = {
+    dir: string;
+};
+export type HeartbeatSchedulerEvent = {
+    type: 'heartbeat.scheduler.started';
+    timestamp: string;
+} | {
+    type: 'heartbeat.scheduler.stopped';
+    reason: 'aborted' | 'completed' | 'error';
+    timestamp: string;
+} | {
+    type: 'heartbeat.task.due';
+    taskId: string;
+    timestamp: string;
+} | {
+    type: 'heartbeat.task.started';
+    taskId: string;
+    loadedCheckpoint: boolean;
+    status: HeartbeatTaskStatus;
+    progress: string;
+    timestamp: string;
+} | {
+    type: 'heartbeat.task.finished';
+    taskId: string;
+    decision: HeartbeatDecision;
+    outcome: string;
+    status: HeartbeatTaskStatus;
+    progress: string;
+    summary: string;
+    runId: string;
+    usage?: LlmUsage;
+    nextRunAt?: string;
+    enabled: boolean;
+    timestamp: string;
+} | {
+    type: 'heartbeat.task.failed';
+    taskId: string;
+    error: string;
+    status: HeartbeatTaskStatus;
+    progress: string;
+    nextRunAt?: string;
+    timestamp: string;
+};
+export type HeartbeatTaskRunner = (task: HeartbeatTask, checkpoint: AgentLoopState | AgentLoopCheckpoint | undefined) => Promise<AgentHeartbeatResult>;
+export type RunDueHeartbeatTasksOptions = {
+    store: HeartbeatTaskStore;
+    runner?: HeartbeatTaskRunner;
+    heartbeat?: Omit<RunAgentHeartbeatOptions, 'task' | 'checkpoint'>;
+    now?: () => Date;
+    onEvent?: (event: HeartbeatSchedulerEvent) => void;
+    failureRetryMs?: number;
+};
+export type RunDueHeartbeatTasksResult = {
+    checked: number;
+    ran: number;
+    failed: number;
+    records: HeartbeatTaskRunRecord[];
+};
+export type RunHeartbeatSchedulerOptions = RunDueHeartbeatTasksOptions & {
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+};
+export declare function createFileHeartbeatTaskStore(options: FileHeartbeatTaskStoreOptions): HeartbeatTaskStore;
+export declare function runDueHeartbeatTasks(options: RunDueHeartbeatTasksOptions): Promise<RunDueHeartbeatTasksResult>;
+export declare function runHeartbeatScheduler(options: RunHeartbeatSchedulerOptions): Promise<void>;
+//# sourceMappingURL=heartbeat-scheduler.d.ts.map

package/dist/src/runtime/heartbeat-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-scheduler.d.ts","sourceRoot":"","sources":["../../../src/runtime/heartbeat-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/heartbeat-scheduler.js

@@ -0,0 +1,306 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { runAgentHeartbeat } from './heartbeat.js';
+import { suggestNextHeartbeatDelayMs } from './heartbeat-store.js';
+const DEFAULT_FAILURE_RETRY_MS = 5 * 60_000;
+export function createFileHeartbeatTaskStore(options) {
+    const tasksDir = join(options.dir, 'tasks');
+    const checkpointsDir = join(options.dir, 'checkpoints');
+    const runsDir = join(options.dir, 'runs');
+    return {
+        async listTasks() {
+            if (!existsSync(tasksDir)) {
+                return [];
+            }
+            return readdirSync(tasksDir)
+                .filter((entry) => entry.endsWith('.json'))
+                .map((entry) => JSON.parse(readFileSync(join(tasksDir, entry), 'utf8')))
+                .sort((left, right) => left.id.localeCompare(right.id));
+        },
+        async saveTask(task) {
+            const path = join(tasksDir, `${safeTaskFileName(task.id)}.json`);
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, JSON.stringify(normalizeTaskForSave(task), null, 2));
+        },
+        async loadCheckpoint(task) {
+            const path = checkpointPathForTask(task, checkpointsDir);
+            if (!existsSync(path)) {
+                return undefined;
+            }
+            return JSON.parse(readFileSync(path, 'utf8'));
+        },
+        async saveCheckpoint(task, checkpoint) {
+            const path = checkpointPathForTask(task, checkpointsDir);
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, JSON.stringify(checkpoint, null, 2));
+        },
+        async saveRunRecord(record) {
+            const timestamp = new Date().toISOString().replaceAll(':', '-');
+            const path = join(runsDir, `${timestamp}-${safeTaskFileName(record.task.id)}.json`);
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, JSON.stringify(record, null, 2));
+        },
+        async listRunRecords(options = {}) {
+            if (!existsSync(runsDir)) {
+                return [];
+            }
+            const entries = readdirSync(runsDir)
+                .filter((entry) => entry.endsWith('.json'))
+                .flatMap((entry) => {
+                const path = join(runsDir, entry);
+                try {
+                    const record = JSON.parse(readFileSync(path, 'utf8'));
+                    if (options.taskId && record.task.id !== options.taskId) {
+                        return [];
+                    }
+                    return [runRecordEntryFromPath(path, record)];
+                }
+                catch {
+                    return [];
+                }
+            })
+                .sort((left, right) => right.createdAt.localeCompare(left.createdAt));
+            return options.limit ? entries.slice(0, options.limit) : entries;
+        },
+        async loadRunRecord(id) {
+            const entries = await this.listRunRecords?.();
+            return entries?.find((entry) => entry.id === id || entry.runId === id);
+        },
+    };
+}
+export async function runDueHeartbeatTasks(options) {
+    const now = options.now?.() ?? new Date();
+    const tasks = await options.store.listTasks();
+    const dueTasks = tasks.filter((task) => isTaskDue(task, now));
+    const records = [];
+    let failed = 0;
+    for (const task of dueTasks) {
+        options.onEvent?.({ type: 'heartbeat.task.due', taskId: task.id, timestamp: now.toISOString() });
+        try {
+            const checkpoint = await options.store.loadCheckpoint(task);
+            const runningTask = normalizeTaskForSave({
+                ...task,
+                status: 'running',
+                lastProgress: checkpoint ?
+                    'Resuming heartbeat wake from the last checkpoint.'
+                    : 'Starting a new heartbeat wake cycle.',
+                lastLoadedCheckpoint: Boolean(checkpoint),
+                lastError: undefined,
+                updatedAt: now.toISOString(),
+            });
+            await options.store.saveTask(runningTask);
+            options.onEvent?.({
+                type: 'heartbeat.task.started',
+                taskId: task.id,
+                loadedCheckpoint: Boolean(checkpoint),
+                status: runningTask.status ?? 'running',
+                progress: runningTask.lastProgress ?? '',
+                timestamp: now.toISOString(),
+            });
+            const result = await runHeartbeatTask(task, checkpoint, options);
+            await options.store.saveCheckpoint(task, result.checkpoint);
+            const nextTask = updateTaskAfterResult(task, result, now, Boolean(checkpoint));
+            await options.store.saveTask(nextTask);
+            const record = { task: nextTask, result, loadedCheckpoint: Boolean(checkpoint) };
+            await options.store.saveRunRecord?.(record);
+            records.push(record);
+            options.onEvent?.({
+                type: 'heartbeat.task.finished',
+                taskId: task.id,
+                decision: result.decision,
+                outcome: result.state.outcome,
+                status: nextTask.status ?? 'waiting',
+                progress: nextTask.lastProgress ?? '',
+                summary: result.summary,
+                runId: result.state.runId,
+                usage: result.state.usage,
+                nextRunAt: nextTask.nextRunAt,
+                enabled: nextTask.enabled,
+                timestamp: now.toISOString(),
+            });
+        }
+        catch (error) {
+            failed++;
+            const nextTask = updateTaskAfterFailure(task, error, now, options.failureRetryMs ?? DEFAULT_FAILURE_RETRY_MS);
+            await options.store.saveTask(nextTask);
+            options.onEvent?.({
+                type: 'heartbeat.task.failed',
+                taskId: task.id,
+                error: error instanceof Error ? error.message : String(error),
+                status: nextTask.status ?? 'failed',
+                progress: nextTask.lastProgress ?? '',
+                nextRunAt: nextTask.nextRunAt,
+                timestamp: now.toISOString(),
+            });
+        }
+    }
+    return {
+        checked: tasks.length,
+        ran: records.length,
+        failed,
+        records,
+    };
+}
+export async function runHeartbeatScheduler(options) {
+    options.onEvent?.({ type: 'heartbeat.scheduler.started', timestamp: (options.now?.() ?? new Date()).toISOString() });
+    try {
+        while (!options.signal?.aborted) {
+            await runDueHeartbeatTasks(options);
+            await (options.sleep ?? sleep)(options.pollIntervalMs ?? 60_000, options.signal);
+        }
+        options.onEvent?.({ type: 'heartbeat.scheduler.stopped', reason: 'aborted', timestamp: (options.now?.() ?? new Date()).toISOString() });
+    }
+    catch (error) {
+        if (options.signal?.aborted) {
+            options.onEvent?.({ type: 'heartbeat.scheduler.stopped', reason: 'aborted', timestamp: (options.now?.() ?? new Date()).toISOString() });
+            return;
+        }
+        options.onEvent?.({ type: 'heartbeat.scheduler.stopped', reason: 'error', timestamp: (options.now?.() ?? new Date()).toISOString() });
+        throw error;
+    }
+}
+function isTaskDue(task, now) {
+    if (!task.enabled) {
+        return false;
+    }
+    if (!task.nextRunAt) {
+        return true;
+    }
+    const nextRunAt = Date.parse(task.nextRunAt);
+    return Number.isFinite(nextRunAt) && nextRunAt <= now.getTime();
+}
+async function runHeartbeatTask(task, checkpoint, options) {
+    if (options.runner) {
+        return options.runner(task, checkpoint);
+    }
+    return runAgentHeartbeat({
+        ...options.heartbeat,
+        task: task.task,
+        checkpoint,
+        model: task.model ?? options.heartbeat?.model,
+        maxSteps: task.maxSteps ?? options.heartbeat?.maxSteps,
+        workspaceRoot: task.workspaceRoot ?? options.heartbeat?.workspaceRoot,
+        stateDir: task.stateDir ?? options.heartbeat?.stateDir,
+        memoryDir: task.memoryDir ?? options.heartbeat?.memoryDir,
+        searchIgnoreDirs: task.searchIgnoreDirs ?? options.heartbeat?.searchIgnoreDirs,
+        systemContext: task.systemContext ?? options.heartbeat?.systemContext,
+    });
+}
+function updateTaskAfterResult(task, result, now, loadedCheckpoint) {
+    const terminal = result.decision === 'complete' || result.decision === 'escalate';
+    const delayMs = terminal ? undefined
+        : result.decision === 'continue' ? task.intervalMs
+            : suggestNextHeartbeatDelayMs(result.decision) ?? task.intervalMs;
+    const projection = projectionForResult(result, delayMs);
+    return normalizeTaskForSave({
+        ...task,
+        enabled: terminal ? false : task.enabled,
+        status: projection.status,
+        lastProgress: projection.progress,
+        nextRunAt: delayMs === undefined ? undefined : new Date(now.getTime() + delayMs).toISOString(),
+        lastRunAt: now.toISOString(),
+        lastRunId: result.state.runId,
+        lastLoadedCheckpoint: loadedCheckpoint,
+        resumable: result.decision !== 'complete',
+        lastUsage: result.state.usage,
+        lastDecision: result.decision,
+        lastOutcome: result.state.outcome,
+        lastSummary: result.summary,
+        lastError: undefined,
+        updatedAt: now.toISOString(),
+    });
+}
+function updateTaskAfterFailure(task, error, now, retryMs) {
+    return normalizeTaskForSave({
+        ...task,
+        status: 'failed',
+        lastProgress: 'Heartbeat wake failed and will retry later.',
+        nextRunAt: new Date(now.getTime() + retryMs).toISOString(),
+        lastRunAt: now.toISOString(),
+        lastError: error instanceof Error ? error.message : String(error),
+        updatedAt: now.toISOString(),
+    });
+}
+function normalizeTaskForSave(task) {
+    return {
+        ...task,
+        intervalMs: Math.max(1, Math.trunc(task.intervalMs)),
+        status: task.status ?? 'idle',
+    };
+}
+function checkpointPathForTask(task, checkpointsDir) {
+    return task.checkpointPath ?? join(checkpointsDir, `${safeTaskFileName(task.id)}.json`);
+}
+function safeTaskFileName(id) {
+    if (!/^[a-zA-Z0-9._-]+$/.test(id)) {
+        throw new Error(`Invalid heartbeat task id "${id}". Use only letters, numbers, dots, underscores, and hyphens.`);
+    }
+    return id;
+}
+function projectionForResult(result, delayMs) {
+    switch (result.decision) {
+        case 'continue':
+            return {
+                status: 'waiting',
+                progress: delayMs === undefined ?
+                    'Heartbeat wake finished.'
+                    : `Heartbeat wake finished. Waiting until the next scheduled run in ${formatDelay(delayMs)}.`,
+            };
+        case 'pause':
+            return {
+                status: 'waiting',
+                progress: delayMs === undefined ?
+                    'Heartbeat paused.'
+                    : `Heartbeat paused. Waiting ${formatDelay(delayMs)} before the next wake.`,
+            };
+        case 'complete':
+            return {
+                status: 'complete',
+                progress: 'Heartbeat task completed and will not wake again.',
+            };
+        case 'escalate':
+            return {
+                status: 'blocked',
+                progress: 'Heartbeat escalated for user input and is waiting for follow-up.',
+            };
+    }
+}
+function formatDelay(ms) {
+    if (ms % (24 * 60 * 60_000) === 0) {
+        return `${ms / (24 * 60 * 60_000)}d`;
+    }
+    if (ms % (60 * 60_000) === 0) {
+        return `${ms / (60 * 60_000)}h`;
+    }
+    if (ms % 60_000 === 0) {
+        return `${ms / 60_000}m`;
+    }
+    if (ms % 1_000 === 0) {
+        return `${ms / 1_000}s`;
+    }
+    return `${ms}ms`;
+}
+function runRecordEntryFromPath(path, record) {
+    const id = basename(path, '.json');
+    return {
+        id,
+        path,
+        taskId: record.task.id,
+        runId: record.result.state.runId,
+        createdAt: record.result.state.finishedAt,
+        record,
+    };
+}
+function sleep(ms, signal) {
+    if (signal?.aborted) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        const timeout = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timeout);
+            resolve();
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=heartbeat-scheduler.js.map