@claxedo/sandbox-manager 0.5.1

package/dist/service-url-exposure.d.ts

@@ -0,0 +1,10 @@
+import type { SandboxDriverID } from "./driver-catalog";
+export type SandboxServiceUrlExposure = {
+    source: "driver-service-url";
+    access: "private" | "public" | "driver-authenticated" | "unknown";
+    driver: SandboxDriverID;
+    fallbackAccess?: "private" | "public" | "driver-authenticated" | "unknown";
+    note?: string;
+};
+export declare function sandboxServiceUrlExposure(driver: SandboxDriverID): SandboxServiceUrlExposure;
+export declare function sandboxServiceUrlExposureEnv(driver: SandboxDriverID): Record<string, string>;

package/dist/service-url-exposure.mjs

@@ -0,0 +1,46 @@
+import { createRequire as __createRequire } from 'module';var require = __createRequire(import.meta.url);
+
+// src/runtime-env.ts
+function workspaceRuntimeServiceExposureEnv(input) {
+  return {
+    ...input.driver === "docker" ? { WORKSPACE_RUNTIME_HOST: "0.0.0.0" } : {},
+    WORKSPACE_RUNTIME_SERVICE_EXPOSURE_SOURCE: input.source,
+    WORKSPACE_RUNTIME_SERVICE_EXPOSURE_ACCESS: input.access,
+    WORKSPACE_RUNTIME_SERVICE_EXPOSURE_DRIVER: input.driver,
+    ...input.fallbackAccess ? { WORKSPACE_RUNTIME_SERVICE_EXPOSURE_FALLBACK_ACCESS: input.fallbackAccess } : {},
+    ...input.note ? { WORKSPACE_RUNTIME_SERVICE_EXPOSURE_NOTE: input.note } : {}
+  };
+}
+
+// src/service-url-exposure.ts
+function sandboxServiceUrlExposure(driver) {
+  if (driver === "docker") {
+    return {
+      source: "driver-service-url",
+      access: "private",
+      driver,
+      note: "Docker service URLs resolve to a local loopback port on the host."
+    };
+  }
+  if (driver === "daytona") {
+    return {
+      source: "driver-service-url",
+      access: "driver-authenticated",
+      driver,
+      fallbackAccess: "public",
+      note: "Daytona uses a signed preview URL when available and falls back to a preview link."
+    };
+  }
+  return {
+    source: "driver-service-url",
+    access: "public",
+    driver
+  };
+}
+function sandboxServiceUrlExposureEnv(driver) {
+  return workspaceRuntimeServiceExposureEnv(sandboxServiceUrlExposure(driver));
+}
+export {
+  sandboxServiceUrlExposure,
+  sandboxServiceUrlExposureEnv
+};

package/dist/stores/memory.d.ts

@@ -0,0 +1,6 @@
+import type { SandboxLeaseStore, SandboxLease, SandboxRegion } from "..";
+export declare function createMemoryLeaseStore(seed?: SandboxLease[]): SandboxLeaseStore;
+export declare function sandboxLease(input: Partial<SandboxLease> & {
+    workspaceId: string;
+    homeRegion?: SandboxRegion;
+}): SandboxLease;

package/dist/stores/memory.mjs

