@grackle-ai/core 0.75.4

package/dist/ws-bridge.js

@@ -0,0 +1,372 @@
+import { WebSocketServer, WebSocket } from "ws";
+import { create } from "@bufbuild/protobuf";
+import { powerline } from "@grackle-ai/common";
+import { envRegistry, sessionStore, workspaceStore, taskStore, grackleHome } from "@grackle-ai/database";
+import * as adapterManager from "./adapter-manager.js";
+import { reconnectOrProvision, } from "@grackle-ai/adapter-sdk";
+import * as streamHub from "./stream-hub.js";
+import * as tokenPush from "./token-push.js";
+import { v4 as uuid } from "uuid";
+import { join } from "node:path";
+import { LOGS_DIR, DEFAULT_MCP_PORT, ROOT_TASK_ID, eventTypeToString, } from "@grackle-ai/common";
+import { resolvePersona, fetchOrchestratorContext, SystemPromptBuilder, buildTaskPrompt } from "@grackle-ai/prompt";
+import { logger } from "./logger.js";
+import { processEventStream } from "./event-processor.js";
+import { setWssInstance } from "./ws-broadcast.js";
+import { emit } from "./event-bus.js";
+import { recoverSuspendedSessions } from "./session-recovery.js";
+import { buildMcpServersJson, toDialableHost } from "./grpc-service.js";
+import { createScopedToken, loadOrCreateApiKey } from "@grackle-ai/auth";
+const WS_PING_INTERVAL_MS = 30_000;
+const WS_CLOSE_UNAUTHORIZED = 4001;
+const WS_CLOSE_FORBIDDEN_ORIGIN = 4003;
+/** Loopback hostnames accepted as valid WebSocket origins in local mode. */
+const LOOPBACK_HOSTNAMES = new Set([
+    "localhost",
+    "127.0.0.1",
+    "::1",
+    "[::1]",
+]);
+/**
+ * Check whether a WebSocket Origin header is allowed.
+ *
+ * Rules:
+ * - Missing origin (non-browser clients, extensions) → always allowed
+ * - Origin port must match the web server port
+ * - In local mode (`allowNetwork === false`), hostname must be loopback
+ * - In network mode (`allowNetwork === true`), any hostname on the right port is allowed
+ */
+export function isAllowedOrigin(origin, webPort, allowNetwork) {
+    if (origin === undefined) {
+        return true;
+    }
+    let parsed;
+    try {
+        parsed = new URL(origin);
+    }
+    catch {
+        return false;
+    }
+    const originPort = parsed.port
+        ? parseInt(parsed.port, 10)
+        : (parsed.protocol === "https:" ? 443 : 80);
+    if (originPort !== webPort) {
+        return false;
+    }
+    if (allowNetwork) {
+        return true;
+    }
+    return LOOPBACK_HOSTNAMES.has(parsed.hostname);
+}
+/** Create a WebSocket server on top of an HTTP server for real-time event streaming. */
+export function createWsBridge(httpServer, options) {
+    const wss = new WebSocketServer({ server: httpServer });
+    setWssInstance(wss);
+    wss.on("connection", (ws, req) => {
+        const origin = req.headers.origin;
+        if (!isAllowedOrigin(origin, options.webPort ?? 0, options.allowNetwork ?? false)) {
+            logger.warn({ origin }, "Rejected WebSocket connection from disallowed origin");
+            ws.close(WS_CLOSE_FORBIDDEN_ORIGIN, "Forbidden origin");
+            return;
+        }
+        const url = new URL(req.url || "/", "http://localhost");
+        const token = url.searchParams.get("token") || "";
+        const hasValidToken = token.length > 0 && options.verifyApiKey(token);
+        const hasValidCookie = options.validateCookie
+            ? options.validateCookie(req.headers.cookie || "")
+            : false;
+        if (!hasValidToken && !hasValidCookie) {
+            ws.close(WS_CLOSE_UNAUTHORIZED, "Unauthorized");
+            return;
+        }
+        const subscriptions = new Map();
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        ws.on("message", async (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                await handleMessage(ws, msg, subscriptions);
+            }
+            catch (err) {
+                sendWs(ws, { type: "error", payload: { message: String(err) } });
+            }
+        });
+        ws.on("close", () => {
+            for (const sub of subscriptions.values()) {
+                sub.cancel();
+            }
+        });
+        const pingInterval = setInterval(() => {
+            if (ws.readyState === WebSocket.OPEN) {
+                ws.ping();
+            }
+        }, WS_PING_INTERVAL_MS);
+        ws.on("close", () => clearInterval(pingInterval));
+    });
+    return wss;
+}
+/** Safely parse an adapter config string, returning an empty object on failure. */
+function safeParseAdapterConfig(raw, environmentId) {
+    try {
+        const parsed = JSON.parse(raw || "{}");
+        if (typeof parsed === "object" && parsed !== null) {
+            return parsed;
+        }
+        logger.warn({ environmentId, raw }, "adapterConfig is not an object, using empty config");
+        return {};
+    }
+    catch (err) {
+        logger.warn({ environmentId, raw, err }, "Failed to parse adapterConfig, using empty config");
+        return {};
+    }
+}
+/**
+ * Auto-provisions and connects an environment if it is not already connected.
+ * Sends provision progress events over the WebSocket and updates the environment
+ * registry status. Returns the connection on success, or undefined on failure.
+ */
+async function autoProvisionEnvironment(ws, environmentId, env, logContext) {
+    let conn = adapterManager.getConnection(environmentId);
+    if (conn) {
+        return conn;
+    }
+    const adapter = adapterManager.getAdapter(env.adapterType);
+    if (!adapter) {
+        sendWs(ws, {
+            type: "error",
+            payload: { message: `No adapter for type: ${env.adapterType}` },
+        });
+        return undefined;
+    }
+    logger.info({ environmentId, ...logContext }, "Auto-provisioning environment");
+    envRegistry.updateEnvironmentStatus(environmentId, "connecting");
+    emit("environment.changed", {});
+    try {
+        const config = safeParseAdapterConfig(env.adapterConfig, environmentId);
+        config.defaultRuntime = env.defaultRuntime;
+        const powerlineToken = env.powerlineToken || "";
+        for await (const provEvent of reconnectOrProvision(environmentId, adapter, config, powerlineToken, !!env.bootstrapped)) {
+            logger.info({ environmentId, stage: provEvent.stage, ...logContext }, "Auto-provision progress");
+            emit("environment.provision_progress", {
+                environmentId,
+                stage: provEvent.stage,
+                message: provEvent.message,
+                progress: provEvent.progress,
+            });
+        }
+        conn = await adapter.connect(environmentId, config, powerlineToken);
+        adapterManager.setConnection(environmentId, conn);
+        // Push stored tokens to newly connected environment
+        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");
+        });
+        logger.info({ environmentId, ...logContext }, "Auto-provision complete");
+        emit("environment.provision_progress", {
+            environmentId,
+            stage: "ready",
+            message: "Environment connected",
+            progress: 1,
+        });
+        return conn;
+    }
+    catch (err) {
+        logger.error({ environmentId, ...logContext, err }, "Auto-provision failed");
+        envRegistry.updateEnvironmentStatus(environmentId, "error");
+        emit("environment.changed", {});
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        emit("environment.provision_progress", {
+            environmentId,
+            stage: "error",
+            message: `Auto-provision failed: ${errorMessage}`,
+            progress: 0,
+        });
+        sendWs(ws, {
+            type: "error",
+            payload: {
+                message: `Failed to auto-connect environment ${environmentId}: ${errorMessage}`,
+            },
+        });
+        return undefined;
+    }
+}
+/** Start a new agent session for a task. Returns an error message string on failure, undefined on success. */
+export async function startTaskSession(ws, task, options) {
+    const workspace = task.workspaceId ? workspaceStore.getWorkspace(task.workspaceId) : undefined;
+    if (task.workspaceId && !workspace) {
+        logger.warn({ taskId: task.id }, "startTaskSession failed: workspace not found");
+        return `Workspace not found: ${task.workspaceId}`;
+    }
+    const environmentId = options?.environmentId || workspace?.environmentId || "";
+    const env = envRegistry.getEnvironment(environmentId);
+    if (!env) {
+        logger.warn({ taskId: task.id, environmentId }, "startTaskSession failed: environment not found");
+        return `Environment not found: ${environmentId}`;
+    }
+    let conn;
+    if (ws) {
+        conn = await autoProvisionEnvironment(ws, environmentId, env, {
+            taskId: task.id,
+        });
+    }
+    else {
+        conn = adapterManager.getConnection(environmentId) ?? undefined;
+    }
+    if (!conn) {
+        return ws ? undefined : `Environment not connected: ${environmentId}`;
+    }
+    // Resolve persona via cascade (request → task → workspace → app default)
+    let resolved;
+    try {
+        resolved = resolvePersona(options?.personaId || "", task.defaultPersonaId, workspace?.defaultPersonaId || "");
+    }
+    catch (err) {
+        return err.message;
+    }
+    const sessionId = uuid();
+    const { runtime, model, maxTurns, systemPrompt, persona: resolvedPersonaRow } = resolved;
+    const logPath = join(grackleHome, LOGS_DIR, sessionId);
+    const freshTask = taskStore.getTask(task.id) || task;
+    // For the root/System task, use the user's chat message (passed as notes)
+    // as the initial prompt instead of the task title "System".
+    // For regular tasks, build the prompt from title + description.
+    const taskPrompt = freshTask.id === ROOT_TASK_ID
+        ? (options?.notes || "")
+        : buildTaskPrompt(freshTask.title, freshTask.description, options?.notes);
+    const orchestratorCtx = freshTask.canDecompose && freshTask.depth <= 1
+        ? fetchOrchestratorContext(freshTask.workspaceId || "") : undefined;
+    const systemContext = new SystemPromptBuilder({
+        task: { title: freshTask.title, description: freshTask.description, notes: options?.notes || "" },
+        taskId: freshTask.id, canDecompose: freshTask.canDecompose, personaPrompt: systemPrompt,
+        taskDepth: freshTask.depth, ...orchestratorCtx,
+        ...(orchestratorCtx && { triggerMode: "fresh" }),
+    }).build();
+    sessionStore.createSession(sessionId, environmentId, runtime, freshTask.title, model, logPath, freshTask.id, resolved.personaId);
+    emit("task.started", {
+        taskId: freshTask.id,
+        sessionId,
+        workspaceId: freshTask.workspaceId || "",
+    });
+    // Re-push stored tokens + provider credentials (scoped to runtime) so they're fresh for this session.
+    // For local envs, skip file tokens — the PowerLine is on the same machine.
+    await tokenPush.refreshTokensForTask(environmentId, runtime, env.adapterType === "local" ? { excludeFileTokens: true } : undefined);
+    let mcpServersJson = "";
+    try {
+        const parsed = JSON.parse(resolvedPersonaRow.mcpServers || "[]");
+        if (Array.isArray(parsed)) {
+            const mcpServers = parsed;
+            if (mcpServers.length > 0) {
+                mcpServersJson = buildMcpServersJson(mcpServers);
+            }
+        }
+    }
+    catch {
+        logger.warn("Failed to parse persona.mcpServers JSON; ignoring");
+    }
+    // Build MCP broker URL + scoped token so runtimes can call the MCP server.
+    const mcpPort = parseInt(process.env.GRACKLE_MCP_PORT || String(DEFAULT_MCP_PORT), 10);
+    const mcpDialHost = toDialableHost(process.env.GRACKLE_HOST || "127.0.0.1");
+    const mcpUrl = `http://${mcpDialHost}:${mcpPort}/mcp`;
+    const mcpToken = createScopedToken({ sub: freshTask.id, pid: freshTask.workspaceId || "", per: resolved.personaId, sid: sessionId }, loadOrCreateApiKey(grackleHome));
+    const useWorktrees = workspace?.useWorktrees ?? false;
+    const powerlineReq = create(powerline.SpawnRequestSchema, {
+        sessionId,
+        runtime,
+        prompt: taskPrompt,
+        model,
+        maxTurns,
+        branch: freshTask.branch,
+        worktreeBasePath: freshTask.branch
+            ? (workspace?.worktreeBasePath || process.env.GRACKLE_WORKTREE_BASE || "/workspace")
+            : "",
+        useWorktrees,
+        systemContext,
+        workspaceId: freshTask.workspaceId ?? undefined,
+        taskId: freshTask.id,
+        mcpServersJson,
+        mcpUrl,
+        mcpToken,
+    });
+    processEventStream(conn.client.spawn(powerlineReq), {
+        sessionId,
+        logPath,
+        workspaceId: freshTask.workspaceId ?? undefined,
+        taskId: freshTask.id,
+        systemContext,
+        prompt: taskPrompt,
+    });
+    return undefined;
+}
+async function handleMessage(ws, msg, subscriptions) {
+    switch (msg.type) {
+        case "subscribe": {
+            const sessionId = msg.payload?.sessionId;
+            if (!sessionId) {
+                return;
+            }
+            // Cancel any existing subscription for this session
+            const subKey = `session:${sessionId}`;
+            const existing = subscriptions.get(subKey);
+            if (existing) {
+                subscriptions.delete(subKey);
+                existing.cancel();
+            }
+            const stream = streamHub.createStream(sessionId);
+            subscriptions.set(subKey, stream);
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            (async () => {
+                for await (const event of stream) {
+                    sendWs(ws, {
+                        type: "session_event",
+                        payload: {
+                            sessionId: event.sessionId,
+                            eventType: eventTypeToString(event.type),
+                            timestamp: event.timestamp,
+                            content: event.content,
+                            raw: event.raw || undefined,
+                        },
+                    });
+                }
+            })();
+            break;
+        }
+        case "subscribe_all": {
+            // Cancel any existing global subscription
+            const existingGlobal = subscriptions.get("global");
+            if (existingGlobal) {
+                subscriptions.delete("global");
+                existingGlobal.cancel();
+            }
+            const stream = streamHub.createGlobalStream();
+            subscriptions.set("global", stream);
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            (async () => {
+                for await (const event of stream) {
+                    sendWs(ws, {
+                        type: "session_event",
+                        payload: {
+                            sessionId: event.sessionId,
+                            eventType: eventTypeToString(event.type),
+                            timestamp: event.timestamp,
+                            content: event.content,
+                            raw: event.raw || undefined,
+                        },
+                    });
+                }
+            })();
+            break;
+        }
+        default:
+            // ignore unknown messages
+            break;
+    }
+}
+function sendWs(ws, msg) {
+    if (ws.readyState === WebSocket.OPEN) {
+        ws.send(JSON.stringify(msg));
+    }
+}
+//# sourceMappingURL=ws-bridge.js.map

