@cursor/july 0.1.27 → 0.1.29

package/dist/internal/host-platforms.js

@@ -14,7 +14,27 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { WebClient } from "@slack/web-api";
 import { createGitHubOctokit } from "../channels/github/api.js";
 import { ensureGhCliTokenEnv, hasGitHubAppCredentials, resolveCredentialValue, resolveGitHubInstallationId, tryResolveGhAuthToken, } from "../channels/github/auth.js";
-import { tryResolveBotToken } from "../channels/slack/credentials.js";
+import { slackEnvKeys, tryResolveBotToken, } from "../channels/slack/credentials.js";
+/** Bot-token Slack client. Pass channel credentials so `envPrefix` is honored. */
+export function createHostSlackClient(options = {}) {
+    let slackPromise;
+    return {
+        getClient: () => __awaiter(this, void 0, void 0, function* () {
+            slackPromise !== null && slackPromise !== void 0 ? slackPromise : (slackPromise = (() => __awaiter(this, void 0, void 0, function* () {
+                const token = yield tryResolveBotToken(options.credentials);
+                if (token === undefined) {
+                    const botKey = slackEnvKeys(options.envPrefix).bot;
+                    const hint = options.envPrefix === undefined || options.envPrefix.trim() === ""
+                        ? `${botKey} or a channel envPrefix`
+                        : botKey;
+                    throw new Error(`No Slack bot token available (set ${hint}).`);
+                }
+                return new WebClient(token);
+            }))());
+            return slackPromise;
+        }),
+    };
+}
 /**
  * Build host platforms from ambient credentials. Prefer App installation
  * auth when configured; otherwise fall back to PAT / `gh auth` for local
@@ -22,7 +42,6 @@ import { tryResolveBotToken } from "../channels/slack/credentials.js";
  */
 export function createHostPlatforms(options = {}) {
     let octokitPromise;
-    let slackPromise;
     return {
         github: {
             getOctokit: () => {
@@ -32,20 +51,10 @@ export function createHostPlatforms(options = {}) {
                 return octokitPromise;
             },
         },
-        slack: {
-            getClient: () => __awaiter(this, void 0, void 0, function* () {
-                if (slackPromise === undefined) {
-                    slackPromise = (() => __awaiter(this, void 0, void 0, function* () {
-                        const token = yield tryResolveBotToken(undefined);
-                        if (token === undefined) {
-                            throw new Error("No Slack bot token available (set SLACK_BOT_TOKEN or a channel envPrefix).");
-                        }
-                        return new WebClient(token);
-                    }))();
-                }
-                return slackPromise;
-            }),
-        },
+        slack: createHostSlackClient({
+            credentials: options.slackCredentials,
+            envPrefix: options.slackEnvPrefix,
+        }),
     };
 }
 /**

package/dist/internal/http-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-channel.d.ts","sourceRoot":"","sources":["../../src/internal/http-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,qBAAqB,EAErB,aAAa,EACd,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAQ7B,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,WAAW,EAAE,CAwYhB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,QAAQ,GAAG,SAAS,CAiBtB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC/D,QAAQ,CAQV;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,QAAQ,CAEV;AAoGD,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAc9C"}
+{"version":3,"file":"http-channel.d.ts","sourceRoot":"","sources":["../../src/internal/http-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,qBAAqB,EAErB,aAAa,EACd,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAQ7B,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,WAAW,EAAE,CA0YhB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,QAAQ,GAAG,SAAS,CAiBtB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC/D,QAAQ,CAQV;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,QAAQ,CAEV;AAoGD,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAc9C"}

package/dist/internal/http-channel.js

@@ -194,7 +194,9 @@ export function buildHttpChannelRoutes(args) {
             }
             const url = new URL(request.url);
             const asJson = url.searchParams.get("format") === "json";
-            const snapshot = yield engine.listEvents(sessionId, 0);
+            const snapshot = yield engine.listEvents(sessionId, 0, {
+                backfillCloudCost: true,
+            });
             if (asJson) {
                 return jsonResponse({
                     sessionId,

package/dist/internal/local-control-plane.d.ts

@@ -0,0 +1,25 @@
+/**
+ * In-process control plane started with local `serve`. Owns schedule clocks
+ * and reminder documents + clocks, then fires into the kit the same way the
+ * Cursor backend does over HTTP when `--no-control-plane` is set.
+ */
+import type { PlatformTimers } from "./platform-timers.js";
+export interface LocalControlPlane extends PlatformTimers {
+    /** Arm persisted reminder clocks after the kit fire callback is live. */
+    startClocks(): void;
+    stop(): void;
+}
+export declare function createLocalControlPlane(opts: {
+    fireSchedule: (name: string) => Promise<unknown>;
+    fireReminder: (id: string, fireCount: number) => Promise<unknown>;
+    /**
+     * Persist reminder documents under `<stateDir>/reminders`. Local serve
+     * passes `<stateRoot>/control-plane`; records previously stored at
+     * `<stateRoot>/reminders` are migrated in on first boot.
+     */
+    stateDir?: string;
+    /** Arm deadline timers. Off in `--dev`. Defaults to true. */
+    armReminderClocks?: boolean;
+    logger?: (line: string) => void;
+}): Promise<LocalControlPlane>;
+//# sourceMappingURL=local-control-plane.d.ts.map

package/dist/internal/local-control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-control-plane.d.ts","sourceRoot":"","sources":["../../src/internal/local-control-plane.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,yEAAyE;IACzE,WAAW,IAAI,IAAI,CAAC;IACpB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6J7B"}

package/dist/internal/local-control-plane.js

@@ -0,0 +1,172 @@
+/**
+ * In-process control plane started with local `serve`. Owns schedule clocks
+ * and reminder documents + clocks, then fires into the kit the same way the
+ * Cursor backend does over HTTP when `--no-control-plane` is set.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { dirname, join } from "node:path";
+import { parseCron } from "./cron.js";
+import { MAX_TIMER_MS } from "./reminder-schedule.js";
+import { ReminderStore } from "./reminder-store.js";
+export function createLocalControlPlane(opts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const logger = (_a = opts.logger) !== null && _a !== void 0 ? _a : (() => { });
+        const armReminderClocks = opts.armReminderClocks !== false;
+        const store = opts.stateDir === undefined
+            ? undefined
+            : new ReminderStore(join(opts.stateDir, "reminders"));
+        const schedules = new Map();
+        const reminderTimers = new Map();
+        const reminders = new Map();
+        let scheduleTimer;
+        let lastFiredMinute = -1;
+        if (store !== undefined) {
+            for (const record of yield store.list()) {
+                reminders.set(record.id, record);
+            }
+            if (opts.stateDir !== undefined) {
+                const legacyStore = new ReminderStore(join(dirname(opts.stateDir), "reminders"));
+                for (const record of yield legacyStore.list()) {
+                    if (reminders.has(record.id)) {
+                        yield legacyStore.delete(record.id);
+                        continue;
+                    }
+                    reminders.set(record.id, record);
+                    yield store.save(record);
+                    yield legacyStore.delete(record.id);
+                }
+            }
+        }
+        function armScheduleTicker() {
+            var _a;
+            if (scheduleTimer !== undefined || schedules.size === 0) {
+                return;
+            }
+            const now = Date.now();
+            const nextMinute = (Math.floor(now / 60000) + 1) * 60000;
+            scheduleTimer = setTimeout(() => tickSchedules(), nextMinute - now + 250);
+            (_a = scheduleTimer.unref) === null || _a === void 0 ? void 0 : _a.call(scheduleTimer);
+        }
+        function stopScheduleTicker() {
+            if (scheduleTimer === undefined) {
+                return;
+            }
+            clearTimeout(scheduleTimer);
+            scheduleTimer = undefined;
+        }
+        function tickSchedules() {
+            scheduleTimer = undefined;
+            const now = new Date();
+            const minute = Math.floor(now.getTime() / 60000);
+            if (minute !== lastFiredMinute) {
+                lastFiredMinute = minute;
+                for (const [name, cron] of schedules) {
+                    if (!cron.matches(now)) {
+                        continue;
+                    }
+                    void opts.fireSchedule(name).catch((error) => {
+                        logger(`[agentkit] schedule "${name}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
+                    });
+                }
+            }
+            armScheduleTicker();
+        }
+        function clearReminderTimer(id) {
+            const timer = reminderTimers.get(id);
+            if (timer !== undefined) {
+                clearTimeout(timer);
+                reminderTimers.delete(id);
+            }
+        }
+        function armReminder(record) {
+            var _a;
+            clearReminderTimer(record.id);
+            const delay = Math.min(MAX_TIMER_MS, Math.max(0, record.nextFireAtMs - Date.now()));
+            const timer = setTimeout(() => {
+                reminderTimers.delete(record.id);
+                const current = reminders.get(record.id);
+                if (current === undefined || current.status !== "armed") {
+                    return;
+                }
+                if (current.nextFireAtMs > Date.now() + 50) {
+                    armReminder(current);
+                    return;
+                }
+                void opts.fireReminder(current.id, current.fireCount).catch((error) => {
+                    logger(`[agentkit] reminder "${current.id}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
+                });
+            }, delay);
+            (_a = timer.unref) === null || _a === void 0 ? void 0 : _a.call(timer);
+            reminderTimers.set(record.id, timer);
+        }
+        return {
+            upsertSchedule(input) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    schedules.set(input.name, parseCron(input.cron));
+                    armScheduleTicker();
+                });
+            },
+            deleteSchedule(name) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    schedules.delete(name);
+                    if (schedules.size === 0) {
+                        stopScheduleTicker();
+                    }
+                });
+            },
+            putReminder(record) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    reminders.set(record.id, record);
+                    yield store === null || store === void 0 ? void 0 : store.save(record);
+                    if (armReminderClocks && record.status === "armed") {
+                        armReminder(record);
+                        return;
+                    }
+                    clearReminderTimer(record.id);
+                });
+            },
+            getReminder(id) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    return reminders.get(id);
+                });
+            },
+            listReminders() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    return [...reminders.values()];
+                });
+            },
+            deleteReminder(id) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    clearReminderTimer(id);
+                    reminders.delete(id);
+                    yield store === null || store === void 0 ? void 0 : store.delete(id);
+                });
+            },
+            startClocks() {
+                if (!armReminderClocks) {
+                    return;
+                }
+                for (const record of reminders.values()) {
+                    if (record.status === "armed") {
+                        armReminder(record);
+                    }
+                }
+            },
+            stop() {
+                stopScheduleTicker();
+                for (const id of [...reminderTimers.keys()]) {
+                    clearReminderTimer(id);
+                }
+            },
+        };
+    });
+}

package/dist/internal/platform-schedule-sync.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Keep control-plane Temporal calendars aligned with authored
+ * `agent/schedules/*`. Upsert current names and delete ones that disappeared
+ * since the last successful sync (persisted under the engine state root).
+ */
+import type { PlatformTimers } from "./platform-timers.js";
+export declare const PLATFORM_SCHEDULE_CATALOG_FILENAME = "platform-schedule-names.json";
+export declare function syncHostedPlatformSchedules(args: {
+    timers: PlatformTimers;
+    schedules: ReadonlyArray<{
+        name: string;
+        cron: string;
+    }>;
+    catalogPath: string;
+    logger: (line: string) => void;
+}): Promise<void>;
+//# sourceMappingURL=platform-schedule-sync.d.ts.map

package/dist/internal/platform-schedule-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-schedule-sync.d.ts","sourceRoot":"","sources":["../../src/internal/platform-schedule-sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,kCAAkC,iCACf,CAAC;AAEjC,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyChB"}

package/dist/internal/platform-schedule-sync.js

@@ -0,0 +1,72 @@
+/**
+ * Keep control-plane Temporal calendars aligned with authored
+ * `agent/schedules/*`. Upsert current names and delete ones that disappeared
+ * since the last successful sync (persisted under the engine state root).
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export const PLATFORM_SCHEDULE_CATALOG_FILENAME = "platform-schedule-names.json";
+export function syncHostedPlatformSchedules(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const previous = yield readScheduleCatalog(args.catalogPath);
+        const currentNames = args.schedules.map((schedule) => schedule.name);
+        const currentSet = new Set(currentNames);
+        const failedDeletes = [];
+        for (const name of previous) {
+            if (currentSet.has(name)) {
+                continue;
+            }
+            try {
+                yield args.timers.deleteSchedule(name);
+            }
+            catch (error) {
+                failedDeletes.push(name);
+                args.logger(`[agentkit] platform timer delete failed for schedule "${name}": ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        for (const schedule of args.schedules) {
+            try {
+                yield args.timers.upsertSchedule({
+                    name: schedule.name,
+                    cron: schedule.cron,
+                });
+            }
+            catch (error) {
+                args.logger(`[agentkit] platform timer upsert failed for schedule "${schedule.name}": ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // Keep failed removals in the catalog so the next boot retries them.
+        yield writeScheduleCatalog(args.catalogPath, [
+            ...new Set([...currentNames, ...failedDeletes]),
+        ]);
+    });
+}
+function readScheduleCatalog(catalogPath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const parsed = JSON.parse(yield readFile(catalogPath, "utf8"));
+            if (!Array.isArray(parsed)) {
+                return [];
+            }
+            return parsed.filter((entry) => typeof entry === "string");
+        }
+        catch (_a) {
+            return [];
+        }
+    });
+}
+function writeScheduleCatalog(catalogPath, names) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield mkdir(dirname(catalogPath), { recursive: true });
+        yield writeFile(catalogPath, `${JSON.stringify(names)}\n`, "utf8");
+    });
+}

package/dist/internal/platform-timers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Timed-work client used by the kit. Local serve implements this in-process
+ * (`createLocalControlPlane`). Cursor hosting (`--no-control-plane`) uses
+ * the HTTP client below against the Cursor backend. Authors never see this
+ * surface.
+ *
+ * The control plane owns reminder *documents* and clocks. The kit only
+ * executes fires.
+ */
+import { type ReminderRecord } from "./reminder-store.js";
+export interface PlatformTimers {
+    upsertSchedule(input: {
+        name: string;
+        cron: string;
+    }): Promise<void>;
+    deleteSchedule(name: string): Promise<void>;
+    putReminder(record: ReminderRecord): Promise<void>;
+    getReminder(id: string): Promise<ReminderRecord | undefined>;
+    listReminders(): Promise<ReminderRecord[]>;
+    deleteReminder(id: string): Promise<void>;
+}
+export interface CursorHostedPlatformTimersOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    fetch?: typeof fetch;
+}
+export declare function createCursorHostedPlatformTimers(options?: CursorHostedPlatformTimersOptions): PlatformTimers;
+//# sourceMappingURL=platform-timers.d.ts.map

