@tangle-network/sandbox 0.9.7 → 0.10.1

package/dist/tangle/index.d.ts

@@ -1,2 +1,2 @@
-import { a as TANGLE_JOBS_CONTRACT, c as AgentSandboxBlueprintAbi, d as SandboxCreateParamTypes, f as SandboxCreateResponseParamTypes, i as TANGLE_CHAIN_ID, l as ITangleJobsAbi, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, p as SandboxIdParamTypes, r as JOB_SANDBOX_DELETE, s as TangleSandboxClientConfig, t as TangleSandboxClient, u as JsonResponseParamTypes } from "../index-DLH5MBrq.js";
+import { a as TANGLE_JOBS_CONTRACT, c as AgentSandboxBlueprintAbi, d as SandboxCreateParamTypes, f as SandboxCreateResponseParamTypes, i as TANGLE_CHAIN_ID, l as ITangleJobsAbi, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, p as SandboxIdParamTypes, r as JOB_SANDBOX_DELETE, s as TangleSandboxClientConfig, t as TangleSandboxClient, u as JsonResponseParamTypes } from "../index-DS4SOkKG.js";
 export { AgentSandboxBlueprintAbi, ITangleJobsAbi, JOB_SANDBOX_CREATE, JOB_SANDBOX_DELETE, JsonResponseParamTypes, SandboxCreateParamTypes, SandboxCreateResponseParamTypes, SandboxIdParamTypes, TANGLE_CHAIN_ID, TANGLE_JOBS_CONTRACT, TANGLE_MAINNET_RPC, TangleSandboxClient, TangleSandboxClientConfig };

package/dist/tangle/index.js

@@ -1,2 +1,2 @@
-import { a as TANGLE_JOBS_CONTRACT, c as ITangleJobsAbi, d as SandboxCreateResponseParamTypes, f as SandboxIdParamTypes, i as TANGLE_CHAIN_ID, l as JsonResponseParamTypes, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, r as JOB_SANDBOX_DELETE, s as AgentSandboxBlueprintAbi, t as TangleSandboxClient, u as SandboxCreateParamTypes } from "../tangle-CMGJEZit.js";
+import { a as TANGLE_JOBS_CONTRACT, c as ITangleJobsAbi, d as SandboxCreateResponseParamTypes, f as SandboxIdParamTypes, i as TANGLE_CHAIN_ID, l as JsonResponseParamTypes, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, r as JOB_SANDBOX_DELETE, s as AgentSandboxBlueprintAbi, t as TangleSandboxClient, u as SandboxCreateParamTypes } from "../tangle-DayyZe-i.js";
 export { AgentSandboxBlueprintAbi, ITangleJobsAbi, JOB_SANDBOX_CREATE, JOB_SANDBOX_DELETE, JsonResponseParamTypes, SandboxCreateParamTypes, SandboxCreateResponseParamTypes, SandboxIdParamTypes, TANGLE_CHAIN_ID, TANGLE_JOBS_CONTRACT, TANGLE_MAINNET_RPC, TangleSandboxClient };

package/dist/{tangle-CMGJEZit.js → tangle-DayyZe-i.js}

@@ -1,4 +1,5 @@
-import { t as SandboxInstance } from "./sandbox-bDWrUu8i.js";
+import { t as SandboxInstance } from "./sandbox-CeimsfC8.js";
+import { p as parseErrorResponse } from "./errors-DSz87Rkk.js";
 //#region src/tangle/abi.ts
 /**
 * Tangle Contract ABI Definitions
@@ -90,7 +91,7 @@ const ITangleJobsAbi = [
 			{
 				name: "jobIndex",
 				type: "uint8",
-				indexed: true
+				indexed: false
 			},
 			{
 				name: "caller",
@@ -161,8 +162,8 @@ const SandboxCreateParamTypes = [
 		type: "bool"
 	},
 	{
-		name: "ssh_public_keys",
-		type: "string[]"
+		name: "ssh_public_key",
+		type: "string"
 	},
 	{
 		name: "web_terminal_enabled",
@@ -456,7 +457,7 @@ var TangleChainClient = class {
 				options.env ? JSON.stringify(options.env) : "",
 				options.metadata ? JSON.stringify(options.metadata) : "",
 				options.sshEnabled ?? false,
-				options.sshPublicKeys ?? (options.sshPublicKey ? [options.sshPublicKey] : []),
+				options.sshPublicKey ?? options.sshPublicKeys?.[0] ?? "",
 				options.webTerminalEnabled ?? false,
 				BigInt(options.maxLifetimeSeconds ?? 0),
 				BigInt(options.idleTimeoutSeconds ?? 0),
@@ -572,6 +573,14 @@ var TangleChainClient = class {
 };
 //#endregion
 //#region src/tangle/client.ts
+/**
+* TangleSandboxClient — on-chain sandbox lifecycle via EVM calls.
+*
+* Implements HttpClient so `SandboxInstance` works unchanged. Lifecycle
+* operations (create/stop/resume/delete) go on-chain via Tangle jobs, and
+* runtime operations are routed directly to the sandbox runtime URL
+* returned by the on-chain job result.
+*/
 function randomHexToken(bytes) {
 	if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.getRandomValues !== "function") throw new Error("randomHexToken: globalThis.crypto.getRandomValues is unavailable; this runtime cannot generate cryptographically secure nonces. Run on a host with WebCrypto support (Node 20+, browsers, Workers).");
 	const buf = new Uint8Array(bytes);
