@grackle-ai/plugin-core 0.96.3

package/dist/codespace-handlers.d.ts

@@ -0,0 +1,6 @@
+import { grackle } from "@grackle-ai/common";
+/** List available GitHub Codespaces. */
+export declare function listCodespaces(): Promise<grackle.CodespaceList>;
+/** Create a new GitHub Codespace. */
+export declare function createCodespace(req: grackle.CreateCodespaceRequest): Promise<grackle.CreateCodespaceResponse>;
+//# sourceMappingURL=codespace-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codespace-handlers.d.ts","sourceRoot":"","sources":["../src/codespace-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAc7C,wCAAwC;AACxC,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAgCrE;AAED,qCAAqC;AACrC,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAwBnH"}

package/dist/codespace-handlers.js

@@ -0,0 +1,66 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { exec } from "@grackle-ai/core";
+import { formatGhError } from "./utils/format-gh-error.js";
+import { logger } from "@grackle-ai/core";
+/** Timeout for `gh codespace list` in milliseconds. */
+const GH_CODESPACE_LIST_TIMEOUT_MS = 30_000;
+/** Timeout for `gh codespace create` in milliseconds. */
+const GH_CODESPACE_CREATE_TIMEOUT_MS = 300_000;
+/** Maximum number of codespaces returned by `gh codespace list`. */
+const GH_CODESPACE_LIST_LIMIT = 50;
+/** List available GitHub Codespaces. */
+export async function listCodespaces() {
+    try {
+        const result = await exec("gh", [
+            "codespace",
+            "list",
+            "--json",
+            "name,repository,state,gitStatus",
+            "--limit",
+            String(GH_CODESPACE_LIST_LIMIT),
+        ], { timeout: GH_CODESPACE_LIST_TIMEOUT_MS });
+        const entries = JSON.parse(result.stdout || "[]");
+        return create(grackle.CodespaceListSchema, {
+            codespaces: entries.map((e) => create(grackle.CodespaceInfoSchema, {
+                name: String(e.name ?? ""),
+                repository: String(e.repository ?? ""),
+                state: String(e.state ?? ""),
+                gitStatus: String(e.gitStatus ?? ""),
+            })),
+        });
+    }
+    catch (err) {
+        logger.warn({ err }, "Failed to list codespaces");
+        return create(grackle.CodespaceListSchema, {
+            codespaces: [],
+            error: formatGhError(err, "list codespaces"),
+        });
+    }
+}
+/** Create a new GitHub Codespace. */
+export async function createCodespace(req) {
+    if (!req.repo.trim()) {
+        throw new ConnectError("repo is required", Code.InvalidArgument);
+    }
+    const trimmedRepo = req.repo.trim();
+    const createArgs = ["codespace", "create", "--repo", trimmedRepo];
+    if (req.machine.trim()) {
+        createArgs.push("--machine", req.machine.trim());
+    }
+    try {
+        const result = await exec("gh", createArgs, {
+            timeout: GH_CODESPACE_CREATE_TIMEOUT_MS,
+        });
+        return create(grackle.CreateCodespaceResponseSchema, {
+            name: result.stdout.trim(),
+            repository: trimmedRepo,
+        });
+    }
+    catch (err) {
+        logger.error({ err, repo: trimmedRepo }, "Failed to create codespace");
+        throw new ConnectError(formatGhError(err, "create codespace"), Code.Internal);
+    }
+}
+//# sourceMappingURL=codespace-handlers.js.map

package/dist/codespace-handlers.js.map

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

