@dbx-tools/appkit-graphiti 0.6.113

package/README.md

@@ -0,0 +1,77 @@
+# `@dbx-tools/appkit-graphiti`
+
+AppKit process plugin for the Python `dbx-tools-graphiti` MCP runtime.
+
+## Key features
+
+- starts Graphiti as a supervised AppKit sidecar;
+- inherits the Lakebase environment resolved by `@dbx-tools/appkit` and native
+  `lakebase()`, enabling the Python Postgres write journal automatically;
+- starts mise-managed Caddy on `DATABRICKS_APP_PORT`;
+- routes `/graphiti/*` to Graphiti and all other traffic to AppKit;
+- selects a free loopback port for Graphiti unless one is explicitly configured;
+- discovers the upstream MCP tools and exposes them through
+  `plugins.graphiti?.toolkit()` for Mastra and AppKit agents;
+- binds both child processes to the shared concurrently-style supervisor so
+  signals propagate and any child exit tears down the app;
+- exposes the internal AppKit port and public MCP path through plugin exports.
+
+## Why use this over native AppKit
+
+AppKit has no Graphiti or embedded MCP sidecar. This package owns AppKit process
+lifecycle and single-port routing while `dbx-tools-graphiti` owns
+Graphiti, Neo4j, LiteLLM, and Postgres recovery.
+
+## Register
+
+Install `dbx-tools-graphiti` in the app's Python dependencies, then register
+native `lakebase()` before the Graphiti plugin:
+
+```ts
+import { lakebase, server } from "@databricks/appkit";
+import { appkit } from "@dbx-tools/appkit";
+import { config as graphitiConfig, plugin as graphitiPlugin } from "@dbx-tools/appkit-graphiti";
+
+const graphiti = graphitiConfig.resolveGraphitiConfig();
+
+await appkit.createApp({
+  plugins: [
+    server({ host: "127.0.0.1", port: graphiti.appPort }),
+    lakebase(),
+    graphitiPlugin.graphiti(graphiti),
+  ],
+});
+```
+
+The public MCP endpoint is `/graphiti/mcp/`. Caddy listens on the platform's
+`DATABRICKS_APP_PORT`; AppKit and Graphiti remain loopback-only.
+
+Add the MCP tools to a Mastra agent with:
+
+```ts
+tools(plugins) {
+  return { ...plugins.graphiti?.toolkit() };
+}
+```
+
+## Configuration
+
+Plugin config overrides environment values:
+
+- `publicPort` / `DATABRICKS_APP_PORT`: Caddy's public port, default `8000`;
+- `appPort` / `GRAPHITI_APP_PORT`: AppKit's internal port, default public + 1;
+- `graphitiPort` / `GRAPHITI_PORT`: Graphiti's internal port; a free loopback
+  port is selected automatically when omitted;
+- `routePrefix` / `GRAPHITI_ROUTE_PREFIX`: public Graphiti prefix, default
+  `/graphiti`;
+- `python` / `PYTHON`: Python executable, default `python3`;
+- `journalNamespace` / `JOURNAL_NAMESPACE`: Postgres journal namespace, default
+  `DATABRICKS_APP_NAME` then `default`.
+
+The app must package both Node and Python dependencies. Databricks Apps supports
+this directly with `package.json` plus `requirements.txt`.
+
+## Modules
+
+- `config` resolves ports, process command, route prefix, and journal namespace;
+- `plugin` starts and supervises Graphiti and Caddy.

package/index.ts

@@ -0,0 +1,10 @@
+// GENERATED by projen watch - DO NOT EDIT.
+// Regenerated from the exporting modules in ./src.
+// Hand edits are overwritten on the next watch; this file is read-only.
+
+export const PACKAGE_IDENTIFIER = "@dbx-tools/appkit-graphiti";
+export * as config from "./src/config.ts";
+export * as plugin from "./src/plugin.ts";
+export { GRAPHITI_CONFIG_SCHEMA } from "./src/config.ts";
+export type { GraphitiPluginConfig, ResolvedGraphitiPluginConfig } from "./src/config.ts";
+export { GraphitiPlugin, graphiti } from "./src/plugin.ts";

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export declare const PACKAGE_IDENTIFIER = "@dbx-tools/appkit-graphiti";
+export * as config from "./src/config.ts";
+export * as plugin from "./src/plugin.ts";
+export { GRAPHITI_CONFIG_SCHEMA } from "./src/config.ts";
+export type { GraphitiPluginConfig, ResolvedGraphitiPluginConfig } from "./src/config.ts";
+export { GraphitiPlugin, graphiti } from "./src/plugin.ts";

package/lib/index.js

@@ -0,0 +1,9 @@
+// GENERATED by projen watch - DO NOT EDIT.
+// Regenerated from the exporting modules in ./src.
+// Hand edits are overwritten on the next watch; this file is read-only.
+export const PACKAGE_IDENTIFIER = "@dbx-tools/appkit-graphiti";
+export * as config from "./src/config.js";
+export * as plugin from "./src/plugin.js";
+export { GRAPHITI_CONFIG_SCHEMA } from "./src/config.js";
+export { GraphitiPlugin, graphiti } from "./src/plugin.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyw0QkFBNEIsQ0FBQztBQUMvRCxPQUFPLEtBQUssTUFBTSxNQUFNLGlCQUFpQixDQUFDO0FBQzFDLE9BQU8sS0FBSyxNQUFNLE1BQU0saUJBQWlCLENBQUM7QUFDMUMsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFekQsT0FBTyxFQUFFLGNBQWMsRUFBRSxRQUFRLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEdFTkVSQVRFRCBieSBwcm9qZW4gd2F0Y2ggLSBETyBOT1QgRURJVC5cbi8vIFJlZ2VuZXJhdGVkIGZyb20gdGhlIGV4cG9ydGluZyBtb2R1bGVzIGluIC4vc3JjLlxuLy8gSGFuZCBlZGl0cyBhcmUgb3ZlcndyaXR0ZW4gb24gdGhlIG5leHQgd2F0Y2g7IHRoaXMgZmlsZSBpcyByZWFkLW9ubHkuXG5cbmV4cG9ydCBjb25zdCBQQUNLQUdFX0lERU5USUZJRVIgPSBcIkBkYngtdG9vbHMvYXBwa2l0LWdyYXBoaXRpXCI7XG5leHBvcnQgKiBhcyBjb25maWcgZnJvbSBcIi4vc3JjL2NvbmZpZy50c1wiO1xuZXhwb3J0ICogYXMgcGx1Z2luIGZyb20gXCIuL3NyYy9wbHVnaW4udHNcIjtcbmV4cG9ydCB7IEdSQVBISVRJX0NPTkZJR19TQ0hFTUEgfSBmcm9tIFwiLi9zcmMvY29uZmlnLnRzXCI7XG5leHBvcnQgdHlwZSB7IEdyYXBoaXRpUGx1Z2luQ29uZmlnLCBSZXNvbHZlZEdyYXBoaXRpUGx1Z2luQ29uZmlnIH0gZnJvbSBcIi4vc3JjL2NvbmZpZy50c1wiO1xuZXhwb3J0IHsgR3JhcGhpdGlQbHVnaW4sIGdyYXBoaXRpIH0gZnJvbSBcIi4vc3JjL3BsdWdpbi50c1wiO1xuIl19

package/lib/src/config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * AppKit Graphiti sidecar ports, route prefix, and Python command.
+ *
+ * @module
+ */
+import { type BasePluginConfig } from "@databricks/appkit";
+export interface GraphitiPluginConfig extends BasePluginConfig {
+    publicPort?: number;
+    appPort?: number;
+    graphitiPort?: number;
+    routePrefix?: string;
+    python?: string;
+    journalNamespace?: string;
+}
+export interface ResolvedGraphitiPluginConfig extends GraphitiPluginConfig {
+    publicPort: number;
+    appPort: number;
+    graphitiPort: number;
+    routePrefix: string;
+    python: string;
+    journalNamespace: string;
+}
+export declare const GRAPHITI_CONFIG_SCHEMA: {
+    type: "object";
+    properties: {
+        publicPort: {
+            type: "integer";
+            minimum: number;
+            maximum: number;
+        };
+        appPort: {
+            type: "integer";
+            minimum: number;
+            maximum: number;
+        };
+        graphitiPort: {
+            type: "integer";
+            minimum: number;
+            maximum: number;
+        };
+        routePrefix: {
+            type: "string";
+        };
+        python: {
+            type: "string";
+        };
+        journalNamespace: {
+            type: "string";
+        };
+    };
+    additionalProperties: false;
+};
+/** Resolve plugin config over exact environment values and stable defaults. */
+export declare function resolveGraphitiConfig(config?: GraphitiPluginConfig): ResolvedGraphitiPluginConfig;
+/** Return the internal port an AppKit `server()` plugin should bind. */
+export declare function appPort(config?: GraphitiPluginConfig): number;

