@roackb2/heddle 1.4.0 → 1.5.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/views/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7I,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG;IAClH,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErG,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE;QAAE,MAAM,EAAE,4BAA4B,CAAA;KAAE,CAAA;CAAE,GACzE;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GAC/E;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9C,CAAC"}

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

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

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

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

package/dist/src/core/heartbeat/wake/decision.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Heartbeat decision policy.
+ *
+ * Owns the current text-based heartbeat decision contract and retry cadence.
+ * Future runtime checkpoint work should replace the decision-line parsing here
+ * instead of duplicating heartbeat decision inference in scheduler or host code.
+ */
+import type { AgentHeartbeatResult, HeartbeatDecision } from './types.js';
+export declare class HeartbeatDecisionPolicy {
+    static infer(summary: string, outcome: string): HeartbeatDecision;
+    static suggestNextDelayMs(decision: AgentHeartbeatResult['decision']): number | undefined;
+}
+//# sourceMappingURL=decision.d.ts.map

package/dist/src/core/heartbeat/wake/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/wake/decision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE1E,qBAAa,uBAAuB;IAClC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAajE,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS;CAW1F"}

package/dist/src/core/heartbeat/wake/decision.js

@@ -0,0 +1,24 @@
+export class HeartbeatDecisionPolicy {
+    static infer(summary, outcome) {
+        const match = summary.match(/HEARTBEAT_DECISION:\s*(continue|pause|complete|escalate)\b/i);
+        if (match) {
+            return match[1].toLowerCase();
+        }
+        if (outcome === 'done') {
+            return 'pause';
+        }
+        return 'escalate';
+    }
+    static suggestNextDelayMs(decision) {
+        switch (decision) {
+            case 'continue':
+                return 60_000;
+            case 'pause':
+                return 15 * 60_000;
+            case 'complete':
+            case 'escalate':
+                return undefined;
+        }
+    }
+}
+//# sourceMappingURL=decision.js.map