package/dist/internal/platform-timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-timers.d.ts","sourceRoot":"","sources":["../../src/internal/platform-timers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI5E,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC7D,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAqED,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,cAAc,CA0EhB"}

package/dist/internal/platform-timers.js

@@ -0,0 +1,120 @@
+/**
+ * Timed-work client used by the kit. Local serve implements this in-process
+ * (`createLocalControlPlane`). Cursor hosting (`--no-control-plane`) uses
+ * the HTTP client below against the Cursor backend. Authors never see this
+ * surface.
+ *
+ * The control plane owns reminder *documents* and clocks. The kit only
+ * executes fires.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { isReminderRecord } from "./reminder-store.js";
+const DEFAULT_CURSOR_EXTERNAL_API_URL = "https://api.cursor.com";
+function resolveApiKey(options) {
+    var _a;
+    var _b;
+    const key = (_a = ((_b = options.apiKey) !== null && _b !== void 0 ? _b : process.env.CURSOR_API_KEY)) === null || _a === void 0 ? void 0 : _a.trim();
+    if (key === undefined || key === "") {
+        throw new Error("platform timers require CURSOR_API_KEY (deployment pod credential on Cursor hosting)");
+    }
+    return key;
+}
+function resolveBaseUrl(options) {
+    var _a, _b;
+    const raw = ((_b = (_a = options.baseUrl) !== null && _a !== void 0 ? _a : process.env.CURSOR_API_BASE_URL) !== null && _b !== void 0 ? _b : DEFAULT_CURSOR_EXTERNAL_API_URL).trim();
+    return raw.endsWith("/") ? raw.slice(0, -1) : raw;
+}
+function timedWorkFetch(options, method, path, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const fetchImpl = (_a = options.fetch) !== null && _a !== void 0 ? _a : globalThis.fetch;
+        if (typeof fetchImpl !== "function") {
+            throw new Error("platform timers require fetch");
+        }
+        return fetchImpl(`${resolveBaseUrl(options)}${path}`, Object.assign({ method, headers: Object.assign({ Authorization: `Bearer ${resolveApiKey(options)}` }, (body === undefined ? {} : { "Content-Type": "application/json" })) }, (body === undefined ? {} : { body: JSON.stringify(body) })));
+    });
+}
+function timedWorkRpc(options, method, path, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield timedWorkFetch(options, method, path, body);
+        if (response.ok) {
+            return;
+        }
+        const text = yield response.text();
+        let detail = `HTTP ${response.status}`;
+        try {
+            const parsed = text.length === 0 ? {} : JSON.parse(text);
+            if (parsed !== null &&
+                typeof parsed === "object" &&
+                "error" in parsed &&
+                typeof parsed.error === "string") {
+                detail = parsed.error;
+            }
+        }
+        catch (_a) {
+            // Keep the status-only detail.
+        }
+        throw new Error(`platform timers ${method} ${path}: ${detail}`);
+    });
+}
+export function createCursorHostedPlatformTimers(options = {}) {
+    return {
+        upsertSchedule(input) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield timedWorkRpc(options, "PUT", `/internal/agent-serve/timed-work/schedules/${encodeURIComponent(input.name)}`, { cron: input.cron });
+            });
+        },
+        deleteSchedule(name) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield timedWorkRpc(options, "DELETE", `/internal/agent-serve/timed-work/schedules/${encodeURIComponent(name)}`);
+            });
+        },
+        putReminder(record) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield timedWorkRpc(options, "PUT", `/internal/agent-serve/timed-work/reminders/${encodeURIComponent(record.id)}`, record);
+            });
+        },
+        getReminder(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield timedWorkFetch(options, "GET", `/internal/agent-serve/timed-work/reminders/${encodeURIComponent(id)}`);
+                if (response.status === 404) {
+                    return undefined;
+                }
+                if (!response.ok) {
+                    throw new Error(`platform timers GET /reminders/${id}: HTTP ${response.status}`);
+                }
+                const parsed = yield response.json();
+                return isReminderRecord(parsed) ? parsed : undefined;
+            });
+        },
+        listReminders() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield timedWorkFetch(options, "GET", "/internal/agent-serve/timed-work/reminders");
+                if (!response.ok) {
+                    throw new Error(`platform timers GET /reminders: HTTP ${response.status}`);
+                }
+                const parsed = yield response.json();
+                if (parsed === null ||
+                    typeof parsed !== "object" ||
+                    !("reminders" in parsed) ||
+                    !Array.isArray(parsed.reminders)) {
+                    return [];
+                }
+                return parsed.reminders.filter(isReminderRecord);
+            });
+        },
+        deleteReminder(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield timedWorkRpc(options, "DELETE", `/internal/agent-serve/timed-work/reminders/${encodeURIComponent(id)}`);
+            });
+        },
+    };
+}

package/dist/internal/reminder-runner.d.ts

@@ -4,7 +4,8 @@
  * function XOR prompt.
  */
 import type { ReminderCreateInput, ReminderInfo } from "../types.js";