package/lib/src/config.js

@@ -0,0 +1,56 @@
+/**
+ * AppKit Graphiti sidecar ports, route prefix, and Python command.
+ *
+ * @module
+ */
+import { ConfigurationError } from "@databricks/appkit";
+import { config as coreConfig } from "@dbx-tools/core";
+export const GRAPHITI_CONFIG_SCHEMA = {
+    type: "object",
+    properties: {
+        publicPort: { type: "integer", minimum: 1, maximum: 65535 },
+        appPort: { type: "integer", minimum: 1, maximum: 65535 },
+        graphitiPort: { type: "integer", minimum: 1, maximum: 65535 },
+        routePrefix: { type: "string" },
+        python: { type: "string" },
+        journalNamespace: { type: "string" },
+    },
+    additionalProperties: false,
+};
+/** Resolve plugin config over exact environment values and stable defaults. */
+export function resolveGraphitiConfig(config = {}) {
+    const publicPort = coreConfig.port(config.publicPort, "DATABRICKS_APP_PORT", 8000, coreConfig.ENV_ONLY);
+    const appPort = coreConfig.port(config.appPort, "GRAPHITI_APP_PORT", publicPort + 1, coreConfig.ENV_ONLY);
+    const graphitiPort = coreConfig.port(config.graphitiPort, "GRAPHITI_PORT", 0, coreConfig.ENV_ONLY);
+    if (new Set([publicPort, appPort, graphitiPort]).size !== 3) {
+        throw new ConfigurationError("Graphiti public, AppKit, and sidecar ports must be distinct");
+    }
+    const routePrefix = normalizeRoutePrefix(config.routePrefix ??
+        coreConfig.text("GRAPHITI_ROUTE_PREFIX", coreConfig.ENV_ONLY) ??
+        "/graphiti");
+    const python = config.python ?? coreConfig.text("PYTHON", coreConfig.ENV_ONLY)?.trim() ?? "python3";
+    const journalNamespace = config.journalNamespace ??
+        coreConfig.text("JOURNAL_NAMESPACE", coreConfig.ENV_ONLY)?.trim() ??
+        process.env.DATABRICKS_APP_NAME?.trim() ??
+        "default";
+    return {
+        publicPort,
+        appPort,
+        graphitiPort,
+        routePrefix,
+        python,
+        journalNamespace,
+    };
+}
+/** Return the internal port an AppKit `server()` plugin should bind. */
+export function appPort(config = {}) {
+    return resolveGraphitiConfig(config).appPort;
+}
+function normalizeRoutePrefix(value) {
+    const normalized = `/${value.trim().replace(/^\/+|\/+$/g, "")}`;
+    if (normalized === "/") {
+        throw new ConfigurationError("Graphiti routePrefix must contain a path segment");
+    }
+    return normalized;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsT0FBTyxFQUFFLGtCQUFrQixFQUF5QixNQUFNLG9CQUFvQixDQUFDO0FBQy9FLE9BQU8sRUFBRSxNQUFNLElBQUksVUFBVSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFxQnZELE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHO0lBQ3BDLElBQUksRUFBRSxRQUFRO0lBQ2QsVUFBVSxFQUFFO1FBQ1YsVUFBVSxFQUFFLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUU7UUFDM0QsT0FBTyxFQUFFLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUU7UUFDeEQsWUFBWSxFQUFFLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUU7UUFDN0QsV0FBVyxFQUFFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRTtRQUMvQixNQUFNLEVBQUUsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFO1FBQzFCLGdCQUFnQixFQUFFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRTtLQUNyQztJQUNELG9CQUFvQixFQUFFLEtBQUs7Q0FDTixDQUFDO0FBRXhCLCtFQUErRTtBQUMvRSxNQUFNLFVBQVUscUJBQXFCLENBQ25DLFNBQStCLEVBQUU7SUFFakMsTUFBTSxVQUFVLEdBQUcsVUFBVSxDQUFDLElBQUksQ0FDaEMsTUFBTSxDQUFDLFVBQVUsRUFDakIscUJBQXFCLEVBQ3JCLElBQUksRUFDSixVQUFVLENBQUMsUUFBUSxDQUNwQixDQUFDO0lBQ0YsTUFBTSxPQUFPLEdBQUcsVUFBVSxDQUFDLElBQUksQ0FDN0IsTUFBTSxDQUFDLE9BQU8sRUFDZCxtQkFBbUIsRUFDbkIsVUFBVSxHQUFHLENBQUMsRUFDZCxVQUFVLENBQUMsUUFBUSxDQUNwQixDQUFDO0lBQ0YsTUFBTSxZQUFZLEdBQUcsVUFBVSxDQUFDLElBQUksQ0FDbEMsTUFBTSxDQUFDLFlBQVksRUFDbkIsZUFBZSxFQUNmLENBQUMsRUFDRCxVQUFVLENBQUMsUUFBUSxDQUNwQixDQUFDO0lBQ0YsSUFBSSxJQUFJLEdBQUcsQ0FBQyxDQUFDLFVBQVUsRUFBRSxPQUFPLEVBQUUsWUFBWSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDNUQsTUFBTSxJQUFJLGtCQUFrQixDQUFDLDZEQUE2RCxDQUFDLENBQUM7SUFDOUYsQ0FBQztJQUNELE1BQU0sV0FBVyxHQUFHLG9CQUFvQixDQUN0QyxNQUFNLENBQUMsV0FBVztRQUNoQixVQUFVLENBQUMsSUFBSSxDQUFDLHVCQUF1QixFQUFFLFVBQVUsQ0FBQyxRQUFRLENBQUM7UUFDN0QsV0FBVyxDQUNkLENBQUM7SUFDRixNQUFNLE1BQU0sR0FDVixNQUFNLENBQUMsTUFBTSxJQUFJLFVBQVUsQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxJQUFJLEVBQUUsSUFBSSxTQUFTLENBQUM7SUFDdkYsTUFBTSxnQkFBZ0IsR0FDcEIsTUFBTSxDQUFDLGdCQUFnQjtRQUN2QixVQUFVLENBQUMsSUFBSSxDQUFDLG1CQUFtQixFQUFFLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxJQUFJLEVBQUU7UUFDakUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxtQkFBbUIsRUFBRSxJQUFJLEVBQUU7UUFDdkMsU0FBUyxDQUFDO0lBQ1osT0FBTztRQUNMLFVBQVU7UUFDVixPQUFPO1FBQ1AsWUFBWTtRQUNaLFdBQVc7UUFDWCxNQUFNO1FBQ04sZ0JBQWdCO0tBQ2pCLENBQUM7QUFDSixDQUFDO0FBRUQsd0VBQXdFO0FBQ3hFLE1BQU0sVUFBVSxPQUFPLENBQUMsU0FBK0IsRUFBRTtJQUN2RCxPQUFPLHFCQUFxQixDQUFDLE1BQU0sQ0FBQyxDQUFDLE9BQU8sQ0FBQztBQUMvQyxDQUFDO0FBRUQsU0FBUyxvQkFBb0IsQ0FBQyxLQUFhO0lBQ3pDLE1BQU0sVUFBVSxHQUFHLElBQUksS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDLE9BQU8sQ0FBQyxZQUFZLEVBQUUsRUFBRSxDQUFDLEVBQUUsQ0FBQztJQUNoRSxJQUFJLFVBQVUsS0FBSyxHQUFHLEVBQUUsQ0FBQztRQUN2QixNQUFNLElBQUksa0JBQWtCLENBQUMsa0RBQWtELENBQUMsQ0FBQztJQUNuRixDQUFDO0lBQ0QsT0FBTyxVQUFVLENBQUM7QUFDcEIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQXBwS2l0IEdyYXBoaXRpIHNpZGVjYXIgcG9ydHMsIHJvdXRlIHByZWZpeCwgYW5kIFB5dGhvbiBjb21tYW5kLlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuaW1wb3J0IHsgQ29uZmlndXJhdGlvbkVycm9yLCB0eXBlIEJhc2VQbHVnaW5Db25maWcgfSBmcm9tIFwiQGRhdGFicmlja3MvYXBwa2l0XCI7XG5pbXBvcnQgeyBjb25maWcgYXMgY29yZUNvbmZpZyB9IGZyb20gXCJAZGJ4LXRvb2xzL2NvcmVcIjtcbmltcG9ydCB0eXBlIHsgSlNPTlNjaGVtYTcgfSBmcm9tIFwianNvbi1zY2hlbWFcIjtcblxuZXhwb3J0IGludGVyZmFjZSBHcmFwaGl0aVBsdWdpbkNvbmZpZyBleHRlbmRzIEJhc2VQbHVnaW5Db25maWcge1xuICBwdWJsaWNQb3J0PzogbnVtYmVyO1xuICBhcHBQb3J0PzogbnVtYmVyO1xuICBncmFwaGl0aVBvcnQ/OiBudW1iZXI7XG4gIHJvdXRlUHJlZml4Pzogc3RyaW5nO1xuICBweXRob24/OiBzdHJpbmc7XG4gIGpvdXJuYWxOYW1lc3BhY2U/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgUmVzb2x2ZWRHcmFwaGl0aVBsdWdpbkNvbmZpZyBleHRlbmRzIEdyYXBoaXRpUGx1Z2luQ29uZmlnIHtcbiAgcHVibGljUG9ydDogbnVtYmVyO1xuICBhcHBQb3J0OiBudW1iZXI7XG4gIGdyYXBoaXRpUG9ydDogbnVtYmVyO1xuICByb3V0ZVByZWZpeDogc3RyaW5nO1xuICBweXRob246IHN0cmluZztcbiAgam91cm5hbE5hbWVzcGFjZTogc3RyaW5nO1xufVxuXG5leHBvcnQgY29uc3QgR1JBUEhJVElfQ09ORklHX1NDSEVNQSA9IHtcbiAgdHlwZTogXCJvYmplY3RcIixcbiAgcHJvcGVydGllczoge1xuICAgIHB1YmxpY1BvcnQ6IHsgdHlwZTogXCJpbnRlZ2VyXCIsIG1pbmltdW06IDEsIG1heGltdW06IDY1NTM1IH0sXG4gICAgYXBwUG9ydDogeyB0eXBlOiBcImludGVnZXJcIiwgbWluaW11bTogMSwgbWF4aW11bTogNjU1MzUgfSxcbiAgICBncmFwaGl0aVBvcnQ6IHsgdHlwZTogXCJpbnRlZ2VyXCIsIG1pbmltdW06IDEsIG1heGltdW06IDY1NTM1IH0sXG4gICAgcm91dGVQcmVmaXg6IHsgdHlwZTogXCJzdHJpbmdcIiB9LFxuICAgIHB5dGhvbjogeyB0eXBlOiBcInN0cmluZ1wiIH0sXG4gICAgam91cm5hbE5hbWVzcGFjZTogeyB0eXBlOiBcInN0cmluZ1wiIH0sXG4gIH0sXG4gIGFkZGl0aW9uYWxQcm9wZXJ0aWVzOiBmYWxzZSxcbn0gc2F0aXNmaWVzIEpTT05TY2hlbWE3O1xuXG4vKiogUmVzb2x2ZSBwbHVnaW4gY29uZmlnIG92ZXIgZXhhY3QgZW52aXJvbm1lbnQgdmFsdWVzIGFuZCBzdGFibGUgZGVmYXVsdHMuICovXG5leHBvcnQgZnVuY3Rpb24gcmVzb2x2ZUdyYXBoaXRpQ29uZmlnKFxuICBjb25maWc6IEdyYXBoaXRpUGx1Z2luQ29uZmlnID0ge30sXG4pOiBSZXNvbHZlZEdyYXBoaXRpUGx1Z2luQ29uZmlnIHtcbiAgY29uc3QgcHVibGljUG9ydCA9IGNvcmVDb25maWcucG9ydChcbiAgICBjb25maWcucHVibGljUG9ydCxcbiAgICBcIkRBVEFCUklDS1NfQVBQX1BPUlRcIixcbiAgICA4MDAwLFxuICAgIGNvcmVDb25maWcuRU5WX09OTFksXG4gICk7XG4gIGNvbnN0IGFwcFBvcnQgPSBjb3JlQ29uZmlnLnBvcnQoXG4gICAgY29uZmlnLmFwcFBvcnQsXG4gICAgXCJHUkFQSElUSV9BUFBfUE9SVFwiLFxuICAgIHB1YmxpY1BvcnQgKyAxLFxuICAgIGNvcmVDb25maWcuRU5WX09OTFksXG4gICk7XG4gIGNvbnN0IGdyYXBoaXRpUG9ydCA9IGNvcmVDb25maWcucG9ydChcbiAgICBjb25maWcuZ3JhcGhpdGlQb3J0LFxuICAgIFwiR1JBUEhJVElfUE9SVFwiLFxuICAgIDAsXG4gICAgY29yZUNvbmZpZy5FTlZfT05MWSxcbiAgKTtcbiAgaWYgKG5ldyBTZXQoW3B1YmxpY1BvcnQsIGFwcFBvcnQsIGdyYXBoaXRpUG9ydF0pLnNpemUgIT09IDMpIHtcbiAgICB0aHJvdyBuZXcgQ29uZmlndXJhdGlvbkVycm9yKFwiR3JhcGhpdGkgcHVibGljLCBBcHBLaXQsIGFuZCBzaWRlY2FyIHBvcnRzIG11c3QgYmUgZGlzdGluY3RcIik7XG4gIH1cbiAgY29uc3Qgcm91dGVQcmVmaXggPSBub3JtYWxpemVSb3V0ZVByZWZpeChcbiAgICBjb25maWcucm91dGVQcmVmaXggPz9cbiAgICAgIGNvcmVDb25maWcudGV4dChcIkdSQVBISVRJX1JPVVRFX1BSRUZJWFwiLCBjb3JlQ29uZmlnLkVOVl9PTkxZKSA/P1xuICAgICAgXCIvZ3JhcGhpdGlcIixcbiAgKTtcbiAgY29uc3QgcHl0aG9uID1cbiAgICBjb25maWcucHl0aG9uID8/IGNvcmVDb25maWcudGV4dChcIlBZVEhPTlwiLCBjb3JlQ29uZmlnLkVOVl9PTkxZKT8udHJpbSgpID8/IFwicHl0aG9uM1wiO1xuICBjb25zdCBqb3VybmFsTmFtZXNwYWNlID1cbiAgICBjb25maWcuam91cm5hbE5hbWVzcGFjZSA/P1xuICAgIGNvcmVDb25maWcudGV4dChcIkpPVVJOQUxfTkFNRVNQQUNFXCIsIGNvcmVDb25maWcuRU5WX09OTFkpPy50cmltKCkgPz9cbiAgICBwcm9jZXNzLmVudi5EQVRBQlJJQ0tTX0FQUF9OQU1FPy50cmltKCkgPz9cbiAgICBcImRlZmF1bHRcIjtcbiAgcmV0dXJuIHtcbiAgICBwdWJsaWNQb3J0LFxuICAgIGFwcFBvcnQsXG4gICAgZ3JhcGhpdGlQb3J0LFxuICAgIHJvdXRlUHJlZml4LFxuICAgIHB5dGhvbixcbiAgICBqb3VybmFsTmFtZXNwYWNlLFxuICB9O1xufVxuXG4vKiogUmV0dXJuIHRoZSBpbnRlcm5hbCBwb3J0IGFuIEFwcEtpdCBgc2VydmVyKClgIHBsdWdpbiBzaG91bGQgYmluZC4gKi9cbmV4cG9ydCBmdW5jdGlvbiBhcHBQb3J0KGNvbmZpZzogR3JhcGhpdGlQbHVnaW5Db25maWcgPSB7fSk6IG51bWJlciB7XG4gIHJldHVybiByZXNvbHZlR3JhcGhpdGlDb25maWcoY29uZmlnKS5hcHBQb3J0O1xufVxuXG5mdW5jdGlvbiBub3JtYWxpemVSb3V0ZVByZWZpeCh2YWx1ZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3Qgbm9ybWFsaXplZCA9IGAvJHt2YWx1ZS50cmltKCkucmVwbGFjZSgvXlxcLyt8XFwvKyQvZywgXCJcIil9YDtcbiAgaWYgKG5vcm1hbGl6ZWQgPT09IFwiL1wiKSB7XG4gICAgdGhyb3cgbmV3IENvbmZpZ3VyYXRpb25FcnJvcihcIkdyYXBoaXRpIHJvdXRlUHJlZml4IG11c3QgY29udGFpbiBhIHBhdGggc2VnbWVudFwiKTtcbiAgfVxuICByZXR1cm4gbm9ybWFsaXplZDtcbn1cbiJdfQ==

package/lib/src/plugin.d.ts

@@ -0,0 +1,35 @@
+import { Plugin, type PluginManifest, type ResourceRequirement } from "@databricks/appkit";
+import { type GraphitiPluginConfig } from "./config.ts";
+interface ToolkitEntry {
+    pluginName: string;
+    localName: string;
+    def: {
+        name: string;
+        description: string;
+        parameters: unknown;
+    };
+}
+export declare class GraphitiPlugin extends Plugin<GraphitiPluginConfig> {
+    static manifest: PluginManifest<"graphiti">;
+    static getResourceRequirements(): ResourceRequirement[];
+    private readonly logger;
+    private children;
+    private mcp?;
+    private mcpTools;
+    private resolved?;
+    private stopping;
+    setup(): Promise<void>;
+    abortActiveOperations(): void;
+    exports(): {
+        appPort: number;
+        graphitiPort: number;
+        mcpPath: string;
+        publicPort: number;
+        routePrefix: string;
+    };
+    toolkit(): Record<string, ToolkitEntry>;
+    executeAgentTool(name: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
+    private stopGraphiti;
+}
+export declare const graphiti: import("@databricks/appkit").ToPlugin<typeof GraphitiPlugin, GraphitiPluginConfig, "graphiti">;
+export {};

package/lib/src/plugin.js

@@ -0,0 +1,194 @@
+/**
+ * AppKit plugin that supervises Graphiti and a Caddy single-port proxy.
+ *
+ * @module
+ */
+import { createServer } from "node:net";
+import { Plugin, lakebase, toPlugin, } from "@databricks/appkit";
+import { interceptor as appkitInterceptor, plugin as appkitPlugin } from "@dbx-tools/appkit";
+import { exec } from "@dbx-tools/core";
+import { async as asyncModule, log } from "@dbx-tools/shared-core";
+import { MCPClient } from "@mastra/mcp";
+import { GRAPHITI_CONFIG_SCHEMA, resolveGraphitiConfig, } from "./config.js";
+const LAKEBASE_MANIFEST = appkitPlugin.data(lakebase).plugin.manifest;
+export class GraphitiPlugin extends Plugin {
+    static manifest = {
+        name: "graphiti",
+        displayName: "Graphiti",
+        description: "Runs the dbx-tools Graphiti MCP sidecar with Lakebase-backed recovery and " +
+            "publishes it through the App's single port with Caddy.",
+        stability: "beta",
+        resources: {
+            required: [],
+            optional: [...LAKEBASE_MANIFEST.resources.required],
+        },
+        config: { schema: GRAPHITI_CONFIG_SCHEMA },
+    };
+    static getResourceRequirements() {
+        return LAKEBASE_MANIFEST.resources.required.map((resource) => ({
+            ...resource,
+            required: true,
+        }));
+    }
+    logger = log.logger(this);
+    children = [];
+    mcp;
+    mcpTools = {};
+    resolved;
+    stopping = false;
+    async setup() {
+        const configured = resolveGraphitiConfig(this.config);
+        this.resolved = {
+            ...configured,
+            graphitiPort: configured.graphitiPort || (await availablePort()),
+        };
+        if (!process.env.LAKEBASE_ENDPOINT && !process.env.PGHOST) {
+            throw new Error("Graphiti requires Lakebase; register lakebase() before graphiti() and bind its Postgres resource");
+        }
+        for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+            process.once(signal, () => this.stopGraphiti());
+        }
+        const supervisor = appkitInterceptor.createInterceptorContext({});
+        supervisor.context.onTeardown(() => this.stopGraphiti());
+        const graphiti = exec.spawn(this.resolved.python, ["-m", "dbx_tools.graphiti", "start"], {
+            env: {
+                ...process.env,
+                GRAPHITI_HOST: "127.0.0.1",
+                GRAPHITI_PORT: String(this.resolved.graphitiPort),
+                JOURNAL_NAMESPACE: this.resolved.journalNamespace,
+            },
+            stdin: "ignore",
+            stdout: "inherit",
+            stderr: "inherit",
+        });
+        const caddy = exec.spawn(this.resolved.python, [
+            "-m",
+            "dbx_tools.graphiti.proxy",
+            "--public-port",
+            String(this.resolved.publicPort),
+            "--app-port",
+            String(this.resolved.appPort),
+            "--graphiti-port",
+            String(this.resolved.graphitiPort),
+            "--route-prefix",
+            this.resolved.routePrefix,
+        ], {
+            env: process.env,
+            stdin: "ignore",
+            stdout: "inherit",
+            stderr: "inherit",
+        });
+        this.children = [graphiti, caddy];
+        for (const child of this.children)
+            supervisor.context.bindProcess(child);
+        await waitForGraphiti(this.resolved.graphitiPort);
+        this.mcp = new MCPClient({
+            id: `appkit-graphiti-${this.resolved.graphitiPort}`,
+            servers: {
+                graphiti: {
+                    url: new URL(`http://127.0.0.1:${this.resolved.graphitiPort}/mcp`),
+                },
+            },
+        });
+        const discovered = await this.mcp.listTools();
+        this.mcpTools = Object.fromEntries(Object.entries(discovered).map(([name, tool]) => [
+            name.replace(/^graphiti_/, ""),
+            tool,
+        ]));
+        this.logger.info("ready", {
+            appPort: this.resolved.appPort,
+            graphitiPort: this.resolved.graphitiPort,
+            publicPort: this.resolved.publicPort,
+            mcpPath: `${this.resolved.routePrefix}/mcp/`,
+            tools: Object.keys(this.mcpTools),
+        });
+    }
+    abortActiveOperations() {
+        super.abortActiveOperations();
+        this.stopGraphiti();
+        void this.mcp?.disconnect();
+        this.mcp = undefined;
+        this.mcpTools = {};
+        for (const child of this.children) {
+            if (!child.killed)
+                child.kill("SIGTERM");
+        }
+        this.children = [];
+    }
+    exports() {
+        const resolved = this.resolved ?? resolveGraphitiConfig(this.config);
+        return {
+            appPort: resolved.appPort,
+            graphitiPort: resolved.graphitiPort,
+            mcpPath: `${resolved.routePrefix}/mcp/`,
+            publicPort: resolved.publicPort,
+            routePrefix: resolved.routePrefix,
+        };
+    }
+    toolkit() {
+        return Object.fromEntries(Object.entries(this.mcpTools).map(([name, tool]) => [
+            name,
+            {
+                pluginName: "graphiti",
+                localName: name,
+                def: {
+                    name,
+                    description: tool.description,
+                    parameters: tool.inputSchema ?? { type: "object", properties: {} },
+                },
+            },
+        ]));
+    }
+    async executeAgentTool(name, args, signal) {
+        const tool = this.mcpTools[name];
+        if (!tool?.execute)
+            throw new Error(`Unknown Graphiti tool: ${name}`);
+        return tool.execute(args, { abortSignal: signal });
+    }
+    stopGraphiti() {
+        if (this.stopping || !this.resolved)
+            return;
+        this.stopping = true;
+        void exec.spawn(this.resolved.python, ["-m", "dbx_tools.graphiti", "down"], {
+            env: process.env,
+            stdin: "ignore",
+            stdout: "inherit",
+            stderr: "inherit",
+        });
+    }
+}
+export const graphiti = toPlugin(GraphitiPlugin);
+async function waitForGraphiti(port) {
+    for await (const ready of asyncModule.poll(async ({ signal }) => {
+        try {
+            const response = await fetch(`http://127.0.0.1:${port}/health`, { signal });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }, {
+        intervalMs: 250,
+        timeoutMs: 60_000,
+        predicate: (ready) => !ready,
+    })) {
+        if (ready)
+            return;
+    }
+}
+async function availablePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                server.close();
+                reject(new Error("Could not allocate a Graphiti loopback port"));
+                return;
+            }
+            server.close((error) => (error ? reject(error) : resolve(address.port)));
+        });
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3BsdWdpbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUN4QyxPQUFPLEVBQ0wsTUFBTSxFQUNOLFFBQVEsRUFDUixRQUFRLEdBR1QsTUFBTSxvQkFBb0IsQ0FBQztBQUM1QixPQUFPLEVBQUUsV0FBVyxJQUFJLGlCQUFpQixFQUFFLE1BQU0sSUFBSSxZQUFZLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUM3RixPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDdkMsT0FBTyxFQUFFLEtBQUssSUFBSSxXQUFXLEVBQUUsR0FBRyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFbkUsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUN4QyxPQUFPLEVBQ0wsc0JBQXNCLEVBQ3RCLHFCQUFxQixHQUd0QixNQUFNLGFBQWEsQ0FBQztBQUVyQixNQUFNLGlCQUFpQixHQUFHLFlBQVksQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQztBQVl0RSxNQUFNLE9BQU8sY0FBZSxTQUFRLE1BQTRCO0lBQzlELE1BQU0sQ0FBQyxRQUFRLEdBQStCO1FBQzVDLElBQUksRUFBRSxVQUFVO1FBQ2hCLFdBQVcsRUFBRSxVQUFVO1FBQ3ZCLFdBQVcsRUFDVCw0RUFBNEU7WUFDNUUsd0RBQXdEO1FBQzFELFNBQVMsRUFBRSxNQUFNO1FBQ2pCLFNBQVMsRUFBRTtZQUNULFFBQVEsRUFBRSxFQUFFO1lBQ1osUUFBUSxFQUFFLENBQUMsR0FBRyxpQkFBaUIsQ0FBQyxTQUFTLENBQUMsUUFBUSxDQUFDO1NBQ3BEO1FBQ0QsTUFBTSxFQUFFLEVBQUUsTUFBTSxFQUFFLHNCQUFzQixFQUFFO0tBQzNDLENBQUM7SUFFRixNQUFNLENB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RSxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDM0UsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEFwcEtpdCBwbHVnaW4gdGhhdCBzdXBlcnZpc2VzIEdyYXBoaXRpIGFuZCBhIENhZGR5IHNpbmdsZS1wb3J0IHByb3h5LlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuaW1wb3J0IHsgY3JlYXRlU2VydmVyIH0gZnJvbSBcIm5vZGU6bmV0XCI7XG5pbXBvcnQge1xuICBQbHVnaW4sXG4gIGxha2ViYXNlLFxuICB0b1BsdWdpbixcbiAgdHlwZSBQbHVnaW5NYW5pZmVzdCxcbiAgdHlwZSBSZXNvdXJjZVJlcXVpcmVtZW50LFxufSBmcm9tIFwiQGRhdGFicmlja3MvYXBwa2l0XCI7XG5pbXBvcnQgeyBpbnRlcmNlcHRvciBhcyBhcHBraXRJbnRlcmNlcHRvciwgcGx1Z2luIGFzIGFwcGtpdFBsdWdpbiB9IGZyb20gXCJAZGJ4LXRvb2xzL2FwcGtpdFwiO1xuaW1wb3J0IHsgZXhlYyB9IGZyb20gXCJAZGJ4LXRvb2xzL2NvcmVcIjtcbmltcG9ydCB7IGFzeW5jIGFzIGFzeW5jTW9kdWxlLCBsb2cgfSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtY29yZVwiO1xuaW1wb3J0IHR5cGUgeyBUb29sIH0gZnJvbSBcIkBtYXN0cmEvY29yZS90b29sc1wiO1xuaW1wb3J0IHsgTUNQQ2xpZW50IH0gZnJvbSBcIkBtYXN0cmEvbWNwXCI7XG5pbXBvcnQge1xuICBHUkFQSElUSV9DT05GSUdfU0NIRU1BLFxuICByZXNvbHZlR3JhcGhpdGlDb25maWcsXG4gIHR5cGUgR3JhcGhpdGlQbHVnaW5Db25maWcsXG4gIHR5cGUgUmVzb2x2ZWRHcmFwaGl0aVBsdWdpbkNvbmZpZyxcbn0gZnJvbSBcIi4vY29uZmlnLnRzXCI7XG5cbmNvbnN0IExBS0VCQVNFX01BTklGRVNUID0gYXBwa2l0UGx1Z2luLmRhdGEobGFrZWJhc2UpLnBsdWdpbi5tYW5pZmVzdDtcblxuaW50ZXJmYWNlIFRvb2xraXRFbnRyeSB7XG4gIHBsdWdpbk5hbWU6IHN0cmluZztcbiAgbG9jYWxOYW1lOiBzdHJpbmc7XG4gIGRlZjoge1xuICAgIG5hbWU6IHN0cmluZztcbiAgICBkZXNjcmlwdGlvbjogc3RyaW5nO1xuICAgIHBhcmFtZXRlcnM6IHVua25vd247XG4gIH07XG59XG5cbmV4cG9ydCBjbGFzcyBHcmFwaGl0aVBsdWdpbiBleHRlbmRzIFBsdWdpbjxHcmFwaGl0aVBsdWdpbkNvbmZpZz4ge1xuICBzdGF0aWMgbWFuaWZlc3Q6IFBsdWdpbk1hbmlmZXN0PFwiZ3JhcGhpdGlcIj4gPSB7XG4gICAgbmFtZTogXCJncmFwaGl0aVwiLFxuICAgIGRpc3BsYXlOYW1lOiBcIkdyYXBoaXRpXCIsXG4gICAgZGVzY3JpcHRpb246XG4gICAgICBcIlJ1bnMgdGhlIGRieC10b29scyBHcmFwaGl0aSBNQ1Agc2lkZWNhciB3aXRoIExha2ViYXNlLWJhY2tlZCByZWNvdmVyeSBhbmQgXCIgK1xuICAgICAgXCJwdWJsaXNoZXMgaXQgdGhyb3VnaCB0aGUgQXBwJ3Mgc2luZ2xlIHBvcnQgd2l0aCBDYWRkeS5cIixcbiAgICBzdGFiaWxpdHk6IFwiYmV0YVwiLFxuICAgIHJlc291cmNlczoge1xuICAgICAgcmVxdWlyZWQ6IFtdLFxuICAgICAgb3B0aW9uYWw6IFsuLi5MQUtFQkFTRV9NQU5JRkVTVC5yZXNvdXJjZXMucmVxdWlyZWRdLFxuICAgIH0sXG4gICAgY29uZmlnOiB7IHNjaGVtYTogR1JBUEhJVElfQ09ORklHX1NDSEVNQSB9LFxuICB9O1xuXG4gIHN0YXRpYyBnZXRSZXNvdXJjZVJlcXVpcmVtZW50cygpOiBSZXNvdXJjZVJlcXVpcmVtZW50W10ge1xuICAgIHJldHVybiBMQUtFQkFTRV9NQU5JRkVTVC5yZXNvdXJjZXMucmVxdWlyZWQubWFwKChyZXNvdXJjZSkgPT4gKHtcbiAgICAgIC4uLnJlc291cmNlLFxuICAgICAgcmVxdWlyZWQ6IHRydWUsXG4gICAgfSkpO1xuICB9XG5cbiAgcHJpdmF0ZSByZWFkb25seSBsb2dnZXIgPSBsb2cubG9nZ2VyKHRoaXMpO1xuICBwcml2YXRlIGNoaWxkcmVuOiBSZXR1cm5UeXBlPHR5cGVvZiBleGVjLnNwYXduPltdID0gW107XG4gIHByaXZhdGUgbWNwPzogTUNQQ2xpZW50O1xuICBwcml2YXRlIG1jcFRvb2xzOiBSZWNvcmQ8c3RyaW5nLCBUb29sPiA9IHt9O1xuICBwcml2YXRlIHJlc29sdmVkPzogUmVzb2x2ZWRHcmFwaGl0aVBsdWdpbkNvbmZpZztcbiAgcHJpdmF0ZSBzdG9wcGluZyA9IGZhbHNlO1xuXG4gIG92ZXJyaWRlIGFzeW5jIHNldHVwKCk6IFByb21pc2U8dm9pZD4ge1xuICAgIGNvbnN0IGNvbmZpZ3VyZWQgPSByZXNvbHZlR3JhcGhpdGlDb25maWcodGhpcy5jb25maWcpO1xuICAgIHRoaXMucmVzb2x2ZWQgPSB7XG4gICAgICAuLi5jb25maWd1cmVkLFxuICAgICAgZ3JhcGhpdGlQb3J0OiBjb25maWd1cmVkLmdyYXBoaXRpUG9ydCB8fCAoYXdhaXQgYXZhaWxhYmxlUG9ydCgpKSxcbiAgICB9O1xuICAgIGlmICghcHJvY2Vzcy5lbnYuTEFLRUJBU0VfRU5EUE9JTlQgJiYgIXByb2Nlc3MuZW52LlBHSE9TVCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICBcIkdyYXBoaXRpIHJlcXVpcmVzIExha2ViYXNlOyByZWdpc3RlciBsYWtlYmFzZSgpIGJlZm9yZSBncmFwaGl0aSgpIGFuZCBiaW5kIGl0cyBQb3N0Z3JlcyByZXNvdXJjZVwiLFxuICAgICAgKTtcbiAgICB9XG4gICAgZm9yIChjb25zdCBzaWduYWwgb2YgW1wiU0lHSU5UXCIsIFwiU0lHVEVSTVwiLCBcIlNJR0hVUFwiXSBhcyBjb25zdCkge1xuICAgICAgcHJvY2Vzcy5vbmNlKHNpZ25hbCwgKCkgPT4gdGhpcy5zdG9wR3JhcGhpdGkoKSk7XG4gICAgfVxuICAgIGNvbnN0IHN1cGVydmlzb3IgPSBhcHBraXRJbnRlcmNlcHRvci5jcmVhdGVJbnRlcmNlcHRvckNvbnRleHQoe30pO1xuICAgIHN1cGVydmlzb3IuY29udGV4dC5vblRlYXJkb3duKCgpID0+IHRoaXMuc3RvcEdyYXBoaXRpKCkpO1xuICAgIGNvbnN0IGdyYXBoaXRpID0gZXhlYy5zcGF3bih0aGlzLnJlc29sdmVkLnB5dGhvbiwgW1wiLW1cIiwgXCJkYnhfdG9vbHMuZ3JhcGhpdGlcIiwgXCJzdGFydFwiXSwge1xuICAgICAgZW52OiB7XG4gICAgICAgIC4uLnByb2Nlc3MuZW52LFxuICAgICAgICBHUkFQSElUSV9IT1NUOiBcIjEyNy4wLjAuMVwiLFxuICAgICAgICBHUkFQSElUSV9QT1JUOiBTdHJpbmcodGhpcy5yZXNvbHZlZC5ncmFwaGl0aVBvcnQpLFxuICAgICAgICBKT1VSTkFMX05BTUVTUEFDRTogdGhpcy5yZXNvbHZlZC5qb3VybmFsTmFtZXNwYWNlLFxuICAgICAgfSxcbiAgICAgIHN0ZGluOiBcImlnbm9yZVwiLFxuICAgICAgc3Rkb3V0OiBcImluaGVyaXRcIixcbiAgICAgIHN0ZGVycjogXCJpbmhlcml0XCIsXG4gICAgfSk7XG4gICAgY29uc3QgY2FkZHkgPSBleGVjLnNwYXduKFxuICAgICAgdGhpcy5yZXNvbHZlZC5weXRob24sXG4gICAgICBbXG4gICAgICAgIFwiLW1cIixcbiAgICAgICAgXCJkYnhfdG9vbHMuZ3JhcGhpdGkucHJveHlcIixcbiAgICAgICAgXCItLXB1YmxpYy1wb3J0XCIsXG4gICAgICAgIFN0cmluZyh0aGlzLnJlc29sdmVkLnB1YmxpY1BvcnQpLFxuICAgICAgICBcIi0tYXBwLXBvcnRcIixcbiAgICAgICAgU3RyaW5nKHRoaXMucmVzb2x2ZWQuYXBwUG9ydCksXG4gICAgICAgIFwiLS1ncmFwaGl0aS1wb3J0XCIsXG4gICAgICAgIFN0cmluZyh0aGlzLnJlc29sdmVkLmdyYXBoaXRpUG9ydCksXG4gICAgICAgIFwiLS1yb3V0ZS1wcmVmaXhcIixcbiAgICAgICAgdGhpcy5yZXNvbHZlZC5yb3V0ZVByZWZpeCxcbiAgICAgIF0sXG4gICAgICB7XG4gICAgICAgIGVudjogcHJvY2Vzcy5lbnYsXG4gICAgICAgIHN0ZGluOiBcImlnbm9yZVwiLFxuICAgICAgICBzdGRvdXQ6IFwiaW5oZXJpdFwiLFxuICAgICAgICBzdGRlcnI6IFwiaW5oZXJpdFwiLFxuICAgICAgfSxcbiAgICApO1xuICAgIHRoaXMuY2hpbGRyZW4gPSBbZ3JhcGhpdGksIGNhZGR5XTtcbiAgICBmb3IgKGNvbnN0IGNoaWxkIG9mIHRoaXMuY2hpbGRyZW4pIHN1cGVydmlzb3IuY29udGV4dC5iaW5kUHJvY2VzcyhjaGlsZCk7XG4gICAgYXdhaXQgd2FpdEZvckdyYXBoaXRpKHRoaXMucmVzb2x2ZWQuZ3JhcGhpdGlQb3J0KTtcbiAgICB0aGlzLm1jcCA9IG5ldyBNQ1BDbGllbnQoe1xuICAgICAgaWQ6IGBhcHBraXQtZ3JhcGhpdGktJHt0aGlzLnJlc29sdmVkLmdyYXBoaXRpUG9ydH1gLFxuICAgICAgc2VydmVyczoge1xuICAgICAgICBncmFwaGl0aToge1xuICAgICAgICAgIHVybDogbmV3IFVSTChgaHR0cDovLzEyNy4wLjAuMToke3RoaXMucmVzb2x2ZWQuZ3JhcGhpdGlQb3J0fS9tY3BgKSxcbiAgICAgICAgfSxcbiAgICAgIH0sXG4gICAgfSk7XG4gICAgY29uc3QgZGlzY292ZXJlZCA9IGF3YWl0IHRoaXMubWNwLmxpc3RUb29scygpO1xuICAgIHRoaXMubWNwVG9vbHMgPSBPYmplY3QuZnJvbUVudHJpZXMoXG4gICAgICBPYmplY3QuZW50cmllcyhkaXNjb3ZlcmVkKS5tYXAoKFtuYW1lLCB0b29sXSkgPT4gW1xuICAgICAgICBuYW1lLnJlcGxhY2UoL15ncmFwaGl0aV8vLCBcIlwiKSxcbiAgICAgICAgdG9vbCBhcyBUb29sLFxuICAgICAgXSksXG4gICAgKTtcbiAgICB0aGlzLmxvZ2dlci5pbmZvKFwicmVhZHlcIiwge1xuICAgICAgYXBwUG9ydDogdGhpcy5yZXNvbHZlZC5hcHBQb3J0LFxuICAgICAgZ3JhcGhpdGlQb3J0OiB0aGlzLnJlc29sdmVkLmdyYXBoaXRpUG9ydCxcbiAgICAgIHB1YmxpY1BvcnQ6IHRoaXMucmVzb2x2ZWQucHVibGljUG9ydCxcbiAgICAgIG1jcFBhdGg6IGAke3RoaXMucmVzb2x2ZWQucm91dGVQcmVmaXh9L21jcC9gLFxuICAgICAgdG9vbHM6IE9iamVjdC5rZXlzKHRoaXMubWNwVG9vbHMpLFxuICAgIH0pO1xuICB9XG5cbiAgb3ZlcnJpZGUgYWJvcnRBY3RpdmVPcGVyYXRpb25zKCk6IHZvaWQge1xuICAgIHN1cGVyLmFib3J0QWN0aXZlT3BlcmF0aW9ucygpO1xuICAgIHRoaXMuc3RvcEdyYXBoaXRpKCk7XG4gICAgdm9pZCB0aGlzLm1jcD8uZGlzY29ubmVjdCgpO1xuICAgIHRoaXMubWNwID0gdW5kZWZpbmVkO1xuICAgIHRoaXMubWNwVG9vbHMgPSB7fTtcbiAgICBmb3IgKGNvbnN0IGNoaWxkIG9mIHRoaXMuY2hpbGRyZW4pIHtcbiAgICAgIGlmICghY2hpbGQua2lsbGVkKSBjaGlsZC5raWxsKFwiU0lHVEVSTVwiKTtcbiAgICB9XG4gICAgdGhpcy5jaGlsZHJlbiA9IFtdO1xuICB9XG5cbiAgb3ZlcnJpZGUgZXhwb3J0cygpIHtcbiAgICBjb25zdCByZXNvbHZlZCA9IHRoaXMucmVzb2x2ZWQgPz8gcmVzb2x2ZUdyYXBoaXRpQ29uZmlnKHRoaXMuY29uZmlnKTtcbiAgICByZXR1cm4ge1xuICAgICAgYXBwUG9ydDogcmVzb2x2ZWQuYXBwUG9ydCxcbiAgICAgIGdyYXBoaXRpUG9ydDogcmVzb2x2ZWQuZ3JhcGhpdGlQb3J0LFxuICAgICAgbWNwUGF0aDogYCR7cmVzb2x2ZWQucm91dGVQcmVmaXh9L21jcC9gLFxuICAgICAgcHVibGljUG9ydDogcmVzb2x2ZWQucHVibGljUG9ydCxcbiAgICAgIHJvdXRlUHJlZml4OiByZXNvbHZlZC5yb3V0ZVByZWZpeCxcbiAgICB9O1xuICB9XG5cbiAgdG9vbGtpdCgpOiBSZWNvcmQ8c3RyaW5nLCBUb29sa2l0RW50cnk+IHtcbiAgICByZXR1cm4gT2JqZWN0LmZyb21FbnRyaWVzKFxuICAgICAgT2JqZWN0LmVudHJpZXModGhpcy5tY3BUb29scykubWFwKChbbmFtZSwgdG9vbF0pID0+IFtcbiAgICAgICAgbmFtZSxcbiAgICAgICAge1xuICAgICAgICAgIHBsdWdpbk5hbWU6IFwiZ3JhcGhpdGlcIixcbiAgICAgICAgICBsb2NhbE5hbWU6IG5hbWUsXG4gICAgICAgICAgZGVmOiB7XG4gICAgICAgICAgICBuYW1lLFxuICAgICAgICAgICAgZGVzY3JpcHRpb246IHRvb2wuZGVzY3JpcHRpb24sXG4gICAgICAgICAgICBwYXJhbWV0ZXJzOiB0b29sLmlucHV0U2NoZW1hID8/IHsgdHlwZTogXCJvYmplY3RcIiwgcHJvcGVydGllczoge30gfSxcbiAgICAgICAgICB9LFxuICAgICAgICB9LFxuICAgICAgXSksXG4gICAgKTtcbiAgfVxuXG4gIGFzeW5jIGV4ZWN1dGVBZ2VudFRvb2wobmFtZTogc3RyaW5nLCBhcmdzOiB1bmtub3duLCBzaWduYWw/OiBBYm9ydFNpZ25hbCk6IFByb21pc2U8dW5rbm93bj4ge1xuICAgIGNvbnN0IHRvb2wgPSB0aGlzLm1jcFRvb2xzW25hbWVdO1xuICAgIGlmICghdG9vbD8uZXhlY3V0ZSkgdGhyb3cgbmV3IEVycm9yKGBVbmtub3duIEdyYXBoaXRpIHRvb2w6ICR7bmFtZX1gKTtcbiAgICByZXR1cm4gdG9vbC5leGVjdXRlKGFyZ3MsIHsgYWJvcnRTaWduYWw6IHNpZ25hbCB9IGFzIG5ldmVyKTtcbiAgfVxuXG4gIHByaXZhdGUgc3RvcEdyYXBoaXRpKCk6IHZvaWQge1xuICAgIGlmICh0aGlzLnN0b3BwaW5nIHx8ICF0aGlzLnJlc29sdmVkKSByZXR1cm47XG4gICAgdGhpcy5zdG9wcGluZyA9IHRydWU7XG4gICAgdm9pZCBleGVjLnNwYXduKHRoaXMucmVzb2x2ZWQucHl0aG9uLCBbXCItbVwiLCBcImRieF90b29scy5ncmFwaGl0aVwiLCBcImRvd25cIl0sIHtcbiAgICAgIGVudjogcHJvY2Vzcy5lbnYsXG4gICAgICBzdGRpbjogXCJpZ25vcmVcIixcbiAgICAgIHN0ZG91dDogXCJpbmhlcml0XCIsXG4gICAgICBzdGRlcnI6IFwiaW5oZXJpdFwiLFxuICAgIH0pO1xuICB9XG59XG5cbmV4cG9ydCBjb25zdCBncmFwaGl0aSA9IHRvUGx1Z2luKEdyYXBoaXRpUGx1Z2luKTtcblxuYXN5bmMgZnVuY3Rpb24gd2FpdEZvckdyYXBoaXRpKHBvcnQ6IG51bWJlcik6IFByb21pc2U8dm9pZD4ge1xuICBmb3IgYXdhaXQgKGNvbnN0IHJlYWR5IG9mIGFzeW5jTW9kdWxlLnBvbGwoXG4gICAgYXN5bmMgKHsgc2lnbmFsIH0pID0+IHtcbiAgICAgIHRyeSB7XG4gICAgICAgIGNvbnN0IHJlc3BvbnNlID0gYXdhaXQgZmV0Y2goYGh0dHA6Ly8xMjcuMC4wLjE6JHtwb3J0fS9oZWFsdGhgLCB7IHNpZ25hbCB9KTtcbiAgICAgICAgcmV0dXJuIHJlc3BvbnNlLm9rO1xuICAgICAgfSBjYXRjaCB7XG4gICAgICAgIHJldHVybiBmYWxzZTtcbiAgICAgIH1cbiAgICB9LFxuICAgIHtcbiAgICAgIGludGVydmFsTXM6IDI1MCxcbiAgICAgIHRpbWVvdXRNczogNjBfMDAwLFxuICAgICAgcHJlZGljYXRlOiAocmVhZHkpID0+ICFyZWFkeSxcbiAgICB9LFxuICApKSB7XG4gICAgaWYgKHJlYWR5KSByZXR1cm47XG4gIH1cbn1cblxuYXN5bmMgZnVuY3Rpb24gYXZhaWxhYmxlUG9ydCgpOiBQcm9taXNlPG51bWJlcj4ge1xuICByZXR1cm4gbmV3IFByb21pc2UoKHJlc29sdmUsIHJlamVjdCkgPT4ge1xuICAgIGNvbnN0IHNlcnZlciA9IGNyZWF0ZVNlcnZlcigpO1xuICAgIHNlcnZlci5vbmNlKFwiZXJyb3JcIiwgcmVqZWN0KTtcbiAgICBzZXJ2ZXIubGlzdGVuKDAsIFwiMTI3LjAuMC4xXCIsICgpID0+IHtcbiAgICAgIGNvbnN0IGFkZHJlc3MgPSBzZXJ2ZXIuYWRkcmVzcygpO1xuICAgICAgaWYgKCFhZGRyZXNzIHx8IHR5cGVvZiBhZGRyZXNzID09PSBcInN0cmluZ1wiKSB7XG4gICAgICAgIHNlcnZlci5jbG9zZSgpO1xuICAgICAgICByZWplY3QobmV3IEVycm9yKFwiQ291bGQgbm90IGFsbG9jYXRlIGEgR3JhcGhpdGkgbG9vcGJhY2sgcG9ydFwiKSk7XG4gICAgICAgIHJldHVybjtcbiAgICAgIH1cbiAgICAgIHNlcnZlci5jbG9zZSgoZXJyb3IpID0+IChlcnJvciA/IHJlamVjdChlcnJvcikgOiByZXNvbHZlKGFkZHJlc3MucG9ydCkpKTtcbiAgICB9KTtcbiAgfSk7XG59XG4iXX0=

