@grackle-ai/core 0.75.4

package/README.md

@@ -0,0 +1,30 @@
+# @grackle-ai/core
+
+Core gRPC business logic for [Grackle](https://github.com/nick-pape/grackle).
+
+## Overview
+
+This package contains the runtime business logic for the Grackle server:
+
+- **gRPC Service** — ConnectRPC handlers for environment, session, task, workspace, persona, and knowledge operations
+- **Event System** — Domain event bus with pub/sub, event processing, and persistence
+- **Streaming** — Stream multiplexing, registry, and pipe delivery for real-time agent output
+- **WebSocket Bridge** — Event broadcast to connected web clients
+- **Session Lifecycle** — Recovery, auto-hibernate, and reanimate for agent sessions
+- **Adapter Management** — Registry and health-check heartbeat for environment adapters
+- **Signals** — SIGCHLD handling for parent-child task coordination
+- **Credentials** — Token push and credential bundling for remote environments
+
+## Usage
+
+This package is consumed by `@grackle-ai/server` (the orchestrator) which wires it together with the web server, MCP server, and PowerLine.
+
+```typescript
+import {
+  registerGrackleRoutes,
+  registerAdapter, startHeartbeat,
+  emit, subscribe,
+  createWsBridge,
+  logger,
+} from "@grackle-ai/core";
+```

package/dist/adapter-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse a JSON adapter configuration string, throwing a gRPC Internal error
+ * if the value is not valid JSON or not a plain object.
+ */
+export declare function parseAdapterConfig(raw: string): Record<string, unknown>;
+//# sourceMappingURL=adapter-config.d.ts.map

package/dist/adapter-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-config.d.ts","sourceRoot":"","sources":["../src/adapter-config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWvE"}

package/dist/adapter-config.js

@@ -0,0 +1,19 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+/**
+ * Parse a JSON adapter configuration string, throwing a gRPC Internal error
+ * if the value is not valid JSON or not a plain object.
+ */
+export function parseAdapterConfig(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new ConnectError("Invalid adapter configuration", Code.Internal);
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new ConnectError("Invalid adapter configuration", Code.Internal);
+    }
+    return parsed;
+}
+//# sourceMappingURL=adapter-config.js.map

package/dist/adapter-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-config.js","sourceRoot":"","sources":["../src/adapter-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CAAC,+BAA+B,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,YAAY,CAAC,+BAA+B,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC"}

package/dist/adapter-manager.d.ts

@@ -0,0 +1,22 @@
+import type { EnvironmentAdapter, PowerLineConnection } from "@grackle-ai/adapter-sdk";
+/** Register an environment adapter so it can be looked up by type. */
+export declare function registerAdapter(adapter: EnvironmentAdapter): void;
+/** Retrieve a registered adapter by its type name. */
+export declare function getAdapter(type: string): EnvironmentAdapter | undefined;
+/** Store an active PowerLine connection for an environment. */
+export declare function setConnection(environmentId: string, conn: PowerLineConnection): void;
+/** Get the active PowerLine connection for an environment, if connected. */
+export declare function getConnection(environmentId: string): PowerLineConnection | undefined;
+/** Remove the stored connection for an environment. */
+export declare function removeConnection(environmentId: string): void;
+/** Return the map of all active environment connections. */
+export declare function listConnections(): Map<string, PowerLineConnection>;
+/**
+ * Start a periodic health-check loop that calls `onDisconnect` when a
+ * PowerLine becomes unreachable. Optionally calls `onHeartbeatComplete`
+ * after each tick (used for auto-reconnect of disconnected environments).
+ */
+export declare function startHeartbeat(onDisconnect: (environmentId: string) => void, onHeartbeatComplete?: () => Promise<void>): void;
+/** Stop the periodic health-check loop. */
+export declare function stopHeartbeat(): void;
+//# sourceMappingURL=adapter-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-manager.d.ts","sourceRoot":"","sources":["../src/adapter-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAUvF,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEjE;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEvE;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAEpF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEpF;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAElE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,EAC7C,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACxC,IAAI,CAsCN;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/adapter-manager.js

