@grackle-ai/core 0.79.0 → 0.79.1

package/dist/{cron-manager.d.ts → cron-phase.d.ts}

@@ -1,13 +1,14 @@
 /**
- * CronManager — periodic ticker that fires due schedules.
+ * Cron reconciliation phase — fires due schedules on each tick.
  *
- * Runs as a background interval on the server, checking the schedule store
- * for due entries on each tick and spawning tasks for them.
+ * Extracted from the former CronManager so it can plug into the
+ * ReconciliationManager as one of several ordered phases.
  */
 import type { ScheduleRow, EnvironmentRow, TaskRow } from "@grackle-ai/database";
 import type { GrackleEventType } from "./event-bus.js";
-/** Dependencies injected into CronManager for testability (NFR-4). */
-export interface CronManagerDeps {
+import type { ReconciliationPhase } from "./reconciliation-manager.js";
+/** 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). */
@@ -40,28 +41,10 @@ export interface CronManagerDeps {
     isEnvironmentConnected: (environmentId: string) => boolean;
 }
 /**
- * Periodic cron manager that checks for due schedules and fires them.
+ * Create a ReconciliationPhase that fires due schedules.
+ *
+ * @param deps - Injected dependencies
+ * @returns A phase to register with ReconciliationManager
  */
-export declare class CronManager {
-    private readonly deps;
-    private readonly checkIntervalMs;
-    private timer;
-    private ticking;
-    private tickPromise;
-    /**
-     * @param deps - Injected dependencies
-     * @param checkIntervalMs - How often to check for due schedules (default 10s)
-     */
-    constructor(deps: CronManagerDeps, checkIntervalMs?: number);
-    /** Start the periodic ticker. */
-    start(): void;
-    /** Stop the ticker and await any in-flight tick. */
-    stop(): Promise<void>;
-    /** Attempt a tick, skipping if a previous tick is still in-flight. */
-    private tryTick;
-    /** Execute one tick: query due schedules and fire each. */
-    private tick;
-    /** Fire a single schedule: create task, start session, advance. */
-    private fireSchedule;
-}
-//# sourceMappingURL=cron-manager.d.ts.map
+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;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,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,yEAAyE;IACzE,gBAAgB,EAAE,CAChB,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACrE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACzE,4DAA4D;IAC5D,6BAA6B,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;IAChE,+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,0DAA0D;IAC1D,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAC7C,mEAAmE;IAEnE,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrF,4CAA4C;IAC5C,sBAAsB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAcxE"}

package/dist/cron-phase.js

@@ -0,0 +1,116 @@
+/**
+ * Cron reconciliation phase — fires due schedules on each tick.
+ *
+ * Extracted from the former CronManager so it can plug into the
+ * ReconciliationManager as one of several ordered phases.
+ */
+import { v4 as uuidv4 } from "uuid";
+import { logger } from "./logger.js";
+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;
+            }
+            logger.debug({ count: due.length }, "Cron phase: due schedules");
+            for (const schedule of due) {
+                await fireSchedule(deps, schedule);
+            }
+        },
+    };
+}
+/** Fire a single schedule: create task, start session, advance. */
+async 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) {
+        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 {
+        // Resolve environment — check connectivity before creating tasks to avoid orphan tasks
+        let environmentId;
+        if (schedule.environmentId) {
+            // Explicit environment: verify it's connected before creating a task
+            if (!deps.isEnvironmentConnected(schedule.environmentId)) {
+                logger.warn({ scheduleId: schedule.id, environmentId: schedule.environmentId }, "Schedule fire skipped: specified environment not connected");
+                deps.advanceSchedule(schedule.id, now, nextRunAt);
+                return;
+            }
+            environmentId = schedule.environmentId;
+        }
+        else {
+            // Auto-select first connected environment
+            const env = deps.findFirstConnectedEnvironment();
+            if (!env) {
+                logger.warn({ scheduleId: schedule.id }, "Schedule fire skipped: no connected environment");
+                deps.advanceSchedule(schedule.id, now, nextRunAt);
+                return;
+            }
+            environmentId = env.id;
+        }
+        // Validate persona exists
+        const persona = deps.getPersona(schedule.personaId);
+        if (!persona) {
+            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);
+        // Fetch the created task for startTaskSession
+        const task = deps.getTask(taskId);
+        if (!task) {
+            logger.error({ scheduleId: schedule.id, taskId }, "Schedule fire failed: created task not found");
+            deps.advanceSchedule(schedule.id, now, nextRunAt);
+            return;
+        }
+        // Start the task session
+        const error = await deps.startTaskSession(undefined, task, {
+            environmentId,
+            personaId: schedule.personaId,
+        });
+        // Advance schedule regardless of session start outcome
+        deps.advanceSchedule(schedule.id, now, nextRunAt);
+        if (error) {
+            logger.warn({ scheduleId: schedule.id, taskId, error }, "Schedule fire: task created but session start failed");
+            return;
+        }
+        // Emit event only on successful fire
+        deps.emit("schedule.fired", {
+            scheduleId: schedule.id,
+            taskId,
+            firedAt: now,
+        });
+        logger.info({ scheduleId: schedule.id, taskId, title: schedule.title }, "Schedule fired");
+    }
+    catch (err) {
+        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/find-connected-environment.d.ts

@@ -2,7 +2,7 @@
  * Find the first connected environment, preferring local adapters.
  *
  * Extracted from the root task boot listener in server/src/index.ts
- * so that CronManager and other server-internal code can reuse the logic.
+ * so that the cron phase and other server-internal code can reuse the logic.
  */
 import { type EnvironmentRow } from "@grackle-ai/database";
 /**

package/dist/find-connected-environment.js

@@ -2,7 +2,7 @@
  * Find the first connected environment, preferring local adapters.
  *
  * Extracted from the root task boot listener in server/src/index.ts
- * so that CronManager and other server-internal code can reuse the logic.
+ * so that the cron phase and other server-internal code can reuse the logic.
  */
 import { envRegistry } from "@grackle-ai/database";
 /**

package/dist/index.d.ts

@@ -10,8 +10,10 @@ export { attemptReconnects, resetReconnectState } from "./auto-reconnect.js";
 export { pushToEnv } from "./token-push.js";
 export { computeTaskStatus } from "./compute-task-status.js";
 export { isKnowledgeEnabled, initKnowledge } from "./knowledge-init.js";
-export { CronManager } from "./cron-manager.js";
-export type { CronManagerDeps } from "./cron-manager.js";
+export { ReconciliationManager } from "./reconciliation-manager.js";
+export type { ReconciliationPhase } from "./reconciliation-manager.js";
+export { createCronPhase } from "./cron-phase.js";
+export type { CronPhaseDeps } from "./cron-phase.js";
 export { findFirstConnectedEnvironment } from "./find-connected-environment.js";
 export { validateExpression, computeNextRunAt } from "./schedule-expression.js";
 export { checkVersionStatus, clearVersionCache, type VersionStatus } from "./version-check.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EACL,eAAe,EAAE,UAAU,EAC3B,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAC/D,cAAc,EAAE,aAAa,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGhF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EACL,eAAe,EAAE,UAAU,EAC3B,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAC/D,cAAc,EAAE,aAAa,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGhF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -17,8 +17,9 @@ export { pushToEnv } from "./token-push.js";
 export { computeTaskStatus } from "./compute-task-status.js";
 // ─── Knowledge ─────────────────────────────────────────────
 export { isKnowledgeEnabled, initKnowledge } from "./knowledge-init.js";
-// ─── Cron / Scheduling ────────────────────────────────────
-export { CronManager } from "./cron-manager.js";
+// ─── Reconciliation / Scheduling ──────────────────────────
+export { ReconciliationManager } from "./reconciliation-manager.js";
+export { createCronPhase } from "./cron-phase.js";
 export { findFirstConnectedEnvironment } from "./find-connected-environment.js";
 export { validateExpression, computeNextRunAt } from "./schedule-expression.js";
 // ─── Version Check ────────────────────────────────────────

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,8DAA8D;AAC9D,OAAO,EACL,eAAe,EAAE,UAAU,EAC3B,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAC/D,cAAc,EAAE,aAAa,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,8DAA8D;AAC9D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,8DAA8D;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAExE,6DAA6D;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAE/F,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8DAA8D;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,8DAA8D;AAC9D,OAAO,EACL,eAAe,EAAE,UAAU,EAC3B,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAC/D,cAAc,EAAE,aAAa,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,8DAA8D;AAC9D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,8DAA8D;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAExE,6DAA6D;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAE/F,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8DAA8D;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/reconciliation-manager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ReconciliationManager — periodic ticker that runs ordered phases on each tick.
+ *
+ * Generalized from CronManager to support pluggable phases (cron, dispatch,
+ * stall detection, etc.) in a single background loop.
+ */
+/** A named async phase that runs during each reconciliation tick. */
+export interface ReconciliationPhase {
+    /** Short name for logging (e.g. "cron", "dispatch"). */
+    name: string;
+    /** Execute the phase. Errors are caught by the manager — they don't abort the tick. */
+    execute: () => Promise<void>;
+}
+/**
+ * Periodic reconciliation manager that runs ordered phases on a configurable interval.
+ */
+export declare class ReconciliationManager {
+    private readonly phases;
+    private readonly tickIntervalMs;
+    private timer;
+    private ticking;
+    private tickPromise;
+    /**
+     * @param phases - Ordered list of phases to run on each tick
+     * @param tickIntervalMs - Override tick interval (default: GRACKLE_RECONCILIATION_TICK_MS env var or 10s)
+     */
+    constructor(phases: ReconciliationPhase[], tickIntervalMs?: number);
+    /** Start the periodic ticker. */
+    start(): void;
+    /** Stop the ticker and await any in-flight tick. */
+    stop(): Promise<void>;
+    /** Attempt a tick, skipping if a previous tick is still in-flight. */
+    private tryTick;
+    /** Execute one tick: run each phase sequentially, isolating errors. */
+    private tick;
+}
+//# sourceMappingURL=reconciliation-manager.d.ts.map

package/dist/reconciliation-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-manager.d.ts","sourceRoot":"","sources":["../src/reconciliation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAA4B;IAE/C;;;OAGG;gBACgB,MAAM,EAAE,mBAAmB,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM;IAwBzE,iCAAiC;IAC1B,KAAK,IAAI,IAAI;IAepB,oDAAoD;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWlC,sEAAsE;YACxD,OAAO;IAgBrB,uEAAuE;YACzD,IAAI;CASnB"}

package/dist/reconciliation-manager.js

@@ -0,0 +1,98 @@
+/**
+ * ReconciliationManager — periodic ticker that runs ordered phases on each tick.
+ *
+ * Generalized from CronManager to support pluggable phases (cron, dispatch,
+ * stall detection, etc.) in a single background loop.
+ */
+import { logger } from "./logger.js";
+/** Default tick interval in milliseconds. */
+const DEFAULT_TICK_INTERVAL_MS = 10_000;
+/**
+ * Periodic reconciliation manager that runs ordered phases on a configurable interval.
+ */
+export class ReconciliationManager {
+    phases;
+    tickIntervalMs;
+    timer;
+    ticking = false;
+    tickPromise;
+    /**
+     * @param phases - Ordered list of phases to run on each tick
+     * @param tickIntervalMs - Override tick interval (default: GRACKLE_RECONCILIATION_TICK_MS env var or 10s)
+     */
+    constructor(phases, tickIntervalMs) {
+        this.phases = phases;
+        if (tickIntervalMs !== undefined) {
+            this.tickIntervalMs = tickIntervalMs;
+        }
+        else {
+            const envRaw = process.env.GRACKLE_RECONCILIATION_TICK_MS;
+            if (envRaw !== undefined && envRaw !== "") {
+                const parsed = parseInt(envRaw, 10);
+                if (Number.isFinite(parsed) && parsed > 0) {
+                    this.tickIntervalMs = parsed;
+                }
+                else {
+                    logger.warn({ envValue: envRaw, default: DEFAULT_TICK_INTERVAL_MS }, "Invalid GRACKLE_RECONCILIATION_TICK_MS; falling back to default");
+                    this.tickIntervalMs = DEFAULT_TICK_INTERVAL_MS;
+                }
+            }
+            else {
+                this.tickIntervalMs = DEFAULT_TICK_INTERVAL_MS;
+            }
+        }
+    }
+    /** Start the periodic ticker. */
+    start() {
+        if (this.timer) {
+            return;
+        }
+        logger.info({ intervalMs: this.tickIntervalMs, phases: this.phases.map((p) => p.name) }, "ReconciliationManager started");
+        this.timer = setInterval(() => {
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            this.tryTick();
+        }, this.tickIntervalMs);
+        this.timer.unref();
+    }
+    /** Stop the ticker and await any in-flight tick. */
+    async stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        if (this.tickPromise) {
+            await this.tickPromise;
+        }
+        logger.info("ReconciliationManager stopped");
+    }
+    /** Attempt a tick, skipping if a previous tick is still in-flight. */
+    async tryTick() {
+        if (this.ticking) {
+            return;
+        }
+        this.ticking = true;
+        this.tickPromise = this.tick();
+        try {
+            await this.tickPromise;
+        }
+        catch (err) {
+            logger.error({ err }, "ReconciliationManager tick failed");
+        }
+        finally {
+            this.ticking = false;
+            this.tickPromise = undefined;
+        }
+    }
+    /** Execute one tick: run each phase sequentially, isolating errors. */
+    async tick() {
+        for (const phase of this.phases) {
+            try {
+                await phase.execute();
+            }
+            catch (err) {
+                logger.error({ err, phase: phase.name }, "Reconciliation phase '%s' failed", phase.name);
+            }
+        }
+    }
+}
+//# sourceMappingURL=reconciliation-manager.js.map

package/dist/reconciliation-manager.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/core",
-  "version": "0.79.0",
+  "version": "0.79.1",
   "description": "Core gRPC business logic for Grackle — RPC handlers, event system, streaming, session lifecycle",
   "license": "MIT",
   "repository": {
@@ -37,12 +37,12 @@
     "ulid": "^2.3.0",
     "uuid": "^11.0.0",
     "ws": "^8.0.0",
-    "@grackle-ai/adapter-sdk": "0.79.0",
-    "@grackle-ai/common": "0.79.0",
-    "@grackle-ai/database": "0.79.0",
-    "@grackle-ai/knowledge": "0.79.0",
-    "@grackle-ai/auth": "0.79.0",
-    "@grackle-ai/prompt": "0.79.0"
+    "@grackle-ai/adapter-sdk": "0.79.1",
+    "@grackle-ai/auth": "0.79.1",
+    "@grackle-ai/common": "0.79.1",
+    "@grackle-ai/knowledge": "0.79.1",
+    "@grackle-ai/database": "0.79.1",
+    "@grackle-ai/prompt": "0.79.1"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.7",

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

@@ -1 +0,0 @@
-{"version":3,"file":"cron-manager.d.ts","sourceRoot":"","sources":["../src/cron-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMvD,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,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,yEAAyE;IACzE,gBAAgB,EAAE,CAChB,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACrE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACzE,4DAA4D;IAC5D,6BAA6B,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;IAChE,+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,0DAA0D;IAC1D,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAC7C,mEAAmE;IAEnE,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrF,4CAA4C;IAC5C,sBAAsB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAA4B;IAE/C;;;OAGG;gBACgB,IAAI,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,MAAM;IAKlE,iCAAiC;IAC1B,KAAK,IAAI,IAAI;IAepB,oDAAoD;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWlC,sEAAsE;YACxD,OAAO;IAgBrB,2DAA2D;YAC7C,IAAI;IAWlB,mEAAmE;YACrD,YAAY;CAyH3B"}

package/dist/cron-manager.js

@@ -1,167 +0,0 @@
-/**
- * CronManager — periodic ticker that fires due schedules.
- *
- * Runs as a background interval on the server, checking the schedule store
- * for due entries on each tick and spawning tasks for them.
- */
-import { v4 as uuidv4 } from "uuid";
-import { logger } from "./logger.js";
-import { computeNextRunAt } from "./schedule-expression.js";
-import { ROOT_TASK_ID } from "@grackle-ai/common";
-/** Default tick interval in milliseconds. */
-const DEFAULT_CHECK_INTERVAL_MS = 10_000;
-/**
- * Periodic cron manager that checks for due schedules and fires them.
- */
-export class CronManager {
-    deps;
-    checkIntervalMs;
-    timer;
-    ticking = false;
-    tickPromise;
-    /**
-     * @param deps - Injected dependencies
-     * @param checkIntervalMs - How often to check for due schedules (default 10s)
-     */
-    constructor(deps, checkIntervalMs) {
-        this.deps = deps;
-        this.checkIntervalMs = checkIntervalMs ?? DEFAULT_CHECK_INTERVAL_MS;
-    }
-    /** Start the periodic ticker. */
-    start() {
-        if (this.timer) {
-            return;
-        }
-        logger.info({ intervalMs: this.checkIntervalMs }, "CronManager started");
-        this.timer = setInterval(() => {
-            // eslint-disable-next-line @typescript-eslint/no-floating-promises
-            this.tryTick();
-        }, this.checkIntervalMs);
-        this.timer.unref();
-    }
-    /** Stop the ticker and await any in-flight tick. */
-    async stop() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = undefined;
-        }
-        if (this.tickPromise) {
-            await this.tickPromise;
-        }
-        logger.info("CronManager stopped");
-    }
-    /** Attempt a tick, skipping if a previous tick is still in-flight. */
-    async tryTick() {
-        if (this.ticking) {
-            return;
-        }
-        this.ticking = true;
-        this.tickPromise = this.tick();
-        try {
-            await this.tickPromise;
-        }
-        catch (err) {
-            logger.error({ err }, "CronManager tick failed");
-        }
-        finally {
-            this.ticking = false;
-            this.tickPromise = undefined;
-        }
-    }
-    /** Execute one tick: query due schedules and fire each. */
-    async tick() {
-        const due = this.deps.getDueSchedules();
-        if (due.length === 0) {
-            return;
-        }
-        logger.debug({ count: due.length }, "CronManager tick: due schedules");
-        for (const schedule of due) {
-            await this.fireSchedule(schedule);
-        }
-    }
-    /** Fire a single schedule: create task, start session, advance. */
-    async fireSchedule(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) {
-            logger.error({ scheduleId: schedule.id, scheduleExpression: schedule.scheduleExpression, err }, "CronManager: failed to compute nextRunAt; disabling schedule");
-            // Disable the schedule to prevent error loop on every tick
-            this.deps.setScheduleEnabled(schedule.id, false, null);
-            return;
-        }
-        try {
-            // Resolve environment — check connectivity before creating tasks to avoid orphan tasks
-            let environmentId;
-            if (schedule.environmentId) {
-                // Explicit environment: verify it's connected before creating a task
-                if (!this.deps.isEnvironmentConnected(schedule.environmentId)) {
-                    logger.warn({ scheduleId: schedule.id, environmentId: schedule.environmentId }, "Schedule fire skipped: specified environment not connected");
-                    this.deps.advanceSchedule(schedule.id, now, nextRunAt);
-                    return;
-                }
-                environmentId = schedule.environmentId;
-            }
-            else {
-                // Auto-select first connected environment
-                const env = this.deps.findFirstConnectedEnvironment();
-                if (!env) {
-                    logger.warn({ scheduleId: schedule.id }, "Schedule fire skipped: no connected environment");
-                    this.deps.advanceSchedule(schedule.id, now, nextRunAt);
-                    return;
-                }
-                environmentId = env.id;
-            }
-            // Validate persona exists
-            const persona = this.deps.getPersona(schedule.personaId);
-            if (!persona) {
-                logger.warn({ scheduleId: schedule.id, personaId: schedule.personaId }, "Schedule fire skipped: persona not found");
-                this.deps.advanceSchedule(schedule.id, now, nextRunAt);
-                return;
-            }
-            // Create task
-            const taskId = uuidv4();
-            const taskTitle = `${schedule.title} @ ${now}`;
-            const parentTaskId = schedule.parentTaskId || ROOT_TASK_ID;
-            this.deps.createTask(taskId, schedule.workspaceId || undefined, taskTitle, schedule.description, [], // no dependencies
-            "", // no workspace slug
-            parentTaskId, false, // canDecompose
-            schedule.personaId);
-            this.deps.setTaskScheduleId(taskId, schedule.id);
-            // Fetch the created task for startTaskSession
-            const task = this.deps.getTask(taskId);
-            if (!task) {
-                logger.error({ scheduleId: schedule.id, taskId }, "Schedule fire failed: created task not found");
-                this.deps.advanceSchedule(schedule.id, now, nextRunAt);
-                return;
-            }
-            // Start the task session
-            const error = await this.deps.startTaskSession(undefined, task, {
-                environmentId,
-                personaId: schedule.personaId,
-            });
-            // Advance schedule regardless of session start outcome
-            this.deps.advanceSchedule(schedule.id, now, nextRunAt);
-            if (error) {
-                logger.warn({ scheduleId: schedule.id, taskId, error }, "Schedule fire: task created but session start failed");
-                return;
-            }
-            // Emit event only on successful fire
-            this.deps.emit("schedule.fired", {
-                scheduleId: schedule.id,
-                taskId,
-                firedAt: now,
-            });
-            logger.info({ scheduleId: schedule.id, taskId, title: schedule.title }, "Schedule fired");
-        }
-        catch (err) {
-            logger.error({ scheduleId: schedule.id, err }, "Schedule fire failed with exception");
-            // Still advance to prevent retry storms
-            this.deps.advanceSchedule(schedule.id, now, nextRunAt);
-        }
-    }
-}
-//# sourceMappingURL=cron-manager.js.map