@@ -0,0 +1,117 @@
+import { createRequire as __createRequire } from 'module';var require = __createRequire(import.meta.url);
+
+// src/index.ts
+function applySandboxLeasePatch(current, patch, updatedAt) {
+  return {
+    ...current,
+    ...patch.status === void 0 ? {} : { status: patch.status },
+    ...patch.sandboxId === void 0 ? {} : { sandboxId: patch.sandboxId },
+    ...patch.url === void 0 ? {} : { url: patch.url },
+    ...patch.hostId === void 0 ? {} : { hostId: patch.hostId },
+    ...patch.driverResourceId === void 0 ? {} : { driverResourceId: patch.driverResourceId },
+    ...patch.retryCount === void 0 ? {} : { retryCount: patch.retryCount },
+    ...patch.lastHeartbeatAt === void 0 ? {} : { lastHeartbeatAt: patch.lastHeartbeatAt },
+    ...patch.lastActivityAt === void 0 ? {} : { lastActivityAt: patch.lastActivityAt },
+    ...patch.labels === void 0 ? {} : { labels: patch.labels },
+    ...patch.nextRetryAt === void 0 ? {} : { nextRetryAt: patch.nextRetryAt ?? void 0 },
+    ...patch.lastError === void 0 ? {} : { lastError: patch.lastError ?? void 0 },
+    updatedAt
+  };
+}
+
+// src/stores/memory.ts
+function createMemoryLeaseStore(seed = []) {
+  const leases = new Map(seed.map((lease) => [lease.workspaceId, { ...lease }]));
+  return {
+    async acquire(workspaceId, input) {
+      const now = input.now ?? Date.now();
+      const current = leases.get(workspaceId);
+      if (current?.status === "ready") {
+        return { acquired: false, lease: current, retryAfterMs: 0 };
+      }
+      if (current?.status === "acquiring" && now - current.updatedAt < input.staleAfterMs) {
+        return {
+          acquired: false,
+          lease: current,
+          retryAfterMs: Math.max(0, input.staleAfterMs - (now - current.updatedAt))
+        };
+      }
+      const resumable = current?.status === "stopped";
+      const next = {
+        workspaceId,
+        homeRegion: current?.homeRegion ?? input.homeRegion,
+        driver: current?.driver ?? input.driver,
+        epoch: (current?.epoch ?? 0) + 1,
+        status: "acquiring",
+        retryCount: current?.retryCount ?? 0,
+        createdAt: current?.createdAt ?? now,
+        updatedAt: now,
+        sandboxId: resumable ? current.sandboxId : void 0,
+        url: resumable ? current.url : void 0,
+        hostId: resumable ? current.hostId : void 0,
+        driverResourceId: resumable ? current.driverResourceId : void 0,
+        lastHeartbeatAt: resumable ? current.lastHeartbeatAt : void 0,
+        lastActivityAt: resumable ? current.lastActivityAt : void 0,
+        labels: resumable ? current.labels : void 0
+      };
+      leases.set(workspaceId, next);
+      return { acquired: true, lease: next };
+    },
+    async update(workspaceId, expectedEpoch, patch) {
+      const current = leases.get(workspaceId);
+      if (!current || current.epoch !== expectedEpoch) return;
+      const next = applySandboxLeasePatch(current, patch, Date.now());
+      leases.set(workspaceId, next);
+      return next;
+    },
+    async recordFailure(workspaceId, expectedEpoch, error, nextRetryAt) {
+      const current = leases.get(workspaceId);
+      if (!current || current.epoch !== expectedEpoch) return;
+      const next = {
+        ...current,
+        status: "unavailable",
+        retryCount: current.retryCount + 1,
+        lastError: error,
+        nextRetryAt,
+        updatedAt: Date.now()
+      };
+      leases.set(workspaceId, next);
+      return next;
+    },
+    async release(workspaceId) {
+      leases.delete(workspaceId);
+    },
+    async get(workspaceId) {
+      const lease = leases.get(workspaceId);
+      return lease ? { ...lease, labels: lease.labels ? { ...lease.labels } : void 0 } : void 0;
+    },
+    async list() {
+      return [...leases.values()].map((lease) => ({ ...lease }));
+    }
+  };
+}
+function sandboxLease(input) {
+  return {
+    workspaceId: input.workspaceId,
+    homeRegion: input.homeRegion ?? "us-east",
+    driver: input.driver ?? "test",
+    epoch: input.epoch ?? 1,
+    status: input.status ?? "ready",
+    retryCount: input.retryCount ?? 0,
+    createdAt: input.createdAt ?? Date.now(),
+    updatedAt: input.updatedAt ?? Date.now(),
+    sandboxId: input.sandboxId,
+    url: input.url,
+    hostId: input.hostId,
+    driverResourceId: input.driverResourceId,
+    nextRetryAt: input.nextRetryAt,
+    lastError: input.lastError,
+    lastHeartbeatAt: input.lastHeartbeatAt,
+    lastActivityAt: input.lastActivityAt,
+    labels: input.labels
+  };
+}
+export {
+  createMemoryLeaseStore,
+  sandboxLease
+};

package/package.json