package/dist/cron-phase.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 { ScheduleRow } from "@grackle-ai/database";
+import type { GrackleEventType } from "@grackle-ai/core";
+import type { ReconciliationPhase } from "@grackle-ai/core";
+/** 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;
+}
+/**
+ * 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;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,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;CACtF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAcxE"}

package/dist/cron-phase.js

@@ -0,0 +1,88 @@
+/**
+ * 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 { logger } from "@grackle-ai/core";
+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) {
+                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) {
+        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) {
+            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,
+        });
+        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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAiClD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC;YACjE,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;gBAC3B,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,YAAY,CAAC,IAAmB,EAAE,QAAqB;IAC9D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,yEAAyE;QACzE,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC;IAC7F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE,EACjF,6DAA6D,CAC9D,CAAC;QACF,2DAA2D;QAC3D,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,EAC1D,0CAA0C,CAC3C,CAAC;YACF,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,cAAc;QACd,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,GAAG,QAAQ,CAAC,KAAK,MAAM,GAAG,EAAE,CAAC;QAC/C,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,YAAY,CAAC;QAC3D,IAAI,CAAC,UAAU,CACb,MAAM,EACN,QAAQ,CAAC,WAAW,IAAI,SAAS,EACjC,SAAS,EACT,QAAQ,CAAC,WAAW,EACpB,EAAE,EAAE,kBAAkB;QACtB,EAAE,EAAE,oBAAoB;QACxB,YAAY,EACZ,KAAK,EAAE,eAAe;QACtB,QAAQ,CAAC,SAAS,CACnB,CAAC;QACF,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAE5C,yEAAyE;QACzE,uEAAuE;QACvE,gDAAgD;QAChD,IAAI,CAAC,kBAAkB,CAAC;YACtB,EAAE,EAAE,MAAM,EAAE;YACZ,MAAM;YACN,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,SAAS,EAAE,QAAQ,CAAC,SAAS;SAC9B,CAAC,CAAC;QAEH,mBAAmB;QACnB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAElD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1B,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,MAAM;YACN,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAC1D,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,EAChC,qCAAqC,CACtC,CAAC;QACF,wCAAwC;QACxC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/dispatch-phase.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Dispatch reconciliation phase — drains the dispatch queue on each tick.
+ *
+ * Picks up tasks that were enqueued (because the target environment was at
+ * concurrency capacity) and spawns them when capacity frees up. Follows the
+ * same dependency-injection pattern as cron-phase.ts for testability.
+ */
+import type { DispatchQueueRow, TaskRow } from "@grackle-ai/database";
+import type { ReconciliationPhase } from "@grackle-ai/core";
+/** Dependencies injected into the dispatch phase for testability. */
+export interface DispatchPhaseDeps {
+    /** List all pending dispatch queue entries in FIFO order. */
+    listPendingEntries: () => DispatchQueueRow[];
+    /** Remove an entry from the dispatch queue by taskId. */
+    dequeueEntry: (taskId: string) => void;
+    /** Look up a task by ID. */
+    getTask: (taskId: string) => TaskRow | undefined;
+    /** Check whether an environment has capacity for another session. */
+    hasCapacity: (environmentId: string) => boolean;
+    /** Check whether an environment exists in the registry. */
+    environmentExists: (environmentId: string) => boolean;
+    /** Check if a task is eligible to start (deps met, no active session). */
+    isTaskEligible: (taskId: string) => boolean;
+    /** Start a task session. Returns error string on failure, undefined on success. */
+    startTaskSession: (task: TaskRow, options?: {
+        personaId?: string;
+        environmentId?: string;
+        notes?: string;
+    }) => Promise<string | undefined>;
+    /** Check if an environment is connected. */
+    isEnvironmentConnected: (environmentId: string) => boolean;
+    /** Resolve an environment for a task with no explicit environmentId. */
+    resolveEnvironment: (task: TaskRow) => string | undefined;
+}
+/**
+ * Create a ReconciliationPhase that drains the dispatch queue.
+ *
+ * On each tick:
+ * 1. Lists pending entries in FIFO order
+ * 2. For each: dequeues orphans (deleted task/environment), skips if disconnected or at capacity
+ * 3. Verifies task eligibility (deps met, not already working) before spawning
+ * 4. Calls startTaskSession; on success dequeues, on failure keeps queued for retry
+ * 5. Each entry is wrapped in try/catch so one bad task doesn't block others
+ */
+export declare function createDispatchPhase(deps: DispatchPhaseDeps): ReconciliationPhase;
+//# sourceMappingURL=dispatch-phase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-phase.d.ts","sourceRoot":"","sources":["../src/dispatch-phase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,gBAAgB,EAAE,CAAC;IAC7C,yDAAyD;IACzD,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,4BAA4B;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IACjD,qEAAqE;IACrE,WAAW,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,2DAA2D;IAC3D,iBAAiB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;IACtD,0EAA0E;IAC1E,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,mFAAmF;IACnF,gBAAgB,EAAE,CAChB,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,4CAA4C;IAC5C,sBAAsB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,wEAAwE;IACxE,kBAAkB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CAC3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAyBhF"}

package/dist/dispatch-phase.js

