@grackle-ai/plugin-scheduling 0.98.0

package/README.md

@@ -0,0 +1,19 @@
+# @grackle-ai/plugin-scheduling
+
+Scheduling plugin for Grackle. Provides:
+
+- **Schedule CRUD handlers** — `createSchedule`, `listSchedules`, `getSchedule`, `updateSchedule`, `deleteSchedule` gRPC methods
+- **Cron reconciliation phase** — fires due schedules on each tick, creates tasks, enqueues for dispatch
+- **Schedule expression parsing** — interval shorthand (`30s`, `5m`, `1h`, `1d`) and standard 5-field cron syntax
+
+## Usage
+
+```typescript
+import { createSchedulingPlugin } from "@grackle-ai/plugin-scheduling";
+import { createCorePlugin } from "@grackle-ai/server";
+import { loadPlugins } from "@grackle-ai/plugin-sdk";
+
+const loaded = await loadPlugins([createCorePlugin(), createSchedulingPlugin()], ctx);
+```
+
+The scheduling plugin declares `dependencies: ["core"]` so it is always loaded after the core plugin.

package/dist/cron-phase.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Cron reconciliation phase — fires due schedules on each tick.
+ *
+ * Creates tasks for due schedules and enqueues them for dispatch.
+ * The dispatch phase (separate reconciliation phase) handles starting
+ * sessions, respecting concurrency limits, and environment resolution.
+ */
+import type { Logger } from "pino";
+import type { ScheduleRow } from "@grackle-ai/database";
+import type { GrackleEventType } from "@grackle-ai/core";
+import type { ReconciliationPhase } from "@grackle-ai/plugin-sdk";
+/** Dependencies injected into the cron phase for testability. */
+export interface CronPhaseDeps {
+    /** Query the schedule store for due entries. */
+    getDueSchedules: () => ScheduleRow[];
+    /** Advance a schedule after firing (update lastRunAt, nextRunAt, runCount). */
+    advanceSchedule: (id: string, lastRunAt: string, nextRunAt: string) => void;
+    /** Create a new task in the task store. */
+    createTask: (id: string, workspaceId: string | undefined, title: string, description: string, dependsOn: string[], workspaceSlug: string, parentTaskId?: string, canDecompose?: boolean, defaultPersonaId?: string) => void;
+    /** Set the schedule_id FK on a task. */
+    setTaskScheduleId: (taskId: string, scheduleId: string) => void;
+    /** Enqueue a task for the dispatch phase to start. */
+    enqueueForDispatch: (entry: {
+        id: string;
+        taskId: string;
+        environmentId?: string;
+        personaId?: string;
+    }) => void;
+    /** Emit a domain event. */
+    emit: (type: GrackleEventType, payload: Record<string, unknown>) => void;
+    /** Look up a persona by ID. */
+    getPersona: (id: string) => {
+        id: string;
+        name: string;
+        runtime: string;
+    } | undefined;
+    /** Enable or disable a schedule, setting or clearing nextRunAt. */
+    setScheduleEnabled: (id: string, enabled: boolean, nextRunAt: string | null) => void;
+    /** Logger instance provided by the plugin context. */
+    logger: Pick<Logger, "debug" | "info" | "warn" | "error">;
+}
+/**
+ * Create a ReconciliationPhase that fires due schedules.
+ *
+ * @param deps - Injected dependencies
+ * @returns A phase to register with ReconciliationManager
+ */
+export declare function createCronPhase(deps: CronPhaseDeps): ReconciliationPhase;
+//# sourceMappingURL=cron-phase.d.ts.map

package/dist/cron-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-phase.d.ts","sourceRoot":"","sources":["../src/cron-phase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,eAAe,EAAE,MAAM,WAAW,EAAE,CAAC;IACrC,+EAA+E;IAC/E,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,2CAA2C;IAC3C,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,OAAO,EACtB,gBAAgB,CAAC,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,wCAAwC;IACxC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,sDAAsD;IACtD,kBAAkB,EAAE,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAChH,2BAA2B;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACzE,+BAA+B;IAC/B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtF,mEAAmE;IAEnE,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrF,sDAAsD;IACtD,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAcxE"}