package/lib/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/config.ts","../src/plugin.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@dbx-tools/appkit-graphiti",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reggie-db/dbx-tools.git",
+    "directory": "packages/js/node/appkit-graphiti"
+  },
+  "scripts": {
+    "build": "projen build",
+    "compile": "projen compile",
+    "default": "projen default",
+    "package": "projen package",
+    "post-compile": "projen post-compile",
+    "pre-compile": "projen pre-compile",
+    "prepack": "projen prepack",
+    "test": "projen test",
+    "watch": "projen watch",
+    "projen": "projen"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "@types/json-schema": "^7",
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@databricks/appkit": "^0.60.0",
+    "@dbx-tools/appkit": "0.6.113",
+    "@dbx-tools/core": "0.6.113",
+    "@dbx-tools/shared-core": "0.6.113",
+    "@mastra/core": "1.47.0",
+    "@mastra/mcp": "1.12.0"
+  },
+  "main": "./lib/index.js",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "main": "./lib/index.js",
+    "types": "./lib/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./lib/index.d.ts",
+        "default": "./lib/index.js"
+      },
+      "./package.json": "./package.json"
+    }
+  },
+  "version": "0.6.113",
+  "types": "./lib/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "lib"
+  ],
+  "dbxToolsConfig": {
+    "tags": [
+      "node"
+    ]
+  },
+  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"bunx projen\"."
+}

