@roackb2/heddle 1.3.0 → 1.5.0

package/dist/src/core/heartbeat/scheduler/runner.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Heartbeat task runner service.
+ *
+ * Translates durable task settings into one wake-service request. Task runtime
+ * overrides intentionally share the wake-service vocabulary so this boundary
+ * only adds the durable task text and checkpoint.
+ */
+import type { AgentLoopCheckpoint, AgentLoopState } from '../../../core/runtime/loop/index.js';
+import type { AgentHeartbeatResult, RunAgentHeartbeatOptions } from '../wake/index.js';
+import type { HeartbeatTask } from '../tasks/index.js';
+export declare class HeartbeatTaskRunnerService {
+    static run(args: {
+        task: HeartbeatTask;
+        checkpoint: AgentLoopState | AgentLoopCheckpoint | undefined;
+        heartbeat?: Omit<RunAgentHeartbeatOptions, 'task' | 'checkpoint'>;
+    }): Promise<AgentHeartbeatResult>;
+    private static resolveRuntime;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/core/heartbeat/scheduler/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/scheduler/runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAExF,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,qBAAa,0BAA0B;WACxB,GAAG,CAAC,IAAI,EAAE;QACrB,IAAI,EAAE,aAAa,CAAC;QACpB,UAAU,EAAE,cAAc,GAAG,mBAAmB,GAAG,SAAS,CAAC;QAC7D,SAAS,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC;KACnE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAKjC,OAAO,CAAC,MAAM,CAAC,cAAc;CAY9B"}

package/dist/src/core/heartbeat/scheduler/runner.js

@@ -0,0 +1,16 @@
+import { HeartbeatWakeService } from '../wake/index.js';
+export class HeartbeatTaskRunnerService {
+    static async run(args) {
+        const runtime = HeartbeatTaskRunnerService.resolveRuntime(args);
+        return await HeartbeatWakeService.run(runtime);
+    }
+    static resolveRuntime(args) {
+        return {
+            ...args.heartbeat,
+            ...args.task.runtime,
+            task: args.task.task,
+            checkpoint: args.checkpoint,
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/src/core/heartbeat/scheduler/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/scheduler/runner.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIxD,MAAM,OAAO,0BAA0B;IACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAIhB;QACC,MAAM,OAAO,GAAG,0BAA0B,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO,MAAM,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,IAI7B;QACC,OAAO;YACL,GAAG,IAAI,CAAC,SAAS;YACjB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/heartbeat/scheduler/service.d.ts

@@ -0,0 +1,8 @@
+import type { RunDueHeartbeatTasksOptions, RunDueHeartbeatTasksResult, RunHeartbeatSchedulerOptions } from './types.js';
+export declare class HeartbeatSchedulerService {
+    static runDueTasks(options: RunDueHeartbeatTasksOptions): Promise<RunDueHeartbeatTasksResult>;
+    static runLoop(options: RunHeartbeatSchedulerOptions): Promise<void>;
+    private static isTaskDue;
+    private static sleep;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/src/core/heartbeat/scheduler/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/scheduler/service.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAIpB,qBAAa,yBAAyB;WACvB,WAAW,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,0BAA0B,CAAC;WA4EtF,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB1E,OAAO,CAAC,MAAM,CAAC,SAAS;IAaxB,OAAO,CAAC,MAAM,CAAC,KAAK;CAarB"}

package/dist/src/core/heartbeat/scheduler/service.js

@@ -0,0 +1,125 @@
+/**
+ * Heartbeat scheduler service.
+ *
+ * Owns due-task selection, scheduler lifecycle events, checkpoint persistence,
+ * task state projection, and run-record persistence.
+ */
+import { HeartbeatTaskStateProjector } from '../tasks/index.js';
+import { HeartbeatTaskRunnerService } from './runner.js';
+const DEFAULT_FAILURE_RETRY_MS = 5 * 60_000;
+export class HeartbeatSchedulerService {
+    static async runDueTasks(options) {
+        const now = options.now?.() ?? new Date();
+        const tasks = await options.store.listTasks();
+        const dueTasks = tasks.filter((task) => HeartbeatSchedulerService.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 loadedCheckpoint = Boolean(checkpoint);
+                const runningTask = HeartbeatTaskStateProjector.markRunning({
+                    task,
+                    now,
+                    loadedCheckpoint,
+                });
+                await options.store.saveTask(runningTask);
+                options.onEvent?.({
+                    type: 'heartbeat.task.started',
+                    taskId: task.id,
+                    loadedCheckpoint,
+                    status: runningTask.state?.status ?? 'running',
+                    progress: runningTask.state?.progress ?? '',
+                    timestamp: now.toISOString(),
+                });
+                const result = options.runner ?
+                    await options.runner(task, checkpoint)
+                    : await HeartbeatTaskRunnerService.run({ task, checkpoint, heartbeat: options.heartbeat });
+                await options.store.saveCheckpoint(task, result.checkpoint);
+                const nextTask = HeartbeatTaskStateProjector.afterResult({
+                    task,
+                    result,
+                    now,
+                    loadedCheckpoint,
+                });
+                await options.store.saveTask(nextTask);
+                const record = { task: nextTask, result, loadedCheckpoint };
+                await options.store.saveRunRecord?.(record);
+                records.push(record);
+                options.onEvent?.({
+                    type: 'heartbeat.task.finished',
+                    taskId: task.id,
+                    record,
+                    timestamp: now.toISOString(),
+                });
+            }
+            catch (error) {
+                failed++;
+                const nextTask = HeartbeatTaskStateProjector.afterFailure({
+                    task,
+                    error,
+                    now,
+                    retryMs: 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.state?.status ?? 'failed',
+                    progress: nextTask.state?.progress ?? '',
+                    nextRunAt: nextTask.schedule.nextRunAt,
+                    timestamp: now.toISOString(),
+                });
+            }
+        }
+        return {
+            checked: tasks.length,
+            ran: records.length,
+            failed,
+            records,
+        };
+    }
+    static async runLoop(options) {
+        options.onEvent?.({ type: 'heartbeat.scheduler.started', timestamp: (options.now?.() ?? new Date()).toISOString() });
+        try {
+            while (!options.signal?.aborted) {
+                await HeartbeatSchedulerService.runDueTasks(options);
+                await (options.sleep ?? HeartbeatSchedulerService.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;
+        }
+    }
+    static isTaskDue(task, now) {
+        if (!task.enabled) {
+            return false;
+        }
+        if (!task.schedule.nextRunAt) {
+            return true;
+        }
+        const nextRunAt = Date.parse(task.schedule.nextRunAt);
+        return Number.isFinite(nextRunAt) && nextRunAt <= now.getTime();
+    }
+    static 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=service.js.map

package/dist/src/core/heartbeat/scheduler/service.js.map

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

package/dist/src/core/{runtime/heartbeat-scheduler.d.ts → heartbeat/scheduler/types.d.ts}

@@ -1,9 +1,6 @@
-import type { AgentHeartbeatResult, HeartbeatDecision, RunAgentHeartbeatOptions } from './heartbeat.js';
-import type { AgentLoopCheckpoint, AgentLoopState } from './events.js';
-import type { LlmUsage } from '../llm/types.js';
-import type { HeartbeatTask, HeartbeatTaskRunRecord, HeartbeatTaskStore, HeartbeatTaskStatus } from './heartbeat-task-store.js';
-export { createFileHeartbeatTaskStore, } from './heartbeat-task-store.js';
-export type { FileHeartbeatTaskStoreOptions, HeartbeatTask, HeartbeatTaskRunRecord, HeartbeatTaskRunRecordEntry, HeartbeatTaskStore, HeartbeatTaskStatus, } from './heartbeat-task-store.js';
+import type { AgentLoopCheckpoint, AgentLoopState } from '../../../core/runtime/loop/index.js';
+import type { AgentHeartbeatResult, RunAgentHeartbeatOptions } from '../wake/index.js';
+import type { HeartbeatTask, HeartbeatTaskRunRecord, HeartbeatTaskStatus, HeartbeatTaskStore } from '../tasks/index.js';
 export type HeartbeatSchedulerEvent = {
     type: 'heartbeat.scheduler.started';
     timestamp: string;
@@ -25,15 +22,7 @@ export type HeartbeatSchedulerEvent = {
 } | {
     type: 'heartbeat.task.finished';
     taskId: string;
-    decision: HeartbeatDecision;
-    outcome: string;
-    status: HeartbeatTaskStatus;
-    progress: string;
-    summary: string;
-    runId: string;
-    usage?: LlmUsage;
-    nextRunAt?: string;
-    enabled: boolean;
+    record: HeartbeatTaskRunRecord;
     timestamp: string;
 } | {
     type: 'heartbeat.task.failed';
@@ -64,6 +53,4 @@ export type RunHeartbeatSchedulerOptions = RunDueHeartbeatTasksOptions & {
     signal?: AbortSignal;
     sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
 };
-export declare function runDueHeartbeatTasks(options: RunDueHeartbeatTasksOptions): Promise<RunDueHeartbeatTasksResult>;
-export declare function runHeartbeatScheduler(options: RunHeartbeatSchedulerOptions): Promise<void>;
-//# sourceMappingURL=heartbeat-scheduler.d.ts.map
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/heartbeat/scheduler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/scheduler/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAExH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,6BAA6B,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,6BAA6B,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjE;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAAG,CAChC,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,cAAc,GAAG,mBAAmB,GAAG,SAAS,KACzD,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEnC,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,2BAA2B,GAAG;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC"}

package/dist/src/core/heartbeat/scheduler/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/heartbeat/scheduler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/scheduler/types.ts"],"names":[],"mappings":""}

package/dist/src/core/heartbeat/tasks/index.d.ts

@@ -0,0 +1,4 @@
+export { FileHeartbeatTaskRepository } from './repository.js';
+export { HeartbeatTaskStateProjector } from './task-state.js';
+export type { FileHeartbeatTaskRepositoryOptions, HeartbeatTask, HeartbeatTaskRunRecord, HeartbeatTaskRunRecordEntry, HeartbeatTaskRuntime, HeartbeatTaskSchedule, HeartbeatTaskState, HeartbeatTaskStatus, HeartbeatTaskStore, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/heartbeat/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/tasks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,kCAAkC,EAClC,aAAa,EACb,sBAAsB,EACtB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/src/core/heartbeat/tasks/index.js

@@ -0,0 +1,3 @@
+export { FileHeartbeatTaskRepository } from './repository.js';
+export { HeartbeatTaskStateProjector } from './task-state.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/heartbeat/tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/tasks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/core/heartbeat/tasks/repository.d.ts

@@ -0,0 +1,24 @@
+import type { AgentLoopCheckpoint } from '../../../core/runtime/loop/index.js';
+import type { FileHeartbeatTaskRepositoryOptions, HeartbeatTask, HeartbeatTaskRunRecord, HeartbeatTaskRunRecordEntry, HeartbeatTaskStore } from './types.js';
+export declare class FileHeartbeatTaskRepository implements HeartbeatTaskStore {
+    private readonly tasksDir;
+    private readonly checkpointsDir;
+    private readonly runsDir;
+    constructor(options: FileHeartbeatTaskRepositoryOptions);
+    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>;
+    private readTaskFile;
+    private readRunRecordFile;
+    private checkpointPathForTask;
+    private static safeTaskFileName;
+    private static runRecordEntryFromPath;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/src/core/heartbeat/tasks/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/tasks/repository.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,OAAO,KAAK,EACV,kCAAkC,EAClC,aAAa,EACb,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,2BAA4B,YAAW,kBAAkB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,kCAAkC;IAMjD,SAAS,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAWrC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAc7E,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnF,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,cAAc,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC;IAazG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC;IAKjF,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAO/B,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAYtC"}

package/dist/src/core/heartbeat/tasks/repository.js

@@ -0,0 +1,116 @@
+/**
+ * File-backed heartbeat task repository.
+ *
+ * Owns task, checkpoint, and run-record file I/O for heartbeat scheduling.
+ * Scheduler and host code should depend on this repository contract instead of
+ * reading heartbeat JSON files directly.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { AgentLoopCheckpointSchema, HeartbeatTaskRunRecordSchema, HeartbeatTaskSchema } from './schemas.js';
+import { HeartbeatTaskStateProjector } from './task-state.js';
+export class FileHeartbeatTaskRepository {
+    tasksDir;
+    checkpointsDir;
+    runsDir;
+    constructor(options) {
+        this.tasksDir = join(options.dir, 'tasks');
+        this.checkpointsDir = join(options.dir, 'checkpoints');
+        this.runsDir = join(options.dir, 'runs');
+    }
+    async listTasks() {
+        if (!existsSync(this.tasksDir)) {
+            return [];
+        }
+        return readdirSync(this.tasksDir)
+            .filter((entry) => entry.endsWith('.json'))
+            .flatMap((entry) => this.readTaskFile(join(this.tasksDir, entry)))
+            .sort((left, right) => left.id.localeCompare(right.id));
+    }
+    async saveTask(task) {
+        const path = join(this.tasksDir, `${FileHeartbeatTaskRepository.safeTaskFileName(task.id)}.json`);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(HeartbeatTaskSchema.parse(HeartbeatTaskStateProjector.normalize(task)), null, 2)}\n`);
+    }
+    async loadCheckpoint(task) {
+        const path = this.checkpointPathForTask(task);
+        if (!existsSync(path)) {
+            return undefined;
+        }
+        try {
+            const parsed = AgentLoopCheckpointSchema.safeParse(JSON.parse(readFileSync(path, 'utf8')));
+            return parsed.success ? parsed.data : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async saveCheckpoint(task, checkpoint) {
+        const path = this.checkpointPathForTask(task);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(AgentLoopCheckpointSchema.parse(checkpoint), null, 2)}\n`);
+    }
+    async saveRunRecord(record) {
+        const timestamp = new Date().toISOString().replaceAll(':', '-');
+        const path = join(this.runsDir, `${timestamp}-${FileHeartbeatTaskRepository.safeTaskFileName(record.task.id)}.json`);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(HeartbeatTaskRunRecordSchema.parse(record), null, 2)}\n`);
+    }
+    async listRunRecords(options = {}) {
+        if (!existsSync(this.runsDir)) {
+            return [];
+        }
+        const entries = readdirSync(this.runsDir)
+            .filter((entry) => entry.endsWith('.json'))
+            .flatMap((entry) => this.readRunRecordFile(join(this.runsDir, entry), options))
+            .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);
+    }
+    readTaskFile(path) {
+        try {
+            const parsed = HeartbeatTaskSchema.safeParse(JSON.parse(readFileSync(path, 'utf8')));
+            return parsed.success ? [HeartbeatTaskStateProjector.normalize(parsed.data)] : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    readRunRecordFile(path, options) {
+        try {
+            const parsed = HeartbeatTaskRunRecordSchema.safeParse(JSON.parse(readFileSync(path, 'utf8')));
+            if (!parsed.success || (options.taskId && parsed.data.task.id !== options.taskId)) {
+                return [];
+            }
+            return [FileHeartbeatTaskRepository.runRecordEntryFromPath(path, parsed.data)];
+        }
+        catch {
+            return [];
+        }
+    }
+    checkpointPathForTask(task) {
+        return task.checkpointPath ?? join(this.checkpointsDir, `${FileHeartbeatTaskRepository.safeTaskFileName(task.id)}.json`);
+    }
+    static 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;
+    }
+    static runRecordEntryFromPath(path, record) {
+        const id = basename(path, '.json');
+        return {
+            id,
+            path,
+            taskId: record.task.id,
+            workspaceId: record.task.workspaceId,
+            runId: record.result.state.runId,
+            createdAt: record.result.state.finishedAt,
+            record,
+        };
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/src/core/heartbeat/tasks/repository.js.map

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

package/dist/src/core/heartbeat/tasks/schemas.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Zod schemas for heartbeat task persistence.
+ *
+ * These schemas own the on-disk JSON contract for heartbeat tasks and run
+ * records. Checkpoints are still parsed with a minimal runtime shape because
+ * the runtime loop does not yet expose a full checkpoint schema.
+ */
+import { z } from 'zod';
+export declare const HeartbeatTaskStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    complete: "complete";
+    idle: "idle";
+    running: "running";
+    waiting: "waiting";
+    blocked: "blocked";
+}>;
+export declare const HeartbeatDecisionSchema: z.ZodEnum<{
+    continue: "continue";
+    pause: "pause";
+    complete: "complete";
+    escalate: "escalate";
+}>;
+export declare const HeartbeatTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    task: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodBoolean;
+    checkpointPath: z.ZodOptional<z.ZodString>;
+    schedule: z.ZodObject<{
+        intervalMs: z.ZodNumber;
+        nextRunAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        maxSteps: z.ZodOptional<z.ZodNumber>;
+        workspaceRoot: z.ZodOptional<z.ZodString>;
+        stateDir: z.ZodOptional<z.ZodString>;
+        memoryDir: z.ZodOptional<z.ZodString>;
+        searchIgnoreDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        systemContext: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    state: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            failed: "failed";
+            complete: "complete";
+            idle: "idle";
+            running: "running";
+            waiting: "waiting";
+            blocked: "blocked";
+        }>;
+        progress: z.ZodOptional<z.ZodString>;
+        runId: z.ZodOptional<z.ZodString>;
+        runAt: z.ZodOptional<z.ZodString>;
+        loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+        resumable: z.ZodBoolean;
+        result: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+            decision: z.ZodEnum<{
+                continue: "continue";
+                pause: "pause";
+                complete: "complete";
+                escalate: "escalate";
+            }>;
+            summary: z.ZodString;
+            checkpoint: z.ZodObject<{
+                version: z.ZodLiteral<1>;
+                runId: z.ZodString;
+                createdAt: z.ZodString;
+                state: z.ZodObject<{
+                    runId: z.ZodString;
+                    status: z.ZodString;
+                    transcript: z.ZodArray<z.ZodUnknown>;
+                    trace: z.ZodArray<z.ZodUnknown>;
+                }, z.core.$loose>;
+            }, z.core.$loose>;
+            state: z.ZodObject<{
+                runId: z.ZodString;
+                finishedAt: z.ZodString;
+                outcome: z.ZodString;
+                usage: z.ZodOptional<z.ZodObject<{
+                    inputTokens: z.ZodNumber;
+                    outputTokens: z.ZodNumber;
+                    totalTokens: z.ZodNumber;
+                    cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+                    reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                    requests: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>;
+        }, z.core.$loose>>>;
+        error: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const AgentLoopCheckpointSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    createdAt: z.ZodString;
+    state: z.ZodObject<{
+        runId: z.ZodString;
+        status: z.ZodString;
+        transcript: z.ZodArray<z.ZodUnknown>;
+        trace: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const HeartbeatTaskRunRecordSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        id: z.ZodString;
+        workspaceId: z.ZodOptional<z.ZodString>;
+        task: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodBoolean;
+        checkpointPath: z.ZodOptional<z.ZodString>;
+        schedule: z.ZodObject<{
+            intervalMs: z.ZodNumber;
+            nextRunAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+            maxSteps: z.ZodOptional<z.ZodNumber>;
+            workspaceRoot: z.ZodOptional<z.ZodString>;
+            stateDir: z.ZodOptional<z.ZodString>;
+            memoryDir: z.ZodOptional<z.ZodString>;
+            searchIgnoreDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            systemContext: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        state: z.ZodOptional<z.ZodObject<{
+            status: z.ZodEnum<{
+                failed: "failed";
+                complete: "complete";
+                idle: "idle";
+                running: "running";
+                waiting: "waiting";
+                blocked: "blocked";
+            }>;
+            progress: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            runAt: z.ZodOptional<z.ZodString>;
+            loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+            resumable: z.ZodBoolean;
+            result: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                decision: z.ZodEnum<{
+                    continue: "continue";
+                    pause: "pause";
+                    complete: "complete";
+                    escalate: "escalate";
+                }>;
+                summary: z.ZodString;
+                checkpoint: z.ZodObject<{
+                    version: z.ZodLiteral<1>;
+                    runId: z.ZodString;
+                    createdAt: z.ZodString;
+                    state: z.ZodObject<{
+                        runId: z.ZodString;
+                        status: z.ZodString;
+                        transcript: z.ZodArray<z.ZodUnknown>;
+                        trace: z.ZodArray<z.ZodUnknown>;
+                    }, z.core.$loose>;
+                }, z.core.$loose>;
+                state: z.ZodObject<{
+                    runId: z.ZodString;
+                    finishedAt: z.ZodString;
+                    outcome: z.ZodString;
+                    usage: z.ZodOptional<z.ZodObject<{
+                        inputTokens: z.ZodNumber;
+                        outputTokens: z.ZodNumber;
+                        totalTokens: z.ZodNumber;
+                        cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+                        reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                        requests: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                }, z.core.$loose>;
+            }, z.core.$loose>>>;
+            error: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    result: z.ZodObject<{
+        decision: z.ZodEnum<{
+            continue: "continue";
+            pause: "pause";
+            complete: "complete";
+            escalate: "escalate";
+        }>;
+        summary: z.ZodString;
+        checkpoint: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            runId: z.ZodString;
+            createdAt: z.ZodString;
+            state: z.ZodObject<{
+                runId: z.ZodString;
+                status: z.ZodString;
+                transcript: z.ZodArray<z.ZodUnknown>;
+                trace: z.ZodArray<z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$loose>;
+        state: z.ZodObject<{
+            runId: z.ZodString;
+            finishedAt: z.ZodString;
+            outcome: z.ZodString;
+            usage: z.ZodOptional<z.ZodObject<{
+                inputTokens: z.ZodNumber;
+                outputTokens: z.ZodNumber;
+                totalTokens: z.ZodNumber;
+                cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+                reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                requests: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    loadedCheckpoint: z.ZodBoolean;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/src/core/heartbeat/tasks/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/tasks/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;EAA0E,CAAC;AACjH,eAAO,MAAM,uBAAuB;;;;;EAAwD,CAAC;AAW7F,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+B9B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAUtB,CAAC;AAcjB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIvC,CAAC"}