package/dist/cron-phase.js

@@ -0,0 +1,87 @@
+/**
+ * Cron reconciliation phase — fires due schedules on each tick.
+ *
+ * Creates tasks for due schedules and enqueues them for dispatch.
+ * The dispatch phase (separate reconciliation phase) handles starting
+ * sessions, respecting concurrency limits, and environment resolution.
+ */
+import { v4 as uuidv4 } from "uuid";
+import { computeNextRunAt } from "./schedule-expression.js";
+import { ROOT_TASK_ID } from "@grackle-ai/common";
+/**
+ * Create a ReconciliationPhase that fires due schedules.
+ *
+ * @param deps - Injected dependencies
+ * @returns A phase to register with ReconciliationManager
+ */
+export function createCronPhase(deps) {
+    return {
+        name: "cron",
+        execute: async () => {
+            const due = deps.getDueSchedules();
+            if (due.length === 0) {
+                return;
+            }
+            deps.logger.debug({ count: due.length }, "Cron phase: due schedules");
+            for (const schedule of due) {
+                fireSchedule(deps, schedule);
+            }
+        },
+    };
+}
+/** Fire a single schedule: create task, enqueue for dispatch, advance. */
+function fireSchedule(deps, schedule) {
+    const now = new Date().toISOString();
+    let nextRunAt;
+    try {
+        // Anchor to the schedule's lastRunAt (not current time) to prevent drift
+        nextRunAt = computeNextRunAt(schedule.scheduleExpression, schedule.lastRunAt ?? undefined);
+    }
+    catch (err) {
+        deps.logger.error({ scheduleId: schedule.id, scheduleExpression: schedule.scheduleExpression, err }, "Cron phase: failed to compute nextRunAt; disabling schedule");
+        // Disable the schedule to prevent error loop on every tick
+        deps.setScheduleEnabled(schedule.id, false, null);
+        return;
+    }
+    try {
+        // Validate persona exists
+        const persona = deps.getPersona(schedule.personaId);
+        if (!persona) {
+            deps.logger.warn({ scheduleId: schedule.id, personaId: schedule.personaId }, "Schedule fire skipped: persona not found");
+            deps.advanceSchedule(schedule.id, now, nextRunAt);
+            return;
+        }
+        // Create task
+        const taskId = uuidv4();
+        const taskTitle = `${schedule.title} @ ${now}`;
+        const parentTaskId = schedule.parentTaskId || ROOT_TASK_ID;
+        deps.createTask(taskId, schedule.workspaceId || undefined, taskTitle, schedule.description, [], // no dependencies
+        "", // no workspace slug
+        parentTaskId, false, // canDecompose
+        schedule.personaId);
+        deps.setTaskScheduleId(taskId, schedule.id);
+        // Enqueue for the dispatch phase to start (respects concurrency limits).
+        // Environment resolution is handled by the dispatch phase; we pass the
+        // schedule's preferred environmentId as a hint.
+        deps.enqueueForDispatch({
+            id: uuidv4(),
+            taskId,
+            environmentId: schedule.environmentId,
+            personaId: schedule.personaId,
+        });
+        // Advance schedule
+        deps.advanceSchedule(schedule.id, now, nextRunAt);
+        deps.emit("schedule.fired", {
+            scheduleId: schedule.id,
+            taskId,
+            firedAt: now,
+        });
+        deps.logger.info({ scheduleId: schedule.id, taskId, title: schedule.title }, "Schedule fired");
+    }
+    catch (err) {
+        deps.logger.error({ scheduleId: schedule.id, err }, "Schedule fire failed with exception");
+        // Still advance to prevent retry storms
+        deps.advanceSchedule(schedule.id, now, nextRunAt);
+    }
+}
+//# sourceMappingURL=cron-phase.js.map

