@blaxel/core 0.3.22 → 0.3.23

package/dist/esm-browser/client/sdk.gen.js

@@ -442,7 +442,7 @@ export const createDrive = (options) => {
 };
 /**
  * Delete a drive
- * Deletes a drive immediately. The drive record is removed from the database synchronously.
+ * Starts the deletion of a drive. The drive is marked DELETING and its storage is wiped asynchronously; the drive disappears from listings once the cleanup completes.
  */
 export const deleteDrive = (options) => {
     return (options.client ?? _heyApiClient).delete({
@@ -734,7 +734,7 @@ export const cleanupImages = (options) => {
 };
 /**
  * List container images
- * Returns all container images stored in the workspace registry, grouped by repository with their available tags. Images are created during deployments of agents, functions, sandboxes, and jobs.
+ * Returns paginated image summaries starting with API version 2026-09-22. Older versions return a bare array including all tags.
  */
 export const listImages = (options) => {
     return (options?.client ?? _heyApiClient).get({
@@ -786,7 +786,7 @@ export const deleteImage = (options) => {
 };
 /**
  * Get container image
- * Returns detailed information about a container image including all available tags, creation dates, and size information.
+ * Returns a bounded image summary starting with API version 2026-09-22. Older versions return the image with all tags.
  */
 export const getImage = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -852,6 +852,22 @@ export const unshareImage = (options) => {
         ...options
     });
 };
+/**
+ * List image tags
+ * Returns a bounded page of image tags. Search by prefix or exact name. Tags are ordered by name only. Send Blaxel-Version 2026-09-22 with image catalog requests.
+ */
+export const listImageTags = (options) => {
+    return (options.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/images/{resourceType}/{imageName}/tags',
+        ...options
+    });
+};
 /**
  * Delete container image tag
  * Deletes a specific tag from a container image. The underlying image layers are kept if other tags reference them. Will fail if the tag is currently in use.
@@ -1634,7 +1650,7 @@ export const archiveSandbox = (options) => {
 };
 /**
  * Fork sandbox
- * Forks a sandbox into a new sandbox or application. When forking to a sandbox, the target must not already exist (409 if it does). When forking to an application, a new revision is added if the app already exists, or a new application is created. This is a WIP endpoint — the full implementation depends on the execution plane.
+ * Forks a sandbox into a new sandbox or application. When forking to a sandbox, the target must not already exist (409 if it does). When forking to an application, a new revision is added if the app already exists, or a new application is created. With no snapshotId, a fork to a sandbox copies the source sandbox's live state directly and no snapshot is persisted, while a fork to an application takes a snapshot its revision then references. This is a WIP endpoint — the full implementation depends on the execution plane.
  */
 export const forkSandbox = (options) => {
     return (options.client ?? _heyApiClient).post({
@@ -1934,7 +1950,7 @@ export const createSandboxSnapshot = (options) => {
 };
 /**
  * Delete sandbox snapshot
- * Deletes a snapshot of a sandbox by its ID.
+ * Deletes a snapshot of a sandbox, addressed by its name among that sandbox's snapshots (or by its ID).
  */
 export const deleteSandboxSnapshot = (options) => {
     return (options.client ?? _heyApiClient).delete({
@@ -2222,7 +2238,7 @@ export const deleteSnapshot = (options) => {
 };
 /**
  * Get snapshot
- * Returns a snapshot of the workspace by name.
+ * Returns a snapshot of the workspace by ID.
  */
 export const getSnapshot = (options) => {
     return (options.client ?? _heyApiClient).get({

package/dist/esm-browser/common/settings.js

@@ -24,10 +24,10 @@ 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.22";
-const BUILD_COMMIT = "0978bae88a7844ecb221e08137918547b9f0439b";
+const BUILD_VERSION = "0.3.23";
+const BUILD_COMMIT = "3f7319f88bf305c481c80932c29c7513c85b543d";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
-const BLAXEL_API_VERSION = "2026-04-28";
+const BLAXEL_API_VERSION = "2026-09-22";
 // Bun < 1.3.11 never sends connection-level WINDOW_UPDATE: the pooled h2
 // session freezes after exactly 65535 cumulative body bytes and every request
 // on it hangs until the edge resets the streams (~330s).

package/dist/esm-browser/common/settings.test.js

@@ -9,10 +9,10 @@ describe('Settings.apiVersion', () => {
     afterEach(() => {
         delete env.BL_API_VERSION;
     });
-    it('defaults to 2026-04-28 when BL_API_VERSION is not set', async () => {
+    it('defaults to 2026-09-22 when BL_API_VERSION is not set', async () => {
         delete env.BL_API_VERSION;
         const { settings } = await import('./settings.js');
-        expect(settings.apiVersion).toBe('2026-04-28');
+        expect(settings.apiVersion).toBe('2026-09-22');
     });
     it('headers include Blaxel-Version set to the default', async () => {
         delete env.BL_API_VERSION;
@@ -21,7 +21,7 @@ describe('Settings.apiVersion', () => {
         const previous = settings.credentials;
         settings.credentials = new ApiKey({ apiKey: 'test-key', workspace: 'test-ws' });
         try {
-            expect(settings.headers['Blaxel-Version']).toBe('2026-04-28');
+            expect(settings.headers['Blaxel-Version']).toBe('2026-09-22');
         }
         finally {
             settings.credentials = previous;

package/dist/esm-browser/image/pagination.test.js

@@ -0,0 +1,70 @@
+import { createServer } from "node:http";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { initialize } from "../common/autoload.js";
+import { settings } from "../common/settings.js";
+import { ImageInstance } from "./image.js";
+// Exercise the generated client, authentication headers and cursor helpers over HTTP.
+describe("image pagination HTTP contract", () => {
+    let server;
+    const requests = [];
+    const previousConfig = { ...settings.config };
+    const previousCredentials = settings.credentials;
+    beforeEach(async () => {
+        requests.length = 0;
+        server = createServer((request, response) => {
+            const url = new URL(request.url, "http://localhost");
+            requests.push({ url, version: request.headers["blaxel-version"] });
+            const cursor = url.searchParams.get("cursor");
+            const tag = url.pathname.endsWith("/tags");
+            const item = tag ? { name: "v2", size: 123 } : { metadata: { name: "example" }, spec: { size: 123, tagCount: 10000 } };
+            response.writeHead(200, { "Content-Type": "application/json" });
+            response.end(JSON.stringify({
+                data: cursor === "empty" ? [] : [item],
+                meta: cursor === "end" ? {} : { total: 10000, totalIsPartial: true, hasMore: true, nextCursor: cursor ? "end" : "empty" },
+            }));
+        });
+        await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+        const address = server.address();
+        if (!address || typeof address === "string")
+            throw new Error("Expected TCP server");
+        initialize({ apiKey: "test-key", workspace: "test", disableH2: true });
+        const { ensureAutoloaded } = await import("../common/lazyInit.js");
+        ensureAutoloaded();
+        const { client } = await import("../client/client.gen.js");
+        client.setConfig({ baseUrl: `http://127.0.0.1:${address.port}`, fetch });
+    });
+    afterEach(async () => {
+        settings.config = previousConfig;
+        settings.credentials = previousCredentials;
+        server.closeAllConnections();
+        await new Promise((resolve, reject) => server.close((error) => error ? reject(error) : resolve()));
+    });
+    it("lists summaries lazily and follows empty pages without fetching tags", async () => {
+        const page = await ImageInstance.list({ limit: 1, q: "ex", sort: "name:asc" });
+        expect(requests).toHaveLength(1);
+        expect(page.data[0].spec.tagCount).toBe(10000);
+        expect(page.meta.totalIsPartial).toBe(true);
+        const items = await page.autoPagingToArray({ limit: 10 });
+        expect(items).toHaveLength(2);
+        expect(requests.map(({ url }) => url.pathname)).toEqual(["/images", "/images", "/images"]);
+        expect(requests.map(({ url }) => url.searchParams.get("cursor"))).toEqual([null, "empty", "end"]);
+        for (const request of requests) {
+            expect(request.version).toBe("2026-09-22");
+            expect(request.url.searchParams.get("q")).toBe("ex");
+            expect(request.url.searchParams.get("limit")).toBe("1");
+            expect(request.url.searchParams.get("sort")).toBe("name:asc");
+        }
+    });
+    it("preserves shared-owner and tag filters on every page", async () => {
+        const page = await ImageInstance.listTags("sandbox", "example", {
+            limit: 1, name: "v2", sourceWorkspace: "owner", sort: "name:desc",
+        });
+        expect(await page.autoPagingToArray({ limit: 10 })).toHaveLength(2);
+        for (const { url } of requests) {
+            expect(url.pathname).toBe("/images/sandbox/example/tags");
+            expect(url.searchParams.get("sourceWorkspace")).toBe("owner");
+            expect(url.searchParams.get("name")).toBe("v2");
+            expect(url.searchParams.get("sort")).toBe("name:desc");
+        }
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@blaxel/core",
-	"version": "0.3.22",
+	"version": "0.3.23",
 	"description": "Blaxel Core SDK for TypeScript",
 	"license": "MIT",
 	"author": "Blaxel, INC (https://blaxel.ai)",