daycare-cli 0.0.0-canary.017f2bd

package/dist/engine/heartbeat/heartbeats.d.ts

@@ -0,0 +1,39 @@
+import type { Context } from "@/types";
+import type { Storage } from "../../storage/storage.js";
+import type { AgentSystem } from "../agents/agentSystem.js";
+import type { ConfigModule } from "../config/configModule.js";
+import type { EngineEventBus } from "../ipc/events.js";
+import type { ConnectorRegistry } from "../modules/connectorRegistry.js";
+import type { PermissionRequestRegistry } from "../modules/tools/permissionRequestRegistry.js";
+import type { HeartbeatCreateTaskArgs, HeartbeatDefinition } from "./heartbeatTypes.js";
+export type HeartbeatsOptions = {
+    config: ConfigModule;
+    storage: Storage;
+    eventBus: EngineEventBus;
+    agentSystem: AgentSystem;
+    connectorRegistry: ConnectorRegistry;
+    permissionRequestRegistry: PermissionRequestRegistry;
+    intervalMs?: number;
+};
+/**
+ * Coordinates heartbeat scheduling for engine runtime.
+ * Posts heartbeat prompts directly to the agent system.
+ */
+export declare class Heartbeats {
+    private readonly eventBus;
+    private readonly agentSystem;
+    private readonly scheduler;
+    constructor(options: HeartbeatsOptions);
+    start(): Promise<void>;
+    stop(): void;
+    listTasks(): Promise<HeartbeatDefinition[]>;
+    runNow(args?: {
+        ids?: string[];
+    }): Promise<{
+        ran: number;
+        taskIds: string[];
+    }>;
+    addTask(ctx: Context, args: HeartbeatCreateTaskArgs): Promise<HeartbeatDefinition>;
+    removeTask(ctx: Context, taskId: string): Promise<boolean>;
+}
+//# sourceMappingURL=heartbeats.d.ts.map

package/dist/engine/heartbeat/heartbeats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeats.d.ts","sourceRoot":"","sources":["../../../sources/engine/heartbeat/heartbeats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAG/F,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAMxF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,yBAAyB,EAAE,yBAAyB,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,OAAO,EAAE,iBAAiB;IAoDhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC5B,IAAI,IAAI,IAAI;IAIN,SAAS,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAI3C,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAI9E,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIlF,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGnE"}

package/dist/engine/heartbeat/heartbeats.js