package/dist/cron-phase.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createSchedulingPlugin } from "./scheduling-plugin.js";
+export { createCronPhase } from "./cron-phase.js";
+export type { CronPhaseDeps } from "./cron-phase.js";
+export { validateExpression, computeNextRunAt, parseDuration, isIntervalExpression } from "./schedule-expression.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// ─── Plugin Entry Point ──────────────────────────────────────
+export { createSchedulingPlugin } from "./scheduling-plugin.js";
+// ─── Reconciliation Phase ────────────────────────────────────
+export { createCronPhase } from "./cron-phase.js";
+// ─── Expression Utilities ────────────────────────────────────
+export { validateExpression, computeNextRunAt, parseDuration, isIntervalExpression } from "./schedule-expression.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,gEAAgE;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,gEAAgE;AAChE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/schedule-expression.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Schedule expression parsing and next-run-time computation.
+ *
+ * Supports two formats:
+ * - **Interval shorthand**: `"<number><unit>"` where unit is s/m/h/d (min 10s)
+ * - **Cron expressions**: Standard 5-field cron syntax via `cron-parser`
+ */
+/**
+ * Parse an interval shorthand expression to milliseconds.
+ *
+ * @param expr - e.g. "30s", "5m", "1h", "1d"
+ * @returns Duration in milliseconds
+ * @throws If the expression is invalid or below the minimum (10s)
+ */
+export declare function parseDuration(expr: string): number;
+/**
+ * Detect whether an expression is interval shorthand (vs. cron).
+ *
+ * @param expr - Schedule expression string
+ * @returns true if the expression matches interval shorthand format
+ */
+export declare function isIntervalExpression(expr: string): boolean;
+/**
+ * Compute the next run time for a schedule expression.
+ *
+ * For intervals: if `lastRunAt + interval` is in the future, use that (prevents
+ * drift). Otherwise use `now + interval` (prevents burst-firing after downtime).
+ *
+ * For cron: next occurrence after now.
+ *
+ * @param expr - Schedule expression (interval or cron)
+ * @param lastRunAt - ISO timestamp of the last fire (undefined for first fire)
+ * @returns ISO timestamp of the next fire
+ */
+export declare function computeNextRunAt(expr: string, lastRunAt?: string): string;
+/**
+ * Validate a schedule expression. Throws if invalid.
+ *
+ * @param expr - Schedule expression to validate
+ * @throws If the expression is neither valid interval shorthand nor valid cron
+ */
+export declare function validateExpression(expr: string): void;
+//# sourceMappingURL=schedule-expression.d.ts.map

package/dist/schedule-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-expression.d.ts","sourceRoot":"","sources":["../src/schedule-expression.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBlD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBrD"}

package/dist/schedule-expression.js

