@ekairos/sandbox 1.22.15-beta.development.0 → 1.22.16-beta.development.0

package/dist/vercel-options.js

@@ -0,0 +1,149 @@
+const DEFAULT_EPHEMERAL_TIMEOUT_MS = 5 * 60 * 1000;
+const DEFAULT_CODING_AGENT_TIMEOUT_MS = 20 * 60 * 1000;
+const DEFAULT_SNAPSHOT_EXPIRATION_MS = 7 * 24 * 60 * 60 * 1000;
+const MAX_VERCEL_TIMEOUT_MS = 5 * 60 * 60 * 1000;
+const MAX_VERCEL_VCPUS = 8;
+const MAX_VERCEL_PORTS = 15;
+const MAX_VERCEL_TAGS = 5;
+function parseOptionalBoolean(value) {
+    const normalized = String(value ?? "").trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (["1", "true", "yes", "y", "on"].includes(normalized))
+        return true;
+    if (["0", "false", "no", "n", "off"].includes(normalized))
+        return false;
+    return undefined;
+}
+function parseOptionalNumber(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function clampInteger(value, min, max) {
+    return Math.min(max, Math.max(min, Math.floor(value)));
+}
+function inferProfile(config, env) {
+    const explicit = String(config.vercel?.profile ?? env.SANDBOX_VERCEL_PROFILE ?? "")
+        .trim()
+        .toLowerCase();
+    if (explicit === "coding-agent" || explicit === "agent" || explicit === "codex")
+        return "coding-agent";
+    if (explicit === "ephemeral" || explicit === "cost")
+        return "ephemeral";
+    const purpose = String(config.purpose ?? "").toLowerCase();
+    if (purpose.includes("codex") || purpose.includes("coding-agent") || purpose.includes("agent")) {
+        return "coding-agent";
+    }
+    return "ephemeral";
+}
+function normalizePorts(ports) {
+    if (!Array.isArray(ports))
+        return [];
+    const normalized = ports
+        .map((port) => Number(port))
+        .filter((port) => Number.isFinite(port) && port > 0)
+        .map((port) => Math.floor(port));
+    return Array.from(new Set(normalized)).slice(0, MAX_VERCEL_PORTS);
+}
+function normalizeTagKey(value) {
+    return value
+        .trim()
+        .replace(/[^a-zA-Z0-9_.:-]/g, "_")
+        .slice(0, 64);
+}
+function normalizeTagValue(value) {
+    return value.trim().slice(0, 128);
+}
+function setTag(tags, key, value) {
+    if (Object.keys(tags).length >= MAX_VERCEL_TAGS)
+        return;
+    const normalizedKey = normalizeTagKey(String(key ?? ""));
+    const normalizedValue = normalizeTagValue(String(value ?? ""));
+    if (!normalizedKey || !normalizedValue)
+        return;
+    tags[normalizedKey] = normalizedValue;
+}
+function resolveTags(config, resolved, sandboxId) {
+    const tags = {};
+    setTag(tags, "ekairos", "1");
+    setTag(tags, "profile", resolved.profile);
+    if (config.purpose)
+        setTag(tags, "purpose", config.purpose);
+    if (sandboxId)
+        setTag(tags, "sandboxId", sandboxId);
+    for (const [key, value] of Object.entries(config.vercel?.tags ?? {})) {
+        setTag(tags, key, value);
+    }
+    return Object.keys(tags).length > 0 ? tags : undefined;
+}
+export function resolveVercelSandboxConfig(config, opts) {
+    const env = opts?.env ?? process.env;
+    const profile = inferProfile(config, env);
+    const isCodingAgent = profile === "coding-agent";
+    const timeoutFromConfig = parseOptionalNumber(config.timeoutMs);
+    const timeoutFromEnv = parseOptionalNumber(env.SANDBOX_VERCEL_TIMEOUT_MS);
+    const timeoutDefault = isCodingAgent ? DEFAULT_CODING_AGENT_TIMEOUT_MS : DEFAULT_EPHEMERAL_TIMEOUT_MS;
+    const timeoutMs = clampInteger(timeoutFromConfig ?? timeoutFromEnv ?? timeoutDefault, 1000, MAX_VERCEL_TIMEOUT_MS);
+    const vcpusFromConfig = parseOptionalNumber(config.resources?.vcpus);
+    const vcpusFromEnv = parseOptionalNumber(env.SANDBOX_VERCEL_VCPUS);
+    const vcpusDefault = isCodingAgent ? 2 : 1;
+    const vcpus = clampInteger(vcpusFromConfig ?? vcpusFromEnv ?? vcpusDefault, 1, MAX_VERCEL_VCPUS);
+    const name = String(config.vercel?.name ?? env.SANDBOX_VERCEL_NAME ?? "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .slice(0, 80) || undefined;
+    const persistent = config.vercel?.persistent ??
+        parseOptionalBoolean(env.SANDBOX_VERCEL_PERSISTENT) ??
+        isCodingAgent;
+    const reuse = config.vercel?.reuse ??
+        parseOptionalBoolean(env.SANDBOX_VERCEL_REUSE) ??
+        Boolean(persistent && name);
+    const deleteOnStop = config.vercel?.deleteOnStop ??
+        parseOptionalBoolean(env.SANDBOX_VERCEL_DELETE_ON_STOP) ??
+        !persistent;
+    const snapshotExpirationFromConfig = parseOptionalNumber(config.vercel?.snapshotExpirationMs);
+    const snapshotExpirationFromEnv = parseOptionalNumber(env.SANDBOX_VERCEL_SNAPSHOT_EXPIRATION_MS);
+    const snapshotExpirationMs = snapshotExpirationFromConfig ??
+        snapshotExpirationFromEnv ??
+        (persistent ? DEFAULT_SNAPSHOT_EXPIRATION_MS : undefined);
+    const base = {
+        profile,
+        runtime: String(config.runtime ?? "node22"),
+        timeoutMs,
+        ports: normalizePorts(config.ports),
+        vcpus,
+        ...(name ? { name } : {}),
+        reuse,
+        persistent,
+        deleteOnStop,
+        ...(snapshotExpirationMs !== undefined
+            ? { snapshotExpirationMs: Math.max(0, Math.floor(snapshotExpirationMs)) }
+            : {}),
+    };
+    return {
+        ...base,
+        tags: resolveTags(config, base, opts?.sandboxId),
+    };
+}
+export function safeVercelConfigForRecord(config, resolved) {
+    const { token: _token, ...safeConfig } = config.vercel ?? {};
+    return {
+        ...safeConfig,
+        profile: resolved.profile,
+        runtime: resolved.runtime,
+        timeoutMs: resolved.timeoutMs,
+        vcpus: resolved.vcpus,
+        ports: resolved.ports,
+        persistent: resolved.persistent,
+        deleteOnStop: resolved.deleteOnStop,
+        reuse: resolved.reuse,
+        ...(resolved.name ? { name: resolved.name } : {}),
+        ...(resolved.snapshotExpirationMs !== undefined
+            ? { snapshotExpirationMs: resolved.snapshotExpirationMs }
+            : {}),
+        ...(resolved.tags ? { tags: resolved.tags } : {}),
+    };
+}
+//# sourceMappingURL=vercel-options.js.map

package/dist/vercel-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-options.js","sourceRoot":"","sources":["../src/vercel-options.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekairos/sandbox",
-  "version": "1.22.15-beta.development.0",
+  "version": "1.22.16-beta.development.0",
   "description": "Pulzar Sandbox - Provider-agnostic sandbox helpers",
   "type": "module",
   "main": "dist/index.js",
@@ -54,7 +54,7 @@
   },
   "dependencies": {
     "@daytonaio/sdk": "^0.134.0",
-    "@ekairos/domain": "^1.22.15-beta.development.0",
+    "@ekairos/domain": "^1.22.16-beta.development.0",
     "@instantdb/admin": "0.22.158",
     "@instantdb/core": "0.22.158",
     "@vercel/sandbox": "2.0.0-beta.13",