@blaxel/core 0.3.35 → 0.3.36-preview.347

package/dist/cjs/common/coding-agent.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODING_AGENT_ENV_VARS = void 0;
+exports.detectCodingAgent = detectCodingAgent;
+/**
+ * Environment variables coding agents set for the commands they run, first
+ * match wins, with the agent id the SDK reports. Ids match the Blaxel CLI's.
+ */
+const CODING_AGENTS = [
+    ["CLAUDECODE", "claude-code"],
+    ["CODEX_THREAD_ID", "codex"],
+    ["CODEX_SANDBOX", "codex"],
+    ["CURSOR_AGENT", "cursor"],
+    ["GEMINI_CLI", "gemini-cli"],
+    ["QWEN_CODE", "qwen-code"],
+    ["OPENCODE_TERMINAL", "opencode"],
+    ["OPENCODE", "opencode"],
+    ["GOOSE_TERMINAL", "goose"],
+    ["AUGMENT_AGENT", "augment"],
+];
+/**
+ * Agent names found in the generic `AI_AGENT` and `AGENT` variables, mapped to
+ * the same ids. Any other `AI_AGENT` name is reported as "other".
+ */
+const CODING_AGENT_NAMES = {
+    "claude-code": "claude-code",
+    claude: "claude-code",
+    codex: "codex",
+    cursor: "cursor",
+    "cursor-cli": "cursor",
+    "gemini-cli": "gemini-cli",
+    gemini: "gemini-cli",
+    "qwen-code": "qwen-code",
+    opencode: "opencode",
+    goose: "goose",
+    augment: "augment",
+    "augment-cli": "augment",
+    crush: "crush",
+    "github-copilot": "github-copilot",
+    "github-copilot-cli": "github-copilot",
+};
+/** Every environment variable `detectCodingAgent` reads. */
+exports.CODING_AGENT_ENV_VARS = [
+    ...CODING_AGENTS.map(([name]) => name),
+    "AI_AGENT",
+    "AGENT",
+];
+function agentName(value) {
+    const name = value?.trim().toLowerCase() ?? "";
+    // Claude Code sets AI_AGENT=claude-code_<version>_agent: keep the name.
+    const end = name.search(/[_/@ ]/);
+    return end > 0 ? name.slice(0, end) : name;
+}
+function knownAgentId(name) {
+    return Object.prototype.hasOwnProperty.call(CODING_AGENT_NAMES, name)
+        ? CODING_AGENT_NAMES[name]
+        : undefined;
+}
+/**
+ * Id of the coding agent whose environment the SDK runs in, "other" for an
+ * agent without a known name, or "" for none.
+ */
+function detectCodingAgent(getenv) {
+    for (const [name, id] of CODING_AGENTS) {
+        if (getenv(name)?.trim()) {
+            return id;
+        }
+    }
+    const name = agentName(getenv("AI_AGENT"));
+    if (name) {
+        return knownAgentId(name) ?? "other";
+    }
+    // AGENT is a generic name, so only a known agent name counts.
+    return knownAgentId(agentName(getenv("AGENT"))) ?? "";
+}