@@ -0,0 +1,107 @@
+import { getLogger } from "../../log.js";
+import { permissionBuildUser } from "../permissions/permissionBuildUser.js";
+import { gatePermissionRequest } from "../scheduling/gatePermissionRequest.js";
+import { heartbeatPromptBuildBatch } from "./ops/heartbeatPromptBuildBatch.js";
+import { HeartbeatScheduler } from "./ops/heartbeatScheduler.js";
+const logger = getLogger("heartbeat.facade");
+/**
+ * Coordinates heartbeat scheduling for engine runtime.
+ * Posts heartbeat prompts directly to the agent system.
+ */
+export class Heartbeats {
+    eventBus;
+    agentSystem;
+    scheduler;
+    constructor(options) {
+        this.eventBus = options.eventBus;
+        this.agentSystem = options.agentSystem;
+        this.scheduler = new HeartbeatScheduler({
+            config: options.config,
+            repository: options.storage.heartbeatTasks,
+            intervalMs: options.intervalMs,
+            resolveDefaultPermissions: async () => {
+                const ownerUserId = await this.agentSystem.ownerUserIdEnsure();
+                return permissionBuildUser(this.agentSystem.userHomeForUserId(ownerUserId));
+            },
+            resolvePermissions: async () => this.agentSystem.permissionsForTarget({
+                descriptor: { type: "system", tag: "heartbeat" }
+            }),
+            onRun: async (tasks) => {
+                const target = { descriptor: { type: "system", tag: "heartbeat" } };
+                const targetAgentId = await this.agentSystem.agentIdForTarget(target);
+                const permissions = await this.agentSystem.permissionsForTarget(target);
+                this.agentSystem.updateAgentPermissions(targetAgentId, permissions, Date.now());
+                const batch = heartbeatPromptBuildBatch(tasks);
+                await this.agentSystem.postAndAwait(target, {
+                    type: "system_message",
+                    text: batch.prompt,
+                    origin: "heartbeat",
+                    execute: true
+                });
+            },
+            onError: async (error, taskIds) => {
+                logger.warn({ taskIds, error }, "error: Heartbeat task failed");
+            },
+            onGatePermissionRequest: async (task, missing) => {
+                const label = task.title ? `heartbeat task "${task.title}" (${task.id})` : `heartbeat task ${task.id}`;
+                const target = { descriptor: { type: "system", tag: "heartbeat" } };
+                const agentId = await this.agentSystem.agentIdForTarget(target);
+                const result = await gatePermissionRequest({
+                    missing,
+                    taskLabel: label,
+                    agentSystem: this.agentSystem,
+                    connectorRegistry: options.connectorRegistry,
+                    permissionRequestRegistry: options.permissionRequestRegistry,
+                    agentId
+                });
+                return result.granted;
+            },
+            onTaskComplete: (task, runAt) => {
+                this.eventBus.emit("heartbeat.task.ran", { taskId: task.id, runAt: runAt.toISOString() });
+            }
+        });
+    }
+    async start() {
+        await this.scheduler.start();
+        const tasks = await this.listTasks();
+        this.eventBus.emit("heartbeat.started", { tasks });
+        if (tasks.length === 0) {
+            logger.info("event: No heartbeat tasks found on boot.");
+            return;
+        }
+        const withLastRun = tasks.filter((task) => typeof task.lastRunAt === "number");
+        const missingLastRun = tasks.filter((task) => typeof task.lastRunAt !== "number");
+        if (withLastRun.length > 0) {
+            const mostRecent = Math.max(...withLastRun.map((task) => task.lastRunAt ?? 0));
+            logger.info({
+                taskCount: tasks.length,
+                mostRecentRunAt: new Date(mostRecent).toISOString()
+            }, "load: Heartbeat last run loaded on boot");
+        }
+        if (missingLastRun.length > 0) {
+            logger.info({
+                taskCount: missingLastRun.length,
+                taskIds: missingLastRun.map((task) => task.id)
+            }, "event: Heartbeat missing last run info; running now");
+            await this.runNow({ ids: missingLastRun.map((task) => task.id) });
+        }
+        const nextRunAt = this.scheduler.getNextRunAt() ?? new Date(Date.now() + this.scheduler.getIntervalMs());
+        logger.info({ nextRunAt: nextRunAt.toISOString() }, "schedule: Next heartbeat run scheduled");
+    }
+    stop() {
+        this.scheduler.stop();
+    }
+    async listTasks() {
+        return this.scheduler.listTasks();
+    }
+    async runNow(args) {
+        return this.scheduler.runNow(args?.ids);
+    }
+    async addTask(ctx, args) {
+        return this.scheduler.createTask(ctx, args);
+    }
+    async removeTask(ctx, taskId) {
+        return this.scheduler.deleteTask(ctx, taskId);
+    }
+}
+//# sourceMappingURL=heartbeats.js.map

package/dist/engine/heartbeat/heartbeats.js.map

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

package/dist/engine/heartbeat/heartbeats.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=heartbeats.spec.d.ts.map

package/dist/engine/heartbeat/heartbeats.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeats.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/heartbeat/heartbeats.spec.ts"],"names":[],"mappings":""}

package/dist/engine/heartbeat/heartbeats.spec.js

