@axiom-lattice/core 2.1.87 → 2.1.89

package/dist/index.d.mts

@@ -1410,6 +1410,26 @@ interface BackendProtocol {
      * @returns Raw file content as FileData
      */
     readRaw(filePath: string): MaybePromise<FileData>;
+    /**
+     * Read file content as raw binary Buffer.
+     *
+     * Optional method for backends that support binary file access.
+     * Backends that store files as text (StateBackend, MemoryBackend, StoreBackend)
+     * may omit this method.
+     *
+     * @param filePath - Absolute file path
+     * @returns Raw file content as Buffer
+     */
+    readBinary?(filePath: string): Promise<Buffer>;
+    /**
+     * Write raw binary data to a file.
+     *
+     * Optional method for backends that support binary file writing.
+     *
+     * @param filePath - Absolute file path
+     * @param data - Binary data to write
+     */
+    writeBinary?(filePath: string, data: Buffer): Promise<void>;
     /**
      * Structured search results or error string for invalid input.
      *
@@ -4228,7 +4248,6 @@ interface MicrosandboxRemoteProviderConfig extends MicrosandboxServiceClientConf
 declare class MicrosandboxRemoteProvider implements SandboxProvider {
     private readonly config;
     private readonly client;
-    private readonly instances;
     private readonly creating;
     constructor(config: MicrosandboxRemoteProviderConfig);
     createSandbox(name: string, config: RunSandboxConfig): Promise<SandboxInstance>;
@@ -5583,6 +5602,8 @@ declare class VolumeFilesystem implements BackendProtocol {
     lsInfo(path: string): Promise<FileInfo[]>;
     read(filePath: string, offset?: number, limit?: number): Promise<string>;
     readRaw(filePath: string): Promise<FileData>;
+    readBinary(filePath: string): Promise<Buffer>;
+    writeBinary(filePath: string, data: Buffer): Promise<void>;
     grepRaw(_pattern: string, _path?: string | null, _glob?: string | null): string | GrepMatch[];
     globInfo(_pattern: string, _path?: string): FileInfo[];
     write(filePath: string, content: string): Promise<WriteResult>;

package/dist/index.d.ts

@@ -1410,6 +1410,26 @@ interface BackendProtocol {
      * @returns Raw file content as FileData
      */
     readRaw(filePath: string): MaybePromise<FileData>;
+    /**
+     * Read file content as raw binary Buffer.
+     *
+     * Optional method for backends that support binary file access.
+     * Backends that store files as text (StateBackend, MemoryBackend, StoreBackend)
+     * may omit this method.
+     *
+     * @param filePath - Absolute file path
+     * @returns Raw file content as Buffer
+     */
+    readBinary?(filePath: string): Promise<Buffer>;
+    /**
+     * Write raw binary data to a file.
+     *
+     * Optional method for backends that support binary file writing.
+     *
+     * @param filePath - Absolute file path
+     * @param data - Binary data to write
+     */
+    writeBinary?(filePath: string, data: Buffer): Promise<void>;
     /**
      * Structured search results or error string for invalid input.
      *
@@ -4228,7 +4248,6 @@ interface MicrosandboxRemoteProviderConfig extends MicrosandboxServiceClientConf
 declare class MicrosandboxRemoteProvider implements SandboxProvider {
     private readonly config;
     private readonly client;
-    private readonly instances;
     private readonly creating;
     constructor(config: MicrosandboxRemoteProviderConfig);
     createSandbox(name: string, config: RunSandboxConfig): Promise<SandboxInstance>;
@@ -5583,6 +5602,8 @@ declare class VolumeFilesystem implements BackendProtocol {
     lsInfo(path: string): Promise<FileInfo[]>;
     read(filePath: string, offset?: number, limit?: number): Promise<string>;
     readRaw(filePath: string): Promise<FileData>;
+    readBinary(filePath: string): Promise<Buffer>;
+    writeBinary(filePath: string, data: Buffer): Promise<void>;
     grepRaw(_pattern: string, _path?: string | null, _glob?: string | null): string | GrepMatch[];
     globInfo(_pattern: string, _path?: string): FileInfo[];
     write(filePath: string, content: string): Promise<WriteResult>;

package/dist/index.js

@@ -7482,7 +7482,8 @@ var VolumeFilesystem = class {
     }).join("\n");
   }
   async readRaw(filePath) {
-    const content = await this.client.read(filePath);
+    const buf = await this.client.readRaw(filePath);
+    const content = buf.toString("utf-8");
     const lines = content.split("\n");
     const now = (/* @__PURE__ */ new Date()).toISOString();
     return {
@@ -7491,6 +7492,12 @@ var VolumeFilesystem = class {
       modified_at: now
     };
   }
+  async readBinary(filePath) {
+    return this.client.readRaw(filePath);
+  }
+  async writeBinary(filePath, data) {
+    await this.client.writeRaw(filePath, data);
+  }
   grepRaw(_pattern, _path, _glob) {
     throw new Error("Not supported on volume backend");
   }
@@ -24365,7 +24372,6 @@ function getDefaultMicrosandboxRemoteConfig() {
 var MicrosandboxRemoteProvider = class {
   constructor(config) {
     this.config = config;
-    this.instances = /* @__PURE__ */ new Map();
     this.creating = /* @__PURE__ */ new Map();
     this.client = config.client ?? new MicrosandboxServiceClient({
       baseURL: config.baseURL,
@@ -24377,48 +24383,32 @@ var MicrosandboxRemoteProvider = class {
     if (inFlight) {
       return inFlight;
     }
-    const existing = this.instances.get(name);
-    if (existing) {
-      console.log(`[MicrosandboxRemote] createSandbox name=${name} INSTANCE_CACHE_HIT`);
-      return existing;
-    }
     const creation = (async () => {
       const tStart = Date.now();
       const input = this.buildEnsureInput(config);
       console.log(`[MicrosandboxRemote] createSandbox name=${name} calling ensureSandbox...`);
       await this.client.ensureSandbox(name, input);
       console.log(`[MicrosandboxRemote] createSandbox DONE name=${name} elapsed=${Date.now() - tStart}ms`);
-      const instance = new MicrosandboxRemoteInstance(name, this.client);
-      this.instances.set(name, instance);
-      return instance;
+      return new MicrosandboxRemoteInstance(name, this.client);
     })();
     this.creating.set(name, creation);
-    creation.then(
-      () => {
-        this.creating.delete(name);
-      },
-      () => {
-        this.creating.delete(name);
-      }
-    );
+    creation.finally(() => this.creating.delete(name));
     return creation;
   }
   async getSandbox(name) {
-    const instance = this.instances.get(name);
-    if (!instance) {
+    const status = await this.client.getStatus(name);
+    if (status.status === "unknown") {
       throw new Error(`Sandbox ${name} not found`);
     }
-    return instance;
+    return new MicrosandboxRemoteInstance(name, this.client);
   }
   async stopSandbox(name) {
     try {
       await this.client.stopSandbox(name);
     } catch {
     }
-    this.instances.delete(name);
   }
   async deleteSandbox(name) {
-    this.instances.delete(name);
     await this.client.deleteSandbox(name);
   }
   createVolumeFsClient(volumeName, _pathPrefix) {
@@ -24431,7 +24421,7 @@ var MicrosandboxRemoteProvider = class {
     };
   }
   async listSandboxes() {
-    return Array.from(this.instances.values());
+    return [];
   }
   buildEnsureInput(config) {
     const defaultMicrosandboxRemoteConfig = getDefaultMicrosandboxRemoteConfig();