package/dist/cron-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron-manager.js","sourceRoot":"","sources":["../src/cron-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,6CAA6C;AAC7C,MAAM,yBAAyB,GAAW,MAAM,CAAC;AA2CjD;;GAEG;AACH,MAAM,OAAO,WAAW;IACL,IAAI,CAAkB;IACtB,eAAe,CAAS;IACjC,KAAK,CAA6C;IAClD,OAAO,GAAY,KAAK,CAAC;IACzB,WAAW,CAA4B;IAE/C;;;OAGG;IACH,YAAmB,IAAqB,EAAE,eAAwB;QAChE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,eAAe,GAAG,eAAe,IAAI,yBAAyB,CAAC;IACtE,CAAC;IAED,iCAAiC;IAC1B,KAAK;QACV,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,EACpC,qBAAqB,CACtB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,mEAAmE;YACnE,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,oDAAoD;IAC7C,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC;QACzB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED,sEAAsE;IAC9D,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,yBAAyB,CAAC,CAAC;QACnD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,2DAA2D;IACnD,KAAK,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,iCAAiC,CAAC,CAAC;QACvE,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,mEAAmE;IAC3D,KAAK,CAAC,YAAY,CAAC,QAAqB;QAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,yEAAyE;YACzE,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE,EACjF,8DAA8D,CAC/D,CAAC;YACF,2DAA2D;YAC3D,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,uFAAuF;YACvF,IAAI,aAAiC,CAAC;YACtC,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC3B,qEAAqE;gBACrE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC9D,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,EAClE,4DAA4D,CAC7D,CAAC;oBACF,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;oBACvD,OAAO;gBACT,CAAC;gBACD,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,0CAA0C;gBAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,6BAA6B,EAAE,CAAC;gBACtD,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,EAC3B,iDAAiD,CAClD,CAAC;oBACF,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;oBACvD,OAAO;gBACT,CAAC;gBACD,aAAa,GAAG,GAAG,CAAC,EAAE,CAAC;YACzB,CAAC;YAED,0BAA0B;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACzD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,EAC1D,0CAA0C,CAC3C,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YAED,cAAc;YACd,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,GAAG,QAAQ,CAAC,KAAK,MAAM,GAAG,EAAE,CAAC;YAC/C,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,YAAY,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,UAAU,CAClB,MAAM,EACN,QAAQ,CAAC,WAAW,IAAI,SAAS,EACjC,SAAS,EACT,QAAQ,CAAC,WAAW,EACpB,EAAE,EAAE,kBAAkB;YACtB,EAAE,EAAE,oBAAoB;YACxB,YAAY,EACZ,KAAK,EAAE,eAAe;YACtB,QAAQ,CAAC,SAAS,CACnB,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAEjD,8CAA8C;YAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EACnC,8CAA8C,CAC/C,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YAED,yBAAyB;YACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE;gBAC9D,aAAa;gBACb,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B,CAAC,CAAC;YAEH,uDAAuD;YACvD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;YAEvD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAC1C,sDAAsD,CACvD,CAAC;gBACF,OAAO;YACT,CAAC;YAED,qCAAqC;YACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAC/B,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,MAAM;gBACN,OAAO,EAAE,GAAG;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAC1D,gBAAgB,CACjB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,EAChC,qCAAqC,CACtC,CAAC;YACF,wCAAwC;YACxC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF"}