@grackle-ai/plugin-core 0.96.3

package/dist/environment-handlers.js

@@ -0,0 +1,255 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { envRegistry, workspaceStore, workspaceEnvironmentLinkStore, sessionStore, sqlite } from "@grackle-ai/database";
+import { reconnectOrProvision } from "@grackle-ai/adapter-sdk";
+import { adapterManager } from "@grackle-ai/core";
+import { tokenPush } from "@grackle-ai/core";
+import { parseAdapterConfig } from "@grackle-ai/core";
+import { emit } from "@grackle-ai/core";
+import { recoverSuspendedSessions } from "@grackle-ai/core";
+import { clearReconnectState } from "@grackle-ai/core";
+import { logger } from "@grackle-ai/core";
+import { envRowToProto } from "./grpc-proto-converters.js";
+import { killSessionAndCleanup } from "./grpc-shared.js";
+import { resolveBootstrapRuntime } from "@grackle-ai/core";
+/** List all registered environments. */
+export async function listEnvironments() {
+    const rows = envRegistry.listEnvironments();
+    return create(grackle.EnvironmentListSchema, {
+        environments: rows.map(envRowToProto),
+    });
+}
+/** Register a new environment. */
+export async function addEnvironment(req) {
+    if (!req.displayName || !req.adapterType) {
+        throw new ConnectError("displayName and adapterType required", Code.InvalidArgument);
+    }
+    const id = req.displayName.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    envRegistry.addEnvironment(id, req.displayName, req.adapterType, req.adapterConfig);
+    emit("environment.changed", {});
+    logger.info({ environmentId: id, adapterType: req.adapterType }, "Environment added");
+    const row = envRegistry.getEnvironment(id);
+    return envRowToProto(row);
+}
+/** Update an existing environment's display name and/or adapter config. */
+export async function updateEnvironment(req) {
+    if (!req.id) {
+        throw new ConnectError("id is required", Code.InvalidArgument);
+    }
+    const existing = envRegistry.getEnvironment(req.id);
+    if (!existing) {
+        throw new ConnectError(`Environment not found: ${req.id}`, Code.NotFound);
+    }
+    const displayName = req.displayName !== undefined ? req.displayName : undefined;
+    if (displayName?.trim() === "") {
+        throw new ConnectError("Environment name cannot be empty", Code.InvalidArgument);
+    }
+    let adapterConfig;
+    if (req.adapterConfig !== undefined) {
+        const raw = req.adapterConfig.trim() || "{}";
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw new ConnectError("adapterConfig is not valid JSON", Code.InvalidArgument);
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            throw new ConnectError("adapterConfig must be a JSON object", Code.InvalidArgument);
+        }
+        adapterConfig = raw;
+    }
+    const trimmedName = displayName !== undefined ? displayName.trim() : undefined;
+    if (trimmedName === undefined && adapterConfig === undefined) {
+        throw new ConnectError("No updatable fields provided", Code.InvalidArgument);
+    }
+    envRegistry.updateEnvironment(req.id, {
+        displayName: trimmedName,
+        adapterConfig,
+    });
+    logger.info({ environmentId: req.id, displayName: trimmedName }, "Environment updated");
+    emit("environment.changed", {});
+    const updated = envRegistry.getEnvironment(req.id);
+    return envRowToProto(updated);
+}
+/** Remove an environment after disconnecting it and cleaning up references. */
+export async function removeEnvironment(req) {
+    // Block deletion if workspaces still reference this environment as primary
+    const wsCount = workspaceStore.countWorkspacesByEnvironment(req.id);
+    if (wsCount > 0) {
+        throw new ConnectError(`Cannot remove environment: ${wsCount} active workspace(s) still reference it. Archive or reparent them first.`, Code.FailedPrecondition);
+    }
+    // Stop auto-reconnect attempts for this environment
+    clearReconnectState(req.id);
+    // Disconnect the adapter if currently connected
+    const env = envRegistry.getEnvironment(req.id);
+    if (env) {
+        const adapter = adapterManager.getAdapter(env.adapterType);
+        if (adapter) {
+            try {
+                await adapter.disconnect(req.id);
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    }
+    adapterManager.removeConnection(req.id);
+    // Delete links, sessions, and environment atomically to prevent partial cleanup
+    // if a concurrent LinkEnvironment RPC races between steps.
+    const conn = sqlite;
+    if (conn) {
+        conn.transaction(() => {
+            workspaceEnvironmentLinkStore.deleteLinksForEnvironment(req.id);
+            sessionStore.deleteByEnvironment(req.id);
+            envRegistry.removeEnvironment(req.id);
+        })();
+    }
+    else {
+        workspaceEnvironmentLinkStore.deleteLinksForEnvironment(req.id);
+        sessionStore.deleteByEnvironment(req.id);
+        envRegistry.removeEnvironment(req.id);
+    }
+    emit("environment.changed", {});
+    emit("environment.removed", { environmentId: req.id });
+    logger.info({ environmentId: req.id }, "Environment removed");
+    return create(grackle.EmptySchema, {});
+}
+/** Provision (bootstrap + connect) an environment, streaming progress events. */
+export async function* provisionEnvironment(req) {
+    // Manual provision overrides auto-reconnect
+    clearReconnectState(req.id);
+    const env = envRegistry.getEnvironment(req.id);
+    if (!env) {
+        yield create(grackle.ProvisionEventSchema, {
+            stage: "error",
+            message: `Environment not found: ${req.id}`,
+            progress: 0,
+        });
+        return;
+    }
+    const adapter = adapterManager.getAdapter(env.adapterType);
+    if (!adapter) {
+        yield create(grackle.ProvisionEventSchema, {
+            stage: "error",
+            message: `No adapter for type: ${env.adapterType}`,
+            progress: 0,
+        });
+        return;
+    }
+    // Force teardown: kill active session, disconnect adapter, clear connection
+    if (req.force) {
+        const activeSession = sessionStore.getActiveForEnv(req.id);
+        if (activeSession) {
+            killSessionAndCleanup(activeSession);
+        }
+        try {
+            await adapter.disconnect(req.id);
+        }
+        catch {
+            // best-effort teardown
+        }
+        adapterManager.removeConnection(req.id);
+    }
+    envRegistry.updateEnvironmentStatus(req.id, "connecting");
+    emit("environment.changed", {});
+    const config = parseAdapterConfig(env.adapterConfig);
+    config.defaultRuntime = resolveBootstrapRuntime(env);
+    const powerlineToken = env.powerlineToken;
+    try {
+        for await (const event of reconnectOrProvision(req.id, adapter, config, powerlineToken, !!env.bootstrapped, req.force)) {
+            yield create(grackle.ProvisionEventSchema, {
+                stage: event.stage,
+                message: event.message,
+                progress: event.progress,
+            });
+        }
+    }
+    catch (err) {
+        logger.error({ environmentId: req.id, err }, "Provision/bootstrap failed");
+        const currentEnv = envRegistry.getEnvironment(req.id);
+        if (currentEnv?.status !== "connected") {
+            envRegistry.updateEnvironmentStatus(req.id, "error");
+            emit("environment.changed", {});
+        }
+        yield create(grackle.ProvisionEventSchema, {
+            stage: "error",
+            message: `Provision failed: ${err instanceof Error ? err.message : String(err)}`,
+            progress: 0,
+        });
+        return;
+    }
+    try {
+        const conn = await adapter.connect(req.id, config, powerlineToken);
+        adapterManager.setConnection(req.id, conn);
+        // Push stored tokens to newly connected environment
+        await tokenPush.pushToEnv(req.id);
+        envRegistry.updateEnvironmentStatus(req.id, "connected");
+        envRegistry.markBootstrapped(req.id);
+        emit("environment.changed", {});
+        // Auto-recover suspended sessions (fire-and-forget)
+        recoverSuspendedSessions(req.id, conn).catch((err) => {
+            logger.error({ environmentId: req.id, err }, "Session recovery failed");
+        });
+    }
+    catch (err) {
+        // adapter.connect() actually failed
+        envRegistry.updateEnvironmentStatus(req.id, "error");
+        emit("environment.changed", {});
+        yield create(grackle.ProvisionEventSchema, {
+            stage: "error",
+            message: `Connection failed: ${err instanceof Error ? err.message : String(err)}`,
+            progress: 0,
+        });
+        return;
+    }
+    logger.info({ environmentId: req.id }, "Environment provisioned");
+    // Best-effort: notify client that provision completed.
+    // If the client already disconnected (e.g. fire-and-forget fetch in
+    // test helpers), the yield throws — but the environment IS connected,
+    // so we must NOT revert the status to "error".
+    try {
+        yield create(grackle.ProvisionEventSchema, {
+            stage: "ready",
+            message: "Environment connected",
+            progress: 1,
+        });
+    }
+    catch {
+        // Client disconnected after successful provision — ignore
+    }
+}
+/** Stop (disconnect) an environment. */
+export async function stopEnvironment(req) {
+    const env = envRegistry.getEnvironment(req.id);
+    if (!env) {
+        throw new ConnectError(`Environment not found: ${req.id}`, Code.NotFound);
+    }
+    const adapter = adapterManager.getAdapter(env.adapterType);
+    if (adapter) {
+        await adapter.stop(req.id, parseAdapterConfig(env.adapterConfig));
+    }
+    adapterManager.removeConnection(req.id);
+    envRegistry.updateEnvironmentStatus(req.id, "disconnected");
+    emit("environment.changed", {});
+    logger.info({ environmentId: req.id }, "Environment stopped");
+    return create(grackle.EmptySchema, {});
+}
+/** Destroy an environment and its underlying resources. */
+export async function destroyEnvironment(req) {
+    const env = envRegistry.getEnvironment(req.id);
+    if (!env) {
+        throw new ConnectError(`Environment not found: ${req.id}`, Code.NotFound);
+    }
+    const adapter = adapterManager.getAdapter(env.adapterType);
+    if (adapter) {
+        await adapter.destroy(req.id, parseAdapterConfig(env.adapterConfig));
+    }
+    adapterManager.removeConnection(req.id);
+    envRegistry.updateEnvironmentStatus(req.id, "disconnected");
+    emit("environment.changed", {});
+    logger.info({ environmentId: req.id }, "Environment destroyed");
+    return create(grackle.EmptySchema, {});
+}
+//# sourceMappingURL=environment-handlers.js.map

package/dist/environment-handlers.js.map

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

package/dist/environment-reconciliation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Environment status reconciliation phase — periodic safety net for
+ * in-memory connection state vs database environment status drift.
+ *
+ * At several call sites, `removeConnection()` succeeds but the subsequent
+ * `updateEnvironmentStatus()` can fail (e.g., DB lock). This leaves the
+ * database showing "connected" while no in-memory connection exists. The
+ * heartbeat only probes entries in the connections Map, so the drift
+ * persists indefinitely. This phase detects and fixes such mismatches.
+ */
+import type { EnvironmentStatus } from "@grackle-ai/common";
+import type { EnvironmentRow } from "@grackle-ai/database";
+import type { GrackleEventType } from "@grackle-ai/core";
+import type { ReconciliationPhase } from "@grackle-ai/core";
+/** Dependencies injected into the environment reconciliation phase for testability. */
+export interface EnvironmentReconciliationDeps {
+    /** List all registered environments from the database. */
+    listEnvironments: () => EnvironmentRow[];
+    /** Get the set of environment IDs that currently have in-memory connections. */
+    listConnectionIds: () => Set<string>;
+    /** Update an environment's status in the database. */
+    updateEnvironmentStatus: (id: string, status: EnvironmentStatus) => void;
+    /** Remove an in-memory connection entry. */
+    removeConnection: (environmentId: string) => void;
+    /** Emit a domain event. */
+    emit: (type: GrackleEventType, payload: Record<string, unknown>) => void;
+}
+/**
+ * Create the environment status reconciliation phase.
+ *
+ * @param deps - Injected dependencies for testability.
+ * @returns A ReconciliationPhase that can be registered with the ReconciliationManager.
+ */
+export declare function createEnvironmentReconciliationPhase(deps: EnvironmentReconciliationDeps): ReconciliationPhase;
+//# sourceMappingURL=environment-reconciliation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment-reconciliation.d.ts","sourceRoot":"","sources":["../src/environment-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAoB5D,uFAAuF;AACvF,MAAM,WAAW,6BAA6B;IAC5C,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,cAAc,EAAE,CAAC;IACzC,gFAAgF;IAChF,iBAAiB,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,sDAAsD;IACtD,uBAAuB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACzE,4CAA4C;IAC5C,gBAAgB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,2BAA2B;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC1E;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,6BAA6B,GAClC,mBAAmB,CAkDrB"}

package/dist/environment-reconciliation.js

@@ -0,0 +1,74 @@
+/**
+ * Environment status reconciliation phase — periodic safety net for
+ * in-memory connection state vs database environment status drift.
+ *
+ * At several call sites, `removeConnection()` succeeds but the subsequent
+ * `updateEnvironmentStatus()` can fail (e.g., DB lock). This leaves the
+ * database showing "connected" while no in-memory connection exists. The
+ * heartbeat only probes entries in the connections Map, so the drift
+ * persists indefinitely. This phase detects and fixes such mismatches.
+ */
+import { logger } from "@grackle-ai/core";
+/**
+ * Statuses that indicate the environment should have an active connection.
+ *
+ * "connecting" is intentionally excluded — it represents an in-progress
+ * provision/connect where no in-memory connection exists yet. Reconciling
+ * it would incorrectly flip environments back to "disconnected" during
+ * normal provisioning flows.
+ */
+const ACTIVE_STATUSES = new Set([
+    "connected",
+]);
+/** Statuses that indicate the environment should NOT have an in-memory connection. */
+const INACTIVE_STATUSES = new Set([
+    "disconnected",
+    "sleeping",
+]);
+/**
+ * Create the environment status reconciliation phase.
+ *
+ * @param deps - Injected dependencies for testability.
+ * @returns A ReconciliationPhase that can be registered with the ReconciliationManager.
+ */
+export function createEnvironmentReconciliationPhase(deps) {
+    return {
+        name: "environment-status",
+        execute: async () => {
+            const environments = deps.listEnvironments();
+            const connectionIds = deps.listConnectionIds();
+            let fixedCount = 0;
+            // ── Forward drift: DB says active, but no in-memory connection ──
+            for (const env of environments) {
+                if (ACTIVE_STATUSES.has(env.status) && !connectionIds.has(env.id)) {
+                    try {
+                        deps.updateEnvironmentStatus(env.id, "disconnected");
+                        deps.emit("environment.changed", {});
+                        fixedCount++;
+                    }
+                    catch (err) {
+                        logger.error({ err, environmentId: env.id }, "Environment reconciliation: failed to fix forward drift");
+                    }
+                }
+            }
+            // ── Reverse drift: in-memory connection exists, but DB says inactive ──
+            const envById = new Map(environments.map((e) => [e.id, e]));
+            for (const connectionId of connectionIds) {
+                const env = envById.get(connectionId);
+                if (env && INACTIVE_STATUSES.has(env.status)) {
+                    try {
+                        deps.removeConnection(connectionId);
+                        fixedCount++;
+                    }
+                    catch (err) {
+                        logger.error({ err, environmentId: connectionId }, "Environment reconciliation: failed to fix reverse drift");
+                    }
+                }
+            }
+            if (fixedCount > 0) {
+                logger.warn({ fixedCount }, "Environment reconciliation: fixed %d drift(s) — these should have been caught by the primary disconnect flow", fixedCount);
+            }
+        },
+    };
+}
+//# sourceMappingURL=environment-reconciliation.js.map

package/dist/environment-reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-reconciliation.js","sourceRoot":"","sources":["../src/environment-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C;;;;;;;GAOG;AACH,MAAM,eAAe,GAAmC,IAAI,GAAG,CAAC;IAC9D,WAAW;CACZ,CAAC,CAAC;AAEH,sFAAsF;AACtF,MAAM,iBAAiB,GAAmC,IAAI,GAAG,CAAC;IAChE,cAAc;IACd,UAAU;CACX,CAAC,CAAC;AAgBH;;;;;GAKG;AACH,MAAM,UAAU,oCAAoC,CAClD,IAAmC;IAEnC,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,KAAK,IAAmB,EAAE;YACjC,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC/C,IAAI,UAAU,GAAG,CAAC,CAAC;YAEnB,mEAAmE;YACnE,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;gBAC/B,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,MAA2B,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACvF,IAAI,CAAC;wBACH,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;wBACrD,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;wBACrC,UAAU,EAAE,CAAC;oBACf,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,EAAE,EAC9B,yDAAyD,CAC1D,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,yEAAyE;YACzE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAyB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACpF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBACtC,IAAI,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,MAA2B,CAAC,EAAE,CAAC;oBAClE,IAAI,CAAC;wBACH,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;wBACpC,UAAU,EAAE,CAAC;oBACf,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,EACpC,yDAAyD,CAC1D,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,EACd,8GAA8G,EAC9G,UAAU,CACX,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/escalation-handlers.d.ts

@@ -0,0 +1,8 @@
+import { grackle } from "@grackle-ai/common";
+/** Create a new escalation and route it to notification channels. */
+export declare function createEscalation(req: grackle.CreateEscalationRequest): Promise<grackle.Escalation>;
+/** List escalations with optional workspace and status filters. */
+export declare function listEscalations(req: grackle.ListEscalationsRequest): Promise<grackle.EscalationList>;
+/** Acknowledge an escalation (mark as seen by the human). */
+export declare function acknowledgeEscalation(req: grackle.AcknowledgeEscalationRequest): Promise<grackle.Escalation>;
+//# sourceMappingURL=escalation-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-handlers.d.ts","sourceRoot":"","sources":["../src/escalation-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAS7C,qEAAqE;AACrE,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAuCxG;AAED,mEAAmE;AACnE,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAS1G;AAED,6DAA6D;AAC7D,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,4BAA4B,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAWlH"}

package/dist/escalation-handlers.js

@@ -0,0 +1,60 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { escalationStore } from "@grackle-ai/database";
+import { ulid } from "ulid";
+import { routeEscalation } from "@grackle-ai/core";
+import { escalationRowToProto } from "./grpc-proto-converters.js";
+/** Valid urgency values for escalations. */
+const VALID_URGENCY = new Set(["low", "normal", "high"]);
+/** Create a new escalation and route it to notification channels. */
+export async function createEscalation(req) {
+    if (!req.message) {
+        throw new ConnectError("message is required", Code.InvalidArgument);
+    }
+    const urgency = VALID_URGENCY.has(req.urgency) ? req.urgency : "normal";
+    const id = ulid();
+    const taskUrl = req.taskId ? `/tasks/${req.taskId}` : "";
+    escalationStore.createEscalation(id, req.workspaceId, req.taskId, req.title || "Escalation", req.message, "explicit", urgency, taskUrl);
+    const row = escalationStore.getEscalation(id);
+    if (row) {
+        await routeEscalation(row);
+    }
+    // Re-read after routing to get updated status
+    const updated = escalationStore.getEscalation(id);
+    return escalationRowToProto(updated ?? row ?? {
+        id,
+        workspaceId: req.workspaceId,
+        taskId: req.taskId,
+        title: req.title || "Escalation",
+        message: req.message,
+        source: "explicit",
+        urgency: req.urgency || "normal",
+        status: "pending",
+        createdAt: new Date().toISOString(),
+        deliveredAt: null,
+        acknowledgedAt: null,
+        taskUrl,
+    });
+}
+/** List escalations with optional workspace and status filters. */
+export async function listEscalations(req) {
+    const rows = escalationStore.listEscalations(req.workspaceId || undefined, req.status || undefined, req.limit > 0 ? req.limit : undefined);
+    return create(grackle.EscalationListSchema, {
+        escalations: rows.map(escalationRowToProto),
+    });
+}
+/** Acknowledge an escalation (mark as seen by the human). */
+export async function acknowledgeEscalation(req) {
+    if (!req.id) {
+        throw new ConnectError("id is required", Code.InvalidArgument);
+    }
+    const row = escalationStore.getEscalation(req.id);
+    if (!row) {
+        throw new ConnectError(`escalation not found: ${req.id}`, Code.NotFound);
+    }
+    escalationStore.updateEscalationStatus(req.id, "acknowledged");
+    const updated = escalationStore.getEscalation(req.id);
+    return escalationRowToProto(updated ?? row);
+}
+//# sourceMappingURL=escalation-handlers.js.map

package/dist/escalation-handlers.js.map

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

package/dist/finding-handlers.d.ts

@@ -0,0 +1,8 @@
+import { grackle } from "@grackle-ai/common";
+/** Post a new finding. */
+export declare function postFinding(req: grackle.PostFindingRequest): Promise<grackle.Finding>;
+/** Query findings with optional filters. */
+export declare function queryFindings(req: grackle.QueryFindingsRequest): Promise<grackle.FindingList>;
+/** Get a single finding by ID. */
+export declare function getFinding(req: grackle.GetFindingRequest): Promise<grackle.Finding>;
+//# sourceMappingURL=finding-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finding-handlers.d.ts","sourceRoot":"","sources":["../src/finding-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM7C,0BAA0B;AAC1B,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAmB3F;AAED,4CAA4C;AAC5C,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAUnG;AAED,kCAAkC;AAClC,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CASzF"}

package/dist/finding-handlers.js

@@ -0,0 +1,38 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { findingStore } from "@grackle-ai/database";
+import { v4 as uuid } from "uuid";
+import { emit } from "@grackle-ai/core";
+import { findingRowToProto } from "./grpc-proto-converters.js";
+/** Post a new finding. */
+export async function postFinding(req) {
+    if (!req.title) {
+        throw new ConnectError("title is required", Code.InvalidArgument);
+    }
+    const id = uuid().slice(0, 8);
+    findingStore.postFinding(id, req.workspaceId, req.taskId, req.sessionId, req.category, req.title, req.content, [...req.tags]);
+    emit("finding.posted", { workspaceId: req.workspaceId, findingId: id });
+    const rows = findingStore.queryFindings(req.workspaceId);
+    const row = rows.find((r) => r.id === id);
+    return findingRowToProto(row);
+}
+/** Query findings with optional filters. */
+export async function queryFindings(req) {
+    const rows = findingStore.queryFindings(req.workspaceId, req.categories.length > 0 ? [...req.categories] : undefined, req.tags.length > 0 ? [...req.tags] : undefined, req.limit || undefined);
+    return create(grackle.FindingListSchema, {
+        findings: rows.map(findingRowToProto),
+    });
+}
+/** Get a single finding by ID. */
+export async function getFinding(req) {
+    if (!req.id) {
+        throw new ConnectError("id is required", Code.InvalidArgument);
+    }
+    const row = findingStore.getFinding(req.id);
+    if (!row) {
+        throw new ConnectError(`finding not found: ${req.id}`, Code.NotFound);
+    }
+    return findingRowToProto(row);
+}
+//# sourceMappingURL=finding-handlers.js.map

package/dist/finding-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-handlers.js","sourceRoot":"","sources":["../src/finding-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,0BAA0B;AAC1B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAA+B;IAC/D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,YAAY,CAAC,WAAW,CACtB,EAAE,EACF,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,SAAS,EACb,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,KAAK,EACT,GAAG,CAAC,OAAO,EACX,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CACd,CAAC;IACF,IAAI,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,OAAO,iBAAiB,CAAC,GAAI,CAAC,CAAC;AACjC,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAiC;IACnE,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,CACrC,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,EAC3D,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAC/C,GAAG,CAAC,KAAK,IAAI,SAAS,CACvB,CAAC;IACF,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE;QACvC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC;KACtC,CAAC,CAAC;AACL,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAA8B;IAC7D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,YAAY,CAAC,sBAAsB,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/dist/grpc-proto-converters.d.ts

@@ -0,0 +1,31 @@
+import { grackle } from "@grackle-ai/common";
+import type { EnvironmentRow, SessionRow } from "@grackle-ai/database";
+import { workspaceStore, taskStore, personaStore, findingStore, escalationStore, scheduleStore } from "@grackle-ai/database";
+import type { KnowledgeNode, KnowledgeEdge } from "@grackle-ai/knowledge";
+/** Convert an environment database row to its proto representation. */
+export declare function envRowToProto(row: EnvironmentRow): grackle.Environment;
+/** Convert a session database row to its proto representation. */
+export declare function sessionRowToProto(row: SessionRow): grackle.Session;
+/**
+ * Convert a workspace database row to its proto representation.
+ * When converting many workspaces (e.g. listWorkspaces), pass a pre-fetched
+ * linkedEnvMap to avoid N+1 queries. When omitted, falls back to a per-row query.
+ */
+export declare function workspaceRowToProto(row: workspaceStore.WorkspaceRow, linkedEnvMap?: Map<string, string[]>): grackle.Workspace;
+/** Convert a task database row to its proto representation. */
+export declare function taskRowToProto(row: taskStore.TaskRow, childIds?: string[], computedStatus?: string, latestSessionId?: string): grackle.Task;
+/** Convert a schedule database row to its proto representation. */
+export declare function scheduleRowToProto(row: scheduleStore.ScheduleRow): grackle.Schedule;
+/** Convert a finding database row to its proto representation. */
+export declare function findingRowToProto(row: findingStore.FindingRow): grackle.Finding;
+/** Convert an escalation database row to its proto representation. */
+export declare function escalationRowToProto(row: escalationStore.EscalationRow): grackle.Escalation;
+/** Safely parse a JSON string, returning the fallback value on failure. */
+export declare function safeParseJson<T>(value: string | undefined, fallback: T): T;
+/** Convert a persona database row to a Persona proto message. */
+export declare function personaRowToProto(row: personaStore.PersonaRow): grackle.Persona;
+/** Convert a KnowledgeNode to its proto representation. */
+export declare function knowledgeNodeToProto(node: KnowledgeNode): grackle.KnowledgeNodeProto;
+/** Convert a KnowledgeEdge to its proto representation. */
+export declare function knowledgeEdgeToProto(edge: KnowledgeEdge): grackle.KnowledgeEdgeProto;
+//# sourceMappingURL=grpc-proto-converters.d.ts.map

package/dist/grpc-proto-converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-proto-converters.d.ts","sourceRoot":"","sources":["../src/grpc-proto-converters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAqD,MAAM,sBAAsB,CAAC;AAChL,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE1E,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAYtE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAsBlE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,cAAc,CAAC,YAAY,EAChC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,OAAO,CAAC,SAAS,CAoBnB;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,CAAC,OAAO,EACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,cAAc,CAAC,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAyBd;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,CAAC,WAAW,GAAG,OAAO,CAAC,QAAQ,CAiBnF;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAK/E;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,CAAC,aAAa,GAAG,OAAO,CAAC,UAAU,CAe3F;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAS1E;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAgE/E;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAepF;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAQpF"}