@@ -0,0 +1,178 @@
+{
+  "name": "@claxedo/sandbox-manager",
+  "version": "0.5.1",
+  "type": "module",
+  "description": "Sandbox lifecycle manager with epoch-based leases and pluggable drivers for Daytona, Modal, Vercel Sandbox, Cloudflare, and Docker",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kyashrathore/Claxedo.git",
+    "directory": "packages/sandbox-manager"
+  },
+  "keywords": [
+    "claxedo",
+    "sandbox",
+    "daytona",
+    "modal",
+    "agents"
+  ],
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./dist/index.mjs",
+      "development": "./dist/index.mjs",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./command": {
+      "types": "./dist/command.d.ts",
+      "bun": "./dist/command.mjs",
+      "development": "./dist/command.mjs",
+      "import": "./dist/command.mjs",
+      "default": "./dist/command.mjs"
+    },
+    "./constants": {
+      "types": "./dist/constants.d.ts",
+      "bun": "./dist/constants.mjs",
+      "development": "./dist/constants.mjs",
+      "import": "./dist/constants.mjs",
+      "default": "./dist/constants.mjs"
+    },
+    "./defaults": {
+      "types": "./dist/defaults.d.ts",
+      "bun": "./dist/defaults.mjs",
+      "development": "./dist/defaults.mjs",
+      "import": "./dist/defaults.mjs",
+      "default": "./dist/defaults.mjs"
+    },
+    "./driver-catalog": {
+      "types": "./dist/driver-catalog.d.ts",
+      "bun": "./dist/driver-catalog.mjs",
+      "development": "./dist/driver-catalog.mjs",
+      "import": "./dist/driver-catalog.mjs",
+      "default": "./dist/driver-catalog.mjs"
+    },
+    "./drivers/cloudflare": {
+      "types": "./dist/drivers/cloudflare.d.ts",
+      "bun": "./dist/drivers/cloudflare.mjs",
+      "development": "./dist/drivers/cloudflare.mjs",
+      "import": "./dist/drivers/cloudflare.mjs",
+      "default": "./dist/drivers/cloudflare.mjs"
+    },
+    "./drivers/daytona": {
+      "types": "./dist/drivers/daytona.d.ts",
+      "bun": "./dist/drivers/daytona.mjs",
+      "development": "./dist/drivers/daytona.mjs",
+      "import": "./dist/drivers/daytona.mjs",
+      "default": "./dist/drivers/daytona.mjs"
+    },
+    "./drivers/docker": {
+      "types": "./dist/drivers/docker.d.ts",
+      "bun": "./dist/drivers/docker.mjs",
+      "development": "./dist/drivers/docker.mjs",
+      "import": "./dist/drivers/docker.mjs",
+      "default": "./dist/drivers/docker.mjs"
+    },
+    "./drivers/fetch-bridge": {
+      "types": "./dist/drivers/fetch-bridge.d.ts",
+      "bun": "./dist/drivers/fetch-bridge.mjs",
+      "development": "./dist/drivers/fetch-bridge.mjs",
+      "import": "./dist/drivers/fetch-bridge.mjs",
+      "default": "./dist/drivers/fetch-bridge.mjs"
+    },
+    "./drivers/modal": {
+      "types": "./dist/drivers/modal.d.ts",
+      "bun": "./dist/drivers/modal.mjs",
+      "development": "./dist/drivers/modal.mjs",
+      "import": "./dist/drivers/modal.mjs",
+      "default": "./dist/drivers/modal.mjs"
+    },
+    "./drivers/vercel": {
+      "types": "./dist/drivers/vercel.d.ts",
+      "bun": "./dist/drivers/vercel.mjs",
+      "development": "./dist/drivers/vercel.mjs",
+      "import": "./dist/drivers/vercel.mjs",
+      "default": "./dist/drivers/vercel.mjs"
+    },
+    "./image": {
+      "types": "./dist/image.d.ts",
+      "bun": "./dist/image.mjs",
+      "development": "./dist/image.mjs",
+      "import": "./dist/image.mjs",
+      "default": "./dist/image.mjs"
+    },
+    "./lease-policy": {
+      "types": "./dist/lease-policy.d.ts",
+      "bun": "./dist/lease-policy.mjs",
+      "development": "./dist/lease-policy.mjs",
+      "import": "./dist/lease-policy.mjs",
+      "default": "./dist/lease-policy.mjs"
+    },
+    "./lease-types": {
+      "types": "./dist/lease-types.d.ts",
+      "bun": "./dist/lease-types.mjs",
+      "development": "./dist/lease-types.mjs",
+      "import": "./dist/lease-types.mjs",
+      "default": "./dist/lease-types.mjs"
+    },
+    "./runtime-env": {
+      "types": "./dist/runtime-env.d.ts",
+      "bun": "./dist/runtime-env.mjs",
+      "development": "./dist/runtime-env.mjs",
+      "import": "./dist/runtime-env.mjs",
+      "default": "./dist/runtime-env.mjs"
+    },
+    "./service-url-exposure": {
+      "types": "./dist/service-url-exposure.d.ts",
+      "bun": "./dist/service-url-exposure.mjs",
+      "development": "./dist/service-url-exposure.mjs",
+      "import": "./dist/service-url-exposure.mjs",
+      "default": "./dist/service-url-exposure.mjs"
+    },
+    "./stores/memory": {
+      "types": "./dist/stores/memory.d.ts",
+      "bun": "./dist/stores/memory.mjs",
+      "development": "./dist/stores/memory.mjs",
+      "import": "./dist/stores/memory.mjs",
+      "default": "./dist/stores/memory.mjs"
+    },
+    "./drivers/cloudflare-egress": {
+      "types": "./dist/drivers/cloudflare-egress.d.ts",
+      "bun": "./dist/drivers/cloudflare-egress.mjs",
+      "development": "./dist/drivers/cloudflare-egress.mjs",
+      "import": "./dist/drivers/cloudflare-egress.mjs",
+      "default": "./dist/drivers/cloudflare-egress.mjs"
+    }
+  },
+  "files": [
+    "README.md",
+    "LICENSE",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@claxedo/workspace-runtime": "0.5.1",
+    "@daytona/sdk": "0.192.0",
+    "@vercel/sandbox": "1.10.2",
+    "modal": "0.7.5"
+  },
+  "scripts": {
+    "build": "tsx scripts/build.ts",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "bun test src"
+  },
+  "devDependencies": {
+    "@tsconfig/node-lts": "22.0.4",
+    "@types/bun": "1.3.13",
+    "@types/node": "24.12.2",
+    "esbuild": "0.25.12",
+    "tsx": "4.22.3",
+    "typescript": "5.8.2",
+    "vitest": "2.1.9"
+  }
+}