@roackb2/heddle 1.4.0 → 1.6.0

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

package/dist/src/core/{runtime/heartbeat-task-store.d.ts → heartbeat/tasks/types.d.ts}

@@ -1,36 +1,33 @@
-import type { AgentHeartbeatResult, HeartbeatDecision } from './heartbeat.js';
-import type { AgentLoopCheckpoint } from './events.js';
-import type { LlmUsage } from '../llm/types.js';
+import type { AgentLoopCheckpoint } from '../../../core/runtime/loop/index.js';
+import type { AgentHeartbeatResult, RunAgentHeartbeatOptions } from '../wake/index.js';
+export type HeartbeatTaskStatus = 'idle' | 'running' | 'waiting' | 'blocked' | 'complete' | 'failed';
+export type HeartbeatTaskSchedule = {
+    intervalMs: number;
+    nextRunAt?: string;
+};
+export type HeartbeatTaskRuntime = Pick<RunAgentHeartbeatOptions, 'model' | 'maxSteps' | 'workspaceRoot' | 'stateDir' | 'memoryDir' | 'searchIgnoreDirs' | 'systemContext'>;
+export type HeartbeatTaskState = {
+    status?: HeartbeatTaskStatus;
+    progress?: string;
+    runId?: string;
+    runAt?: string;
+    loadedCheckpoint?: boolean;
+    resumable?: boolean;
+    result?: AgentHeartbeatResult;
+    error?: string;
+    updatedAt?: string;
+};
 export type HeartbeatTask = {
     id: string;
     workspaceId?: 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;
+    schedule: HeartbeatTaskSchedule;
+    runtime?: HeartbeatTaskRuntime;
+    state?: HeartbeatTaskState;
 };
-export type HeartbeatTaskStatus = 'idle' | 'running' | 'waiting' | 'blocked' | 'complete' | 'failed';
 export type HeartbeatTaskRunRecord = {
     task: HeartbeatTask;
     result: AgentHeartbeatResult;
@@ -57,9 +54,7 @@ export type HeartbeatTaskStore = {
     }) => Promise<HeartbeatTaskRunRecordEntry[]>;
     loadRunRecord?: (id: string) => Promise<HeartbeatTaskRunRecordEntry | undefined>;
 };