package/dist/ws-bridge.js.map

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

package/dist/ws-broadcast.d.ts

@@ -0,0 +1,19 @@
+import type { WebSocketServer } from "ws";
+import { envRegistry } from "@grackle-ai/database";
+/** Set the WebSocketServer instance used for broadcasting. Called once during server startup. */
+export declare function setWssInstance(wss: WebSocketServer): void;
+/** Broadcast a message to all connected WS clients. */
+export declare function broadcast(msg: {
+    type: string;
+    payload?: Record<string, unknown>;
+}): void;
+/** Map a database environment row to the WebSocket payload shape. */
+export declare function envRowToWs(r: ReturnType<typeof envRegistry.listEnvironments>[number]): Record<string, unknown>;
+/** Broadcast the current environment list to all connected WebSocket clients. */
+export declare function broadcastEnvironments(): void;
+/**
+ * Register a bus subscriber that forwards GrackleEvents to all WS clients.
+ * Idempotent — subsequent calls are no-ops.
+ */
+export declare function initWsSubscriber(): void;
+//# sourceMappingURL=ws-broadcast.d.ts.map

package/dist/ws-broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-broadcast.d.ts","sourceRoot":"","sources":["../src/ws-broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKnD,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAEzD;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAQxF;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CACxB,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,GACzD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAKD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAgBvC"}

