@superblocksteam/sdk 2.0.83 → 2.0.84-next.0

package/dist/telemetry/index.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach, } from "vitest";
+// Set environment variables before any imports
+process.env.OTEL_SDK_DISABLED = "true";
+process.env.SUPERBLOCKS_DEPLOYMENT_TYPE = "";
+// Mock dd-trace before importing the module under test
+vi.mock("dd-trace", () => ({
+    default: {
+        init: vi.fn(),
+        llmobs: { enabled: false },
+    },
+}));
+// Mock getConfiguration to avoid needing real credentials
+vi.mock("./util.js", () => ({
+    SERVICE_NAME: "sdk-dev-server",
+    getConfiguration: vi.fn().mockResolvedValue({
+        superblocksBaseUrl: new URL("https://app.superblocks.com"),
+        otlpBaseUrl: "https://app.superblocks.com/api",
+        superblocksHostname: "app.superblocks.com",
+        serviceName: "sdk-dev-server",
+        token: "test1234",
+    }),
+}));
+// Mock the logging module
+vi.mock("./logging.js", () => ({
+    getLogger: vi.fn().mockReturnValue({
+        info: vi.fn(),
+        debug: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    }),
+}));
+describe("CLI SDK Telemetry Integration", () => {
+    let telemetryModule;
+    beforeAll(async () => {
+        // Dynamic import after mocks are set up
+        telemetryModule = await import("./index.js");
+    });
+    afterAll(async () => {
+        // Clean up telemetry
+        const { resetTelemetry, isTelemetryInitialized, getTelemetryInstance } = await import("@superblocksteam/telemetry");
+        if (isTelemetryInitialized()) {
+            await getTelemetryInstance().shutdown();
+            resetTelemetry();
+        }
+    });
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe("configureTelemetry", () => {
+        it("successfully initializes telemetry", async () => {
+            const { isTelemetryInitialized } = await import("@superblocksteam/telemetry");
+            await telemetryModule.configureTelemetry();
+            expect(isTelemetryInitialized()).toBe(true);
+        });
+        it("initializes dd-trace for LLMObs", async () => {
+            const ddTrace = await import("dd-trace");
+            await telemetryModule.configureTelemetry();
+            expect(ddTrace.default.init).toHaveBeenCalled();
+        });
+    });
+    describe("getTracer", () => {
+        it("returns working tracer after initialization", async () => {
+            await telemetryModule.configureTelemetry();
+            const tracer = telemetryModule.getTracer();
+            expect(tracer).toBeDefined();
+            expect(typeof tracer.startSpan).toBe("function");
+        });
+        it("can create spans", async () => {
+            await telemetryModule.configureTelemetry();
+            const tracer = telemetryModule.getTracer();
+            const span = tracer.startSpan("test-span");
+            expect(span).toBeDefined();
+            span.end();
+        });
+    });
+    describe("getLogger", () => {
+        it("returns working logger after initialization", async () => {
+            await telemetryModule.configureTelemetry();
+            const logger = telemetryModule.getLogger();
+            expect(logger).toBeDefined();
+            expect(typeof logger.emit).toBe("function");
+        });
+    });
+    describe("deploymentType", () => {
+        it("exports deploymentType constant", () => {
+            expect(telemetryModule.deploymentType).toBeDefined();
+        });
+        it("exports isCloudPrem constant", () => {
+            expect(typeof telemetryModule.isCloudPrem).toBe("boolean");
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/telemetry/index.test.js.map

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

package/dist/telemetry/local-obs.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Local Observability Configuration
+ *
+ * Provides a single toggle (SUPERBLOCKS_LOCAL_OBS=true) that auto-configures
+ * all environment variables needed for local observability testing with the
+ * LGTM stack (Loki, Grafana, Tempo, Mimir).
+ *
+ * This eliminates the need to manually set 9+ environment variables:
+ * - SUPERBLOCKS_DEPLOYMENT_TYPE
+ * - SUPERBLOCKS_LLMOBS_ENABLED
+ * - OTEL_EXPORTER_OTLP_ENDPOINT
+ * - SUPERBLOCKS_OTEL_COLLECTOR_URL
+ * - DD_LLMOBS_ENABLED
+ * - DD_LLMOBS_ML_APP
+ * - DD_LLMOBS_AGENTLESS_ENABLED
+ * - DD_SITE
+ * - DD_API_KEY
+ *
+ * Usage:
+ *   SUPERBLOCKS_LOCAL_OBS=true pnpm start:all
+ *
+ * Or with custom OTEL endpoint:
+ *   SUPERBLOCKS_LOCAL_OBS=true OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 pnpm start:all
+ */
+import { DeploymentTypeEnum } from "@superblocksteam/shared";
+export interface LocalObsConfig {
+    /** Whether local observability mode is enabled */
+    enabled: boolean;
+    /** OTEL endpoint for traces, metrics, logs */
+    otelEndpoint: string;
+    /** Deployment type (cloud-prem for local obs) */
+    deploymentType: DeploymentTypeEnum.CLOUD_PREM;
+    /** LLMObs configuration */
+    llmobs: {
+        enabled: true;
+        mlApp: string;
+        agentlessEnabled: true;
+    };
+    /** Datadog configuration for dd-trace */
+    datadog: {
+        site: string;
+        apiKey: string;
+    };
+}
+/**
+ * Checks if local observability mode is enabled.
+ *
+ * Returns true if:
+ * - SUPERBLOCKS_LOCAL_OBS=true (primary toggle)
+ * - OR all required env vars are manually configured (legacy mode)
+ */
+export declare function isLocalObsEnabled(): boolean;
+/**
+ * Gets the local observability configuration.
+ *
+ * When SUPERBLOCKS_LOCAL_OBS=true, this returns a complete configuration
+ * with sensible defaults for local development. Individual values can still
+ * be overridden via environment variables.
+ *
+ * @returns LocalObsConfig if local obs is enabled, null otherwise
+ */
+export declare function getLocalObsConfig(): LocalObsConfig | null;
+/**
+ * Applies local observability configuration to process.env.
+ *
+ * This ensures that all downstream code that reads env vars directly
+ * (like dd-trace auto-initialization) gets the correct values.
+ *
+ * Should be called early in the application lifecycle, before any
+ * telemetry initialization occurs.
+ */
+export declare function applyLocalObsEnvVars(): void;
+//# sourceMappingURL=local-obs.d.ts.map

package/dist/telemetry/local-obs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-obs.d.ts","sourceRoot":"","sources":["../../src/telemetry/local-obs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAK7D,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,cAAc,EAAE,kBAAkB,CAAC,UAAU,CAAC;IAC9C,2BAA2B;IAC3B,MAAM,EAAE;QACN,OAAO,EAAE,IAAI,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,IAAI,CAAC;KACxB,CAAC;IACF,yCAAyC;IACzC,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAa3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAqBzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAwB3C"}

package/dist/telemetry/local-obs.js

@@ -0,0 +1,107 @@
+/**
+ * Local Observability Configuration
+ *
+ * Provides a single toggle (SUPERBLOCKS_LOCAL_OBS=true) that auto-configures
+ * all environment variables needed for local observability testing with the
+ * LGTM stack (Loki, Grafana, Tempo, Mimir).
+ *
+ * This eliminates the need to manually set 9+ environment variables:
+ * - SUPERBLOCKS_DEPLOYMENT_TYPE
+ * - SUPERBLOCKS_LLMOBS_ENABLED
+ * - OTEL_EXPORTER_OTLP_ENDPOINT
+ * - SUPERBLOCKS_OTEL_COLLECTOR_URL
+ * - DD_LLMOBS_ENABLED
+ * - DD_LLMOBS_ML_APP
+ * - DD_LLMOBS_AGENTLESS_ENABLED
+ * - DD_SITE
+ * - DD_API_KEY
+ *
+ * Usage:
+ *   SUPERBLOCKS_LOCAL_OBS=true pnpm start:all
+ *
+ * Or with custom OTEL endpoint:
+ *   SUPERBLOCKS_LOCAL_OBS=true OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 pnpm start:all
+ */
+import { DeploymentTypeEnum } from "@superblocksteam/shared";
+const DEFAULT_LOCAL_OTEL_ENDPOINT = "http://localhost:24318";
+const DEFAULT_ML_APP_NAME = "superblocks-ai-code-gen";
+/**
+ * Checks if local observability mode is enabled.
+ *
+ * Returns true if:
+ * - SUPERBLOCKS_LOCAL_OBS=true (primary toggle)
+ * - OR all required env vars are manually configured (legacy mode)
+ */
+export function isLocalObsEnabled() {
+    // Primary toggle
+    if (process.env.SUPERBLOCKS_LOCAL_OBS === "true") {
+        return true;
+    }
+    // Legacy mode: all env vars manually configured
+    const hasLegacyConfig = process.env.SUPERBLOCKS_DEPLOYMENT_TYPE === DeploymentTypeEnum.CLOUD_PREM &&
+        process.env.SUPERBLOCKS_LLMOBS_ENABLED === "true" &&
+        !!process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    return hasLegacyConfig;
+}
+/**
+ * Gets the local observability configuration.
+ *
+ * When SUPERBLOCKS_LOCAL_OBS=true, this returns a complete configuration
+ * with sensible defaults for local development. Individual values can still
+ * be overridden via environment variables.
+ *
+ * @returns LocalObsConfig if local obs is enabled, null otherwise
+ */
+export function getLocalObsConfig() {
+    if (!isLocalObsEnabled()) {
+        return null;
+    }
+    return {
+        enabled: true,
+        otelEndpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || DEFAULT_LOCAL_OTEL_ENDPOINT,
+        deploymentType: DeploymentTypeEnum.CLOUD_PREM,
+        llmobs: {
+            enabled: true,
+            mlApp: process.env.DD_LLMOBS_ML_APP || DEFAULT_ML_APP_NAME,
+            agentlessEnabled: true,
+        },
+        datadog: {
+            site: process.env.DD_SITE || "datadoghq.com",
+            // Dummy key for agentless mode - not used when exporting to local OTEL
+            apiKey: process.env.DD_API_KEY || "local-dev-dummy-key",
+        },
+    };
+}
+/**
+ * Applies local observability configuration to process.env.
+ *
+ * This ensures that all downstream code that reads env vars directly
+ * (like dd-trace auto-initialization) gets the correct values.
+ *
+ * Should be called early in the application lifecycle, before any
+ * telemetry initialization occurs.
+ */
+export function applyLocalObsEnvVars() {
+    const config = getLocalObsConfig();
+    if (!config) {
+        return;
+    }
+    // Apply env vars if not already set (allow explicit overrides)
+    const envDefaults = {
+        SUPERBLOCKS_DEPLOYMENT_TYPE: config.deploymentType,
+        SUPERBLOCKS_LLMOBS_ENABLED: "true",
+        OTEL_EXPORTER_OTLP_ENDPOINT: config.otelEndpoint,
+        SUPERBLOCKS_OTEL_COLLECTOR_URL: config.otelEndpoint,
+        DD_LLMOBS_ENABLED: "1",
+        DD_LLMOBS_ML_APP: config.llmobs.mlApp,
+        DD_LLMOBS_AGENTLESS_ENABLED: "1",
+        DD_SITE: config.datadog.site,
+        DD_API_KEY: config.datadog.apiKey,
+    };
+    for (const [key, value] of Object.entries(envDefaults)) {
+        if (!process.env[key]) {
+            process.env[key] = value;
+        }
+    }
+}
+//# sourceMappingURL=local-obs.js.map

package/dist/telemetry/local-obs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-obs.js","sourceRoot":"","sources":["../../src/telemetry/local-obs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAC7D,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAsBtD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB;IAC/B,iBAAiB;IACjB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,MAAM,eAAe,GACnB,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,kBAAkB,CAAC,UAAU;QACzE,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,MAAM;QACjD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IAE5C,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,YAAY,EACV,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,2BAA2B;QACxE,cAAc,EAAE,kBAAkB,CAAC,UAAU;QAC7C,MAAM,EAAE;YACN,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,mBAAmB;YAC1D,gBAAgB,EAAE,IAAI;SACvB;QACD,OAAO,EAAE;YACP,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,eAAe;YAC5C,uEAAuE;YACvE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,qBAAqB;SACxD;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,+DAA+D;IAC/D,MAAM,WAAW,GAA2B;QAC1C,2BAA2B,EAAE,MAAM,CAAC,cAAc;QAClD,0BAA0B,EAAE,MAAM;QAClC,2BAA2B,EAAE,MAAM,CAAC,YAAY;QAChD,8BAA8B,EAAE,MAAM,CAAC,YAAY;QACnD,iBAAiB,EAAE,GAAG;QACtB,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;QACrC,2BAA2B,EAAE,GAAG;QAChC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;QAC5B,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;KAClC,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/telemetry/util.d.ts

@@ -1,8 +1,7 @@
 export declare const SERVICE_NAME = "sdk-dev-server";
 export declare function getConfiguration(): Promise<{
     superblocksBaseUrl: import("url").URL;
-    superblocksTracesUrl: string;
-    superblocksLogsUrl: string;
+    otlpBaseUrl: string;
     superblocksHostname: string;
     serviceName: string;
     token: string;

package/dist/telemetry/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAE7C,wBAAsB,gBAAgB;;;;;;;GA0BrC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,mBAAmB,CAAC;AA2B7C,wBAAsB,gBAAgB;;;;;;GAwBrC"}

package/dist/telemetry/util.js

@@ -1,11 +1,34 @@
 import { getLocalTokenWithUrl } from "@superblocksteam/util";
 export const SERVICE_NAME = "sdk-dev-server";
+/**
+ * Get the OTLP base URL for telemetry export.
+ *
+ * Priority:
+ * 1. SUPERBLOCKS_OTEL_COLLECTOR_URL env var (for local obs mode)
+ * 2. Superblocks API endpoint derived from base URL
+ *
+ * When SUPERBLOCKS_OTEL_COLLECTOR_URL is set (e.g., http://localhost:24318),
+ * telemetry is sent directly to the local OTEL collector.
+ *
+ * Note: This returns the BASE URL. The telemetry library appends /v1/traces,
+ * /v1/metrics, /v1/logs to this URL.
+ */
+function getOtlpBaseUrl(superblocksBaseUrl) {
+    const localOtelUrl = process.env.SUPERBLOCKS_OTEL_COLLECTOR_URL;
+    if (localOtelUrl) {
+        // Remove trailing /v1/traces etc. if present (just use base URL)
+        return localOtelUrl.replace(/\/v1\/(traces|metrics|logs)$/, "");
+    }
+    // Default: Superblocks API proxies OTLP requests
+    // The server expects /api/v1/traces but the telemetry lib adds /v1/traces,
+    // so we return /api and let telemetry lib append /v1/traces
+    return superblocksBaseUrl.origin + "/api";
+}
 export async function getConfiguration() {
     try {
         const tokenWithUrl = await getLocalTokenWithUrl();
         const superblocksBaseUrl = new URL(tokenWithUrl.superblocksBaseUrl);
-        const superblocksTracesUrl = superblocksBaseUrl.origin + "/api/v1/traces";
-        const superblocksLogsUrl = superblocksBaseUrl.origin + "/api/v1/logs";
+        const otlpBaseUrl = getOtlpBaseUrl(superblocksBaseUrl);
         const superblocksHostname = superblocksBaseUrl.hostname;
         let token = "";
         if ("token" in tokenWithUrl) {
@@ -13,8 +36,7 @@ export async function getConfiguration() {
         }
         return {
             superblocksBaseUrl,
-            superblocksTracesUrl,
-            superblocksLogsUrl,
+            otlpBaseUrl,
             superblocksHostname,
             serviceName: SERVICE_NAME,
             token,

package/dist/telemetry/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAClD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACpE,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,MAAM,GAAG,gBAAgB,CAAC;QAC1E,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,MAAM,GAAG,cAAc,CAAC;QACtE,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,QAAQ,CAAC;QACxD,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO;YACL,kBAAkB;YAClB,oBAAoB;YACpB,kBAAkB;YAClB,mBAAmB;YACnB,WAAW,EAAE,YAAY;YACzB,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,4FAA4F,EAC5F,CAAC,CACF,CAAC;QACF,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/telemetry/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CAAC,kBAAuB;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAChE,IAAI,YAAY,EAAE,CAAC;QACjB,iEAAiE;QACjE,OAAO,YAAY,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,iDAAiD;IACjD,2EAA2E;IAC3E,4DAA4D;IAC5D,OAAO,kBAAkB,CAAC,MAAM,GAAG,MAAM,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAClD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,QAAQ,CAAC;QACxD,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;YAC5B,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO;YACL,kBAAkB;YAClB,WAAW;YACX,mBAAmB;YACnB,WAAW,EAAE,YAAY;YACzB,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,4FAA4F,EAC5F,CAAC,CACF,CAAC;QACF,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/sdk",
-  "version": "2.0.83",
+  "version": "2.0.84-next.0",
   "type": "module",
   "description": "Superblocks JS SDK",
   "homepage": "https://www.superblocks.com",
@@ -53,10 +53,11 @@
     "vite-tsconfig-paths": "^6.0.4",
     "winston": "^3.17.0",
     "yaml": "^2.7.1",
-    "@superblocksteam/library-shared": "2.0.83",
-    "@superblocksteam/shared": "0.9562.5",
-    "@superblocksteam/util": "2.0.83",
-    "@superblocksteam/vite-plugin-file-sync": "2.0.83"
+    "@superblocksteam/library-shared": "2.0.84-next.0",
+    "@superblocksteam/shared": "0.9563.1",
+    "@superblocksteam/telemetry": "2.0.84-next.0",
+    "@superblocksteam/vite-plugin-file-sync": "2.0.84-next.0",
+    "@superblocksteam/util": "2.0.84-next.0"
   },
   "optionalDependencies": {
     "@rollup/rollup-darwin-arm64": "^4.34.9",

package/src/cli-replacement/automatic-upgrades.ts

@@ -10,6 +10,10 @@ import gt from "semver/functions/gt.js";
 import valid from "semver/functions/valid.js";
 import { getTracer } from "../telemetry/index.js";
 import { getErrorMeta, getLogger } from "../telemetry/logging.js";
+import {
+  getCurrentCliVersion,
+  clearCliVersionCache,
+} from "./version-detection.js";
 import type { ResponseMeta } from "../socket/handlers.js";
 import type { ApplicationConfigWithTokenConfigAndUserInfo } from "../types/common.js";
 import type { LockService } from "@superblocksteam/vite-plugin-file-sync/lock-service";
@@ -24,11 +28,6 @@ interface Versions {
   [pkg: string]: string;
 }
 
-interface PackageVersionInfo {
-  version: string;
-  alias?: string;
-}
-
 interface CheckVersionsErrorResponse {
   responseMeta: ResponseMeta;
 }
@@ -73,43 +72,6 @@ async function getRemoteVersions(
   }
 }
 
-export async function getCurrentCliVersion(): Promise<
-  PackageVersionInfo | undefined
-> {
-  try {
-    const command = process.platform === "win32" ? "where" : "which";
-    const { stdout } = await exec(`${command} superblocks`);
-    const superblocksPath = stdout.trim();
-
-    if (!superblocksPath) return undefined;
-
-    const { stdout: versionOutput } = await exec(
-      `${superblocksPath} version --json`,
-    );
-    const json = JSON.parse(versionOutput) as Record<string, string>;
-    // Extract version from string like "@superblocksteam/cli/2.0.0-next.1" or "@superblocksteam/cli-ephemeral/2.0.0-SNAPSHOT.ebd2b86d643331f5"
-    const version = json.cliVersion?.replace(
-      /@superblocksteam\/cli(-ephemeral)?\//,
-      "",
-    );
-
-    const aliasMatch = json.cliVersion?.match(/@superblocksteam\/([^\/]+)/);
-    if (aliasMatch && aliasMatch[1] !== "cli") {
-      return {
-        version: version,
-        alias: `@superblocksteam/${aliasMatch[1]}`,
-      };
-    }
-
-    return { version };
-  } catch (error) {
-    if (isNativeError(error)) {
-      logger.error(`Error getting CLI version: ${error.message}`);
-    }
-    return undefined;
-  }
-}
-
 async function upgradeCliWithOclif(targetVersion: string): Promise<boolean> {
   try {
     const command = process.platform === "win32" ? "where" : "which";
@@ -185,6 +147,9 @@ async function upgradeCliWithPackageManager(
   // Wait for the install to complete, then validate the version
   await promise;
 
+  // Clear cache to force actual version detection (not just returning cached value)
+  clearCliVersionCache();
+
   const currentCliInfo = await getCurrentCliVersion();
   if (!currentCliInfo) {
     throw new Error("Could not get validate CLI version post-install");
@@ -196,6 +161,9 @@ async function upgradeCliWithPackageManager(
     );
   }
 
+  // Now that we've validated, cache the correct version (avoids re-detection on next call)
+  clearCliVersionCache({ version: targetVersion, alias });
+
   // This log line is used to end the upgrade spinner
   logger.info(`Successfully upgraded packages to ${targetVersion}`);
 }