@powerhousedao/switchboard 6.0.0-dev.10 → 6.0.0-dev.100

package/Dockerfile

@@ -1,5 +1,5 @@
 # Build stage
-FROM node:22-alpine AS build
+FROM node:24-alpine AS build
 
 WORKDIR /app
 
@@ -19,8 +19,8 @@ RUN pnpm config set @jsr:registry https://npm.jsr.io
 ARG TAG=latest
 ARG PH_PACKAGES=""
 
-# Install ph-cmd and prisma
-RUN pnpm add -g ph-cmd@$TAG prisma@5.17.0
+# Install ph-cmd, prisma, and prettier
+RUN pnpm add -g ph-cmd@$TAG prisma@5.17.0 prettier
 
 # Initialize project based on tag
 RUN case "$TAG" in \
@@ -44,7 +44,7 @@ RUN if [ -n "$PH_PACKAGES" ]; then \
 RUN prisma generate --schema node_modules/document-drive/dist/prisma/schema.prisma
 
 # Final stage - slim node image
-FROM node:22-alpine
+FROM node:24-alpine
 
 WORKDIR /app
 

package/dist/src/index.js

@@ -1,7 +1,12 @@
 #!/usr/bin/env node
+import * as Sentry from "@sentry/node";
+import { childLogger } from "document-drive";
 import { config } from "./config.js";
+import { createMeterProviderFromEnv } from "./metrics.js";
+import { initProfilerFromEnv } from "./profiler.js";
 import { startSwitchboard } from "./server.js";