-export type FileHeartbeatTaskStoreOptions = {
+export type FileHeartbeatTaskRepositoryOptions = {
     dir: string;
 };
-export declare function createFileHeartbeatTaskStore(options: FileHeartbeatTaskStoreOptions): HeartbeatTaskStore;
-export declare function normalizeTaskForSave(task: HeartbeatTask): HeartbeatTask;
-//# sourceMappingURL=heartbeat-task-store.d.ts.map
+//# sourceMappingURL=types.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+export { HeartbeatLucidPresenter } from './lucid-presenter.js';
+export { HeartbeatViewsPresenter } from './presenter.js';
+export type { HeartbeatRunView, HeartbeatTaskView, LucidAdapterOptions, LucidAgentMessage, LucidAgentProgressNotification, LucidAgentResponseNotification, LucidAgentStatus, LucidAgentStatusNotification, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,3 @@
+export { HeartbeatLucidPresenter } from './lucid-presenter.js';
+export { HeartbeatViewsPresenter } from './presenter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/core/heartbeat/views/lucid-presenter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Lucid heartbeat presenter.
+ *
+ * Adapts heartbeat task, run, and scheduler projections into Lucid-style agent
+ * notifications. This is an integration projection, not scheduler policy.
+ */
+import type { HeartbeatSchedulerEvent } from '../scheduler/index.js';
+import type { HeartbeatTaskStatus } from '../tasks/index.js';
+import type { HeartbeatRunView, HeartbeatTaskView, LucidAdapterOptions, LucidAgentMessage, LucidAgentStatus } from './types.js';
+export declare class HeartbeatLucidPresenter {
+    static taskStatusToLucidStatus(status: HeartbeatTaskStatus): LucidAgentStatus;
+    static taskViewToMessages(task: HeartbeatTaskView, options?: LucidAdapterOptions): LucidAgentMessage[];
+    static runViewToMessages(run: HeartbeatRunView, options?: LucidAdapterOptions): LucidAgentMessage[];
+    static schedulerEventToMessages(event: HeartbeatSchedulerEvent, options?: LucidAdapterOptions): LucidAgentMessage[];
+    private static statusMessage;
+    private static progressMessage;
+    private static responseMessage;
+    private static resolveAgentId;
+}
+//# sourceMappingURL=lucid-presenter.d.ts.map

package/dist/src/core/heartbeat/views/lucid-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid-presenter.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/views/lucid-presenter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,uBAAuB;IAClC,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB;IAgB7E,MAAM,CAAC,kBAAkB,CACvB,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,EAAE;IAkBtB,MAAM,CAAC,iBAAiB,CACtB,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,EAAE;IAetB,MAAM,CAAC,wBAAwB,CAC7B,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE,mBAAwB,GAChC,iBAAiB,EAAE;IAgCtB,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B,OAAO,CAAC,MAAM,CAAC,eAAe;IAa9B,OAAO,CAAC,MAAM,CAAC,eAAe;IAa9B,OAAO,CAAC,MAAM,CAAC,cAAc;CAG9B"}

package/dist/src/core/heartbeat/views/lucid-presenter.js

@@ -0,0 +1,112 @@
+export class HeartbeatLucidPresenter {
+    static taskStatusToLucidStatus(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';
+        }
+    }
+    static taskViewToMessages(task, options = {}) {
+        const agentId = HeartbeatLucidPresenter.resolveAgentId(task.taskId, options);
+        const timestamp = task.lastRunAt ?? task.nextRunAt ?? new Date().toISOString();
+        const messages = [
+            HeartbeatLucidPresenter.statusMessage(agentId, HeartbeatLucidPresenter.taskStatusToLucidStatus(task.status), timestamp),
+        ];
+        if (task.progress) {
+            messages.push(HeartbeatLucidPresenter.progressMessage(agentId, task.progress, timestamp));
+        }
+        if (task.summary) {
+            messages.push(HeartbeatLucidPresenter.responseMessage(agentId, task.summary, timestamp));
+        }
+        return messages;
+    }
+    static runViewToMessages(run, options = {}) {
+        const agentId = HeartbeatLucidPresenter.resolveAgentId(run.taskId, options);
+        const timestamp = run.createdAt;
+        const messages = [
+            HeartbeatLucidPresenter.statusMessage(agentId, HeartbeatLucidPresenter.taskStatusToLucidStatus(run.status), timestamp),
+        ];
+        if (run.progress) {
+            messages.push(HeartbeatLucidPresenter.progressMessage(agentId, run.progress, timestamp));
+        }
+        messages.push(HeartbeatLucidPresenter.responseMessage(agentId, run.summary, timestamp));
+        return messages;
+    }
+    static schedulerEventToMessages(event, options = {}) {
+        if (event.type === 'heartbeat.scheduler.started' || event.type === 'heartbeat.scheduler.stopped') {
+            return [];
+        }
+        const agentId = HeartbeatLucidPresenter.resolveAgentId(event.taskId, options);
+        switch (event.type) {
+            case 'heartbeat.task.due':
+                return [];
+            case 'heartbeat.task.started':
+                return [
+                    HeartbeatLucidPresenter.statusMessage(agentId, HeartbeatLucidPresenter.taskStatusToLucidStatus(event.status), event.timestamp),
+                    HeartbeatLucidPresenter.progressMessage(agentId, event.progress, event.timestamp),
+                ];
+            case 'heartbeat.task.finished': {
+                const { task, result } = event.record;
+                return [
+                    HeartbeatLucidPresenter.statusMessage(agentId, HeartbeatLucidPresenter.taskStatusToLucidStatus(task.state?.status ?? 'waiting'), event.timestamp),
+                    HeartbeatLucidPresenter.progressMessage(agentId, task.state?.progress ?? '', event.timestamp),
+                    HeartbeatLucidPresenter.responseMessage(agentId, result.summary, event.timestamp),
+                ];
+            }
+            case 'heartbeat.task.failed':
+                return [
+                    HeartbeatLucidPresenter.statusMessage(agentId, HeartbeatLucidPresenter.taskStatusToLucidStatus(event.status), event.timestamp),
+                    HeartbeatLucidPresenter.progressMessage(agentId, event.progress, event.timestamp),
+                    HeartbeatLucidPresenter.responseMessage(agentId, event.error, event.timestamp),
+                ];
+        }
+    }
+    static statusMessage(agentId, status, timestamp) {
+        return {
+            event: 'agent_status',
+            data: {
+                status: {
+                    agent_id: agentId,
+                    status,
+                    timestamp,
+                },
+            },
+        };
+    }
+    static progressMessage(agentId, progress, timestamp) {
+        return {
+            event: 'agent_progress',
+            data: {
+                progress: {
+                    agent_id: agentId,
+                    progress,
+                    timestamp,
+                },
+            },
+        };
+    }
+    static responseMessage(agentId, response, timestamp) {
+        return {
+            event: 'agent_response',
+            data: {
+                response: {
+                    agent_id: agentId,
+                    response,
+                    timestamp,
+                },
+            },
+        };
+    }
+    static resolveAgentId(taskId, options) {
+        return options.taskIdToAgentId?.(taskId) ?? taskId;
+    }
+}
+//# sourceMappingURL=lucid-presenter.js.map

package/dist/src/core/heartbeat/views/lucid-presenter.js.map

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

package/dist/src/core/heartbeat/views/presenter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Heartbeat views presenter.
+ *
+ * Projects durable task and run records into compact host-facing views. Keep
+ * this projection here so CLI/server/web surfaces do not each reinterpret
+ * heartbeat task state.
+ */
+import type { HeartbeatTask, HeartbeatTaskRunRecordEntry, HeartbeatTaskStore } from '../tasks/index.js';
+import type { HeartbeatRunView, HeartbeatTaskView } from './types.js';
+export declare class HeartbeatViewsPresenter {
+    static listTaskViews(store: HeartbeatTaskStore): Promise<HeartbeatTaskView[]>;
+    static listRunViews(store: HeartbeatTaskStore, options?: {
+        taskId?: string;
+        limit?: number;
+    }): Promise<HeartbeatRunView[]>;
+    static loadRunView(store: HeartbeatTaskStore, id: string, options?: {
+        taskId?: string;
+    }): Promise<HeartbeatRunView | undefined>;
+    static projectTask(task: HeartbeatTask): HeartbeatTaskView;
+    static projectRun(run: HeartbeatTaskRunRecordEntry): HeartbeatRunView;
+}
+//# sourceMappingURL=presenter.d.ts.map

package/dist/src/core/heartbeat/views/presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/views/presenter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtE,qBAAa,uBAAuB;WACrB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;WAItE,YAAY,CACvB,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,gBAAgB,EAAE,CAAC;WAKjB,WAAW,CACtB,KAAK,EAAE,kBAAkB,EACzB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAChC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAWxC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,iBAAiB;IAkB1D,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,2BAA2B,GAAG,gBAAgB;CActE"}

package/dist/src/core/heartbeat/views/presenter.js

@@ -0,0 +1,50 @@
+export class HeartbeatViewsPresenter {
+    static async listTaskViews(store) {
+        return (await store.listTasks()).map((task) => HeartbeatViewsPresenter.projectTask(task));
+    }
+    static async listRunViews(store, options = {}) {
+        const runs = await store.listRunRecords?.(options);
+        return (runs ?? []).map((run) => HeartbeatViewsPresenter.projectRun(run));
+    }
+    static async loadRunView(store, id, options = {}) {
+        const run = id === 'latest' ?
+            (await store.listRunRecords?.({ taskId: options.taskId, limit: 1 }))?.[0]
+            : await store.loadRunRecord?.(id);
+        if (!run || (options.taskId && run.taskId !== options.taskId)) {
+            return undefined;
+        }
+        return HeartbeatViewsPresenter.projectRun(run);
+    }
+    static projectTask(task) {
+        const result = task.state?.result;
+        return {
+            ...task,
+            ...task.schedule,
+            ...task.runtime,
+            ...task.state,
+            taskId: task.id,
+            status: task.state?.status ?? 'idle',
+            lastRunAt: task.state?.runAt,
+            lastRunId: task.state?.runId,
+            decision: result?.decision,
+            summary: result?.summary,
+            outcome: result?.state.outcome,
+            usage: result?.state.usage,
+        };
+    }
+    static projectRun(run) {
+        return {
+            ...HeartbeatViewsPresenter.projectTask(run.record.task),
+            ...run,
+            id: run.id,
+            taskId: run.taskId,
+            runId: run.runId,
+            decision: run.record.result.decision,
+            summary: run.record.result.summary,
+            outcome: run.record.result.state.outcome,
+            loadedCheckpoint: run.record.loadedCheckpoint,
+            usage: run.record.result.state.usage,
+        };
+    }
+}
+//# sourceMappingURL=presenter.js.map

package/dist/src/core/heartbeat/views/presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/views/presenter.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,uBAAuB;IAClC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,KAAyB;QAClD,OAAO,CAAC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,YAAY,CACvB,KAAyB,EACzB,UAA+C,EAAE;QAEjD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,WAAW,CACtB,KAAyB,EACzB,EAAU,EACV,UAA+B,EAAE;QAEjC,MAAM,GAAG,GACP,EAAE,KAAK,QAAQ,CAAC,CAAC;YACf,CAAC,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3E,CAAC,CAAC,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,uBAAuB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAmB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;QAClC,OAAO;YACL,GAAG,IAAI;YACP,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,IAAI,CAAC,OAAO;YACf,GAAG,IAAI,CAAC,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,MAAM;YACpC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK;YAC5B,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK;YAC5B,QAAQ,EAAE,MAAM,EAAE,QAAQ;YAC1B,OAAO,EAAE,MAAM,EAAE,OAAO;YACxB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO;YAC9B,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,GAAgC;QAChD,OAAO;YACL,GAAG,uBAAuB,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YACvD,GAAG,GAAG;YACN,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ;YACpC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;YAClC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;YACxC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB;YAC7C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK;SACrC,CAAC;IACJ,CAAC;CACF"}

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

@@ -1,6 +1,26 @@
-import type { HeartbeatSchedulerEvent } from './heartbeat-scheduler.js';
-import type { HeartbeatTaskStatus } from './heartbeat-task-store.js';
-import type { HeartbeatRunView, HeartbeatTaskView } from './heartbeat-views.js';
+import type { LlmUsage } from '../../../core/llm/types.js';
+import type { HeartbeatDecision } from '../wake/index.js';
+import type { HeartbeatTask, HeartbeatTaskRuntime, HeartbeatTaskSchedule, HeartbeatTaskState, HeartbeatTaskStatus } from '../tasks/index.js';
+export type HeartbeatTaskView = HeartbeatTask & HeartbeatTaskSchedule & HeartbeatTaskRuntime & HeartbeatTaskState & {
+    taskId: string;
+    status: HeartbeatTaskStatus;
+    lastRunAt?: string;
+    lastRunId?: string;
+    decision?: HeartbeatDecision;
+    summary?: string;
+    outcome?: string;
+    usage?: LlmUsage;
+};
+export type HeartbeatRunView = HeartbeatTaskView & {
+    id: string;
+    runId: string;
+    createdAt: string;
+    decision: HeartbeatDecision;
+    outcome: string;
+    summary: string;
+    loadedCheckpoint: boolean;
+    usage?: LlmUsage;
+};
 export type LucidAgentStatus = 'running' | 'paused' | 'asleep' | 'terminated' | 'blocked' | 'failed';
 export type LucidAgentStatusNotification = {
     agent_id: string;
@@ -36,8 +56,4 @@ export type LucidAgentMessage = {
 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
+//# sourceMappingURL=types.d.ts.map