@grackle-ai/server 0.67.0 → 0.68.0

package/dist/adapter-manager.d.ts

@@ -11,8 +11,12 @@ export declare function getConnection(environmentId: string): PowerLineConnectio
 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. */
-export declare function startHeartbeat(onDisconnect: (environmentId: string) => void): void;
+/**
+ * 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

@@ -1 +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,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CA6BlF;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}
+{"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

@@ -28,8 +28,12 @@ export function removeConnection(environmentId) {
 export function listConnections() {
     return connections;
 }
-/** Start a periodic health-check loop that calls `onDisconnect` when a PowerLine becomes unreachable. */
-export function startHeartbeat(onDisconnect) {
+/**
+ * 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;
     }
@@ -56,6 +60,15 @@ export function startHeartbeat(onDisconnect) {
                 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. */

package/dist/adapter-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-manager.js","sourceRoot":"","sources":["../src/adapter-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,qBAAqB,GAAW,MAAM,CAAC;AAE7C,MAAM,QAAQ,GAAoC,IAAI,GAAG,EAA8B,CAAC;AACxF,MAAM,WAAW,GAAqC,IAAI,GAAG,EAA+B,CAAC;AAC7F,IAAI,iBAAiB,GAA+C,SAAS,CAAC;AAE9E,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAA2B;IACzD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,aAAqB,EAAE,IAAyB;IAC5E,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,OAAO,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACxC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,aAAqB;IACpD,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe;IAC7B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,cAAc,CAAC,YAA6C;IAC1E,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,kEAAkE;IAClE,iBAAiB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACzC,KAAK,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,EAAE,qBAAqB,CAAC,CAAC;oBACtD,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,EAAE,iBAAiB,CAAC,CAAC;gBAClD,YAAY,CAAC,aAAa,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAC5B,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,aAAa;IAC3B,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,aAAa,CAAC,iBAAiB,CAAC,CAAC;QACjC,iBAAiB,GAAG,SAAS,CAAC;IAChC,CAAC;AACH,CAAC"}
+{"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,16 @@
+/**
+ * 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;
+/** @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":"AAwCA;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4CvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAK/D;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/auto-reconnect.js

@@ -0,0 +1,154 @@
+import { reconnectOrProvision } from "@grackle-ai/adapter-sdk";
+import * as envRegistry from "./env-registry.js";
+import * as adapterManager from "./adapter-manager.js";
+import * as tokenBroker from "./token-broker.js";
+import { recoverSuspendedSessions } from "./session-recovery.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.
+}
+/** @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 = JSON.parse(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 tokenBroker.pushToEnv(environmentId, { excludeFileTokens: true });
+        }
+        else {
+            await tokenBroker.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/grpc-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grpc-service.d.ts","sourceRoot":"","sources":["../src/grpc-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA+E7E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYvD;AAqLD,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,UAAU,EAAE;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,EAAE,GACF,MAAM,CAUR;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAczE;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA46CjE"}
+{"version":3,"file":"grpc-service.d.ts","sourceRoot":"","sources":["../src/grpc-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA+F7E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYvD;AAqLD,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,UAAU,EAAE;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,EAAE,GACF,MAAM,CAUR;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAczE;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAghDjE"}

package/dist/grpc-service.js

@@ -16,6 +16,7 @@ import { emit } from "./event-bus.js";
 import { processEventStream } from "./event-processor.js";
 import * as processorRegistry from "./processor-registry.js";
 import { recoverSuspendedSessions } from "./session-recovery.js";
+import { clearReconnectState } from "./auto-reconnect.js";
 import { join } from "node:path";
 import { LOGS_DIR, DEFAULT_WEB_PORT, DEFAULT_MCP_PORT, MAX_TASK_DEPTH, SESSION_STATUS, TERMINAL_SESSION_STATUSES, TASK_STATUS, ROOT_TASK_ID, taskStatusToEnum, taskStatusToString, workspaceStatusToEnum, claudeProviderModeToEnum, providerToggleToEnum, } from "@grackle-ai/common";
 import { resolvePersona } from "./resolve-persona.js";
@@ -29,6 +30,8 @@ import { computeTaskStatus } from "./compute-task-status.js";
 import { loadOrCreateApiKey } from "./api-key.js";
 import { logger } from "./logger.js";
 import { reanimateAgent } from "./reanimate-agent.js";
+import { getKnowledgeEmbedder, isKnowledgeEnabled } from "./knowledge-init.js";
+import { knowledgeSearch, getNode as getKnowledgeNodeById, expandNode, createNativeNode, ingest, createPassThroughChunker, listRecentNodes, } from "@grackle-ai/knowledge";
 import { slugify } from "./utils/slugify.js";
 import { SystemPromptBuilder, buildTaskPrompt } from "./system-prompt-builder.js";
 import { importGitHubIssues as executeGitHubImport } from "./github-import.js";
@@ -269,6 +272,8 @@ export function registerGrackleRoutes(router) {
             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) {
@@ -291,6 +296,8 @@ export function registerGrackleRoutes(router) {
             return create(grackle.EmptySchema, {});
         },
         async *provisionEnvironment(req) {
+            // Manual provision overrides auto-reconnect
+            clearReconnectState(req.id);
             const env = envRegistry.getEnvironment(req.id);
             if (!env) {
                 yield create(grackle.ProvisionEventSchema, {
@@ -1360,6 +1367,110 @@ export function registerGrackleRoutes(router) {
             const url = `http://${pairingHost}:${webPort}/pair?code=${code}`;
             return create(grackle.PairingCodeResponseSchema, { code, url });
         },
+        // ── Knowledge Graph ────────────────────────────────────────
+        async searchKnowledge(req) {
+            const embedder = getKnowledgeEmbedder();
+            if (!embedder) {
+                throw new ConnectError("Knowledge graph not available", Code.Unavailable);
+            }
+            const results = await knowledgeSearch(req.query, embedder, {
+                limit: req.limit || 10,
+                workspaceId: req.workspaceId || undefined,
+            });
+            return create(grackle.SearchKnowledgeResponseSchema, {
+                results: results.map((r) => create(grackle.SearchKnowledgeResultSchema, {
+                    score: r.score,
+                    node: knowledgeNodeToProto(r.node),
+                    edges: r.edges.map(knowledgeEdgeToProto),
+                })),
+            });
+        },
+        async getKnowledgeNode(req) {
+            if (!isKnowledgeEnabled()) {
+                throw new ConnectError("Knowledge graph not available", Code.Unavailable);
+            }
+            const result = await getKnowledgeNodeById(req.id);
+            if (!result) {
+                throw new ConnectError(`Knowledge node not found: ${req.id}`, Code.NotFound);
+            }
+            return create(grackle.GetKnowledgeNodeResponseSchema, {
+                node: knowledgeNodeToProto(result.node),
+                edges: result.edges.map(knowledgeEdgeToProto),
+            });
+        },
+        async expandKnowledgeNode(req) {
+            if (!isKnowledgeEnabled()) {
+                throw new ConnectError("Knowledge graph not available", Code.Unavailable);
+            }
+            const result = await expandNode(req.id, {
+                depth: req.depth || 1,
+                edgeTypes: req.edgeTypes.length > 0 ? req.edgeTypes : undefined,
+            });
+            return create(grackle.ExpandKnowledgeNodeResponseSchema, {
+                nodes: result.nodes.map(knowledgeNodeToProto),
+                edges: result.edges.map(knowledgeEdgeToProto),
+            });
+        },
+        async listRecentKnowledgeNodes(req) {
+            if (!isKnowledgeEnabled()) {
+                throw new ConnectError("Knowledge graph not available", Code.Unavailable);
+            }
+            const result = await listRecentNodes(req.limit || 20, req.workspaceId || undefined);
+            return create(grackle.ListRecentKnowledgeNodesResponseSchema, {
+                nodes: result.nodes.map(knowledgeNodeToProto),
+                edges: result.edges.map(knowledgeEdgeToProto),
+            });
+        },
+        async createKnowledgeNode(req) {
+            const embedder = getKnowledgeEmbedder();
+            if (!embedder) {
+                throw new ConnectError("Knowledge graph not available", Code.Unavailable);
+            }
+            const chunker = createPassThroughChunker();
+            const embedded = await ingest(req.content, chunker, embedder);
+            if (embedded.length === 0) {
+                throw new ConnectError("Content produced no embeddings", Code.InvalidArgument);
+            }
+            const id = await createNativeNode({
+                category: (req.category || "insight"),
+                title: req.title,
+                content: req.content,
+                tags: [...req.tags],
+                embedding: embedded[0].vector,
+                workspaceId: req.workspaceId || "",
+            });
+            return create(grackle.CreateKnowledgeNodeResponseSchema, { id });
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Knowledge graph proto converters
+// ---------------------------------------------------------------------------
+/** Convert a KnowledgeNode to its proto representation. */
+function knowledgeNodeToProto(node) {
+    return create(grackle.KnowledgeNodeProtoSchema, {
+        id: node.id,
+        kind: node.kind,
+        workspaceId: node.workspaceId,
+        createdAt: node.createdAt,
+        updatedAt: node.updatedAt,
+        sourceType: node.kind === "reference" ? node.sourceType : "",
+        sourceId: node.kind === "reference" ? node.sourceId : "",
+        label: node.kind === "reference" ? node.label : "",
+        category: node.kind === "native" ? node.category : "",
+        title: node.kind === "native" ? node.title : "",
+        content: node.kind === "native" ? node.content : "",
+        tags: node.kind === "native" ? node.tags : [],
+    });
+}
+/** Convert a KnowledgeEdge to its proto representation. */
+function knowledgeEdgeToProto(edge) {
+    return create(grackle.KnowledgeEdgeProtoSchema, {
+        fromId: edge.fromId,
+        toId: edge.toId,
+        type: edge.type,
+        metadataJson: edge.metadata ? JSON.stringify(edge.metadata) : "",
+        createdAt: edge.createdAt,
     });
 }
 //# sourceMappingURL=grpc-service.js.map