@@ -0,0 +1,81 @@
+import { envRegistry } from "@grackle-ai/database";
+import { logger } from "./logger.js";
+const HEARTBEAT_INTERVAL_MS = 30_000;
+const adapters = new Map();
+const connections = new Map();
+let heartbeatInterval = undefined;
+/** Register an environment adapter so it can be looked up by type. */
+export function registerAdapter(adapter) {
+    adapters.set(adapter.type, adapter);
+}
+/** Retrieve a registered adapter by its type name. */
+export function getAdapter(type) {
+    return adapters.get(type);
+}
+/** Store an active PowerLine connection for an environment. */
+export function setConnection(environmentId, conn) {
+    connections.set(environmentId, conn);
+}
+/** Get the active PowerLine connection for an environment, if connected. */
+export function getConnection(environmentId) {
+    return connections.get(environmentId);
+}
+/** Remove the stored connection for an environment. */
+export function removeConnection(environmentId) {
+    connections.delete(environmentId);
+}
+/** Return the map of all active environment connections. */
+export function listConnections() {
+    return connections;
+}
+/**
+ * Start a periodic health-check loop that calls `onDisconnect` when a
+ * PowerLine becomes unreachable. Optionally calls `onHeartbeatComplete`
+ * after each tick (used for auto-reconnect of disconnected environments).
+ */
+export function startHeartbeat(onDisconnect, onHeartbeatComplete) {
+    if (heartbeatInterval !== undefined) {
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-misused-promises
+    heartbeatInterval = setInterval(async () => {
+        for (const [environmentId, conn] of connections) {
+            const env = envRegistry.getEnvironment(environmentId);
+            if (!env) {
+                continue;
+            }
+            const adapter = adapters.get(env.adapterType);
+            if (!adapter) {
+                continue;
+            }
+            try {
+                const ok = await adapter.healthCheck(conn);
+                if (!ok) {
+                    logger.warn({ environmentId }, "Health check failed");
+                    onDisconnect(environmentId);
+                }
+            }
+            catch {
+                logger.warn({ environmentId }, "Connection lost");
+                onDisconnect(environmentId);
+            }
+        }
+        // After health checks, attempt reconnection of disconnected environments
+        if (onHeartbeatComplete) {
+            try {
+                await onHeartbeatComplete();
+            }
+            catch (err) {
+                logger.error({ err }, "onHeartbeatComplete callback failed");
+            }
+        }
+    }, HEARTBEAT_INTERVAL_MS);
+}
+/** Stop the periodic health-check loop. */
+export function stopHeartbeat() {
+    if (heartbeatInterval !== undefined) {
+        clearInterval(heartbeatInterval);
+        heartbeatInterval = undefined;
+    }
+}
+//# sourceMappingURL=adapter-manager.js.map

package/dist/adapter-manager.js.map

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

package/dist/auto-reconnect.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Scan for disconnected environments and attempt to reconnect eligible ones.
+ * Called after each heartbeat tick. Uses exponential backoff per environment
+ * and a concurrency lock to prevent overlapping attempts.
+ *
+ * Fire-and-forget for each environment — logs errors but does not throw.
+ */
+export declare function attemptReconnects(): Promise<void>;
+/**
+ * Clear reconnect state for an environment. Call when the environment is
+ * manually provisioned, removed, or otherwise taken out of the reconnect cycle.
+ */
+export declare function clearReconnectState(environmentId: string): void;
+/**
+ * Reset reconnect state so the environment is immediately eligible on the
+ * next heartbeat tick. Unlike {@link clearReconnectState} (which deletes state,
+ * causing the next tick to re-initialize with an initial delay), this sets
+ * attempts to zero and nextRetryAt to now.
+ */
+export declare function resetReconnectState(environmentId: string): void;
+/** @internal Reset all reconnect state for testing. */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=auto-reconnect.d.ts.map

package/dist/auto-reconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-reconnect.d.ts","sourceRoot":"","sources":["../src/auto-reconnect.ts"],"names":[],"mappings":"AAyCA;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4CvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/auto-reconnect.js

@@ -0,0 +1,164 @@
+import { reconnectOrProvision } from "@grackle-ai/adapter-sdk";
+import { envRegistry } from "@grackle-ai/database";
+import * as adapterManager from "./adapter-manager.js";
+import * as tokenPush from "./token-push.js";
+import { recoverSuspendedSessions } from "./session-recovery.js";
+import { parseAdapterConfig } from "./adapter-config.js";
+import { emit } from "./event-bus.js";
+import { logger } from "./logger.js";
+// ─── Constants ──────────────────────────────────────────────
+/** Initial delay before first reconnect attempt (milliseconds). */
+const RECONNECT_INITIAL_DELAY_MS = 10_000;
+/** Maximum number of reconnect attempts before giving up. */
+const RECONNECT_MAX_RETRIES = 5;
+/** Maximum delay between reconnect attempts (milliseconds). */
+const RECONNECT_MAX_DELAY_MS = 120_000;
+/** Multiplier for exponential backoff. */
+const RECONNECT_BACKOFF_MULTIPLIER = 2;
+/** Tracks reconnect backoff state per environment. */
+const reconnectStates = new Map();
+/** Prevents concurrent reconnect attempts for the same environment. */
+const reconnecting = new Set();
+// ─── Public API ─────────────────────────────────────────────
+/**
+ * Scan for disconnected environments and attempt to reconnect eligible ones.
+ * Called after each heartbeat tick. Uses exponential backoff per environment
+ * and a concurrency lock to prevent overlapping attempts.
+ *
+ * Fire-and-forget for each environment — logs errors but does not throw.
+ */
+export async function attemptReconnects() {
+    const environments = envRegistry.listEnvironments();
+    const disconnected = environments.filter((env) => env.status === "disconnected");
+    for (const env of disconnected) {
+        const state = reconnectStates.get(env.id);
+        // First time seeing this environment disconnected — initialize state with delay
+        if (!state) {
+            reconnectStates.set(env.id, {
+                attempts: 0,
+                nextRetryAt: Date.now() + RECONNECT_INITIAL_DELAY_MS,
+            });
+            continue;
+        }
+        // Backoff not elapsed yet
+        if (Date.now() < state.nextRetryAt) {
+            continue;
+        }
+        // Max retries exhausted
+        if (state.attempts >= RECONNECT_MAX_RETRIES) {
+            continue;
+        }
+        // Already reconnecting
+        if (reconnecting.has(env.id)) {
+            continue;
+        }
+        // Attempt reconnect (fire-and-forget)
+        tryReconnect(env.id).catch((err) => {
+            logger.error({ environmentId: env.id, err }, "Unhandled error during auto-reconnect");
+        });
+    }
+    // Clean up state for environments that are no longer disconnected
+    for (const [envId] of reconnectStates) {
+        const env = environments.find((e) => e.id === envId);
+        if (env?.status !== "disconnected") {
+            reconnectStates.delete(envId);
+        }
+    }
+}
+/**
+ * Clear reconnect state for an environment. Call when the environment is
+ * manually provisioned, removed, or otherwise taken out of the reconnect cycle.
+ */
+export function clearReconnectState(environmentId) {
+    reconnectStates.delete(environmentId);
+    // Note: does not cancel an in-flight tryReconnect — the lock will
+    // prevent a new attempt from starting, and the in-flight one will
+    // complete or fail on its own.
+}
+/**
+ * Reset reconnect state so the environment is immediately eligible on the
+ * next heartbeat tick. Unlike {@link clearReconnectState} (which deletes state,
+ * causing the next tick to re-initialize with an initial delay), this sets
+ * attempts to zero and nextRetryAt to now.
+ */
+export function resetReconnectState(environmentId) {
+    reconnectStates.set(environmentId, { attempts: 0, nextRetryAt: Date.now() });
+}
+/** @internal Reset all reconnect state for testing. */
+export function _resetForTesting() {
+    reconnectStates.clear();
+    reconnecting.clear();
+}
+// ─── Internal ───────────────────────────────────────────────
+/**
+ * Attempt to reconnect a single disconnected environment.
+ * Uses the existing `reconnectOrProvision` flow from adapter-sdk.
+ */
+async function tryReconnect(environmentId) {
+    reconnecting.add(environmentId);
+    try {
+        // Re-fetch environment in case it was removed while waiting
+        const env = envRegistry.getEnvironment(environmentId);
+        if (!env) {
+            reconnectStates.delete(environmentId);
+            return;
+        }
+        const adapter = adapterManager.getAdapter(env.adapterType);
+        if (!adapter) {
+            logger.warn({ environmentId, adapterType: env.adapterType }, "No adapter registered — skipping reconnect");
+            return;
+        }
+        logger.info({ environmentId, adapterType: env.adapterType }, "Attempting auto-reconnect");
+        envRegistry.updateEnvironmentStatus(environmentId, "connecting");
+        emit("environment.changed", {});
+        const config = parseAdapterConfig(env.adapterConfig);
+        config.defaultRuntime = env.defaultRuntime;
+        const powerlineToken = env.powerlineToken;
+        // Run reconnectOrProvision — tries fast reconnect if supported, falls back to provision
+        for await (const event of reconnectOrProvision(environmentId, adapter, config, powerlineToken, !!env.bootstrapped)) {
+            logger.debug({ environmentId, stage: event.stage, message: event.message }, "Reconnect progress");
+        }
+        // Establish gRPC connection
+        const conn = await adapter.connect(environmentId, config, powerlineToken);
+        adapterManager.setConnection(environmentId, conn);
+        // Push tokens (local environments exclude file tokens)
+        if (env.adapterType === "local") {
+            await tokenPush.pushToEnv(environmentId, { excludeFileTokens: true });
+        }
+        else {
+            await tokenPush.pushToEnv(environmentId);
+        }
+        envRegistry.updateEnvironmentStatus(environmentId, "connected");
+        envRegistry.markBootstrapped(environmentId);
+        emit("environment.changed", {});
+        // Auto-recover suspended sessions (fire-and-forget)
+        recoverSuspendedSessions(environmentId, conn).catch((err) => {
+            logger.error({ environmentId, err }, "Session recovery failed after auto-reconnect");
+        });
+        logger.info({ environmentId }, "Auto-reconnect successful");
+        reconnectStates.delete(environmentId);
+    }
+    catch (err) {
+        // Clean up any partially-established connection to avoid leaking state
+        adapterManager.removeConnection(environmentId);
+        const state = reconnectStates.get(environmentId) ?? { attempts: 0, nextRetryAt: 0 };
+        state.attempts++;
+        if (state.attempts >= RECONNECT_MAX_RETRIES) {
+            logger.error({ environmentId, attempts: state.attempts, err }, "Auto-reconnect exhausted all retries — giving up");
+            envRegistry.updateEnvironmentStatus(environmentId, "error");
+            emit("environment.changed", {});
+        }
+        else {
+            const delay = Math.min(RECONNECT_INITIAL_DELAY_MS * Math.pow(RECONNECT_BACKOFF_MULTIPLIER, state.attempts), RECONNECT_MAX_DELAY_MS);
+            state.nextRetryAt = Date.now() + delay;
+            reconnectStates.set(environmentId, state);
+            logger.info({ environmentId, attempts: state.attempts, nextRetryInMs: delay, err }, "Auto-reconnect failed — will retry");
+            envRegistry.updateEnvironmentStatus(environmentId, "disconnected");
+            emit("environment.changed", {});
+        }
+    }
+    finally {
+        reconnecting.delete(environmentId);
+    }
+}
+//# sourceMappingURL=auto-reconnect.js.map

package/dist/auto-reconnect.js.map

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

package/dist/compute-task-status.d.ts

@@ -0,0 +1,28 @@
+import type { SessionRow } from "@grackle-ai/database";
+/** Result of computing a task's effective status from its session history. */
+export interface TaskStatusResult {
+    /** The computed effective status string (e.g. "working", "paused", "not_started"). */
+    status: string;
+    /** The ID of the most recent session (by startedAt), or empty string if none. */
+    latestSessionId: string;
+}
+/**
+ * Compute the effective task status from the stored DB status and the task's
+ * session history. Pure function — no DB access, no side effects.
+ *
+ * Rules:
+ * 1. "complete" is sticky — once a human marks done, always returned as-is.
+ * 2. "failed" is sticky when no sessions exist (preserves human-set failure).
+ *    With active sessions, active status takes precedence.
+ * 3. No sessions → "not_started" (clamp any stale transient status).
+ * 4. Any active session (pending/running/idle):
+ *    - Any "idle" → "paused"
+ *    - Otherwise → "working"
+ * 5. All sessions terminal → "paused" (work was done, now stopped)
+ *
+ * @param storedStatus - The task's status as stored in the DB.
+ * @param sessions - All sessions for this task, in any order.
+ * @returns Computed status and the ID of the latest session.
+ */
+export declare function computeTaskStatus(storedStatus: string, sessions: Pick<SessionRow, "id" | "status" | "startedAt">[]): TaskStatusResult;
+//# sourceMappingURL=compute-task-status.d.ts.map

package/dist/compute-task-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-task-status.d.ts","sourceRoot":"","sources":["../src/compute-task-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC,EAAE,GAC1D,gBAAgB,CAsClB"}

package/dist/compute-task-status.js

@@ -0,0 +1,70 @@
+import { SESSION_STATUS, TASK_STATUS } from "@grackle-ai/common";
+/** Session statuses that indicate the session is actively running. */
+const ACTIVE_SESSION_STATUSES = new Set([
+    SESSION_STATUS.PENDING,
+    SESSION_STATUS.RUNNING,
+    SESSION_STATUS.IDLE,
+]);
+/**
+ * Compute the effective task status from the stored DB status and the task's
+ * session history. Pure function — no DB access, no side effects.
+ *
+ * Rules:
+ * 1. "complete" is sticky — once a human marks done, always returned as-is.
+ * 2. "failed" is sticky when no sessions exist (preserves human-set failure).
+ *    With active sessions, active status takes precedence.
+ * 3. No sessions → "not_started" (clamp any stale transient status).
+ * 4. Any active session (pending/running/idle):
+ *    - Any "idle" → "paused"
+ *    - Otherwise → "working"
+ * 5. All sessions terminal → "paused" (work was done, now stopped)
+ *
+ * @param storedStatus - The task's status as stored in the DB.
+ * @param sessions - All sessions for this task, in any order.
+ * @returns Computed status and the ID of the latest session.
+ */
+export function computeTaskStatus(storedStatus, sessions) {
+    // "complete" and "failed" are sticky — human-authoritative when no sessions contradict
+    if (storedStatus === TASK_STATUS.COMPLETE || storedStatus === TASK_STATUS.FAILED) {
+        const latestSessionId = sessions.length > 0
+            ? getLatestSession(sessions).id
+            : "";
+        // If there are active sessions, they take precedence over failed (but not complete)
+        if (storedStatus === TASK_STATUS.COMPLETE) {
+            return { status: TASK_STATUS.COMPLETE, latestSessionId };
+        }
+        // For "failed" without sessions, keep it; with active sessions, fall through
+        if (sessions.length === 0) {
+            return { status: TASK_STATUS.FAILED, latestSessionId: "" };
+        }
+    }
+    // No sessions → not_started (clamp any stale transient status)
+    if (sessions.length === 0) {
+        return { status: TASK_STATUS.NOT_STARTED, latestSessionId: "" };
+    }
+    // Check for any active sessions
+    const activeSessions = sessions.filter((s) => ACTIVE_SESSION_STATUSES.has(s.status));
+    if (activeSessions.length > 0) {
+        const hasIdle = activeSessions.some((s) => s.status === SESSION_STATUS.IDLE);
+        return {
+            status: hasIdle ? TASK_STATUS.PAUSED : TASK_STATUS.WORKING,
+            latestSessionId: getLatestSession(sessions).id,
+        };
+    }
+    // All sessions are terminal — task is paused (work was done, now stopped)
+    const latest = getLatestSession(sessions);
+    return { status: TASK_STATUS.PAUSED, latestSessionId: latest.id };
+}
+/** Get the most recent session by startedAt (descending), breaking ties by ID. */
+function getLatestSession(sessions) {
+    return sessions.reduce((latest, current) => {
+        if (current.startedAt > latest.startedAt) {
+            return current;
+        }
+        if (current.startedAt === latest.startedAt && current.id > latest.id) {
+            return current;
+        }
+        return latest;
+    });
+}
+//# sourceMappingURL=compute-task-status.js.map

package/dist/compute-task-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-task-status.js","sourceRoot":"","sources":["../src/compute-task-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAUjE,sEAAsE;AACtE,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC;IAC3D,cAAc,CAAC,OAAO;IACtB,cAAc,CAAC,OAAO;IACtB,cAAc,CAAC,IAAI;CACpB,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,QAA2D;IAE3D,uFAAuF;IACvF,IAAI,YAAY,KAAK,WAAW,CAAC,QAAQ,IAAI,YAAY,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;QACjF,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;YACzC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,EAAE;YAC/B,CAAC,CAAC,EAAE,CAAC;QACP,oFAAoF;QACpF,IAAI,YAAY,KAAK,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC1C,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC3D,CAAC;QACD,6EAA6E;QAC7E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,gCAAgC;IAChC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3C,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CACtC,CAAC;IAEF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO;YAC1D,eAAe,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,EAAE;SAC/C,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE1C,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;AACpE,CAAC;AAED,kFAAkF;AAClF,SAAS,gBAAgB,CACvB,QAA2D;IAE3D,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;QACzC,IAAI,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACzC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;YACrE,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/credential-bundle.d.ts

@@ -0,0 +1,12 @@
+import { powerline } from "@grackle-ai/common";
+import { type DatabaseInstance } from "@grackle-ai/database";
+/**
+ * Build a token bundle containing enabled provider credentials.
+ * When `runtime` is a known {@link RuntimeName}, only providers mapped to that runtime are included.
+ * When `runtime` is omitted, all enabled providers are included.
+ * When `runtime` is provided but not a recognized {@link RuntimeName}, no providers are included
+ * (fails safe rather than exposing all credentials for an unrecognized runtime).
+ * Reads values fresh from `process.env` or disk at call time.
+ */
+export declare function buildProviderTokenBundle(runtime?: string, database?: DatabaseInstance): powerline.TokenBundle;
+//# sourceMappingURL=credential-bundle.d.ts.map

package/dist/credential-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-bundle.d.ts","sourceRoot":"","sources":["../src/credential-bundle.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,SAAS,EAAoB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAsD,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAejH;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC,WAAW,CA0K7G"}