@@ -0,0 +1,169 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { configResolve } from "../../config/configResolve.js";
+import { Storage } from "../../storage/storage.js";
+import { ConfigModule } from "../config/configModule.js";
+import { Heartbeats } from "./heartbeats.js";
+const { gatePermissionRequestMock } = vi.hoisted(() => ({
+    gatePermissionRequestMock: vi.fn()
+}));
+vi.mock("../scheduling/gatePermissionRequest.js", () => ({
+    gatePermissionRequest: gatePermissionRequestMock
+}));
+describe("Heartbeats", () => {
+    const tempDirs = [];
+    afterEach(async () => {
+        await Promise.all(tempDirs.map((dir) => fs.rm(dir, { recursive: true, force: true })));
+        tempDirs.length = 0;
+        gatePermissionRequestMock.mockReset();
+    });
+    it("wires onGatePermissionRequest to gatePermissionRequest", async () => {
+        const dir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-heartbeats-facade-"));
+        tempDirs.push(dir);
+        gatePermissionRequestMock.mockResolvedValue({ granted: true });
+        const connectorRegistry = {};
+        const permissionRequestRegistry = {};
+        const agentSystemMock = {
+            permissionsForTarget: vi.fn(async () => ({
+                workingDir: dir,
+                writeDirs: [],
+                readDirs: [],
+                network: false,
+                events: false
+            })),
+            agentIdForTarget: vi.fn(async () => "heartbeat-agent"),
+            updateAgentPermissions: vi.fn(),
+            postAndAwait: vi.fn(async () => ({ status: "completed" })),
+            post: vi.fn(async () => undefined)
+        };
+        const agentSystem = agentSystemMock;
+        const storage = Storage.open(":memory:");
+        try {
+            const heartbeats = new Heartbeats({
+                config: new ConfigModule(configResolve({ engine: { dataDir: dir } }, path.join(dir, "settings.json"))),
+                storage,
+                eventBus: { emit: vi.fn() },
+                agentSystem,
+                connectorRegistry,
+                permissionRequestRegistry
+            });
+            const callback = heartbeats.scheduler.onGatePermissionRequest;
+            expect(callback).toBeTypeOf("function");
+            const granted = await callback?.({
+                id: "heartbeat-task-1",
+                title: "Morning check",
+                prompt: "Run checks",
+                gate: null,
+                lastRunAt: null,
+                createdAt: 1,
+                updatedAt: 1
+            }, ["@network"]);
+            expect(granted).toBe(true);
+            expect(gatePermissionRequestMock).toHaveBeenCalledWith(expect.objectContaining({
+                missing: ["@network"],
+                taskLabel: 'heartbeat task "Morning check" (heartbeat-task-1)',
+                agentId: "heartbeat-agent",
+                connectorRegistry,
+                permissionRequestRegistry
+            }));
+        }
+        finally {
+            storage.close();
+        }
+    });
+    it("requires ctx for add/remove and scopes deletion by ctx user", async () => {
+        const dir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-heartbeats-add-remove-"));
+        tempDirs.push(dir);
+        const connectorRegistry = {};
+        const permissionRequestRegistry = {};
+        const agentSystem = {
+            permissionsForTarget: vi.fn(async () => ({
+                workingDir: dir,
+                writeDirs: [],
+                readDirs: [],
+                network: false,
+                events: false
+            })),
+            agentIdForTarget: vi.fn(async () => "heartbeat-agent"),
+            updateAgentPermissions: vi.fn(),
+            postAndAwait: vi.fn(async () => ({ status: "completed" })),
+            post: vi.fn(async () => undefined)
+        };
+        const storage = Storage.open(":memory:");
+        try {
+            const heartbeats = new Heartbeats({
+                config: new ConfigModule(configResolve({ engine: { dataDir: dir } }, path.join(dir, "settings.json"))),
+                storage,
+                eventBus: { emit: vi.fn() },
+                agentSystem,
+                connectorRegistry,
+                permissionRequestRegistry
+            });
+            const ctxA = contextBuild("user-a");
+            const ctxB = contextBuild("user-b");
+            const task = await heartbeats.addTask(ctxA, {
+                title: "Scoped heartbeat",
+                prompt: "Run scoped heartbeat"
+            });
+            await expect(heartbeats.removeTask(ctxB, task.id)).resolves.toBe(false);
+            await expect(heartbeats.removeTask(ctxA, task.id)).resolves.toBe(true);
+        }
+        finally {
+            storage.close();
+        }
+    });
+    it("posts executable system_message for heartbeat batches", async () => {
+        const dir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-heartbeats-execute-"));
+        tempDirs.push(dir);
+        const connectorRegistry = {};
+        const permissionRequestRegistry = {};
+        const agentSystemMock = {
+            permissionsForTarget: vi.fn(async () => ({
+                workingDir: dir,
+                writeDirs: [],
+                readDirs: [],
+                network: false,
+                events: false
+            })),
+            agentIdForTarget: vi.fn(async () => "heartbeat-agent"),
+            agentContextForAgentId: vi.fn(async () => ({ agentId: "heartbeat-agent", userId: "user-1" })),
+            updateAgentPermissions: vi.fn(),
+            postAndAwait: vi.fn(async () => ({ type: "system_message", responseText: null })),
+            post: vi.fn(async () => undefined)
+        };
+        const agentSystem = agentSystemMock;
+        const storage = Storage.open(":memory:");
+        try {
+            const heartbeats = new Heartbeats({
+                config: new ConfigModule(configResolve({ engine: { dataDir: dir } }, path.join(dir, "settings.json"))),
+                storage,
+                eventBus: { emit: vi.fn() },
+                agentSystem,
+                connectorRegistry,
+                permissionRequestRegistry
+            });
+            const callback = heartbeats.scheduler.onRun;
+            expect(callback).toBeTypeOf("function");
+            await callback?.([{ id: "hb-1", title: "Morning check", prompt: "Collect status." }]);
+            expect(agentSystemMock.postAndAwait).toHaveBeenCalledTimes(1);
+            expect(agentSystemMock.postAndAwait).toHaveBeenCalledWith({ descriptor: { type: "system", tag: "heartbeat" } }, {
+                type: "system_message",
+                text: "Collect status.",
+                origin: "heartbeat",
+                execute: true
+            });
+        }
+        finally {
+            storage.close();
+        }
+    });
+});
+function contextBuild(userId) {
+    return {
+        agentId: "agent-1",
+        userId
+    };
+}
+//# sourceMappingURL=heartbeats.spec.js.map