package/dist/cjs/common/coding-agent.test.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const coding_agent_js_1 = require("./coding-agent.js");
+function detect(vars) {
+    return (0, coding_agent_js_1.detectCodingAgent)((name) => vars[name]);
+}
+(0, vitest_1.describe)("detectCodingAgent", () => {
+    (0, vitest_1.it)("returns nothing outside a coding agent", () => {
+        (0, vitest_1.expect)(detect({})).toBe("");
+        (0, vitest_1.expect)(detect({ CLAUDECODE: "", AI_AGENT: "  " })).toBe("");
+    });
+    vitest_1.it.each([
+        [{ CLAUDECODE: "1" }, "claude-code"],
+        [{ CODEX_THREAD_ID: "thread" }, "codex"],
+        [{ CODEX_SANDBOX: "seatbelt" }, "codex"],
+        [{ CURSOR_AGENT: "1" }, "cursor"],
+        [{ GEMINI_CLI: "1" }, "gemini-cli"],
+        [{ QWEN_CODE: "1" }, "qwen-code"],
+        [{ OPENCODE_TERMINAL: "1" }, "opencode"],
+        [{ OPENCODE: "1", AGENT: "1" }, "opencode"],
+        [{ GOOSE_TERMINAL: "1" }, "goose"],
+        [{ AUGMENT_AGENT: "1" }, "augment"],
+    ])("detects the marker %j", (vars, id) => {
+        (0, vitest_1.expect)(detect(vars)).toBe(id);
+    });
+    (0, vitest_1.it)("prefers an agent-specific marker over the generic variables", () => {
+        (0, vitest_1.expect)(detect({ AI_AGENT: "something-else", CODEX_SANDBOX: "seatbelt" })).toBe("codex");
+    });
+    vitest_1.it.each([
+        ["claude-code_2-1-306_agent", "claude-code"],
+        ["Cursor", "cursor"],
+        ["crush", "crush"],
+        ["github-copilot-cli", "github-copilot"],
+        ["some-new-agent", "other"],
+    ])("maps AI_AGENT=%j to %j", (value, id) => {
+        (0, vitest_1.expect)(detect({ AI_AGENT: value })).toBe(id);
+    });
+    (0, vitest_1.it)("reads AGENT only for a known agent name", () => {
+        (0, vitest_1.expect)(detect({ AGENT: "goose" })).toBe("goose");
+        (0, vitest_1.expect)(detect({ AGENT: "1" })).toBe("");
+        (0, vitest_1.expect)(detect({ AGENT: "build-runner" })).toBe("");
+        (0, vitest_1.expect)(detect({ AGENT: "goose", AI_AGENT: "claude" })).toBe("claude-code");
+    });
+    (0, vitest_1.it)("never reports a free-form name", () => {
+        (0, vitest_1.expect)(detect({ AI_AGENT: "Jane Doe's laptop" })).toBe("other");
+        (0, vitest_1.expect)(detect({ AI_AGENT: "toString" })).toBe("other");
+        (0, vitest_1.expect)(detect({ AGENT: "toString" })).toBe("");
+    });
+});

package/dist/cjs/common/sentry.js

@@ -187,9 +187,25 @@ function generateEventId() {
         return value.toString(16);
     });
 }