package/src/config.ts

@@ -0,0 +1,99 @@
+/**
+ * AppKit Graphiti sidecar ports, route prefix, and Python command.
+ *
+ * @module
+ */
+import { ConfigurationError, type BasePluginConfig } from "@databricks/appkit";
+import { config as coreConfig } from "@dbx-tools/core";
+import type { JSONSchema7 } from "json-schema";
+
+export interface GraphitiPluginConfig extends BasePluginConfig {
+  publicPort?: number;
+  appPort?: number;
+  graphitiPort?: number;
+  routePrefix?: string;
+  python?: string;
+  journalNamespace?: string;
+}
+
+export interface ResolvedGraphitiPluginConfig extends GraphitiPluginConfig {
+  publicPort: number;
+  appPort: number;
+  graphitiPort: number;
+  routePrefix: string;
+  python: string;
+  journalNamespace: string;
+}
+
+export const GRAPHITI_CONFIG_SCHEMA = {
+  type: "object",
+  properties: {
+    publicPort: { type: "integer", minimum: 1, maximum: 65535 },
+    appPort: { type: "integer", minimum: 1, maximum: 65535 },
+    graphitiPort: { type: "integer", minimum: 1, maximum: 65535 },
+    routePrefix: { type: "string" },
+    python: { type: "string" },
+    journalNamespace: { type: "string" },
+  },
+  additionalProperties: false,
+} satisfies JSONSchema7;
+
+/** Resolve plugin config over exact environment values and stable defaults. */
+export function resolveGraphitiConfig(
+  config: GraphitiPluginConfig = {},
+): ResolvedGraphitiPluginConfig {
+  const publicPort = coreConfig.port(
+    config.publicPort,
+    "DATABRICKS_APP_PORT",
+    8000,
+    coreConfig.ENV_ONLY,
+  );
+  const appPort = coreConfig.port(
+    config.appPort,
+    "GRAPHITI_APP_PORT",
+    publicPort + 1,
+    coreConfig.ENV_ONLY,
+  );
+  const graphitiPort = coreConfig.port(
+    config.graphitiPort,
+    "GRAPHITI_PORT",
+    0,
+    coreConfig.ENV_ONLY,
+  );
+  if (new Set([publicPort, appPort, graphitiPort]).size !== 3) {
+    throw new ConfigurationError("Graphiti public, AppKit, and sidecar ports must be distinct");
+  }
+  const routePrefix = normalizeRoutePrefix(
+    config.routePrefix ??
+      coreConfig.text("GRAPHITI_ROUTE_PREFIX", coreConfig.ENV_ONLY) ??
+      "/graphiti",
+  );
+  const python =
+    config.python ?? coreConfig.text("PYTHON", coreConfig.ENV_ONLY)?.trim() ?? "python3";
+  const journalNamespace =
+    config.journalNamespace ??
+    coreConfig.text("JOURNAL_NAMESPACE", coreConfig.ENV_ONLY)?.trim() ??
+    process.env.DATABRICKS_APP_NAME?.trim() ??
+    "default";
+  return {
+    publicPort,
+    appPort,
+    graphitiPort,
+    routePrefix,
+    python,
+    journalNamespace,
+  };
+}
+
+/** Return the internal port an AppKit `server()` plugin should bind. */
+export function appPort(config: GraphitiPluginConfig = {}): number {
+  return resolveGraphitiConfig(config).appPort;
+}
+
+function normalizeRoutePrefix(value: string): string {
+  const normalized = `/${value.trim().replace(/^\/+|\/+$/g, "")}`;
+  if (normalized === "/") {
+    throw new ConfigurationError("Graphiti routePrefix must contain a path segment");
+  }
+  return normalized;
+}