package/dist/ws-broadcast.js

@@ -0,0 +1,60 @@
+import { envRegistry } from "@grackle-ai/database";
+import { subscribe } from "./event-bus.js";
+let wssInstance = undefined;
+/** Set the WebSocketServer instance used for broadcasting. Called once during server startup. */
+export function setWssInstance(wss) {
+    wssInstance = wss;
+}
+/** Broadcast a message to all connected WS clients. */
+export function broadcast(msg) {
+    if (!wssInstance)
+        return;
+    const data = JSON.stringify(msg);
+    for (const client of wssInstance.clients) {
+        if (client.readyState === 1 /* OPEN */) {
+            client.send(data);
+        }
+    }
+}
+/** Map a database environment row to the WebSocket payload shape. */
+export function envRowToWs(r) {
+    return {
+        id: r.id,
+        displayName: r.displayName,
+        adapterType: r.adapterType,
+        adapterConfig: r.adapterConfig,
+        status: r.status,
+        bootstrapped: r.bootstrapped,
+    };
+}
+/** Broadcast the current environment list to all connected WebSocket clients. */
+export function broadcastEnvironments() {
+    broadcast({
+        type: "environments",
+        payload: { environments: envRegistry.listEnvironments().map(envRowToWs) },
+    });
+}
+/** Guard to ensure initWsSubscriber is only called once. */
+let wsSubscriberInitialized = false;
+/**
+ * Register a bus subscriber that forwards GrackleEvents to all WS clients.
+ * Idempotent — subsequent calls are no-ops.
+ */
+export function initWsSubscriber() {
+    if (wsSubscriberInitialized) {
+        return;
+    }
+    wsSubscriberInitialized = true;
+    subscribe((event) => {
+        if (!wssInstance) {
+            return;
+        }
+        const data = JSON.stringify(event);
+        for (const client of wssInstance.clients) {
+            if (client.readyState === 1 /* OPEN */) {
+                client.send(data);
+            }
+        }
+    });
+}
+//# sourceMappingURL=ws-broadcast.js.map