+const SAFE_WORKSPACE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
 /**
- * Build an allowlisted event. Raw messages, response bodies, workspace/resource
- * context, and absolute host paths are deliberately excluded.
+ * The workspace name is the only user identifier, so an issue shows how many
+ * workspaces it affects. Omitted when unknown or not a workspace name.
+ */
+function sentryUser() {
+    try {
+        const workspace = settings_js_1.settings.workspace;
+        return typeof workspace === "string" && SAFE_WORKSPACE_NAME.test(workspace)
+            ? { id: workspace }
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Build an allowlisted event. Raw messages, response bodies, resource context,
+ * and absolute host paths are deliberately excluded.
  */
 function errorToSentryEvent(error, ownedFrames) {
     return {
@@ -199,6 +215,7 @@ function errorToSentryEvent(error, ownedFrames) {
         level: "error",
         environment: settings_js_1.settings.env,
         release: `sdk-typescript@${settings_js_1.settings.version}`,
+        user: sentryUser(),
         tags: {
             "blaxel.version": settings_js_1.settings.version,
             "blaxel.commit": settings_js_1.settings.commit,
@@ -292,6 +309,7 @@ function h2DegradationToSentryEvent(reason, domainTag, count) {
         release: `sdk-typescript@${settings_js_1.settings.version}`,
         message: `h2 transport degradation: ${reason}`,
         fingerprint: ["h2-degradation", reason, domainTag],
+        user: sentryUser(),
         tags: {
             "blaxel.version": settings_js_1.settings.version,
             "blaxel.commit": settings_js_1.settings.commit,

package/dist/cjs/common/sentry.test.js

@@ -40,7 +40,7 @@ const mockSettings = vitest_1.vi.hoisted(() => ({
     env: "prod",
     version: "9.9.9",
     commit: "abcdef0",
-    workspace: "private-workspace",
+    workspace: "acme-staging",
 }));
 vitest_1.vi.mock("./settings.js", () => ({ settings: mockSettings }));
 const appFrameUrl = "file:///Users/customer/private-project/app.ts";
@@ -164,6 +164,8 @@ function emitUncaughtExceptionMonitor(error) {
                 "blaxel.error_source": "unhandled-sdk-exception",
             });
             (0, vitest_1.expect)(event.tags).not.toHaveProperty("blaxel.workspace");
+            // The workspace is the only user identifier, so issues count affected workspaces.
+            (0, vitest_1.expect)(event.user).toEqual({ id: "acme-staging" });
             const frames = event.exception?.values[0]?.stacktrace.frames ?? [];
             (0, vitest_1.expect)(frames.length).toBeGreaterThan(0);
             for (const frame of frames) {
@@ -172,7 +174,6 @@ function emitUncaughtExceptionMonitor(error) {
             const serialized = JSON.stringify(event);
             (0, vitest_1.expect)(serialized).not.toContain("secret response body");
             (0, vitest_1.expect)(serialized).not.toContain("customer-123");
-            (0, vitest_1.expect)(serialized).not.toContain("private-workspace");
             (0, vitest_1.expect)(serialized).not.toContain("/Users/customer");
         }
         finally {
@@ -269,8 +270,27 @@ function emitUncaughtExceptionMonitor(error) {
                 domainTag,
             },
             extra: { count: 100 },
+            user: { id: "acme-staging" },
         });
     });
+    (0, vitest_1.it)("leaves the user out when the workspace is not a workspace name", async () => {
+        const fetchMock = createFetchMock();
+        vitest_1.vi.stubGlobal("fetch", fetchMock);
+        const workspace = mockSettings.workspace;
+        mockSettings.workspace = "/Users/customer/private project";
+        try {
+            const { flushSentry, initSentry } = await Promise.resolve().then(() => __importStar(require("./sentry.js")));
+            initSentry();
+            emitUncaughtExceptionMonitor(makeSdkError());
+            await flushSentry();
+            const event = eventFromFetch(fetchMock);
+            (0, vitest_1.expect)(event.user).toBeUndefined();
+            (0, vitest_1.expect)(JSON.stringify(event)).not.toContain("/Users/customer");
+        }
+        finally {
+            mockSettings.workspace = workspace;
+        }
+    });
     (0, vitest_1.it)("groups keys independently and hashes external domains", async () => {
         const fetchMock = createFetchMock();
         vitest_1.vi.stubGlobal("fetch", fetchMock);

package/dist/cjs/common/settings.js

@@ -9,6 +9,7 @@ const apikey_js_1 = require("../authentication/apikey.js");
 const clientcredentials_js_1 = require("../authentication/clientcredentials.js");
 const credentials_js_1 = require("../authentication/credentials.js");
 const index_js_1 = require("../authentication/index.js");
+const coding_agent_js_1 = require("../common/coding-agent.js");
 const env_js_1 = require("../common/env.js");
 const errors_js_1 = require("../common/errors.js");
 const h2_runtime_js_1 = require("../common/h2-runtime.js");
@@ -30,8 +31,8 @@ function missingCredentialsMessage() {
     return "No Blaxel credentials found. Set the BL_API_KEY and BL_WORKSPACE environment variables, or run `bl login`.";
 }
 // Build info - these placeholders are replaced at build time by build:replace-imports
-const BUILD_VERSION = "0.3.35";
-const BUILD_COMMIT = "5f8cd5a9c6ba61ebc883d5c583b198b67da4167d";
+const BUILD_VERSION = "0.3.36-preview.347";
+const BUILD_COMMIT = "bb3cd5806f537daac42970497c263d4ccb4b2455";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 const BLAXEL_API_VERSION = "2026-09-22";
 // Bun < 1.3.11 never sends connection-level WINDOW_UPDATE: the pooled h2
@@ -68,6 +69,18 @@ function getConfigTracking() {
     }
     return null;
 }
+/**
+ * Whether `DO_NOT_TRACK` (`1` or `true`) opts out of the coding agent token.
+ * The process environment is checked on its own as well, so a project `.env`
+ * or `blaxel.toml` can't undo an opt-out set for the process. The saved
+ * `tracking` setting is not read: it is an opt-in for error reports, and
+ * `bl login` saves it as false until the user turns it on.
+ */
+function trackingOptedOut() {
+    const optsOut = (value) => value === "true" || value === "1";
+    const processValue = typeof process !== "undefined" ? process.env?.DO_NOT_TRACK : undefined;
+    return optsOut(processValue) || optsOut(env_js_1.env.DO_NOT_TRACK);
+}
 // Function to get OS and architecture
 function getOsArch() {
     try {
@@ -224,16 +237,32 @@ class Settings {
     set integration(value) {
         this.config.integration = value;
     }
+    /**
+     * Id of the coding agent (Claude Code, Codex, Cursor, ...) whose environment
+     * runs the SDK, `"other"` for an agent without a known name, or `""` for none
+     * or when telemetry is opted out. Sent as an `agent/<id>` User-Agent token.
+     */
+    get codingAgent() {
+        const agent = (0, coding_agent_js_1.detectCodingAgent)((name) => env_js_1.env[name]);
+        return agent && !trackingOptedOut() ? agent : "";
+    }
     get headers() {
         this.assertCredentials();
         const osArch = getOsArch();
-        const sdkUserAgent = `blaxel/sdk/typescript/${this.version} (${osArch}) blaxel/${this.commit}`;
+        let userAgent = `blaxel/sdk/typescript/${this.version} (${osArch}) blaxel/${this.commit}`;
         const integration = this.integration;
+        if (integration) {
+            userAgent += ` ${integration}`;
+        }
+        const codingAgent = this.codingAgent;
+        if (codingAgent) {
+            userAgent += ` agent/${codingAgent}`;
+        }
         return {
             "x-blaxel-authorization": this.authorization,
             "x-blaxel-workspace": this.workspace || "",
             "Blaxel-Version": this.apiVersion,
-            "User-Agent": integration ? `${sdkUserAgent} ${integration}` : sdkUserAgent,
+            "User-Agent": userAgent,
         };
     }
     get name() {

package/dist/cjs/common/settings.test.js

@@ -33,10 +33,42 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
 const vitest_1 = require("vitest");
 const apikey_js_1 = require("../authentication/apikey.js");
+const coding_agent_js_1 = require("./coding-agent.js");
 const env_js_1 = require("./env.js");
 const h2_runtime_js_1 = require("./h2-runtime.js");
+/**
+ * These tests may run inside a coding agent, which sets the variables the SDK
+ * reads to tag its User-Agent. Clear them (and DO_NOT_TRACK) for each test.
+ */
+function withoutCodingAgentEnv() {
+    const names = [...coding_agent_js_1.CODING_AGENT_ENV_VARS, 'DO_NOT_TRACK', 'HOME', 'USERPROFILE'];
+    const saved = {};
+    return {
+        clear() {
+            for (const name of names) {
+                saved[name] = process.env[name];
+            }
+            for (const name of [...coding_agent_js_1.CODING_AGENT_ENV_VARS, 'DO_NOT_TRACK']) {
+                delete process.env[name];
+            }
+        },
+        restore() {
+            for (const name of names) {
+                if (saved[name] === undefined) {
+                    delete process.env[name];
+                }
+                else {
+                    process.env[name] = saved[name];
+                }
+            }
+        },
+    };
+}
 (0, vitest_1.describe)('Settings.apiVersion', () => {
     (0, vitest_1.beforeEach)(() => {
         // Reset the module-level settings singleton between tests if needed
@@ -253,6 +285,7 @@ const h2_runtime_js_1 = require("./h2-runtime.js");
 });
 (0, vitest_1.describe)('Settings.integration', () => {
     const sdkUserAgent = /^blaxel\/sdk\/typescript\/\S+ \([^)]+\) blaxel\/\S+/;
+    const agentEnv = withoutCodingAgentEnv();
     async function authenticated() {
         const { settings } = await Promise.resolve().then(() => __importStar(require('./settings.js')));
         settings.credentials = new apikey_js_1.ApiKey({ apiKey: 'test-key', workspace: 'test-ws' });
@@ -260,7 +293,9 @@ const h2_runtime_js_1 = require("./h2-runtime.js");
         delete process.env.BL_INTEGRATION;
         return settings;
     }
+    (0, vitest_1.beforeEach)(() => agentEnv.clear());
     (0, vitest_1.afterEach)(async () => {
+        agentEnv.restore();
         const { settings } = await Promise.resolve().then(() => __importStar(require('./settings.js')));
         delete settings.config.integration;
         delete process.env.BL_INTEGRATION;
@@ -321,3 +356,100 @@ const h2_runtime_js_1 = require("./h2-runtime.js");
         }
     });
 });
+(0, vitest_1.describe)('Settings.codingAgent', () => {
+    const sdkUserAgent = /^blaxel\/sdk\/typescript\/\S+ \([^)]+\) blaxel\/\S+/;
+    const agentEnv = withoutCodingAgentEnv();
+    let home = '';
+    /** A fresh settings module, so it reads the empty test home directory. */
+    async function authenticated() {
+        const { settings } = await Promise.resolve().then(() => __importStar(require('./settings.js')));
+        settings.credentials = new apikey_js_1.ApiKey({ apiKey: 'test-key', workspace: 'test-ws' });
+        delete settings.config.integration;
+        delete process.env.BL_INTEGRATION;
+        return settings;
+    }
+    /** A fresh settings module whose home directory holds this config.yaml. */
+    async function withConfig(config) {
+        (0, fs_1.mkdirSync)((0, path_1.join)(home, '.blaxel'));
+        (0, fs_1.writeFileSync)((0, path_1.join)(home, '.blaxel', 'config.yaml'), config);
+        return authenticated();
+    }
+    // Keep the tracking choice saved on the machine running the tests out.
+    (0, vitest_1.beforeEach)(() => {
+        agentEnv.clear();
+        home = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'blaxel-home-'));
+        process.env.HOME = home;
+        process.env.USERPROFILE = home;
+        vitest_1.vi.resetModules();
+    });
+    (0, vitest_1.afterEach)(() => {
+        agentEnv.restore();
+        delete process.env.BL_INTEGRATION;
+        (0, fs_1.rmSync)(home, { recursive: true, force: true });
+        vitest_1.vi.resetModules();
+    });
+    (0, vitest_1.it)('sends no agent token outside a coding agent', async () => {
+        const settings = await authenticated();
+        (0, vitest_1.expect)(settings.codingAgent).toBe('');
+        (0, vitest_1.expect)(settings.headers['User-Agent']).toMatch(new RegExp(sdkUserAgent.source + '$'));
+    });
+    (0, vitest_1.it)('appends the agent token detected from the environment', async () => {
+        const settings = await authenticated();
+        process.env.CLAUDECODE = '1';
+        (0, vitest_1.expect)(settings.codingAgent).toBe('claude-code');
+        const userAgent = settings.headers['User-Agent'];
+        (0, vitest_1.expect)(userAgent).toMatch(sdkUserAgent);
+        (0, vitest_1.expect)(userAgent.endsWith(' agent/claude-code')).toBe(true);
+    });
+    (0, vitest_1.it)('puts the agent token after the integration token', async () => {
+        const settings = await authenticated();
+        process.env.CODEX_SANDBOX = 'seatbelt';
+        settings.integration = 'herdr/1.4.0';
+        (0, vitest_1.expect)(settings.headers['User-Agent'].endsWith(' herdr/1.4.0 agent/codex')).toBe(true);
+    });
+    vitest_1.it.each(['1', 'true'])('drops the token when DO_NOT_TRACK=%s', async (value) => {
+        const settings = await authenticated();
+        process.env.CLAUDECODE = '1';
+        process.env.DO_NOT_TRACK = value;
+        (0, vitest_1.expect)(settings.codingAgent).toBe('');
+        (0, vitest_1.expect)(settings.headers['User-Agent']).toMatch(new RegExp(sdkUserAgent.source + '$'));
+    });
+    (0, vitest_1.it)('drops the token when the process sets DO_NOT_TRACK=1 and the project .env says false', async () => {
+        vitest_1.vi.doMock('./node.js', async (importOriginal) => {
+            const original = await importOriginal();
+            const fs = original.fs;
+            const readFileSync = ((file, ...rest) => file === '.env' ? 'DO_NOT_TRACK=false\n' : fs.readFileSync(file, ...rest));
+            return { ...original, fs: { ...fs, readFileSync } };
+        });
+        try {
+            const settings = await authenticated();
+            const { env: projectEnv } = await Promise.resolve().then(() => __importStar(require('./env.js')));
+            (0, vitest_1.expect)(projectEnv.DO_NOT_TRACK).toBe('false');
+            process.env.CLAUDECODE = '1';
+            process.env.DO_NOT_TRACK = '1';
+            (0, vitest_1.expect)(settings.codingAgent).toBe('');
+            (0, vitest_1.expect)(settings.headers['User-Agent']).toMatch(new RegExp(sdkUserAgent.source + '$'));
+        }
+        finally {
+            vitest_1.vi.doUnmock('./node.js');
+        }
+    });
+    (0, vitest_1.it)('keeps the token when DO_NOT_TRACK turns tracking on', async () => {
+        const settings = await authenticated();
+        process.env.CLAUDECODE = '1';
+        process.env.DO_NOT_TRACK = '0';
+        (0, vitest_1.expect)(settings.codingAgent).toBe('claude-code');
+    });
+    (0, vitest_1.it)('keeps the token when config.yaml says tracking: false', async () => {
+        // bl login saves tracking: false until the user opts in to error reports.
+        const settings = await withConfig('tracking: false\n');
+        process.env.CURSOR_AGENT = '1';
+        (0, vitest_1.expect)(settings.codingAgent).toBe('cursor');
+    });
+    (0, vitest_1.it)('keeps the token when no tracking choice was saved', async () => {
+        const settings = await withConfig('context:\n  workspace: test-ws\n');
+        process.env.CURSOR_AGENT = '1';
+        (0, vitest_1.expect)(settings.tracking).toBe(false);
+        (0, vitest_1.expect)(settings.codingAgent).toBe('cursor');
+    });
+});

package/dist/cjs/types/common/coding-agent.d.ts

@@ -0,0 +1,7 @@
+/** Every environment variable `detectCodingAgent` reads. */
+export declare const CODING_AGENT_ENV_VARS: readonly string[];
+/**
+ * Id of the coding agent whose environment the SDK runs in, "other" for an
+ * agent without a known name, or "" for none.
+ */
+export declare function detectCodingAgent(getenv: (name: string) => string | undefined): string;

package/dist/cjs/types/common/coding-agent.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/types/common/settings.d.ts

@@ -120,6 +120,12 @@ declare class Settings {
      */
     get integration(): string;
     set integration(value: string | undefined);
+    /**
+     * Id of the coding agent (Claude Code, Codex, Cursor, ...) whose environment
+     * runs the SDK, `"other"` for an agent without a known name, or `""` for none
+     * or when telemetry is opted out. Sent as an `agent/<id>` User-Agent token.
+     */
+    get codingAgent(): string;
     get headers(): Record<string, string>;
     get name(): string;
     get type(): string;