@supertools-ai/core 0.1.4 → 0.1.5

package/README.md

@@ -59,7 +59,7 @@ E2B_API_KEY=your-key        # Get at e2b.dev
 Create `index.ts` and run with `bun run index.ts`:
 
 ```typescript
-import { supertools, defineTool, z } from '@supertools-ai/core';
+import { supertools, defineTool, z, SANDBOX_TEMPLATE } from '@supertools-ai/core';
 import { Sandbox } from 'e2b';
 import Anthropic from '@anthropic-ai/sdk';
 
@@ -88,8 +88,8 @@ const getOrders = defineTool({
     status ? orders.filter(o => o.status === status) : orders,
 });
 
-// Main - use "supertools-bun-014" E2B template - should match your supertools version
-const sandbox = await Sandbox.create('supertools-bun-014').catch((e) => {
+// SANDBOX_TEMPLATE is exported by supertools - always use it to ensure compatibility
+const sandbox = await Sandbox.create(SANDBOX_TEMPLATE).catch((e) => {
   console.error('Failed to create sandbox:', e);
   process.exit(1);
 });
@@ -179,11 +179,11 @@ The benchmark compares three approaches on the same model (Claude Sonnet 4.5):
 Wrap any supported LLM SDK client with programmatic tool calling.
 
 ```typescript
-import { supertools, defineTool, z } from '@supertools-ai/core';
+import { supertools, defineTool, z, SANDBOX_TEMPLATE } from '@supertools-ai/core';
 import { Sandbox } from 'e2b';
 import Anthropic from '@anthropic-ai/sdk';
 
-const sandbox = await Sandbox.create('supertools-bun-014');
+const sandbox = await Sandbox.create(SANDBOX_TEMPLATE);
 const client = supertools(new Anthropic(), {
   // Required
   tools: [defineTool({ name, description, parameters, execute })],
@@ -259,7 +259,7 @@ const calculateStats = defineTool({
 For more control, use the executor directly:
 
 ```typescript
-import { createExecutor, defineTool } from '@supertools-ai/core';
+import { createExecutor, defineTool, SANDBOX_TEMPLATE } from '@supertools-ai/core';
 import { Sandbox } from 'e2b';
 
 // Create your own LLM adapter
@@ -270,7 +270,7 @@ const myAdapter = {
   },
 };
 
-const sandbox = await Sandbox.create('supertools-bun-014');
+const sandbox = await Sandbox.create(SANDBOX_TEMPLATE);
 const executor = createExecutor({
   llm: myAdapter,
   tools: [/* your tools */],

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @example
  * ```ts
- * import { supertools, defineTool, z } from '@supertools-ai/core';
+ * import { supertools, defineTool, z, SANDBOX_TEMPLATE } from '@supertools-ai/core';
  * import { Sandbox } from 'e2b';
  * import Anthropic from '@anthropic-ai/sdk';
  *
@@ -20,7 +20,7 @@
  * });
  *
  * // Create sandbox and wrap your SDK client
- * const sandbox = await Sandbox.create('supertools-bun-014');
+ * const sandbox = await Sandbox.create(SANDBOX_TEMPLATE);
  * const client = supertools(new Anthropic(), { tools: [queryDb], sandbox });
  *
  * // Use exactly like normal - tools execute automatically
@@ -33,6 +33,8 @@
  *
  * @packageDocumentation
  */
+/** The recommended E2B sandbox template for this version of supertools */
+export declare const SANDBOX_TEMPLATE = "supertools-bun-014";
 export { supertools, detectProvider } from './supertools';
 export type { SupertoolsConfig, SupportedProvider } from './supertools';
 export { defineTool, z } from './tool';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -2637,17 +2637,26 @@ class RelayClient {
     }
   }
   onMessage(data) {
-    if (!(data instanceof ArrayBuffer)) {
+    if (typeof data === "string") {
+      const error = `Sandbox template version mismatch. You are using an old sandbox template that uses JSON protocol. Please update to 'supertools-bun-014' or later: Sandbox.create('supertools-bun-014')`;
+      this.log(error);
+      this.state.error = error;
+      this.state.resolver?.({ success: false, error });
+      this.state.resolver = null;
+      return;
+    }
+    const buffer = this.toArrayBuffer(data);
+    if (!buffer) {
       this.log("Expected binary message");
       return;
     }
-    if (data.byteLength > MAX_MESSAGE_SIZE) {
-      this.log(`Message too large: ${data.byteLength}`);
+    if (buffer.byteLength > MAX_MESSAGE_SIZE) {
+      this.log(`Message too large: ${buffer.byteLength}`);
       return;
     }
     let msg;
     try {
-      msg = decode(data);
+      msg = decode(buffer);
     } catch (e) {
       this.log("Decode error:", e);
       return;
@@ -2696,6 +2705,18 @@ class RelayClient {
       this.send("tool_result", { id, success: false, error });
     }
   }
+  toArrayBuffer(data) {
+    if (data instanceof ArrayBuffer) {
+      return data;
+    }
+    if (ArrayBuffer.isView(data)) {
+      const { buffer, byteOffset, byteLength } = data;
+      if (buffer instanceof ArrayBuffer) {
+        return buffer.slice(byteOffset, byteOffset + byteLength);
+      }
+    }
+    return null;
+  }
   send(type, payload) {
     if (!this.connected) {
       this.log("Not connected");
@@ -16932,6 +16953,9 @@ function supertools(client, config2) {
       throw new ConfigurationError(`Unknown provider: ${provider}`);
   }
 }
+
+// src/index.ts
+var SANDBOX_TEMPLATE = "supertools-bun-014";
 export {
   exports_external as z,
   supertools,
@@ -16945,6 +16969,7 @@ export {
   buildSystemPrompt,
   ToolError,
   SandboxError,
+  SANDBOX_TEMPLATE,
   RelayTimeoutError,
   RelayConnectionError,
   ProgrammaticExecutor,

package/dist/relay/client.d.ts

@@ -1,6 +1,7 @@
 /**
  * Relay Client
  *
+ *
  * WebSocket client for bidirectional communication with the sandbox relay.
  * Uses Protocol Buffers for efficient binary encoding.
  */
@@ -39,6 +40,7 @@ export declare class RelayClient {
     private onMessage;
     private handleMessage;
     private handleToolCall;
+    private toArrayBuffer;
     private send;
 }
 export declare function createRelayClient(config: RelayClientConfig): RelayClient;

package/dist/relay/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAO/C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAqBD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoF;IAC3G,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAEvD,OAAO,CAAC,KAAK,CAIX;gBAEU,MAAM,EAAE,iBAAiB;IAgBrC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAM3F,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqB/E,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,gBAAgB;YAqCV,SAAS;IAoBvB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,aAAa;YAyBP,cAAc;IAwB5B,OAAO,CAAC,IAAI;CAYb;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAO/C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAqBD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoF;IAC3G,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAEvD,OAAO,CAAC,KAAK,CAIX;gBAEU,MAAM,EAAE,iBAAiB;IAgBrC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAM3F,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqB/E,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,gBAAgB;YAqCV,SAAS;IAoBvB,OAAO,CAAC,SAAS;IAkCjB,OAAO,CAAC,aAAa;YAyBP,cAAc;IAwB5B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,IAAI;CAYb;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supertools-ai/core",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Programmatic tool calling for LLMs - let AI write code that orchestrates your tools",
   "type": "module",
   "main": "./dist/index.js",