-import { type ReminderRecord } from "./reminder-store.js";
+import type { PlatformTimers } from "./platform-timers.js";
+import type { ReminderRecord } from "./reminder-store.js";
 import { type SessionEngine } from "./session-engine.js";
 export { ReminderValidationError } from "./reminder-schedule.js";
 export declare class UnknownReminderError extends Error {
@@ -14,24 +15,25 @@ export declare class UnknownReminderError extends Error {
 export declare class ReminderRunner {
     private readonly engine;
     private readonly logger;
-    private readonly store;
+    private readonly platformTimers?;
+    private readonly records;
     private readonly handlers;
     private readonly timers;
     private readonly firing;
     /** Single-flight idle gates keyed by `channelId:continuationToken`. */
     private readonly idleGates;
     private started;
-    constructor(engine: SessionEngine, logger?: (line: string) => void);
-    get storeRoot(): string;
-    /** Start deadline timers for armed reminders (call after restore). */
-    start(): Promise<void>;
+    constructor(engine: SessionEngine, logger?: (line: string) => void, platformTimers?: PlatformTimers | undefined);
     /**
-     * Pull reminder records from `defineStorage` into `<stateRoot>/reminders`
-     * when local disk is empty for that id. Failures are logged and skipped.
+     * Load reminder documents from the control plane into memory. Does not
+     * arm in-process timers — the CP owns clocks.
      */
-    private hydrateFromStorage;
-    /** Persist locally and mirror into the authored storage sink when present. */
+    hydrate(): Promise<void>;
+    /** Start deadline timers for armed reminders (tests / no control plane). */
+    start(): Promise<void>;
     private persist;
+    private getRecord;
+    private allRecords;
     stop(): void;
     create(input: ReminderCreateInput): Promise<ReminderInfo>;
     list(filter?: {
@@ -49,8 +51,10 @@ export declare class ReminderRunner {
      * time and disarms as `session_gone`.
      */
     rekeyContinuation(channelId: string, oldToken: string, newToken: string): Promise<number>;
-    /** Fire one reminder immediately (dev / hillclimb). */
-    dispatch(reminderId: string): Promise<{
+    /** Fire one reminder immediately (dev / hillclimb / control plane). */
+    dispatch(reminderId: string, opts?: {
+        expectedFireCount?: number;
+    }): Promise<{
         reminderId: string;
         outcome: "fired" | "noop";
         reason?: string;

package/dist/internal/reminder-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAGnB,YAAY,EAEb,MAAM,aAAa,CAAC;AASrB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAFzC,YACE,UAAU,EAAE,MAAM,EACT,oBAAoB,EAAE,MAAM,EAAE,EAIxC;CACF;AAyDD,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe,EAG3D;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B3B;IAED;;;OAGG;YACW,kBAAkB;IA6BhC,8EAA8E;YAChE,OAAO;IAKrB,IAAI,IAAI,IAAI,CAOX;IAEK,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8D9D;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4B1B;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,SAAoB,GACzB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAED,iFAAiF;IAC3E,qBAAqB,CACzB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;IAED;;;;;OAKG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAkBjB;IAED,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAQD;IAED,OAAO,CAAC,QAAQ;IA4ChB,OAAO,CAAC,UAAU;YAQJ,IAAI;YA6GJ,aAAa;IAY3B,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;YACW,mBAAmB;YAcnB,aAAa;YAcb,YAAY;IA0C1B,OAAO,CAAC,gBAAgB;IA0DxB,OAAO,CAAC,iBAAiB;YAeX,MAAM;YAYN,SAAS;CAoFxB;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"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"}