package/dist/engine/heartbeat/heartbeats.spec.js.map

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

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.d.ts

@@ -0,0 +1,12 @@
+import type { HeartbeatDefinition } from "../heartbeatTypes.js";
+/**
+ * Builds a prompt for running heartbeat tasks as a batch.
+ *
+ * Expects: array of HeartbeatDefinition tasks.
+ * Returns: { title, prompt } for the batch.
+ */
+export declare function heartbeatPromptBuildBatch(tasks: HeartbeatDefinition[]): {
+    title: string;
+    prompt: string;
+};
+//# sourceMappingURL=heartbeatPromptBuildBatch.d.ts.map

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatPromptBuildBatch.d.ts","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatPromptBuildBatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0BzG"}

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.js

@@ -0,0 +1,34 @@
+/**
+ * Builds a prompt for running heartbeat tasks as a batch.
+ *
+ * Expects: array of HeartbeatDefinition tasks.
+ * Returns: { title, prompt } for the batch.
+ */
+export function heartbeatPromptBuildBatch(tasks) {
+    const sorted = [...tasks].sort((a, b) => {
+        const titleCompare = a.title.localeCompare(b.title);
+        return titleCompare !== 0 ? titleCompare : a.id.localeCompare(b.id);
+    });
+    if (sorted.length === 1) {
+        return {
+            title: `Heartbeat: ${sorted[0].title}`,
+            prompt: sorted[0].prompt
+        };
+    }
+    const title = `Heartbeat batch (${sorted.length})`;
+    const sections = sorted.map((task, index) => {
+        const heading = `## ${index + 1}. ${task.title}`;
+        const idLine = `id: ${task.id}`;
+        const body = task.prompt.trim();
+        return [heading, idLine, "", body].filter(Boolean).join("\n");
+    });
+    const prompt = [
+        "# Heartbeat run",
+        "",
+        `Run all ${sorted.length} heartbeat tasks together. Keep results grouped by task.`,
+        "",
+        ...sections
+    ].join("\n");
+    return { title, prompt };
+}
+//# sourceMappingURL=heartbeatPromptBuildBatch.js.map

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatPromptBuildBatch.js","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatPromptBuildBatch.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAA4B;IAClE,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACH,KAAK,EAAE,cAAc,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK,EAAE;YACvC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,MAAM;SAC5B,CAAC;IACN,CAAC;IACD,MAAM,KAAK,GAAG,oBAAoB,MAAM,CAAC,MAAM,GAAG,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG;QACX,iBAAiB;QACjB,EAAE;QACF,WAAW,MAAM,CAAC,MAAM,0DAA0D;QAClF,EAAE;QACF,GAAG,QAAQ;KACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=heartbeatPromptBuildBatch.spec.d.ts.map

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatPromptBuildBatch.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatPromptBuildBatch.spec.ts"],"names":[],"mappings":""}

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.spec.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+import { heartbeatPromptBuildBatch } from "./heartbeatPromptBuildBatch.js";
+const buildTask = (id, title, prompt) => ({
+    id,
+    userId: "user-1",
+    title,
+    prompt,
+    gate: null,
+    lastRunAt: null,
+    createdAt: 1,
+    updatedAt: 1
+});
+describe("heartbeatPromptBuildBatch", () => {
+    it("returns a single-task prompt without batching", () => {
+        const task = buildTask("one", "Check mail", "Review the inbox.");
+        const result = heartbeatPromptBuildBatch([task]);
+        expect(result.title).toBe("Heartbeat: Check mail");
+        expect(result.prompt).toBe("Review the inbox.");
+    });
+    it("builds a sorted batch prompt", () => {
+        const first = buildTask("b", "Alpha", "Do alpha.");
+        const second = buildTask("a", "Alpha", "Do alpha second.");
+        const third = buildTask("c", "Bravo", "Do bravo.");
+        const result = heartbeatPromptBuildBatch([third, second, first]);
+        expect(result.title).toBe("Heartbeat batch (3)");
+        expect(result.prompt).toContain("# Heartbeat run");
+        expect(result.prompt).toContain("## 1. Alpha");
+        expect(result.prompt).toContain("id: a");
+        expect(result.prompt).toContain("Do alpha second.");
+        expect(result.prompt).toContain("## 2. Alpha");
+        expect(result.prompt).toContain("id: b");
+        expect(result.prompt).toContain("## 3. Bravo");
+    });
+});
+//# sourceMappingURL=heartbeatPromptBuildBatch.spec.js.map