package/src/plugin.ts

@@ -0,0 +1,236 @@
+/**
+ * AppKit plugin that supervises Graphiti and a Caddy single-port proxy.
+ *
+ * @module
+ */
+import { createServer } from "node:net";
+import {
+  Plugin,
+  lakebase,
+  toPlugin,
+  type PluginManifest,
+  type ResourceRequirement,
+} from "@databricks/appkit";
+import { interceptor as appkitInterceptor, plugin as appkitPlugin } from "@dbx-tools/appkit";
+import { exec } from "@dbx-tools/core";
+import { async as asyncModule, log } from "@dbx-tools/shared-core";
+import type { Tool } from "@mastra/core/tools";
+import { MCPClient } from "@mastra/mcp";
+import {
+  GRAPHITI_CONFIG_SCHEMA,
+  resolveGraphitiConfig,
+  type GraphitiPluginConfig,
+  type ResolvedGraphitiPluginConfig,
+} from "./config.ts";
+
+const LAKEBASE_MANIFEST = appkitPlugin.data(lakebase).plugin.manifest;
+
+interface ToolkitEntry {
+  pluginName: string;
+  localName: string;
+  def: {
+    name: string;
+    description: string;
+    parameters: unknown;
+  };
+}
+
+export class GraphitiPlugin extends Plugin<GraphitiPluginConfig> {
+  static manifest: PluginManifest<"graphiti"> = {
+    name: "graphiti",
+    displayName: "Graphiti",
+    description:
+      "Runs the dbx-tools Graphiti MCP sidecar with Lakebase-backed recovery and " +
+      "publishes it through the App's single port with Caddy.",
+    stability: "beta",
+    resources: {
+      required: [],
+      optional: [...LAKEBASE_MANIFEST.resources.required],
+    },
+    config: { schema: GRAPHITI_CONFIG_SCHEMA },
+  };
+
+  static getResourceRequirements(): ResourceRequirement[] {
+    return LAKEBASE_MANIFEST.resources.required.map((resource) => ({
+      ...resource,
+      required: true,
+    }));
+  }
+
+  private readonly logger = log.logger(this);
+  private children: ReturnType<typeof exec.spawn>[] = [];
+  private mcp?: MCPClient;
+  private mcpTools: Record<string, Tool> = {};
+  private resolved?: ResolvedGraphitiPluginConfig;
+  private stopping = false;
+
+  override async setup(): Promise<void> {
+    const configured = resolveGraphitiConfig(this.config);
+    this.resolved = {
+      ...configured,
+      graphitiPort: configured.graphitiPort || (await availablePort()),
+    };
+    if (!process.env.LAKEBASE_ENDPOINT && !process.env.PGHOST) {
+      throw new Error(
+        "Graphiti requires Lakebase; register lakebase() before graphiti() and bind its Postgres resource",
+      );
+    }
+    for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"] as const) {
+      process.once(signal, () => this.stopGraphiti());
+    }
+    const supervisor = appkitInterceptor.createInterceptorContext({});
+    supervisor.context.onTeardown(() => this.stopGraphiti());
+    const graphiti = exec.spawn(this.resolved.python, ["-m", "dbx_tools.graphiti", "start"], {
+      env: {
+        ...process.env,
+        GRAPHITI_HOST: "127.0.0.1",
+        GRAPHITI_PORT: String(this.resolved.graphitiPort),
+        JOURNAL_NAMESPACE: this.resolved.journalNamespace,
+      },
+      stdin: "ignore",
+      stdout: "inherit",
+      stderr: "inherit",
+    });
+    const caddy = exec.spawn(
+      this.resolved.python,
+      [
+        "-m",
+        "dbx_tools.graphiti.proxy",
+        "--public-port",
+        String(this.resolved.publicPort),
+        "--app-port",
+        String(this.resolved.appPort),
+        "--graphiti-port",
+        String(this.resolved.graphitiPort),
+        "--route-prefix",
+        this.resolved.routePrefix,
+      ],
+      {
+        env: process.env,
+        stdin: "ignore",
+        stdout: "inherit",
+        stderr: "inherit",
+      },
+    );
+    this.children = [graphiti, caddy];
+    for (const child of this.children) supervisor.context.bindProcess(child);
+    await waitForGraphiti(this.resolved.graphitiPort);
+    this.mcp = new MCPClient({
+      id: `appkit-graphiti-${this.resolved.graphitiPort}`,
+      servers: {
+        graphiti: {
+          url: new URL(`http://127.0.0.1:${this.resolved.graphitiPort}/mcp`),
+        },
+      },
+    });
+    const discovered = await this.mcp.listTools();
+    this.mcpTools = Object.fromEntries(
+      Object.entries(discovered).map(([name, tool]) => [
+        name.replace(/^graphiti_/, ""),
+        tool as Tool,
+      ]),
+    );
+    this.logger.info("ready", {
+      appPort: this.resolved.appPort,
+      graphitiPort: this.resolved.graphitiPort,
+      publicPort: this.resolved.publicPort,
+      mcpPath: `${this.resolved.routePrefix}/mcp/`,
+      tools: Object.keys(this.mcpTools),
+    });
+  }
+
+  override abortActiveOperations(): void {
+    super.abortActiveOperations();
+    this.stopGraphiti();
+    void this.mcp?.disconnect();
+    this.mcp = undefined;
+    this.mcpTools = {};
+    for (const child of this.children) {
+      if (!child.killed) child.kill("SIGTERM");
+    }
+    this.children = [];
+  }
+
+  override exports() {
+    const resolved = this.resolved ?? resolveGraphitiConfig(this.config);
+    return {
+      appPort: resolved.appPort,
+      graphitiPort: resolved.graphitiPort,
+      mcpPath: `${resolved.routePrefix}/mcp/`,
+      publicPort: resolved.publicPort,
+      routePrefix: resolved.routePrefix,
+    };
+  }
+
+  toolkit(): Record<string, ToolkitEntry> {
+    return Object.fromEntries(
+      Object.entries(this.mcpTools).map(([name, tool]) => [
+        name,
+        {
+          pluginName: "graphiti",
+          localName: name,
+          def: {
+            name,
+            description: tool.description,
+            parameters: tool.inputSchema ?? { type: "object", properties: {} },
+          },
+        },
+      ]),
+    );
+  }
+
+  async executeAgentTool(name: string, args: unknown, signal?: AbortSignal): Promise<unknown> {
+    const tool = this.mcpTools[name];
+    if (!tool?.execute) throw new Error(`Unknown Graphiti tool: ${name}`);
+    return tool.execute(args, { abortSignal: signal } as never);
+  }
+
+  private stopGraphiti(): void {
+    if (this.stopping || !this.resolved) return;
+    this.stopping = true;
+    void exec.spawn(this.resolved.python, ["-m", "dbx_tools.graphiti", "down"], {
+      env: process.env,
+      stdin: "ignore",
+      stdout: "inherit",
+      stderr: "inherit",
+    });
+  }
+}
+
+export const graphiti = toPlugin(GraphitiPlugin);
+
+async function waitForGraphiti(port: number): Promise<void> {
+  for await (const ready of asyncModule.poll(
+    async ({ signal }) => {
+      try {
+        const response = await fetch(`http://127.0.0.1:${port}/health`, { signal });
+        return response.ok;
+      } catch {
+        return false;
+      }
+    },
+    {
+      intervalMs: 250,
+      timeoutMs: 60_000,
+      predicate: (ready) => !ready,
+    },
+  )) {
+    if (ready) return;
+  }
+}
+
+async function availablePort(): Promise<number> {
+  return new Promise((resolve, reject) => {
+    const server = createServer();
+    server.once("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close();
+        reject(new Error("Could not allocate a Graphiti loopback port"));
+        return;
+      }
+      server.close((error) => (error ? reject(error) : resolve(address.port)));
+    });
+  });
+}