package/dist/src/core/heartbeat/wake/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/wake/decision.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,uBAAuB;IAClC,MAAM,CAAC,KAAK,CAAC,OAAe,EAAE,OAAe;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC3F,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAuB,CAAC;QACrD,CAAC;QAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,QAA0C;QAClE,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,UAAU;gBACb,OAAO,MAAM,CAAC;YAChB,KAAK,OAAO;gBACV,OAAO,EAAE,GAAG,MAAM,CAAC;YACrB,KAAK,UAAU,CAAC;YAChB,KAAK,UAAU;gBACb,OAAO,SAAS,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+export { HeartbeatDecisionPolicy } from './decision.js';
+export { HeartbeatWakePrompt } from './prompt.js';
+export { HeartbeatWakeService } from './service.js';
+export type { AgentHeartbeatEvent, AgentHeartbeatResult, HeartbeatDecision, HeartbeatDecisionEvent, HeartbeatEscalationEvent, RunAgentHeartbeatOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/wake/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,4 @@
+export { HeartbeatDecisionPolicy } from './decision.js';
+export { HeartbeatWakePrompt } from './prompt.js';
+export { HeartbeatWakeService } from './service.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/wake/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/core/heartbeat/wake/prompt.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Heartbeat wake prompt builder.
+ *
+ * Owns the autonomous heartbeat instructions that are added around a durable
+ * task before it is handed to the generic runtime loop.
+ */
+export declare class HeartbeatWakePrompt {
+    static buildGoal(task: string): string;
+    static appendSystemContext(systemContext: string | undefined): string;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/core/heartbeat/wake/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/wake/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAgBtC,MAAM,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;CAgBtE"}

package/dist/src/core/heartbeat/wake/prompt.js

@@ -0,0 +1,39 @@
+/**
+ * Heartbeat wake prompt builder.
+ *
+ * Owns the autonomous heartbeat instructions that are added around a durable
+ * task before it is handed to the generic runtime loop.
+ */
+export class HeartbeatWakePrompt {
+    static buildGoal(task) {
+        return [
+            'Heartbeat wake cycle.',
+            '',
+            'Durable task:',
+            task,
+            '',
+            'Work autonomously on the task if there is useful, safe progress to make now.',
+            'Do not wait for a chat message.',
+            'If blocked, risky, or user input is required, escalate clearly instead of guessing.',
+            '',
+            'End your response with exactly one decision line:',
+            'HEARTBEAT_DECISION: continue | pause | complete | escalate',
+        ].join('\n');
+    }
+    static appendSystemContext(systemContext) {
+        const heartbeatContext = [
+            '## Heartbeat Mode',
+            '',
+            'This run was started by an autonomous heartbeat, not by a live chat message.',
+            'Operate within the available tools and approval policy.',
+            'There may be no live approval handler. Prefer read-only tools and simple run_shell_inspect commands without cd, &&, redirects, or subshells.',
+            'The shell already runs from the workspace root. For git inspection, use commands such as `git status -sb` directly instead of `cd <path> && git status`.',
+            'Use memory-note tools for durable observations when useful.',
+            'Make bounded useful progress, update durable memory when appropriate, and stop cleanly.',
+            'Escalate only when human input, credentials, policy approval, or risky judgment is required.',
+            'The required final decision line is: HEARTBEAT_DECISION: continue | pause | complete | escalate',
+        ].join('\n');
+        return systemContext ? `${systemContext}\n\n${heartbeatContext}` : heartbeatContext;
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/core/heartbeat/wake/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../src/core/heartbeat/wake/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,OAAO;YACL,uBAAuB;YACvB,EAAE;YACF,eAAe;YACf,IAAI;YACJ,EAAE;YACF,8EAA8E;YAC9E,iCAAiC;YACjC,qFAAqF;YACrF,EAAE;YACF,mDAAmD;YACnD,4DAA4D;SAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,aAAiC;QAC1D,MAAM,gBAAgB,GAAG;YACvB,mBAAmB;YACnB,EAAE;YACF,8EAA8E;YAC9E,yDAAyD;YACzD,8IAA8I;YAC9I,0JAA0J;YAC1J,6DAA6D;YAC7D,yFAAyF;YACzF,8FAA8F;YAC9F,iGAAiG;SAClG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,OAAO,gBAAgB,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACtF,CAAC;CACF"}

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

@@ -0,0 +1,6 @@
+import type { AgentHeartbeatResult, RunAgentHeartbeatOptions } from './types.js';
+export declare class HeartbeatWakeService {
+    static run(options: RunAgentHeartbeatOptions): Promise<AgentHeartbeatResult>;
+    private static toRuntimeOptions;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/core/heartbeat/wake/service.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAIjF,qBAAa,oBAAoB;WAClB,GAAG,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6ClF,OAAO,CAAC,MAAM,CAAC,gBAAgB;CA8BhC"}

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

@@ -0,0 +1,75 @@
+/**
+ * Heartbeat wake service.
+ *
+ * Runs one autonomous heartbeat wake cycle on top of the generic runtime loop.
+ * It owns heartbeat-specific prompt context and heartbeat lifecycle events, but
+ * delegates model/tool stepping to `AgentLoopRuntimeService`.
+ */
+import { resolve } from 'node:path';
+import { appendMemoryCatalogSystemContext } from '../../../core/memory/catalog.js';
+import { AgentLoopCheckpointService, AgentLoopRuntimeService } from '../../../core/runtime/loop/index.js';
+import { HeartbeatDecisionPolicy } from './decision.js';
+import { HeartbeatWakePrompt } from './prompt.js';
+const DEFAULT_HEARTBEAT_MAX_STEPS = 80;
+export class HeartbeatWakeService {
+    static async run(options) {
+        const runtime = HeartbeatWakeService.toRuntimeOptions(options);
+        const result = await AgentLoopRuntimeService.run(runtime);
+        const decision = HeartbeatDecisionPolicy.infer(result.summary, result.outcome);
+        const runId = result.state.runId;
+        const checkpoint = AgentLoopCheckpointService.createCheckpoint(result.state);
+        const now = () => new Date().toISOString();
+        options.onEvent?.({
+            type: 'heartbeat.decision',
+            runId,
+            decision,
+            outcome: result.outcome,
+            summary: result.summary,
+            timestamp: now(),
+        });
+        if (decision === 'escalate') {
+            options.onEvent?.({
+                type: 'escalation.required',
+                runId,
+                task: options.task,
+                outcome: result.outcome,
+                summary: result.summary,
+                step: result.trace.length,
+                timestamp: now(),
+            });
+        }
+        options.onEvent?.({
+            type: 'checkpoint.saved',
+            runId,
+            checkpoint,
+            step: result.trace.length,
+            timestamp: now(),
+        });
+        return {
+            decision,
+            summary: result.summary,
+            checkpoint,
+            state: result.state,
+        };
+    }
+    static toRuntimeOptions(options) {
+        const { task, checkpoint, maxSteps, memoryDir: providedMemoryDir, stateDir, workspaceRoot, systemContext: providedSystemContext, onEvent, ...runtimeOptions } = options;
+        const memoryDir = providedMemoryDir ?? resolve(workspaceRoot ?? process.cwd(), stateDir ?? '.heddle', 'memory');
+        const systemContext = HeartbeatWakePrompt.appendSystemContext(appendMemoryCatalogSystemContext({
+            systemContext: providedSystemContext,
+            memoryRoot: memoryDir,
+        }));
+        return {
+            ...runtimeOptions,
+            goal: HeartbeatWakePrompt.buildGoal(task),
+            maxSteps: maxSteps ?? DEFAULT_HEARTBEAT_MAX_STEPS,
+            workspaceRoot,
+            stateDir,
+            memoryDir,
+            systemContext,
+            resumeFrom: checkpoint,
+            onEvent,
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

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

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