@roackb2/heddle 1.4.0 → 1.5.0

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"}

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

@@ -0,0 +1,78 @@
+/**
+ * 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 const HeartbeatTaskStatusSchema = z.enum(['idle', 'running', 'waiting', 'blocked', 'complete', 'failed']);
+export const HeartbeatDecisionSchema = z.enum(['continue', 'pause', 'complete', 'escalate']);
+const LlmUsageSchema = z.object({
+    inputTokens: z.number().describe('Prompt tokens reported for the heartbeat run.'),
+    outputTokens: z.number().describe('Completion tokens reported for the heartbeat run.'),
+    totalTokens: z.number().describe('Total tokens reported for the heartbeat run.'),
+    cachedInputTokens: z.number().optional().describe('Provider-reported cached input tokens.'),
+    reasoningTokens: z.number().optional().describe('Provider-reported reasoning tokens.'),
+    requests: z.number().optional().describe('Number of provider requests represented by this usage aggregate.'),
+}).passthrough();
+export const HeartbeatTaskSchema = z.object({
+    id: z.string().describe('Stable heartbeat task identifier.'),
+    workspaceId: z.string().optional().describe('Workspace identifier this task belongs to.'),
+    task: z.string().describe('Durable task instruction the heartbeat should pursue.'),
+    name: z.string().optional().describe('Human-facing task label.'),
+    enabled: z.boolean().describe('Whether the scheduler may run this task.'),
+    checkpointPath: z.string().optional().describe('Optional custom checkpoint file path.'),
+    schedule: z.object({
+        intervalMs: z.number().describe('Default interval between heartbeat wake cycles.'),
+        nextRunAt: z.string().optional().describe('Timestamp when this task should next wake.'),
+    }).describe('Scheduler-owned cadence and wake timing.'),
+    runtime: z.object({
+        model: z.string().optional().describe('Model override for this task.'),
+        maxSteps: z.number().optional().describe('Maximum runtime steps for one wake cycle.'),
+        workspaceRoot: z.string().optional().describe('Workspace root override for this task.'),
+        stateDir: z.string().optional().describe('State directory override for this task.'),
+        memoryDir: z.string().optional().describe('Memory directory override for this task.'),
+        searchIgnoreDirs: z.array(z.string()).optional().describe('Search ignore directory overrides.'),
+        systemContext: z.string().optional().describe('Additional system context for this task.'),
+    }).optional().describe('Task-specific runtime overrides passed to the wake service.'),
+    state: z.object({
+        status: HeartbeatTaskStatusSchema.describe('Current scheduler-facing task status.'),
+        progress: z.string().optional().describe('Latest human-readable task progress.'),
+        runId: z.string().optional().describe('Latest runtime run id.'),
+        runAt: z.string().optional().describe('Timestamp when the latest run started or finished.'),
+        loadedCheckpoint: z.boolean().optional().describe('Whether the latest run loaded a checkpoint.'),
+        resumable: z.boolean().describe('Whether this task should be treated as resumable.'),
+        result: z.lazy(() => AgentHeartbeatResultSchema).optional().describe('Latest heartbeat wake result.'),
+        error: z.string().optional().describe('Latest scheduler or wake error.'),
+        updatedAt: z.string().optional().describe('Timestamp when this task record was last updated.'),
+    }).optional().describe('Latest scheduler/result state for this heartbeat task.'),
+});
+export const AgentLoopCheckpointSchema = z.object({
+    version: z.literal(1).describe('Runtime checkpoint format version.'),
+    runId: z.string().describe('Runtime run id represented by this checkpoint.'),
+    createdAt: z.string().describe('Timestamp when the checkpoint was created.'),
+    state: z.object({
+        runId: z.string(),
+        status: z.string(),
+        transcript: z.array(z.unknown()),
+        trace: z.array(z.unknown()),
+    }).passthrough().describe('Runtime loop state snapshot.'),
+}).passthrough();
+const AgentHeartbeatResultSchema = z.object({
+    decision: HeartbeatDecisionSchema,
+    summary: z.string(),
+    checkpoint: AgentLoopCheckpointSchema,
+    state: z.object({
+        runId: z.string(),
+        finishedAt: z.string(),
+        outcome: z.string(),
+        usage: LlmUsageSchema.optional(),
+    }).passthrough(),
+}).passthrough();
+export const HeartbeatTaskRunRecordSchema = z.object({
+    task: HeartbeatTaskSchema.describe('Task state captured after this run.'),
+    result: AgentHeartbeatResultSchema.describe('Heartbeat wake result.'),
+    loadedCheckpoint: z.boolean().describe('Whether this run resumed from a stored checkpoint.'),
+});
+//# sourceMappingURL=schemas.js.map

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

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

package/dist/src/core/heartbeat/tasks/task-state.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Heartbeat task state projector.
+ *
+ * Owns how wake results and failures become durable scheduler-facing task
+ * state. This keeps status/progress text out of CLI, server, and scheduler
+ * loops.
+ */
+import type { AgentHeartbeatResult } from '../wake/index.js';
+import type { HeartbeatTask } from './types.js';
+export declare class HeartbeatTaskStateProjector {
+    static normalize(task: HeartbeatTask): HeartbeatTask;
+    static markRunning(args: {
+        task: HeartbeatTask;
+        now: Date;
+        loadedCheckpoint: boolean;
+    }): HeartbeatTask;
+    static afterResult(args: {
+        task: HeartbeatTask;
+        result: AgentHeartbeatResult;
+        now: Date;
+        loadedCheckpoint: boolean;
+    }): HeartbeatTask;
+    static afterFailure(args: {
+        task: HeartbeatTask;
+        error: unknown;
+        now: Date;
+        retryMs: number;
+    }): HeartbeatTask;
+    private static normalizeState;
+    private static projectResult;
+    private static formatDelay;
+}
+//# sourceMappingURL=task-state.d.ts.map