@@ -0,0 +1,99 @@
+/**
+ * Dispatch reconciliation phase — drains the dispatch queue on each tick.
+ *
+ * Picks up tasks that were enqueued (because the target environment was at
+ * concurrency capacity) and spawns them when capacity frees up. Follows the
+ * same dependency-injection pattern as cron-phase.ts for testability.
+ */
+import { logger } from "@grackle-ai/core";
+/**
+ * Create a ReconciliationPhase that drains the dispatch queue.
+ *
+ * On each tick:
+ * 1. Lists pending entries in FIFO order
+ * 2. For each: dequeues orphans (deleted task/environment), skips if disconnected or at capacity
+ * 3. Verifies task eligibility (deps met, not already working) before spawning
+ * 4. Calls startTaskSession; on success dequeues, on failure keeps queued for retry
+ * 5. Each entry is wrapped in try/catch so one bad task doesn't block others
+ */
+export function createDispatchPhase(deps) {
+    return {
+        name: "dispatch",
+        execute: async () => {
+            const pending = deps.listPendingEntries();
+            if (pending.length === 0) {
+                return;
+            }
+            logger.debug({ count: pending.length }, "Dispatch phase: pending entries");
+            for (const entry of pending) {
+                try {
+                    await dispatchEntry(deps, entry);
+                }
+                catch (err) {
+                    // Catch unexpected throws so one bad entry doesn't abort the entire tick.
+                    // Entry stays queued for retry on next tick.
+                    logger.error({ taskId: entry.taskId, environmentId: entry.environmentId, err }, "Dispatch: unexpected error processing entry");
+                }
+            }
+        },
+    };
+}
+/** Process a single dispatch queue entry. */
+async function dispatchEntry(deps, entry) {
+    // Resolve environment if not explicitly set (auto-resolution cascade)
+    let environmentId = entry.environmentId;
+    if (!environmentId) {
+        const task = deps.getTask(entry.taskId);
+        if (!task) {
+            deps.dequeueEntry(entry.taskId);
+            logger.debug({ taskId: entry.taskId }, "Dispatch: dequeued stale entry (task deleted, pre-resolve)");
+            return;
+        }
+        environmentId = deps.resolveEnvironment(task) || "";
+        if (!environmentId) {
+            // No environment available — stay queued for retry next tick
+            return;
+        }
+    }
+    // Dequeue entries whose environment has been removed entirely (not just disconnected)
+    if (!deps.environmentExists(environmentId)) {
+        deps.dequeueEntry(entry.taskId);
+        logger.debug({ taskId: entry.taskId, environmentId }, "Dispatch: dequeued orphan (environment removed)");
+        return;
+    }
+    // Skip if environment is disconnected (may reconnect later)
+    if (!deps.isEnvironmentConnected(environmentId)) {
+        return;
+    }
+    // Skip if environment is at capacity
+    if (!deps.hasCapacity(environmentId)) {
+        return;
+    }
+    // Look up the task (may have been deleted since enqueue — check again after resolution)
+    const task = deps.getTask(entry.taskId);
+    if (!task) {
+        deps.dequeueEntry(entry.taskId);
+        logger.debug({ taskId: entry.taskId }, "Dispatch: dequeued stale entry (task deleted)");
+        return;
+    }
+    // Verify the task is still eligible (deps met, not already working from a concurrent start).
+    // Skip rather than dequeue — eligibility may change (e.g. deps become met on a later tick).
+    if (!deps.isTaskEligible(entry.taskId)) {
+        return;
+    }
+    const error = await deps.startTaskSession(task, {
+        environmentId,
+        personaId: entry.personaId,
+        notes: entry.notes,
+    });
+    if (error) {
+        logger.warn({ taskId: entry.taskId, environmentId, error }, "Dispatch: session start failed — entry stays queued for retry");
+    }
+    else {
+        // Dequeue only after successful start to avoid losing tasks on transient failures.
+        // startTaskSession already emits "task.started" so we don't emit it here.
+        deps.dequeueEntry(entry.taskId);
+        logger.info({ taskId: entry.taskId, environmentId }, "Dispatch: task started");
+    }
+}
+//# sourceMappingURL=dispatch-phase.js.map

package/dist/dispatch-phase.js.map

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

package/dist/environment-handlers.d.ts

@@ -0,0 +1,16 @@
+import { grackle } from "@grackle-ai/common";
+/** List all registered environments. */
+export declare function listEnvironments(): Promise<grackle.EnvironmentList>;
+/** Register a new environment. */
+export declare function addEnvironment(req: grackle.AddEnvironmentRequest): Promise<grackle.Environment>;
+/** Update an existing environment's display name and/or adapter config. */
+export declare function updateEnvironment(req: grackle.UpdateEnvironmentRequest): Promise<grackle.Environment>;
+/** Remove an environment after disconnecting it and cleaning up references. */
+export declare function removeEnvironment(req: grackle.EnvironmentId): Promise<grackle.Empty>;
+/** Provision (bootstrap + connect) an environment, streaming progress events. */
+export declare function provisionEnvironment(req: grackle.ProvisionEnvironmentRequest): AsyncGenerator<grackle.ProvisionEvent>;
+/** Stop (disconnect) an environment. */
+export declare function stopEnvironment(req: grackle.EnvironmentId): Promise<grackle.Empty>;
+/** Destroy an environment and its underlying resources. */
+export declare function destroyEnvironment(req: grackle.EnvironmentId): Promise<grackle.Empty>;
+//# sourceMappingURL=environment-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment-handlers.d.ts","sourceRoot":"","sources":["../src/environment-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAc7C,wCAAwC;AACxC,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAKzE;AAED,kCAAkC;AAClC,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAerG;AAED,2EAA2E;AAC3E,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAsC3G;AAED,+EAA+E;AAC/E,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CA0C1F;AAED,iFAAiF;AACjF,wBAAuB,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,2BAA2B,GAAG,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAiH5H;AAED,wCAAwC;AACxC,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAexF;AAED,2DAA2D;AAC3D,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAe3F"}