package/dist/ws-broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-broadcast.js","sourceRoot":"","sources":["../src/ws-broadcast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAqB,MAAM,gBAAgB,CAAC;AAE9D,IAAI,WAAW,GAAgC,SAAS,CAAC;AAEzD,iGAAiG;AACjG,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,WAAW,GAAG,GAAG,CAAC;AACpB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,GAAwD;IAChF,IAAI,CAAC,WAAW;QAAE,OAAO;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjC,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CACxB,CAA0D;IAE1D,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,CAAC,CAAC,YAAY;KAC7B,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB;IACnC,SAAS,CAAC;QACR,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,gBAAgB,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;KAC1E,CAAC,CAAC;AACL,CAAC;AAED,4DAA4D;AAC5D,IAAI,uBAAuB,GAAY,KAAK,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,uBAAuB,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,uBAAuB,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,CAAC,KAAmB,EAAE,EAAE;QAChC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@grackle-ai/core",
+  "version": "0.75.4",
+  "description": "Core gRPC business logic for Grackle — RPC handlers, event system, streaming, session lifecycle",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "grackle",
+    "core",
+    "grpc",
+    "event-system",
+    "streaming"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.5.0",
+    "@connectrpc/connect": "^2.0.0",
+    "@connectrpc/connect-node": "^2.0.0",
+    "pino": "^10.3.1",
+    "ulid": "^2.3.0",
+    "uuid": "^11.0.0",
+    "ws": "^8.0.0",
+    "@grackle-ai/adapter-sdk": "0.75.4",
+    "@grackle-ai/common": "0.75.4",
+    "@grackle-ai/knowledge": "0.75.4",
+    "@grackle-ai/database": "0.75.4",
+    "@grackle-ai/auth": "0.75.4",
+    "@grackle-ai/prompt": "0.75.4"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.0.0",
+    "vitest": "^3.1.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}