@@ -0,0 +1,105 @@
+/**
+ * Schedule expression parsing and next-run-time computation.
+ *
+ * Supports two formats:
+ * - **Interval shorthand**: `"<number><unit>"` where unit is s/m/h/d (min 10s)
+ * - **Cron expressions**: Standard 5-field cron syntax via `cron-parser`
+ */
+import cronParser from "cron-parser";
+const INTERVAL_RE = /^(\d+)([smhd])$/;
+const MINIMUM_INTERVAL_MS = 10_000; // 10 seconds
+const UNIT_TO_MS = {
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+};
+/**
+ * Parse an interval shorthand expression to milliseconds.
+ *
+ * @param expr - e.g. "30s", "5m", "1h", "1d"
+ * @returns Duration in milliseconds
+ * @throws If the expression is invalid or below the minimum (10s)
+ */
+export function parseDuration(expr) {
+    const match = INTERVAL_RE.exec(expr);
+    if (!match) {
+        throw new Error(`Invalid interval expression: "${expr}". Expected format: <number><s|m|h|d> (e.g. "30s", "5m")`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const ms = value * UNIT_TO_MS[unit];
+    if (ms <= 0) {
+        throw new Error(`Interval must be positive: "${expr}"`);
+    }
+    if (ms < MINIMUM_INTERVAL_MS) {
+        throw new Error(`Interval "${expr}" (${ms}ms) is below the minimum of ${MINIMUM_INTERVAL_MS}ms (10s)`);
+    }
+    return ms;
+}
+/**
+ * Detect whether an expression is interval shorthand (vs. cron).
+ *
+ * @param expr - Schedule expression string
+ * @returns true if the expression matches interval shorthand format
+ */
+export function isIntervalExpression(expr) {
+    return INTERVAL_RE.test(expr);
+}
+/**
+ * Compute the next run time for a schedule expression.
+ *
+ * For intervals: if `lastRunAt + interval` is in the future, use that (prevents
+ * drift). Otherwise use `now + interval` (prevents burst-firing after downtime).
+ *
+ * For cron: next occurrence after now.
+ *
+ * @param expr - Schedule expression (interval or cron)
+ * @param lastRunAt - ISO timestamp of the last fire (undefined for first fire)
+ * @returns ISO timestamp of the next fire
+ */
+export function computeNextRunAt(expr, lastRunAt) {
+    const now = Date.now();
+    if (isIntervalExpression(expr)) {
+        const intervalMs = parseDuration(expr);
+        const nowPlusInterval = now + intervalMs;
+        if (lastRunAt) {
+            const lastRunMs = new Date(lastRunAt).getTime();
+            const anchored = lastRunMs + intervalMs;
+            // Anchored: use lastRunAt + interval if it's in the future (prevents drift).
+            // If it's in the past (server was down), cap to now + interval (prevents burst).
+            if (anchored > now) {
+                return new Date(anchored).toISOString();
+            }
+            return new Date(nowPlusInterval).toISOString();
+        }
+        return new Date(nowPlusInterval).toISOString();
+    }
+    // Cron expression: compute next occurrence after now
+    const interval = cronParser.parseExpression(expr, { utc: true });
+    return interval.next().toISOString();
+}
+/**
+ * Validate a schedule expression. Throws if invalid.
+ *
+ * @param expr - Schedule expression to validate
+ * @throws If the expression is neither valid interval shorthand nor valid cron
+ */
+export function validateExpression(expr) {
+    if (!expr) {
+        throw new Error("Schedule expression cannot be empty");
+    }
+    if (isIntervalExpression(expr)) {
+        // parseDuration validates format and minimum
+        parseDuration(expr);
+        return;
+    }
+    // Try to parse as cron
+    try {
+        cronParser.parseExpression(expr, { utc: true });
+    }
+    catch {
+        throw new Error(`Invalid schedule expression: "${expr}". Must be interval shorthand (e.g. "30s", "5m") or 5-field cron (e.g. "0 9 * * MON")`);
+    }
+}
+//# sourceMappingURL=schedule-expression.js.map

package/dist/schedule-expression.js.map

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

package/dist/schedule-handlers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Schedule gRPC handler factory.
+ *
+ * Call `createScheduleHandlers(emit)` to obtain the 5 handler functions
+ * with `emit` captured via closure. This factory pattern allows the
+ * scheduling plugin to inject `ctx.emit` from `PluginContext` without
+ * depending on the singleton event bus.
+ */
+import { grackle } from "@grackle-ai/common";
+import type { PluginContext } from "@grackle-ai/plugin-sdk";
+/**
+ * Create the 5 schedule gRPC handler functions with `emit` injected.
+ *
+ * @param emit - Event emitter from the plugin context (`ctx.emit`)
+ * @returns Object containing all schedule handler methods
+ */
+export declare function createScheduleHandlers(emit: PluginContext["emit"]): {
+    createSchedule: (req: grackle.CreateScheduleRequest) => Promise<grackle.Schedule>;
+    listSchedules: (req: grackle.ListSchedulesRequest) => Promise<grackle.ScheduleList>;
+    getSchedule: (req: grackle.ScheduleId) => Promise<grackle.Schedule>;
+    updateSchedule: (req: grackle.UpdateScheduleRequest) => Promise<grackle.Schedule>;
+    deleteSchedule: (req: grackle.ScheduleId) => Promise<grackle.Empty>;
+};
+//# sourceMappingURL=schedule-handlers.d.ts.map

package/dist/schedule-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-handlers.d.ts","sourceRoot":"","sources":["../src/schedule-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG;IACnE,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClF,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACpF,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClF,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;CACrE,CAwIA"}

package/dist/schedule-handlers.js

@@ -0,0 +1,138 @@
+/**
+ * Schedule gRPC handler factory.
+ *
+ * Call `createScheduleHandlers(emit)` to obtain the 5 handler functions
+ * with `emit` captured via closure. This factory pattern allows the
+ * scheduling plugin to inject `ctx.emit` from `PluginContext` without
+ * depending on the singleton event bus.
+ */
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { personaStore, scheduleStore } from "@grackle-ai/database";
+import { v4 as uuid } from "uuid";
+import { validateExpression, computeNextRunAt } from "./schedule-expression.js";
+import { scheduleRowToProto } from "./schedule-proto.js";
+/**
+ * Create the 5 schedule gRPC handler functions with `emit` injected.
+ *
+ * @param emit - Event emitter from the plugin context (`ctx.emit`)
+ * @returns Object containing all schedule handler methods
+ */
+export function createScheduleHandlers(emit) {
+    /** Create a new schedule. */
+    async function createSchedule(req) {
+        const title = req.title.trim();
+        const expr = req.scheduleExpression.trim();
+        const personaId = req.personaId.trim();
+        if (!title) {
+            throw new ConnectError("title is required", Code.InvalidArgument);
+        }
+        if (!expr) {
+            throw new ConnectError("schedule_expression is required", Code.InvalidArgument);
+        }
+        if (!personaId) {
+            throw new ConnectError("persona_id is required", Code.InvalidArgument);
+        }
+        // Validate persona exists
+        const persona = personaStore.getPersona(personaId);
+        if (!persona) {
+            throw new ConnectError(`Persona not found: ${personaId}`, Code.NotFound);
+        }
+        // Validate expression
+        try {
+            validateExpression(expr);
+        }
+        catch (err) {
+            throw new ConnectError(err instanceof Error ? err.message : "Invalid schedule expression", Code.InvalidArgument);
+        }
+        const id = uuid();
+        const nextRunAt = computeNextRunAt(expr);
+        scheduleStore.createSchedule(id, title, req.description, expr, personaId, req.environmentId, req.workspaceId, req.parentTaskId, nextRunAt);
+        emit("schedule.created", { scheduleId: id });
+        const row = scheduleStore.getSchedule(id);
+        return scheduleRowToProto(row);
+    }
+    /** List all schedules, optionally filtered by workspace. */
+    async function listSchedules(req) {
+        const rows = scheduleStore.listSchedules(req.workspaceId || undefined);
+        return create(grackle.ScheduleListSchema, {
+            schedules: rows.map(scheduleRowToProto),
+        });
+    }
+    /** Get a schedule by ID. */
+    async function getSchedule(req) {
+        const row = scheduleStore.getSchedule(req.id);
+        if (!row) {
+            throw new ConnectError(`Schedule not found: ${req.id}`, Code.NotFound);
+        }
+        return scheduleRowToProto(row);
+    }
+    /** Update an existing schedule. */
+    async function updateSchedule(req) {
+        const existing = scheduleStore.getSchedule(req.id);
+        if (!existing) {
+            throw new ConnectError(`Schedule not found: ${req.id}`, Code.NotFound);
+        }
+        const update = {};
+        if (req.title !== undefined && req.title.trim() !== "") {
+            update.title = req.title.trim();
+        }
+        if (req.description !== undefined) {
+            update.description = req.description;
+        }
+        if (req.personaId !== undefined && req.personaId.trim() !== "") {
+            const trimmedPersonaId = req.personaId.trim();
+            const persona = personaStore.getPersona(trimmedPersonaId);
+            if (!persona) {
+                throw new ConnectError(`Persona not found: ${trimmedPersonaId}`, Code.NotFound);
+            }
+            update.personaId = trimmedPersonaId;
+        }
+        if (req.environmentId !== undefined) {
+            update.environmentId = req.environmentId;
+        }
+        // Handle schedule expression change
+        let expressionChanged = false;
+        if (req.scheduleExpression !== undefined && req.scheduleExpression !== "") {
+            const expr = req.scheduleExpression.trim();
+            try {
+                validateExpression(expr);
+            }
+            catch (err) {
+                throw new ConnectError(err instanceof Error ? err.message : "Invalid schedule expression", Code.InvalidArgument);
+            }
+            update.scheduleExpression = expr;
+            expressionChanged = true;
+        }
+        // Handle enable/disable
+        if (req.enabled !== undefined) {
+            update.enabled = req.enabled;
+            if (req.enabled) {
+                const expr = update.scheduleExpression ?? existing.scheduleExpression;
+                update.nextRunAt = computeNextRunAt(expr);
+            }
+            else {
+                update.nextRunAt = null;
+            }
+        }
+        else if (expressionChanged) {
+            // Recompute nextRunAt when expression changes (if currently enabled)
+            if (existing.enabled) {
+                update.nextRunAt = computeNextRunAt(update.scheduleExpression);
+            }
+        }
+        scheduleStore.updateSchedule(req.id, update);
+        emit("schedule.updated", { scheduleId: req.id });
+        const row = scheduleStore.getSchedule(req.id);
+        return scheduleRowToProto(row);
+    }
+    /** Delete a schedule by ID. */
+    async function deleteSchedule(req) {
+        scheduleStore.deleteSchedule(req.id);
+        emit("schedule.deleted", { scheduleId: req.id });
+        return create(grackle.EmptySchema, {});
+    }
+    return { createSchedule, listSchedules, getSchedule, updateSchedule, deleteSchedule };
+}
+//# sourceMappingURL=schedule-handlers.js.map

package/dist/schedule-handlers.js.map

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

package/dist/schedule-proto.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Proto converter for schedule database rows.
+ */
+import { grackle } from "@grackle-ai/common";
+import type { scheduleStore } from "@grackle-ai/database";
+/** Convert a schedule database row to its proto representation. */
+export declare function scheduleRowToProto(row: scheduleStore.ScheduleRow): grackle.Schedule;
+//# sourceMappingURL=schedule-proto.d.ts.map

package/dist/schedule-proto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-proto.d.ts","sourceRoot":"","sources":["../src/schedule-proto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,CAAC,WAAW,GAAG,OAAO,CAAC,QAAQ,CAiBnF"}

package/dist/schedule-proto.js

@@ -0,0 +1,25 @@
+/**
+ * Proto converter for schedule database rows.
+ */
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+/** Convert a schedule database row to its proto representation. */
+export function scheduleRowToProto(row) {
+    return create(grackle.ScheduleSchema, {
+        id: row.id,
+        title: row.title,
+        description: row.description,
+        scheduleExpression: row.scheduleExpression,
+        personaId: row.personaId,
+        environmentId: row.environmentId,
+        workspaceId: row.workspaceId,
+        parentTaskId: row.parentTaskId,
+        enabled: row.enabled,
+        lastRunAt: row.lastRunAt ?? "",
+        nextRunAt: row.nextRunAt ?? "",
+        runCount: row.runCount,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    });
+}
+//# sourceMappingURL=schedule-proto.js.map

package/dist/schedule-proto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-proto.js","sourceRoot":"","sources":["../src/schedule-proto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,GAA8B;IAC/D,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE;QACpC,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;QAC1C,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC"}

package/dist/scheduling-plugin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Scheduling plugin — contributes schedule CRUD handlers and the cron
+ * reconciliation phase to the Grackle server.
+ *
+ * Declares `dependencies: ["core"]` so core handlers are registered first.
+ *
+ * @module
+ */
+import type { GracklePlugin } from "@grackle-ai/plugin-sdk";
+/**
+ * Create the scheduling plugin that contributes schedule CRUD and cron phase.
+ *
+ * @returns A GracklePlugin ready to pass to `loadPlugins()`.
+ */
+export declare function createSchedulingPlugin(): GracklePlugin;
+//# sourceMappingURL=scheduling-plugin.d.ts.map

package/dist/scheduling-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling-plugin.d.ts","sourceRoot":"","sources":["../src/scheduling-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,wBAAwB,CAAC;AAQ3E;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,aAAa,CAwBtD"}

package/dist/scheduling-plugin.js

@@ -0,0 +1,41 @@
+/**
+ * Scheduling plugin — contributes schedule CRUD handlers and the cron
+ * reconciliation phase to the Grackle server.
+ *
+ * Declares `dependencies: ["core"]` so core handlers are registered first.
+ *
+ * @module
+ */
+import { grackle } from "@grackle-ai/common";
+import { scheduleStore, taskStore, personaStore, dispatchQueueStore, } from "@grackle-ai/database";
+import { createScheduleHandlers } from "./schedule-handlers.js";
+import { createCronPhase } from "./cron-phase.js";
+/**
+ * Create the scheduling plugin that contributes schedule CRUD and cron phase.
+ *
+ * @returns A GracklePlugin ready to pass to `loadPlugins()`.
+ */
+export function createSchedulingPlugin() {
+    return {
+        name: "scheduling",
+        dependencies: ["core"],
+        grpcHandlers: (ctx) => [{
+                service: grackle.Grackle,
+                handlers: createScheduleHandlers(ctx.emit),
+            }],
+        reconciliationPhases: (ctx) => [
+            createCronPhase({
+                getDueSchedules: scheduleStore.getDueSchedules,
+                advanceSchedule: scheduleStore.advanceSchedule,
+                createTask: taskStore.createTask,
+                setTaskScheduleId: taskStore.setTaskScheduleId,
+                enqueueForDispatch: dispatchQueueStore.enqueue,
+                emit: ctx.emit,
+                getPersona: personaStore.getPersona,
+                setScheduleEnabled: scheduleStore.setScheduleEnabled,
+                logger: ctx.logger,
+            }),
+        ],
+    };
+}
+//# sourceMappingURL=scheduling-plugin.js.map

package/dist/scheduling-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling-plugin.js","sourceRoot":"","sources":["../src/scheduling-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EACL,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,GAC3D,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,CAAC,MAAM,CAAC;QAEtB,YAAY,EAAE,CAAC,GAAkB,EAAE,EAAE,CAAC,CAAC;gBACrC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC;aAC3C,CAAC;QAEF,oBAAoB,EAAE,CAAC,GAAkB,EAAE,EAAE,CAAC;YAC5C,eAAe,CAAC;gBACd,eAAe,EAAE,aAAa,CAAC,eAAe;gBAC9C,eAAe,EAAE,aAAa,CAAC,eAAe;gBAC9C,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;gBAC9C,kBAAkB,EAAE,kBAAkB,CAAC,OAAO;gBAC9C,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,kBAAkB,EAAE,aAAa,CAAC,kBAAkB;gBACpD,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC;SACH;KACF,CAAC;AACJ,CAAC"}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@grackle-ai/plugin-scheduling",
+  "version": "0.98.0",
+  "description": "Scheduling plugin for Grackle — schedule CRUD handlers, cron reconciliation phase, and expression parsing",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/plugin-scheduling"
+  },
+  "keywords": [
+    "grackle",
+    "plugin",
+    "scheduling",
+    "cron"
+  ],
+  "homepage": "https://github.com/nick-pape/grackle#readme",
+  "bugs": {
+    "url": "https://github.com/nick-pape/grackle/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0 <24.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.5.0",
+    "@connectrpc/connect": "^2.0.0",
+    "cron-parser": "^4.9.0",
+    "pino": "^10.3.1",
+    "uuid": "^11.0.0",
+    "@grackle-ai/common": "0.98.0",
+    "@grackle-ai/core": "0.98.0",
+    "@grackle-ai/database": "0.98.0",
+    "@grackle-ai/plugin-sdk": "0.98.0"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "@types/uuid": "^10.0.0",
+    "vitest": "^3.2.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}