package/dist/src/core/heartbeat/tasks/task-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-state.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/tasks/task-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAA2C,MAAM,YAAY,CAAC;AAEzF,qBAAa,2BAA2B;IACtC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa;IAWpD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC;QACV,gBAAgB,EAAE,OAAO,CAAC;KAC3B,GAAG,aAAa;IAiBjB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE,oBAAoB,CAAC;QAC7B,GAAG,EAAE,IAAI,CAAC;QACV,gBAAgB,EAAE,OAAO,CAAC;KAC3B,GAAG,aAAa;IA6BjB,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,aAAa,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,IAAI,CAAC;QACV,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,aAAa;IAkBjB,OAAO,CAAC,MAAM,CAAC,cAAc;IAQ7B,OAAO,CAAC,MAAM,CAAC,aAAa;IAkC5B,OAAO,CAAC,MAAM,CAAC,WAAW;CAe3B"}

package/dist/src/core/heartbeat/tasks/task-state.js

@@ -0,0 +1,122 @@
+import { HeartbeatDecisionPolicy } from '../wake/index.js';
+export class HeartbeatTaskStateProjector {
+    static normalize(task) {
+        return {
+            ...task,
+            schedule: {
+                ...task.schedule,
+                intervalMs: Math.max(1, Math.trunc(task.schedule.intervalMs)),
+            },
+            state: HeartbeatTaskStateProjector.normalizeState(task.state),
+        };
+    }
+    static markRunning(args) {
+        return HeartbeatTaskStateProjector.normalize({
+            ...args.task,
+            state: {
+                ...args.task.state,
+                status: 'running',
+                progress: args.loadedCheckpoint ?
+                    'Resuming heartbeat wake from the last checkpoint.'
+                    : 'Starting a new heartbeat wake cycle.',
+                loadedCheckpoint: args.loadedCheckpoint,
+                error: undefined,
+                updatedAt: args.now.toISOString(),
+            },
+        });
+    }
+    static afterResult(args) {
+        const terminal = args.result.decision === 'complete' || args.result.decision === 'escalate';
+        const delayMs = terminal ? undefined
+            : args.result.decision === 'continue' ? args.task.schedule.intervalMs
+                : HeartbeatDecisionPolicy.suggestNextDelayMs(args.result.decision) ?? args.task.schedule.intervalMs;
+        const projection = HeartbeatTaskStateProjector.projectResult(args.result, delayMs);
+        return HeartbeatTaskStateProjector.normalize({
+            ...args.task,
+            enabled: terminal ? false : args.task.enabled,
+            schedule: {
+                ...args.task.schedule,
+                nextRunAt: delayMs === undefined ? undefined : new Date(args.now.getTime() + delayMs).toISOString(),
+            },
+            state: {
+                status: projection.status,
+                progress: projection.progress,
+                runAt: args.now.toISOString(),
+                runId: args.result.state.runId,
+                loadedCheckpoint: args.loadedCheckpoint,
+                resumable: args.result.decision !== 'complete',
+                result: args.result,
+                error: undefined,
+                updatedAt: args.now.toISOString(),
+            },
+        });
+    }
+    static afterFailure(args) {
+        return HeartbeatTaskStateProjector.normalize({
+            ...args.task,
+            schedule: {
+                ...args.task.schedule,
+                nextRunAt: new Date(args.now.getTime() + args.retryMs).toISOString(),
+            },
+            state: {
+                ...args.task.state,
+                status: 'failed',
+                progress: 'Heartbeat wake failed and will retry later.',
+                runAt: args.now.toISOString(),
+                error: args.error instanceof Error ? args.error.message : String(args.error),
+                updatedAt: args.now.toISOString(),
+            },
+        });
+    }
+    static normalizeState(state) {
+        return {
+            ...state,
+            status: state?.status ?? 'idle',
+            resumable: state?.resumable ?? true,
+        };
+    }
+    static projectResult(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 ${HeartbeatTaskStateProjector.formatDelay(delayMs)}.`,
+                };
+            case 'pause':
+                return {
+                    status: 'waiting',
+                    progress: delayMs === undefined ?
+                        'Heartbeat paused.'
+                        : `Heartbeat paused. Waiting ${HeartbeatTaskStateProjector.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.',
+                };
+        }
+    }
+    static 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`;
+    }
+}
+//# sourceMappingURL=task-state.js.map

package/dist/src/core/heartbeat/tasks/task-state.js.map

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