-function ensureNodeVersion(minVersion = "22") {
+const logger = childLogger(["switchboard"]);
+function ensureNodeVersion(minVersion = "24") {
     const version = process.versions.node;
     if (!version) {
         return;
@@ -12,10 +17,33 @@ function ensureNodeVersion(minVersion = "22") {
     }
 }
 // Ensure minimum Node.js version
-ensureNodeVersion("22");
-process.on("SIGINT", () => {
+ensureNodeVersion("24");
+const meterProvider = createMeterProviderFromEnv({
+    OTEL_EXPORTER_OTLP_ENDPOINT: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+    OTEL_METRIC_EXPORT_INTERVAL: process.env.OTEL_METRIC_EXPORT_INTERVAL,
+    OTEL_SERVICE_NAME: process.env.OTEL_SERVICE_NAME,
+});
+async function shutdown() {
     console.log("\nShutting down...");
+    // Flush final metrics before exit. Races against a 5s deadline so an
+    // unresponsive OTLP endpoint cannot exhaust terminationGracePeriodSeconds.
+    await Promise.race([
+        meterProvider?.shutdown().catch(() => undefined),
+        new Promise((resolve) => setTimeout(resolve, 5_000)),
+    ]);
     process.exit(0);
-});
-startSwitchboard(config).catch(console.error);
+}
+// SIGINT: Ctrl-C in development; SIGTERM: graceful shutdown in Docker/Kubernetes
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+if (process.env.PYROSCOPE_SERVER_ADDRESS) {
+    try {
+        await initProfilerFromEnv(process.env);
+    }
+    catch (e) {
+        Sentry.captureException(e);
+        logger.error("Error starting profiler: @error", e);
+    }
+}
+startSwitchboard({ ...config, meterProvider }).catch(console.error);
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,SAAS,iBAAiB,CAAC,UAAU,GAAG,IAAI;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CACX,gBAAgB,UAAU,4CAA4C,OAAO,EAAE,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AACD,iCAAiC;AACjC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAExB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;AAE5C,SAAS,iBAAiB,CAAC,UAAU,GAAG,IAAI;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CACX,gBAAgB,UAAU,4CAA4C,OAAO,EAAE,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AACD,iCAAiC;AACjC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAExB,MAAM,aAAa,GAAG,0BAA0B,CAAC;IAC/C,2BAA2B,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B;IACpE,2BAA2B,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B;IACpE,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;CACjD,CAAC,CAAC;AAEH,KAAK,UAAU,QAAQ;IACrB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,qEAAqE;IACrE,2EAA2E;IAC3E,MAAM,OAAO,CAAC,IAAI,CAAC;QACjB,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QAChD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;KAC3D,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,iFAAiF;AACjF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,gBAAgB,CAAC,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/metrics.d.ts

@@ -0,0 +1,7 @@
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+export declare function createMeterProviderFromEnv(env: {
+    OTEL_EXPORTER_OTLP_ENDPOINT?: string;
+    OTEL_METRIC_EXPORT_INTERVAL?: string;
+    OTEL_SERVICE_NAME?: string;
+}): MeterProvider | undefined;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/src/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EAEd,MAAM,4BAA4B,CAAC;AAKpC,wBAAgB,0BAA0B,CAAC,GAAG,EAAE;IAC9C,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,aAAa,GAAG,SAAS,CA8B5B"}

package/dist/src/metrics.js

@@ -0,0 +1,34 @@
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { Resource } from "@opentelemetry/resources";
+import { MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
+import { childLogger } from "document-drive";
+const logger = childLogger(["switchboard", "metrics"]);
+export function createMeterProviderFromEnv(env) {
+    const endpoint = env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint)
+        return undefined;
+    const parsed = parseInt(env.OTEL_METRIC_EXPORT_INTERVAL ?? "", 10);
+    const exportIntervalMillis = Number.isFinite(parsed) && parsed > 0 ? parsed : 5_000;
+    const base = endpoint.replace(/\/$/, "");
+    const exporterUrl = base.endsWith("/v1/metrics")
+        ? base
+        : `${base}/v1/metrics`;
+    logger.info(`Initializing OpenTelemetry metrics exporter at: ${endpoint}`);
+    const meterProvider = new MeterProvider({
+        resource: new Resource({
+            "service.name": env.OTEL_SERVICE_NAME ?? "switchboard",
+        }),
+        readers: [
+            new PeriodicExportingMetricReader({
+                exporter: new OTLPMetricExporter({
+                    url: exporterUrl,
+                }),
+                exportIntervalMillis,
+                exportTimeoutMillis: Math.max(exportIntervalMillis - 250, 1),
+            }),
+        ],
+    });
+    logger.info(`Metrics export enabled (interval: ${exportIntervalMillis}ms)`);
+    return meterProvider;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/src/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EACL,aAAa,EACb,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAEvD,MAAM,UAAU,0BAA0B,CAAC,GAI1C;IACC,MAAM,QAAQ,GAAG,GAAG,CAAC,2BAA2B,CAAC;IACjD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,oBAAoB,GACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IAEzD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC9C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,IAAI,aAAa,CAAC;IAEzB,MAAM,CAAC,IAAI,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC;QACtC,QAAQ,EAAE,IAAI,QAAQ,CAAC;YACrB,cAAc,EAAE,GAAG,CAAC,iBAAiB,IAAI,aAAa;SACvD,CAAC;QACF,OAAO,EAAE;YACP,IAAI,6BAA6B,CAAC;gBAChC,QAAQ,EAAE,IAAI,kBAAkB,CAAC;oBAC/B,GAAG,EAAE,WAAW;iBACjB,CAAC;gBACF,oBAAoB;gBACpB,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,GAAG,EAAE,CAAC,CAAC;aAC7D,CAAC;SACH;KACF,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,qCAAqC,oBAAoB,KAAK,CAAC,CAAC;IAC5E,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/src/profiler.d.ts

@@ -1,4 +1,9 @@
 import type { PyroscopeConfig } from "@pyroscope/nodejs";
 export declare function initProfilerFromEnv(env: typeof process.env): Promise<void>;
-export declare function initProfiler(options?: PyroscopeConfig): Promise<void>;
+interface ProfilerFlags {
+    wallEnabled?: boolean;
+    heapEnabled?: boolean;
+}
+export declare function initProfiler(options?: PyroscopeConfig, flags?: ProfilerFlags): Promise<void>;
+export {};
 //# sourceMappingURL=profiler.d.ts.map

package/dist/src/profiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,iBAehE;AAED,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,eAAe,iBAK3D"}
+{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,iBAgChE;AAED,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,eAAe,EACzB,KAAK,GAAE,aAAyD,iBAqBjE"}

package/dist/src/profiler.js

@@ -1,17 +1,43 @@
 export async function initProfilerFromEnv(env) {
-    const { PYROSCOPE_SERVER_ADDRESS: serverAddress, PYROSCOPE_APPLICATION_NAME: appName, PYROSCOPE_USER: basicAuthUser, PYROSCOPE_PASSWORD: basicAuthPassword, } = env;
+    const { PYROSCOPE_SERVER_ADDRESS: serverAddress, PYROSCOPE_APPLICATION_NAME: appName, PYROSCOPE_USER: basicAuthUser, PYROSCOPE_PASSWORD: basicAuthPassword, PYROSCOPE_WALL_ENABLED: wallEnabled, PYROSCOPE_HEAP_ENABLED: heapEnabled, } = env;
     const options = {
         serverAddress,
         appName,
         basicAuthUser,
         basicAuthPassword,
+        // Wall profiling captures wall-clock time (includes async I/O waits)
+        // This shows GraphQL resolvers even when waiting for database
+        wall: {
+            samplingDurationMs: 10000, // 10 second sampling windows
+            samplingIntervalMicros: 10000, // 10ms sampling interval (100 samples/sec)
+            collectCpuTime: true, // Also collect CPU time alongside wall time
+        },
+        // Heap profiling for memory allocation tracking
+        heap: {
+            samplingIntervalBytes: 512 * 1024, // Sample every 512KB allocated
+            stackDepth: 64, // Capture deeper stacks for better context
+        },
     };
-    return initProfiler(options);
+    return initProfiler(options, {
+        wallEnabled: wallEnabled !== "false",
+        heapEnabled: heapEnabled === "true",
+    });
 }
-export async function initProfiler(options) {
+export async function initProfiler(options, flags = { wallEnabled: true, heapEnabled: false }) {
     console.log("Initializing Pyroscope profiler at:", options?.serverAddress);
-    const Pyroscope = await import("@pyroscope/nodejs");
+    console.log("  Wall profiling:", flags.wallEnabled ? "enabled" : "disabled");
+    console.log("  Heap profiling:", flags.heapEnabled ? "enabled" : "disabled");
+    const { default: Pyroscope } = await import("@pyroscope/nodejs");
     Pyroscope.init(options);
-    Pyroscope.start();
+    // Start wall profiling (captures async I/O time - shows resolvers)
+    if (flags.wallEnabled) {
+        Pyroscope.startWallProfiling();
+    }
+    // Start CPU profiling (captures CPU-bound work)
+    Pyroscope.startCpuProfiling();
+    // Optionally start heap profiling (memory allocations)
+    if (flags.heapEnabled) {
+        Pyroscope.startHeapProfiling();
+    }
 }
 //# sourceMappingURL=profiler.js.map

package/dist/src/profiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.js","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAuB;IAC/D,MAAM,EACJ,wBAAwB,EAAE,aAAa,EACvC,0BAA0B,EAAE,OAAO,EACnC,cAAc,EAAE,aAAa,EAC7B,kBAAkB,EAAE,iBAAiB,GACtC,GAAG,GAAG,CAAC;IAER,MAAM,OAAO,GAAoB;QAC/B,aAAa;QACb,OAAO;QACP,aAAa;QACb,iBAAiB;KAClB,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACpD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}
+{"version":3,"file":"profiler.js","sourceRoot":"","sources":["../../src/profiler.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAuB;IAC/D,MAAM,EACJ,wBAAwB,EAAE,aAAa,EACvC,0BAA0B,EAAE,OAAO,EACnC,cAAc,EAAE,aAAa,EAC7B,kBAAkB,EAAE,iBAAiB,EACrC,sBAAsB,EAAE,WAAW,EACnC,sBAAsB,EAAE,WAAW,GACpC,GAAG,GAAG,CAAC;IAER,MAAM,OAAO,GAAoB;QAC/B,aAAa;QACb,OAAO;QACP,aAAa;QACb,iBAAiB;QACjB,qEAAqE;QACrE,8DAA8D;QAC9D,IAAI,EAAE;YACJ,kBAAkB,EAAE,KAAK,EAAE,6BAA6B;YACxD,sBAAsB,EAAE,KAAK,EAAE,2CAA2C;YAC1E,cAAc,EAAE,IAAI,EAAE,4CAA4C;SACnE;QACD,gDAAgD;QAChD,IAAI,EAAE;YACJ,qBAAqB,EAAE,GAAG,GAAG,IAAI,EAAE,+BAA+B;YAClE,UAAU,EAAE,EAAE,EAAE,2CAA2C;SAC5D;KACF,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,EAAE;QAC3B,WAAW,EAAE,WAAW,KAAK,OAAO;QACpC,WAAW,EAAE,WAAW,KAAK,MAAM;KACpC,CAAC,CAAC;AACL,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAyB,EACzB,QAAuB,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;IAEhE,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE7E,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACjE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAExB,mEAAmE;IACnE,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACjC,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAE9B,uDAAuD;IACvD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/src/renown.d.ts

@@ -0,0 +1,16 @@
+import { type IRenown } from "@renown/sdk/node";
+export interface RenownOptions {
+    /** Path to the keypair file. Defaults to .ph/.keypair.json in cwd */
+    keypairPath?: string;
+    /** If true, won't generate a new keypair if none exists */
+    requireExisting?: boolean;
+    /** Base url of the Renown instance to use */
+    baseUrl?: string;
+}
+/**
+ * Initialize Renown for the Switchboard instance.
+ * This allows Switchboard to authenticate with remote services
+ * using the same identity established during `ph login`.
+ */
+export declare function initRenown(options?: RenownOptions): Promise<IRenown | null>;
+//# sourceMappingURL=renown.d.ts.map

package/dist/src/renown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renown.d.ts","sourceRoot":"","sources":["../../src/renown.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAqCzB"}

package/dist/src/renown.js

@@ -0,0 +1,33 @@
+import { childLogger } from "document-drive";
+import { DEFAULT_RENOWN_URL, NodeKeyStorage, RenownBuilder, RenownCryptoBuilder, } from "@renown/sdk/node";
+const logger = childLogger(["switchboard", "renown"]);
+/**
+ * Initialize Renown for the Switchboard instance.
+ * This allows Switchboard to authenticate with remote services
+ * using the same identity established during `ph login`.
+ */
+export async function initRenown(options = {}) {
+    const { keypairPath, requireExisting = false, baseUrl = DEFAULT_RENOWN_URL, } = options;
+    const keyStorage = new NodeKeyStorage(keypairPath, {
+        logger,
+    });
+    // Check if we have an existing keypair
+    const existingKeyPair = await keyStorage.loadKeyPair();
+    if (!existingKeyPair && requireExisting) {
+        throw new Error("No existing keypair found and requireExisting is true. " +
+            'Run "ph login" to create one.');
+    }
+    if (!existingKeyPair) {
+        logger.info("No existing keypair found. A new one will be generated.");
+    }
+    const renownCrypto = await new RenownCryptoBuilder()
+        .withKeyPairStorage(keyStorage)
+        .build();
+    const renown = await new RenownBuilder("switchboard", {})
+        .withCrypto(renownCrypto)
+        .withBaseUrl(baseUrl)
+        .build();
+    logger.info("Switchboard identity initialized: @did", renownCrypto.did);
+    return renown;
+}
+//# sourceMappingURL=renown.js.map

package/dist/src/renown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renown.js","sourceRoot":"","sources":["../../src/renown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,mBAAmB,GAEpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAWtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAyB,EAAE;IAE3B,MAAM,EACJ,WAAW,EACX,eAAe,GAAG,KAAK,EACvB,OAAO,GAAG,kBAAkB,GAC7B,GAAG,OAAO,CAAC;IAEZ,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,WAAW,EAAE;QACjD,MAAM;KACP,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC;IAEvD,IAAI,CAAC,eAAe,IAAI,eAAe,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,yDAAyD;YACvD,+BAA+B,CAClC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,IAAI,mBAAmB,EAAE;SACjD,kBAAkB,CAAC,UAAU,CAAC;SAC9B,KAAK,EAAE,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,EAAE,CAAC;SACtD,UAAU,CAAC,YAAY,CAAC;SACxB,WAAW,CAAC,OAAO,CAAC;SACpB,KAAK,EAAE,CAAC;IAEX,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAExE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/server.d.ts

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import type { StartServerOptions, SwitchboardReactor } from "./types.js";
 export declare const startSwitchboard: (options?: StartServerOptions) => Promise<SwitchboardReactor>;
-export { getBearerToken, getConnectCrypto, getConnectDid, } from "./connect-crypto.js";
 export * from "./types.js";
 //# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";AA2CA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAiSzE,eAAO,MAAM,gBAAgB,GAC3B,UAAS,kBAAuB,KAC/B,OAAO,CAAC,kBAAkB,CAiE5B,CAAC;AAEF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";AAsDA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwYzE,eAAO,MAAM,gBAAgB,GAC3B,UAAS,kBAAuB,KAC/B,OAAO,CAAC,kBAAkB,CAiE5B,CAAC;AAEF,cAAc,YAAY,CAAC"}

package/dist/src/server.js

@@ -1,8 +1,14 @@
 #!/usr/bin/env node
+import { httpsHooksPath } from "@powerhousedao/reactor-api";
+import { register } from "node:module";
+// Register HTTP/HTTPS module loader hooks for dynamic package imports
+register(httpsHooksPath, import.meta.url);
 import { PGlite } from "@electric-sql/pglite";
-import { CompositeChannelFactory, ConsoleLogger, EventBus, ReactorBuilder, ReactorClientBuilder, SyncBuilder, } from "@powerhousedao/reactor";
-import { VitePackageLoader, getUniqueDocumentModels, initializeAndStartAPI, startViteServer, } from "@powerhousedao/reactor-api";
-import { ConnectCryptoSigner } from "@renown/sdk";
+import { ReactorInstrumentation } from "@powerhousedao/opentelemetry-instrumentation-reactor";
+import { ChannelScheme, EventBus, ReactorBuilder, ReactorClientBuilder, driveCollectionId, parseDriveUrl, } from "@powerhousedao/reactor";
+import { metrics } from "@opentelemetry/api";
+import { HttpPackageLoader, PackageManagementService, PackagesSubgraph, VitePackageLoader, createViteLogger, getUniqueDocumentModels, initializeAndStartAPI, startViteServer, } from "@powerhousedao/reactor-api";
+import {} from "@renown/sdk";
 import * as Sentry from "@sentry/node";
 import { DocumentAlreadyExistsError, InMemoryCache, ReactorBuilder as LegacyReactorBuilder, childLogger, driveDocumentModelModule, } from "document-drive";
 import { RedisCache } from "document-drive/cache/redis";
@@ -16,11 +22,10 @@ import { PGliteDialect } from "kysely-pglite-dialect";
 import path from "path";
 import { Pool } from "pg";
 import { initRedis } from "./clients/redis.js";
-import { initConnectCrypto } from "./connect-crypto.js";
 import { initFeatureFlags } from "./feature-flags.js";
-import { initProfilerFromEnv } from "./profiler.js";
+import { initRenown } from "./renown.js";
 import { addDefaultDrive, addRemoteDrive, isPostgresUrl } from "./utils.js";
-const logger = childLogger(["switchboard"]);
+const defaultLogger = childLogger(["switchboard"]);
 dotenv.config();
 // Feature flag constants
 const DOCUMENT_MODEL_SUBGRAPHS_ENABLED = "DOCUMENT_MODEL_SUBGRAPHS_ENABLED";
@@ -32,7 +37,7 @@ const ENABLE_DUAL_ACTION_CREATE_DEFAULT = true;
 // Create a monolith express app for all subgraphs
 const app = express();
 if (process.env.SENTRY_DSN) {
-    logger.info("Initialized Sentry with env:", process.env.SENTRY_ENV);
+    defaultLogger.info("Initialized Sentry with env: @env", process.env.SENTRY_ENV);
     Sentry.init({
         dsn: process.env.SENTRY_DSN,
         environment: process.env.SENTRY_ENV,
@@ -51,10 +56,10 @@ async function initPrismaStorage(connectionString, cache) {
         if (e instanceof Error && e.message.includes(prismaConnectError)) {
             const dbUrl = connectionString;
             const safeUrl = `${dbUrl.slice(0, dbUrl.indexOf(":") + 1)}{...}${dbUrl.slice(dbUrl.indexOf("@"), dbUrl.lastIndexOf("?"))}`;
-            logger.warn(`Can't reach database server at '${safeUrl}'`);
+            defaultLogger.warn("Can't reach database server at '@safeUrl'", safeUrl);
         }
         else {
-            logger.error(e);
+            defaultLogger.error("@error", e);
         }
         throw e;
     }
@@ -71,7 +76,7 @@ async function initReactorStorage(cache, dbPath = "./.ph/drive-storage") {
         }
     }
     catch {
-        logger.warn("Falling back to filesystem storage");
+        defaultLogger.warn("Falling back to filesystem storage");
     }
     // if url was postgres and connection failed, fallback to filesystem on default path
     const filesystemPath = isPostgres ? "./.ph/drive-storage" : dbPath;
@@ -80,8 +85,15 @@ async function initReactorStorage(cache, dbPath = "./.ph/drive-storage") {
         storagePath: filesystemPath,
     };
 }
-async function initServer(serverPort, options, connectCrypto) {
-    const { dev, packages = [], remoteDrives = [] } = options;
+async function initServer(serverPort, options, renown) {
+    // Register the global MeterProvider before ReactorInstrumentation is
+    // constructed. setGlobalMeterProvider is a one-way door — once set it cannot
+    // be unset — so this must happen before initializeClient calls
+    // instrumentation.start() → createMetrics() → metrics.getMeter().
+    if (options.meterProvider) {
+        metrics.setGlobalMeterProvider(options.meterProvider);
+    }
+    const { dev, packages = [], remoteDrives = [], logger = defaultLogger, } = options;
     const dbPath = options.dbPath ?? process.env.DATABASE_URL;
     // start redis if configured
     const redisUrl = process.env.REDIS_TLS_URL ?? process.env.REDIS_URL;
@@ -91,7 +103,7 @@ async function initServer(serverPort, options, connectCrypto) {
             redis = await initRedis(redisUrl);
         }
         catch (e) {
-            logger.error(e);
+            logger.error("@error", e);
         }
     }
     const cache = redis ? new RedisCache(redis) : new InMemoryCache();
@@ -101,11 +113,25 @@ async function initServer(serverPort, options, connectCrypto) {
     const readModelPath = !dbPath || (isPostgresUrl(dbPath) && dbPath !== storagePath)
         ? ".ph/read-storage"
         : dbPath;
+    // HTTP registry package loading
+    let httpDocumentModels = [];
+    const registryUrl = process.env.PH_REGISTRY_URL;
+    const registryPackages = process.env.PH_REGISTRY_PACKAGES;
+    let httpLoader;
+    if (registryUrl) {
+        httpLoader = new HttpPackageLoader({ registryUrl });
+    }
+    if (httpLoader && registryPackages) {
+        const packageNames = registryPackages.split(",").map((p) => p.trim());
+        httpDocumentModels = await httpLoader.loadPackages(packageNames, logger);
+        logger.info(`Loaded ${httpDocumentModels.length} HTTP document models from ${packageNames.length} packages`);
+    }
     const initializeDriveServer = async (documentModels) => {
         const driveServer = new LegacyReactorBuilder(getUniqueDocumentModels([
             documentModelDocumentModelModule,
             driveDocumentModelModule,
             ...documentModels,
+            ...httpDocumentModels,
         ]))
             .withStorage(storage)
             .withCache(cache)
@@ -119,6 +145,7 @@ async function initServer(serverPort, options, connectCrypto) {
         await driveServer.initialize();
         return driveServer;
     };
+    const reactorLogger = logger.child(["reactor"]);
     const initializeClient = async (driveServer, documentModels) => {
         const eventBus = new EventBus();
         const builder = new ReactorBuilder()
@@ -127,12 +154,16 @@ async function initServer(serverPort, options, connectCrypto) {
             documentModelDocumentModelModule,
             driveDocumentModelModule,
             ...documentModels,
+            ...httpDocumentModels,
         ]))
-            .withLegacyStorage(storage)
-            .withSync(new SyncBuilder().withChannelFactory(new CompositeChannelFactory(new ConsoleLogger(["switchboard"]))))
-            .withFeatures({
-            legacyStorageEnabled: !options.reactorOptions?.storageV2,
-        });
+            .withChannelScheme(ChannelScheme.SWITCHBOARD)
+            .withSignalHandlers()
+            .withLogger(reactorLogger);
+        const maxSkipThreshold = parseInt(process.env.MAX_SKIP_THRESHOLD ?? "", 10);
+        if (!isNaN(maxSkipThreshold) && maxSkipThreshold > 0) {
+            builder.withExecutorConfig({ maxSkipThreshold });
+            logger.info(`Reactor maxSkipThreshold set to ${maxSkipThreshold}`);
+        }
         const reactorDbUrl = process.env.PH_REACTOR_DATABASE_URL;
         if (reactorDbUrl && isPostgresUrl(reactorDbUrl)) {
             const connectionString = reactorDbUrl.includes("?")
@@ -154,29 +185,40 @@ async function initServer(serverPort, options, connectCrypto) {
             builder.withKysely(kysely);
             logger.info("Using PGlite for reactor storage");
         }
+        if (httpLoader) {
+            builder.withDocumentModelLoader(httpLoader);
+        }
         const clientBuilder = new ReactorClientBuilder().withReactorBuilder(builder);
-        if (connectCrypto) {
-            clientBuilder.withSigner(new ConnectCryptoSigner(connectCrypto));
+        if (renown) {
+            clientBuilder.withSigner(renown.signer);
         }
         const module = await clientBuilder.buildModule();
-        const syncManager = module.reactorModule?.syncModule?.syncManager;
-        if (!syncManager) {
-            throw new Error("SyncManager not available from ReactorClientBuilder");
+        if (module.reactorModule) {
+            const instrumentation = new ReactorInstrumentation(module.reactorModule);
+            instrumentation.start();
+            reactorLogger.info("Reactor metrics instrumentation started");
         }
-        return { client: module.client, syncManager };
+        return module;
     };
     let defaultDriveUrl = undefined;
     // TODO get path from powerhouse config
     // start vite server if dev mode is enabled
     const basePath = process.cwd();
-    const vite = dev ? await startViteServer(process.cwd()) : undefined;
+    const viteLogger = createViteLogger(logger);
+    const vite = dev
+        ? await startViteServer(process.cwd(), viteLogger)
+        : undefined;
     // get paths to local document models
     if (!options.disableLocalPackages) {
         packages.push(basePath);
     }
-    // create loader
-    const packageLoader = vite ? VitePackageLoader.build(vite) : undefined;
-    // Start the API with the reactor and options
+    // storageV2=true means use new reactor (NOT legacy)
+    const legacyReactor = !options.reactorOptions?.storageV2;
+    // create loader with legacyReactor option
+    const packageLoader = vite
+        ? VitePackageLoader.build(vite, { legacyReactor })
+        : undefined;
+    const apiLogger = logger.child(["reactor-api"]);
     const api = await initializeAndStartAPI(initializeDriveServer, initializeClient, {
         express: app,
         port: serverPort,
@@ -188,13 +230,41 @@ async function initServer(serverPort, options, connectCrypto) {
         configFile: options.configFile ??
             path.join(process.cwd(), "powerhouse.config.json"),
         mcp: options.mcp ?? true,
+        logger: apiLogger,
         enableDocumentModelSubgraphs: options.enableDocumentModelSubgraphs,
-    });
-    const { client, driveServer } = api;
+        legacyReactor,
+    }, "switchboard");
+    const { client, driveServer, graphqlManager, documentModelRegistry } = api;
+    // Wire up dynamic package management if HTTP loader is configured
+    if (httpLoader) {
+        const packageManagementService = new PackageManagementService({
+            defaultRegistryUrl: registryUrl,
+            httpLoader,
+            documentModelRegistry,
+        });
+        packageManagementService.setOnModelsChanged(async () => {
+            await graphqlManager.regenerateDocumentModelSubgraphs();
+        });
+        const packagesSubgraph = new PackagesSubgraph({
+            relationalDb: undefined,
+            analyticsStore: undefined,
+            reactorClient: client,
+            graphqlManager,
+            syncManager: api.syncManager,
+            path: graphqlManager.getBasePath(),
+            packageManagementService,
+        });
+        void graphqlManager
+            .registerSubgraphInstance(packagesSubgraph, "graphql", false)
+            .then(() => graphqlManager.updateRouter())
+            .catch((error) => {
+            logger.error("Failed to register packages subgraph: @error", error);
+        });
+    }
     // Create default drive if provided
     if (options.drive) {
-        if (!connectCrypto) {
-            throw new Error("Cannot create default drive without ConnectCrypto identity");
+        if (!renown) {
+            throw new Error("Cannot create default drive without Renown identity");
         }
         defaultDriveUrl = await addDefaultDrive(driveServer, client, options.drive, serverPort);
     }
@@ -207,17 +277,31 @@ async function initServer(serverPort, options, connectCrypto) {
         for (const remoteDriveUrl of remoteDrives) {
             let driveId;
             try {
-                const remoteDrive = await addRemoteDrive(driveServer, remoteDriveUrl);
-                driveId = remoteDrive.header.id;
-                logger.debug(`Remote drive ${remoteDriveUrl} synced`);
+                if (legacyReactor) {
+                    // Use legacy reactor's addRemoteDrive
+                    const remoteDrive = await addRemoteDrive(driveServer, remoteDriveUrl);
+                    driveId = remoteDrive.header.id;
+                }
+                else {
+                    // Use new reactor's sync manager
+                    const { syncManager } = api;
+                    const parsed = parseDriveUrl(remoteDriveUrl);
+                    driveId = parsed.driveId;
+                    const remoteName = `remote-drive-${driveId}-${crypto.randomUUID()}`;
+                    await syncManager.add(remoteName, driveCollectionId("main", driveId), {
+                        type: "gql",
+                        parameters: { url: parsed.graphqlEndpoint },
+                    });
+                }
+                logger.debug("Remote drive @remoteDriveUrl synced", remoteDriveUrl);
             }
             catch (error) {
                 if (error instanceof DocumentAlreadyExistsError) {
-                    logger.debug(`Remote drive already added: ${remoteDriveUrl}`);
+                    logger.debug("Remote drive already added: @remoteDriveUrl", remoteDriveUrl);
                     driveId = remoteDriveUrl.split("/").pop();
                 }
                 else {
-                    logger.error(`Failed to connect to remote drive ${remoteDriveUrl}:`, error);
+                    logger.error("Failed to connect to remote drive @remoteDriveUrl: @error", remoteDriveUrl, error);
                 }
             }
             finally {
@@ -232,8 +316,9 @@ async function initServer(serverPort, options, connectCrypto) {
     return {
         defaultDriveUrl,
         api,
-        reactor: driveServer,
-        connectCrypto,
+        reactor: client,
+        legacyReactor: driveServer,
+        renown,
     };
 }
 export const startSwitchboard = async (options = {}) => {
@@ -250,40 +335,34 @@ export const startSwitchboard = async (options = {}) => {
         enableDualActionCreate,
         storageV2,
     };
-    logger.info("Feature flags:", {
+    const logger = options.logger ?? defaultLogger;
+    logger.info("Feature flags: @flags", JSON.stringify({
         DOCUMENT_MODEL_SUBGRAPHS_ENABLED: enableDocumentModelSubgraphs,
         REACTOR_STORAGE_V2: storageV2,
         ENABLE_DUAL_ACTION_CREATE: enableDualActionCreate,
-    });
-    if (process.env.PYROSCOPE_SERVER_ADDRESS) {
-        try {
-            await initProfilerFromEnv(process.env);
-        }
-        catch (e) {
-            Sentry.captureException(e);
-            logger.error("Error starting profiler", e);
-        }
-    }
-    // Initialize ConnectCrypto if identity options are provided or keypair exists
-    let connectCrypto = null;
+    }, null, 2));
+    // Initialize Renown if identity options are provided or keypair exists
+    let renown = null;
     try {
-        connectCrypto = await initConnectCrypto(options.identity);
+        renown = await initRenown(options.identity);
     }
     catch (e) {
-        logger.warn("Failed to initialize ConnectCrypto:", e);
+        logger.warn("Failed to initialize ConnectCrypto: @error", e);
         if (options.identity?.requireExisting) {
             throw new Error('Identity required but failed to initialize. Run "ph login" first.');
         }
     }
     try {
-        return await initServer(serverPort, options, connectCrypto);
+        return await initServer(serverPort, options, renown);
     }
     catch (e) {
         Sentry.captureException(e);
-        logger.error("App crashed", e);
+        logger.error("App crashed: @error", e);
         throw e;
     }
 };
-export { getBearerToken, getConnectCrypto, getConnectDid, } from "./connect-crypto.js";
 export * from "./types.js";
+if (import.meta.main) {
+    await startSwitchboard();
+}
 //# sourceMappingURL=server.js.map