@@ -613,6 +622,81 @@ function requirePathGroup(match, index) {
 	if (value === void 0) throw new Error(`Path matcher missing group ${index}`);
 	return value;
 }
+function asRecord(value) {
+	return value && typeof value === "object" ? value : void 0;
+}
+function readString(record, keys) {
+	if (!record) return void 0;
+	for (const key of keys) {
+		const value = record[key];
+		if (typeof value === "string" && value.length > 0) return value;
+	}
+}
+function entryMetadata(entry) {
+	const metadata = {
+		...entry.metadata ?? {},
+		...entry.teeAttestationJson ? { teeAttestationJson: entry.teeAttestationJson } : {},
+		...entry.teePublicKeyJson ? { teePublicKeyJson: entry.teePublicKeyJson } : {},
+		...entry.attestationNonce ? { attestationNonce: entry.attestationNonce } : {}
+	};
+	return Object.keys(metadata).length > 0 ? metadata : void 0;
+}
+function sandboxInfoFromEntry(entry) {
+	return {
+		id: entry.id,
+		name: entry.name,
+		status: entry.status === "deleted" ? "stopped" : entry.status,
+		connection: entry.runtimeUrl ? {
+			runtimeUrl: entry.runtimeUrl,
+			authToken: entry.runtimeToken
+		} : void 0,
+		metadata: entryMetadata(entry),
+		createdAt: entry.createdAt
+	};
+}
+function sandboxEntryFromWire(fallbackId, raw) {
+	const connection = asRecord(raw.connection);
+	const metadata = asRecord(raw.metadata);
+	const id = readString(raw, [
+		"id",
+		"sandboxId",
+		"sandbox_id"
+	]) ?? fallbackId;
+	const runtimeUrl = readString(connection, [
+		"runtimeUrl",
+		"sidecarUrl",
+		"sidecar_url"
+	]) ?? readString(raw, [
+		"runtimeUrl",
+		"sidecarUrl",
+		"sidecar_url"
+	]) ?? "";
+	const runtimeToken = readString(connection, [
+		"authToken",
+		"runtimeToken",
+		"sidecarToken"
+	]) ?? readString(raw, [
+		"authToken",
+		"runtimeToken",
+		"sidecarToken",
+		"token"
+	]) ?? "";
+	const rawStatus = readString(raw, ["status"]) ?? "running";
+	const createdAtRaw = readString(raw, ["createdAt", "created_at"]);
+	const createdAt = createdAtRaw ? new Date(createdAtRaw) : /* @__PURE__ */ new Date();
+	return {
+		id,
+		name: readString(raw, ["name"]),
+		runtimeUrl,
+		runtimeToken,
+		status: rawStatus === "stopped" || rawStatus === "deleted" || rawStatus === "running" ? rawStatus : "running",
+		createdAt,
+		metadata,
+		teeAttestationJson: readString(raw, ["teeAttestationJson"]),
+		teePublicKeyJson: readString(raw, ["teePublicKeyJson"]),
+		attestationNonce: readString(raw, ["attestationNonce"])
+	};
+}
 var TangleSandboxClient = class {
 	chain;
 	sandboxes = /* @__PURE__ */ new Map();
@@ -649,32 +733,32 @@ var TangleSandboxClient = class {
 		if (runtimeUrl && !runtimeToken) throw new Error("Create job returned a runtime URL without an auth token");
 		const entry = {
 			id: sandboxId,
+			name: options?.name,
 			runtimeUrl,
 			runtimeToken,
 			status: "running",
 			createdAt: /* @__PURE__ */ new Date(),
+			metadata: createOptions.metadata,
 			teeAttestationJson: responseJson.teeAttestationJson,
 			teePublicKeyJson: responseJson.teePublicKeyJson,
 			attestationNonce: attestationNonceFromOptions(createOptions)
 		};
 		this.sandboxes.set(sandboxId, entry);
-		const info = {
-			id: sandboxId,
-			name: options?.name,
-			status: "running",
-			connection: runtimeUrl ? {
-				runtimeUrl,
-				authToken: runtimeToken
-			} : void 0,
-			metadata: {
-				...createOptions.metadata ?? {},
-				...entry.teeAttestationJson ? { teeAttestationJson: entry.teeAttestationJson } : {},
-				...entry.teePublicKeyJson ? { teePublicKeyJson: entry.teePublicKeyJson } : {},
-				...entry.attestationNonce ? { attestationNonce: entry.attestationNonce } : {}
-			},
-			createdAt: entry.createdAt
-		};
-		return new SandboxInstance(this, info);
+		return new SandboxInstance(this, sandboxInfoFromEntry(entry));
+	}
+	/**
+	* Get a sandbox by id. Rehydrates from the operator API when configured so
+	* app servers can resolve sandboxes created by earlier requests.
+	*/
+	async get(id) {
+		const response = await this.fetch(`/v1/sandboxes/${encodeURIComponent(id)}`);
+		if (response.status === 404) return null;
+		if (!response.ok) {
+			const body = await response.text();
+			throw parseErrorResponse(response.status, body, void 0, response.headers);
+		}
+		const data = await response.json();
+		return new SandboxInstance(this, sandboxInfoFromEntry(sandboxEntryFromWire(id, data)));
 	}
 	/**
 	* Route interception for SandboxInstance lifecycle calls.
@@ -696,22 +780,16 @@ var TangleSandboxClient = class {
 		const getMatch = path.match(/^\/v1\/sandboxes\/([^/]+)$/);
 		if (getMatch && method === "GET") {
 			const id = decodeURIComponent(requirePathGroup(getMatch, 1));
-			const entry = this.sandboxes.get(id);
+			let entry = this.sandboxes.get(id);
+			if (!entry && this.operatorApiUrl) {
+				const operatorResponse = await this.fetchOperatorApi(`/api/sandboxes/${encodeURIComponent(id)}`, { method: "GET" });
+				if (!operatorResponse.ok) return operatorResponse;
+				entry = sandboxEntryFromWire(id, await operatorResponse.json());
+				this.sandboxes.set(entry.id, entry);
+			}
 			if (!entry) return new Response(JSON.stringify({ error: "Not found" }), { status: 404 });
-			return new Response(JSON.stringify({
-				id: entry.id,
-				status: entry.status,
-				connection: entry.runtimeUrl ? {
-					runtimeUrl: entry.runtimeUrl,
-					authToken: entry.runtimeToken
-				} : void 0,
-				metadata: {
-					...entry.teeAttestationJson ? { teeAttestationJson: entry.teeAttestationJson } : {},
-					...entry.teePublicKeyJson ? { teePublicKeyJson: entry.teePublicKeyJson } : {},
-					...entry.attestationNonce ? { attestationNonce: entry.attestationNonce } : {}
-				},
-				createdAt: entry.createdAt.toISOString()
-			}), {
+			const info = sandboxInfoFromEntry(entry);
+			return new Response(JSON.stringify(info), {
 				status: 200,
 				headers: { "Content-Type": "application/json" }
 			});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox",
-  "version": "0.9.7",
+  "version": "0.10.1",
   "description": "Client SDK for the Tangle Sandbox platform - build AI agent applications with dev containers",
   "type": "module",
   "main": "./dist/index.js",
@@ -82,8 +82,8 @@
     "url": "https://github.com/tangle-network/agent-dev-container/issues"
   },
   "dependencies": {
-    "@tangle-network/agent-core": "^0.3.3",
-    "@tangle-network/agent-interface": "^0.13.0"
+    "@tangle-network/agent-core": "^0.4.0",
+    "@tangle-network/agent-interface": "^0.21.0"
   },
   "peerDependencies": {
     "@mastra/core": "^1.36.0",