@blaxel/core 0.2.47-preview.104 → 0.2.47-preview.106

package/dist/esm/sandbox/client/sdk.gen.js

@@ -1,5 +1,168 @@
 // This file is auto-generated by @hey-api/openapi-ts
 import { client as _heyApiClient } from "./client.gen.js";
+/**
+ * Welcome message
+ * Returns a welcome message with links to documentation
+ */
+export const delete_ = (options) => {
+    return (options?.client ?? _heyApiClient).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/',
+        ...options
+    });
+};
+/**
+ * Welcome message
+ * Returns a welcome message with links to documentation
+ */
+export const get = (options) => {
+    return (options?.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/',
+        ...options
+    });
+};
+/**
+ * Welcome message
+ * Returns a welcome message with links to documentation
+ */
+export const options = (options) => {
+    return (options?.client ?? _heyApiClient).options({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/',
+        ...options
+    });
+};
+/**
+ * Welcome message
+ * Returns a welcome message with links to documentation
+ */
+export const patch = (options) => {
+    return (options?.client ?? _heyApiClient).patch({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/',
+        ...options
+    });
+};
+/**
+ * Welcome message
+ * Returns a welcome message with links to documentation
+ */
+export const post = (options) => {
+    return (options?.client ?? _heyApiClient).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/',
+        ...options
+    });
+};
+/**
+ * Welcome message
+ * Returns a welcome message with links to documentation
+ */
+export const put = (options) => {
+    return (options?.client ?? _heyApiClient).put({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/',
+        ...options
+    });
+};
+/**
+ * Apply code edit
+ * Uses the configured LLM provider (Relace or Morph) to apply a code edit to the original content.
+ *
+ * To use this endpoint as an agent tool, follow these guidelines:
+ *
+ * Use this tool to make an edit to an existing file. This will be read by a less intelligent model, which will quickly apply the edit. You should make it clear what the edit is, while also minimizing the unchanged code you write.
+ *
+ * When writing the edit, you should specify each edit in sequence, with the special comment "// ... existing code ..." to represent unchanged code in between edited lines.
+ *
+ * Example format:
+ * // ... existing code ...
+ * FIRST_EDIT
+ * // ... existing code ...
+ * SECOND_EDIT
+ * // ... existing code ...
+ * THIRD_EDIT
+ * // ... existing code ...
+ *
+ * You should still bias towards repeating as few lines of the original file as possible to convey the change. But, each edit should contain minimally sufficient context of unchanged lines around the code you're editing to resolve ambiguity.
+ *
+ * DO NOT omit spans of pre-existing code (or comments) without using the "// ... existing code ..." comment to indicate its absence. If you omit the existing code comment, the model may inadvertently delete these lines.
+ *
+ * If you plan on deleting a section, you must provide context before and after to delete it. If the initial code is "Block 1\nBlock 2\nBlock 3", and you want to remove Block 2, you would output "// ... existing code ...\nBlock 1\nBlock 3\n// ... existing code ...".
+ *
+ * Make sure it is clear what the edit should be, and where it should be applied. Make edits to a file in a single edit_file call instead of multiple edit_file calls to the same file. The apply model can handle many distinct edits at once.
+ */
+export const putCodegenFastapplyByPath = (options) => {
+    return (options.client ?? _heyApiClient).put({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/codegen/fastapply/{path}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+/**
+ * Code reranking/semantic search
+ * Uses Relace's code reranking model to find the most relevant files for a given query. This is useful as a first pass in agentic exploration to narrow down the search space.
+ *
+ * Based on: https://docs.relace.ai/docs/code-reranker/agent
+ *
+ * Query Construction: The query can be a short question or a more detailed conversation with the user request included. For a first pass, use the full conversation; for subsequent calls, use more targeted questions.
+ *
+ * Token Limit and Score Threshold: For 200k token context models like Claude 4 Sonnet, recommended defaults are scoreThreshold=0.5 and tokenLimit=30000.
+ *
+ * The response will be a list of file paths and contents ordered from most relevant to least relevant.
+ */
+export const getCodegenRerankingByPath = (options) => {
+    return (options.client ?? _heyApiClient).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/codegen/reranking/{path}',
+        ...options
+    });
+};
 /**
  * Delete file or directory
  * Delete a file or directory
@@ -18,7 +181,7 @@ export const deleteFilesystemByPath = (options) => {
 };
 /**
  * Get file or directory information
- * Get content of a file or listing of a directory
+ * Get content of a file or listing of a directory. Use Accept header to control response format for files.
  */
 export const getFilesystemByPath = (options) => {
     return (options.client ?? _heyApiClient).get({
@@ -236,35 +399,3 @@ export const getWatchFilesystemByPath = (options) => {
         ...options
     });
 };
-/**
- * Stream process logs in real time via WebSocket
- * Streams the stdout and stderr output of a process in real time as JSON messages.
- */
-export const getWsProcessByIdentifierLogsStream = (options) => {
-    return (options.client ?? _heyApiClient).get({
-        security: [
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/ws/process/{identifier}/logs/stream',
-        ...options
-    });
-};
-/**
- * Stream file modification events in a directory via WebSocket
- * Streams JSON events of modified files in the given directory. Closes when the client disconnects.
- */
-export const getWsWatchFilesystemByPath = (options) => {
-    return (options.client ?? _heyApiClient).get({
-        security: [
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/ws/watch/filesystem/{path}',
-        ...options
-    });
-};

package/dist/esm/sandbox/codegen/codegen.js

@@ -0,0 +1,27 @@
+import { SandboxAction } from "../action.js";
+import { getCodegenRerankingByPath, putCodegenFastapplyByPath } from "../client/sdk.gen.js";
+export class SandboxCodegen extends SandboxAction {
+    constructor(sandbox) {
+        super(sandbox);
+    }
+    async fastapply(path, codeEdit, model) {
+        const result = await putCodegenFastapplyByPath({
+            path: { path },
+            body: { codeEdit, model },
+            baseUrl: this.url,
+            client: this.client,
+        });
+        this.handleResponseError(result.response, result.data, result.error);
+        return result.data;
+    }
+    async reranking(path, query, scoreThreshold, tokenLimit, filePattern) {
+        const result = await getCodegenRerankingByPath({
+            path: { path },
+            query: { query, scoreThreshold, tokenLimit, filePattern },
+            baseUrl: this.url,
+            client: this.client,
+        });
+        this.handleResponseError(result.response, result.data, result.error);
+        return result.data;
+    }
+}

package/dist/esm/sandbox/codegen/index.js

@@ -0,0 +1 @@
+export * from "./codegen.js";

package/dist/esm/sandbox/filesystem/filesystem.js

@@ -1,6 +1,7 @@
 import { settings } from "../../common/settings.js";
 import { SandboxAction } from "../action.js";
 import { deleteFilesystemByPath, getFilesystemByPath, getWatchFilesystemByPath, putFilesystemByPath } from "../client/index.js";
+import { readFile, writeFile } from "fs/promises";
 export class SandboxFileSystem extends SandboxAction {
     process;
     constructor(sandbox, process) {
@@ -46,6 +47,10 @@ export class SandboxFileSystem extends SandboxAction {
             // Convert Uint8Array to Blob
             fileBlob = new Blob([content]);
         }
+        else if (typeof content === 'string') {
+            const buffer = await readFile(content);
+            fileBlob = new Blob([buffer]);
+        }
         else {
             throw new Error("Unsupported content type");
         }
@@ -107,6 +112,28 @@ export class SandboxFileSystem extends SandboxAction {
         }
         throw new Error("Unsupported file type");
     }
+    async readBinary(path) {
+        path = this.formatPath(path);
+        const { response, data, error } = await getFilesystemByPath({
+            path: { path },
+            baseUrl: this.url,
+            client: this.client,
+            headers: {
+                'Accept': 'application/octet-stream',
+            },
+        });
+        this.handleResponseError(response, data, error);
+        if (typeof data === 'string') {
+            return new Blob([data]);
+        }
+        return data;
+    }
+    async download(src, destinationPath, { mode = 0o644 } = {}) {
+        const blob = await this.readBinary(src);
+        const arrayBuffer = await blob.arrayBuffer();
+        const buffer = Buffer.from(arrayBuffer);
+        await writeFile(destinationPath, buffer, { mode: mode ?? 0o644 });
+    }
     async rm(path, recursive = false) {
         path = this.formatPath(path);
         const { response, data, error } = await deleteFilesystemByPath({
@@ -197,7 +224,7 @@ export class SandboxFileSystem extends SandboxAction {
                                     filePath = fileEvent.path + "/" + fileEvent.name;
                                 }
                                 const content = await this.read(filePath);
-                                await callback({ ...fileEvent, content });
+                                await callback({ ...fileEvent, content: content });
                             }
                             catch {
                                 await callback({ ...fileEvent, content: undefined });

package/dist/esm/sandbox/index.js

@@ -1,7 +1,8 @@
 export { 
 /* Export SDK functions */
-deleteFilesystemByPath, deleteNetworkProcessByPidMonitor, deleteProcessByIdentifier, deleteProcessByIdentifierKill, getFilesystemByPath, getNetworkProcessByPidPorts, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, getProcessByIdentifierLogsStream, postNetworkProcessByPidMonitor, postProcess, putFilesystemByPath } from "./client/index.js";
+deleteFilesystemByPath, deleteNetworkProcessByPidMonitor, deleteProcessByIdentifier, deleteProcessByIdentifierKill, getFilesystemByPath, getNetworkProcessByPidPorts, putCodegenFastapplyByPath, getCodegenRerankingByPath, getProcess, getProcessByIdentifier, getProcessByIdentifierLogs, getProcessByIdentifierLogsStream, postNetworkProcessByPidMonitor, postProcess, putFilesystemByPath } from "./client/index.js";
 export * from "./filesystem/index.js";
+export * from "./codegen/index.js";
 export * from "./sandbox.js";
 export * from "./types.js";
 // Re-export everything from client except ClientOptions to avoid conflict

package/dist/esm/sandbox/sandbox.js

@@ -5,6 +5,7 @@ import { SandboxFileSystem } from "./filesystem/index.js";
 import { SandboxNetwork } from "./network/index.js";
 import { SandboxPreviews } from "./preview.js";
 import { SandboxProcess } from "./process/index.js";
+import { SandboxCodegen } from "./codegen/index.js";
 import { SandboxSessions } from "./session.js";
 import { normalizeEnvs, normalizePorts, normalizeVolumes } from "./types.js";
 export class SandboxInstance {
@@ -14,6 +15,7 @@ export class SandboxInstance {
     process;
     previews;
     sessions;
+    codegen;
     constructor(sandbox) {
         this.sandbox = sandbox;
         this.process = new SandboxProcess(sandbox);
@@ -21,6 +23,7 @@ export class SandboxInstance {
         this.network = new SandboxNetwork(sandbox);
         this.previews = new SandboxPreviews(sandbox);
         this.sessions = new SandboxSessions(sandbox);
+        this.codegen = new SandboxCodegen(sandbox);
     }
     get metadata() {
         return this.sandbox.metadata;
@@ -41,7 +44,7 @@ export class SandboxInstance {
     }
     static async create(sandbox, { safe = true } = {}) {
         const defaultName = `sandbox-${uuidv4().replace(/-/g, '').substring(0, 8)}`;
-        const defaultImage = `blaxel/base:latest`;
+        const defaultImage = `blaxel/base-image:latest`;
         const defaultMemory = 4096;
         // Handle SandboxCreateConfiguration or simple dict with name/image/memory/ports/envs/volumes keys
         if (!sandbox ||