package/dist/engine/heartbeat/ops/heartbeatPromptBuildBatch.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatPromptBuildBatch.spec.js","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatPromptBuildBatch.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,SAAS,GAAG,CAAC,EAAU,EAAE,KAAa,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC;IAC9D,EAAE;IACF,MAAM,EAAE,QAAQ;IAChB,KAAK;IACL,MAAM;IACN,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,CAAC;CACf,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,yBAAyB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,yBAAyB,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/engine/heartbeat/ops/heartbeatScheduler.d.ts

@@ -0,0 +1,43 @@
+import type { Context } from "@/types";
+import type { HeartbeatCreateTaskArgs, HeartbeatDefinition, HeartbeatSchedulerOptions } from "../heartbeatTypes.js";
+/**
+ * Manages interval-based heartbeat task execution.
+ *
+ * Runs all heartbeat tasks in a single batch at regular intervals.
+ */
+export declare class HeartbeatScheduler {
+    private config;
+    private repository;
+    private intervalMs;
+    private onRun;
+    private onError?;
+    private onGatePermissionRequest?;
+    private onTaskComplete?;
+    private resolveDefaultPermissions;
+    private resolvePermissions?;
+    private gateCheck;
+    private timer;
+    private started;
+    private stopped;
+    private running;
+    private nextRunAt;
+    constructor(options: HeartbeatSchedulerOptions);
+    start(): Promise<void>;
+    stop(): void;
+    runNow(taskIds?: string[]): Promise<{
+        ran: number;
+        taskIds: string[];
+    }>;
+    listTasks(): Promise<HeartbeatDefinition[]>;
+    createTask(ctx: Context, definition: HeartbeatCreateTaskArgs): Promise<HeartbeatDefinition>;
+    deleteTask(ctx: Context, taskId: string): Promise<boolean>;
+    getIntervalMs(): number;
+    getNextRunAt(): Date | null;
+    private generateTaskIdFromTitle;
+    private scheduleNext;
+    private tick;
+    private runOnce;
+    private runOnceUnlocked;
+    private filterByGate;
+}
+//# sourceMappingURL=heartbeatScheduler.d.ts.map

package/dist/engine/heartbeat/ops/heartbeatScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatScheduler.d.ts","sourceRoot":"","sources":["../../../../sources/engine/heartbeat/ops/heartbeatScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,SAAS,CAAC;AAQ3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAIpH;;;;GAIG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,OAAO,CAAC,CAAuC;IACvD,OAAO,CAAC,uBAAuB,CAAC,CAAuD;IACvF,OAAO,CAAC,cAAc,CAAC,CAA8C;IACrE,OAAO,CAAC,yBAAyB,CAAyD;IAC1F,OAAO,CAAC,kBAAkB,CAAC,CAAkD;IAC7E,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAqB;gBAE1B,OAAO,EAAE,yBAAyB;IAcxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,IAAI,IAAI,IAAI;IAaN,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAIvE,SAAS,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAI3C,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwD3F,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAehE,aAAa,IAAI,MAAM;IAIvB,YAAY,IAAI,IAAI,GAAG,IAAI;YAIb,uBAAuB;IAcrC,OAAO,CAAC,YAAY;YAcN,IAAI;YAWJ,OAAO;YAIP,eAAe;YAyDf,YAAY;CAqE7B"}