@ekairos/sandbox 1.22.37-beta.development.0 → 1.22.37

package/dist/contract.js

@@ -0,0 +1,83 @@
+import { z } from "zod";
+export const SANDBOX_EXECUTE_COMMAND_ACTION_NAME = "executeCommand";
+export const SANDBOX_PROCESS_KINDS = [
+    "command",
+    "service",
+    "codex-app-server",
+    "dev-server",
+    "test-runner",
+    "watcher",
+];
+export const SANDBOX_PROCESS_MODES = ["foreground", "background"];
+export const SANDBOX_PROCESS_STATUSES = [
+    "starting",
+    "running",
+    "detached",
+    "exited",
+    "failed",
+    "killed",
+    "lost",
+];
+export const SANDBOX_PROCESS_STREAM_CHUNK_TYPES = [
+    "stdout",
+    "stderr",
+    "status",
+    "exit",
+    "error",
+    "heartbeat",
+    "metadata",
+];
+export const sandboxCommandResultSchema = z
+    .object({
+    success: z.boolean(),
+    exitCode: z.number().optional(),
+    output: z.string().optional(),
+    error: z.string().optional(),
+    streamingLogs: z.array(z.unknown()).optional(),
+    command: z.string().optional(),
+})
+    .passthrough();
+export const sandboxProcessStreamChunkSchema = z
+    .object({
+    version: z.literal(1),
+    at: z.string(),
+    seq: z.number(),
+    type: z.enum(SANDBOX_PROCESS_STREAM_CHUNK_TYPES),
+    sandboxId: z.string(),
+    processId: z.string(),
+    data: z.record(z.string(), z.unknown()).optional(),
+})
+    .passthrough();
+export const sandboxProcessRunResultSchema = z
+    .object({
+    processId: z.string(),
+    streamId: z.string(),
+    streamClientId: z.string(),
+    result: sandboxCommandResultSchema.optional(),
+})
+    .passthrough();
+export const sandboxExecuteCommandInputSchema = z
+    .object({
+    command: z.string().min(1),
+    args: z.array(z.string()).optional(),
+    cwd: z.string().min(1).optional(),
+    env: z.record(z.string(), z.unknown()).optional(),
+    kind: z.enum(SANDBOX_PROCESS_KINDS).optional(),
+    mode: z.enum(SANDBOX_PROCESS_MODES).optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+})
+    .strict();
+export const sandboxExecuteCommandOutputSchema = z.object({
+    sandboxId: z.string().min(1).optional(),
+    processId: z.string().min(1).optional(),
+    streamId: z.string().min(1).optional(),
+    streamClientId: z.string().min(1).optional(),
+    success: z.boolean(),
+    exitCode: z.number().int().optional(),
+    output: z.string().optional(),
+    error: z.string().optional(),
+    command: z.string().optional(),
+    status: z.string().optional(),
+    durationMs: z.number().optional(),
+});
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/domain.d.ts

@@ -0,0 +1,2 @@
+export { sandboxDomain } from "./actions.js";
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/domain.js

@@ -0,0 +1,2 @@
+export { sandboxDomain } from "./actions.js";
+//# sourceMappingURL=domain.js.map

package/dist/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.d.ts

@@ -1,7 +1,11 @@
 export type { SandboxConfig, SandboxId, SandboxProvider, SandboxRunCommandResult, } from "./types.js";
 export { sandboxDomain } from "./actions.js";
 export { sandboxDomain as sandboxSchemaDomain } from "./schema.js";
-export { sandboxDomain as publicSandboxDomain } from "./public.js";
+export { SANDBOX_EXECUTE_COMMAND_ACTION_NAME, SANDBOX_PROCESS_KINDS, SANDBOX_PROCESS_MODES, SANDBOX_PROCESS_STATUSES, SANDBOX_PROCESS_STREAM_CHUNK_TYPES, sandboxCommandResultSchema, sandboxExecuteCommandInputSchema, sandboxExecuteCommandOutputSchema, sandboxProcessRunResultSchema, sandboxProcessStreamChunkSchema, } from "./contract.js";
+export type { SandboxCommandResult, SandboxExecuteCommandInput, SandboxExecuteCommandOutput, SandboxProcessStreamChunkType, } from "./contract.js";
+export { sandboxDomain as publicSandboxDomain, } from "./public.js";
+export { Sandbox } from "./sandbox.js";
+export type { SandboxActions, SerializedSandbox, SerializedSandboxState, } from "./sandbox.js";
 export { SandboxService } from "./service.js";
 export type { CommandResult } from "./commands.js";
 export type { SandboxCommandRunData, SandboxProcessKind, SandboxProcessMode, SandboxProcessRunResult, SandboxProcessStatus, SandboxProcessStreamChunk, } from "./service.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC3F,YAAY,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE5F,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACvD,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzF,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,cAAc,EACd,OAAO,EACP,qBAAqB,EACrB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EACL,mCAAmC,EACnC,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,kCAAkC,EAClC,0BAA0B,EAC1B,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,aAAa,IAAI,mBAAmB,GACrC,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC3F,YAAY,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE5F,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACvD,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzF,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,cAAc,EACd,OAAO,EACP,qBAAqB,EACrB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export { sandboxDomain } from "./actions.js";
 export { sandboxDomain as sandboxSchemaDomain } from "./schema.js";
-export { sandboxDomain as publicSandboxDomain } from "./public.js";
+export { SANDBOX_EXECUTE_COMMAND_ACTION_NAME, SANDBOX_PROCESS_KINDS, SANDBOX_PROCESS_MODES, SANDBOX_PROCESS_STATUSES, SANDBOX_PROCESS_STREAM_CHUNK_TYPES, sandboxCommandResultSchema, sandboxExecuteCommandInputSchema, sandboxExecuteCommandOutputSchema, sandboxProcessRunResultSchema, sandboxProcessStreamChunkSchema, } from "./contract.js";
+export { sandboxDomain as publicSandboxDomain, } from "./public.js";
+export { Sandbox } from "./sandbox.js";
 export { SandboxService } from "./service.js";
 export { SandboxCommandRun } from "./service.js";
 export { runCommandInSandbox } from "./commands.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAU7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAG3F,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAGvD,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,cAAc,EACd,OAAO,EACP,qBAAqB,EACrB,cAAc,GACf,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EACL,mCAAmC,EACnC,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,kCAAkC,EAClC,0BAA0B,EAC1B,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,eAAe,CAAA;AAOtB,OAAO,EACL,aAAa,IAAI,mBAAmB,GACrC,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAMtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAU7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAG3F,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAGvD,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,cAAc,EACd,OAAO,EACP,qBAAqB,EACrB,cAAc,GACf,MAAM,cAAc,CAAA"}

package/dist/providers/daytona.d.ts

@@ -0,0 +1,14 @@
+import { Daytona, Image, type DaytonaConfig } from "@daytonaio/sdk";
+import type { SandboxConfig } from "../types.js";
+export declare function getDaytonaConfig(): DaytonaConfig;
+export declare function resolveDaytonaLanguage(config: SandboxConfig): "python" | "typescript" | "javascript" | undefined;
+export declare function resolveDaytonaVolumes(daytona: Daytona, volumes: Array<{
+    volumeId?: string;
+    volumeName?: string;
+    mountPath: string;
+}>): Promise<Array<{
+    volumeId: string;
+    mountPath: string;
+}>>;
+export declare function buildDeclarativeImage(config: SandboxConfig): Image | undefined;
+//# sourceMappingURL=daytona.d.ts.map

package/dist/providers/daytona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daytona.d.ts","sourceRoot":"","sources":["../../src/providers/daytona.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,wBAAgB,gBAAgB,IAAI,aAAa,CAyBhD;AAiBD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,GACpB,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAOpD;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5E,OAAO,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkEzD;AAYD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,KAAK,GAAG,SAAS,CAkC9E"}

package/dist/providers/daytona.js

@@ -0,0 +1,153 @@
+import { Image } from "@daytonaio/sdk";
+export function getDaytonaConfig() {
+    const apiKey = String(process.env.DAYTONA_API_KEY ?? "").trim();
+    const apiUrl = String(process.env.DAYTONA_API_URL ?? "").trim() ||
+        String(process.env.DAYTONA_SERVER_URL ?? "").trim();
+    const jwtToken = String(process.env.DAYTONA_JWT_TOKEN ?? "").trim();
+    const organizationId = String(process.env.DAYTONA_ORGANIZATION_ID ?? "").trim();
+    const target = String(process.env.DAYTONA_TARGET ?? "").trim();
+    if (!apiUrl) {
+        throw new Error("Missing required Daytona env var: DAYTONA_API_URL (or DAYTONA_SERVER_URL)");
+    }
+    if (!apiKey && !(jwtToken && organizationId)) {
+        throw new Error("Missing required Daytona env vars: DAYTONA_API_KEY or DAYTONA_JWT_TOKEN + DAYTONA_ORGANIZATION_ID");
+    }
+    return {
+        apiUrl,
+        target: target || undefined,
+        apiKey: apiKey || undefined,
+        jwtToken: jwtToken || undefined,
+        organizationId: organizationId || undefined,
+    };
+}
+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 parseCsvList(value) {
+    return String(value ?? "")
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+export function resolveDaytonaLanguage(config) {
+    if (config.daytona?.language)
+        return config.daytona.language;
+    const runtime = String(config.runtime ?? "").toLowerCase();
+    if (runtime.startsWith("python"))
+        return "python";
+    if (runtime.startsWith("node"))
+        return "javascript";
+    if (runtime.startsWith("ts") || runtime.includes("typescript"))
+        return "typescript";
+    return undefined;
+}
+export async function resolveDaytonaVolumes(daytona, volumes) {
+    if (!volumes || volumes.length === 0)
+        return [];
+    const resolved = [];
+    const shouldLog = parseOptionalBoolean(process.env.SANDBOX_DAYTONA_LOG_VOLUMES) ?? false;
+    for (const volume of volumes) {
+        const mountPath = String(volume.mountPath ?? "").trim();
+        if (!mountPath)
+            continue;
+        const volumeId = String(volume.volumeId ?? "").trim();
+        if (volumeId) {
+            resolved.push({ volumeId, mountPath });
+            continue;
+        }
+        const volumeName = String(volume.volumeName ?? "").trim();
+        if (!volumeName) {
+            throw new Error("Daytona volume requires volumeId or volumeName");
+        }
+        let resolvedVolume = await daytona.volume.get(volumeName, true);
+        const stateRaw = String(resolvedVolume?.state ?? "").trim().toLowerCase();
+        const waitStates = new Set([
+            "creating",
+            "provisioning",
+            "pending",
+            "pending_create",
+            "pending-create",
+            "initializing",
+        ]);
+        const readyStates = new Set(["available", "active", "ready"]);
+        if (waitStates.has(stateRaw)) {
+            const maxAttempts = 12;
+            for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+                await new Promise((r) => setTimeout(r, 1000 * attempt));
+                resolvedVolume = await daytona.volume.get(volumeName, true);
+                const state = String(resolvedVolume?.state ?? "").trim().toLowerCase();
+                if (shouldLog) {
+                    console.log(`[daytona:volume] name=${volumeName} state=${state} attempt=${attempt}/${maxAttempts}`);
+                }
+                if (readyStates.has(state))
+                    break;
+            }
+        }
+        const finalState = String(resolvedVolume?.state ?? "").trim().toLowerCase();
+        if (finalState && !readyStates.has(finalState)) {
+            if (shouldLog) {
+                console.log(`[daytona:volume] name=${volumeName} state=${finalState} mountPath=${mountPath} (not ready)`);
+            }
+            throw new Error(`Daytona volume not ready: ${volumeName} (state=${finalState})`);
+        }
+        const resolvedId = String(resolvedVolume?.id ?? "").trim();
+        if (!resolvedId) {
+            throw new Error(`Daytona volume not resolved: ${volumeName}`);
+        }
+        if (shouldLog) {
+            console.log(`[daytona:volume] name=${volumeName} id=${resolvedId} mountPath=${mountPath}`);
+        }
+        resolved.push({ volumeId: resolvedId, mountPath });
+    }
+    return resolved;
+}
+function resolvePythonVersion(runtime) {
+    const fromEnv = String(process.env.SANDBOX_DAYTONA_DECLARATIVE_PYTHON ?? "").trim() ||
+        String(process.env.STRUCTURE_DAYTONA_DECLARATIVE_PYTHON ?? "").trim();
+    if (fromEnv)
+        return fromEnv;
+    const match = String(runtime ?? "").match(/python\s*([0-9]+\.[0-9]+)/i);
+    if (match?.[1])
+        return match[1];
+    return "3.12";
+}
+export function buildDeclarativeImage(config) {
+    const imageFlag = String(config.daytona?.image ?? "").trim();
+    const envFlag = parseOptionalBoolean(process.env.SANDBOX_DAYTONA_DECLARATIVE_IMAGE) ??
+        parseOptionalBoolean(process.env.STRUCTURE_DAYTONA_DECLARATIVE_IMAGE) ??
+        false;
+    const useDeclarative = envFlag || imageFlag.startsWith("declarative");
+    if (!useDeclarative)
+        return undefined;
+    const baseImage = String(process.env.SANDBOX_DAYTONA_DECLARATIVE_BASE ?? "").trim() ||
+        String(process.env.STRUCTURE_DAYTONA_DECLARATIVE_BASE ?? "").trim();
+    const pythonVersion = resolvePythonVersion(config.runtime);
+    const isStructureDataset = config.purpose === "structure.dataset" || typeof config.params?.datasetId === "string";
+    const defaultPackages = isStructureDataset ? ["pandas", "openpyxl"] : [];
+    const packages = [
+        ...parseCsvList(process.env.SANDBOX_DAYTONA_DECLARATIVE_PIP),
+        ...parseCsvList(process.env.STRUCTURE_DAYTONA_DECLARATIVE_PIP),
+        ...defaultPackages,
+    ];
+    const uniquePackages = Array.from(new Set(packages));
+    let image;
+    if (baseImage) {
+        image = Image.base(baseImage);
+    }
+    else {
+        image = Image.debianSlim(pythonVersion);
+    }
+    if (uniquePackages.length > 0) {
+        image = image.pipInstall(uniquePackages);
+    }
+    image = image.workdir("/home/daytona");
+    return image;
+}
+//# sourceMappingURL=daytona.js.map

package/dist/providers/daytona.js.map

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

package/dist/providers/provider.d.ts

@@ -0,0 +1,3 @@
+import type { SandboxConfig, SandboxProvider } from "../types.js";
+export declare function resolveProvider(config: SandboxConfig): SandboxProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/providers/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAYtE"}

package/dist/providers/provider.js

@@ -0,0 +1,18 @@
+export function resolveProvider(config) {
+    const explicit = String(config.provider ?? "").trim().toLowerCase();
+    if (explicit === "daytona")
+        return "daytona";
+    if (explicit === "vercel")
+        return "vercel";
+    if (explicit === "sprites")
+        return "sprites";
+    const env = String(process.env.SANDBOX_PROVIDER ?? "").trim().toLowerCase();
+    if (env === "daytona")
+        return "daytona";
+    if (env === "vercel")
+        return "vercel";
+    if (env === "sprites")
+        return "sprites";
+    return "sprites";
+}
+//# sourceMappingURL=provider.js.map

package/dist/providers/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/providers/provider.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACnE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC5C,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC1C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAE5C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC3E,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACvC,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACrC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAEvC,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/providers/sprites.d.ts

@@ -0,0 +1,39 @@
+import type { SandboxConfig } from "../types.js";
+import type { SpritesSandbox } from "./types.js";
+export declare function spritesFetch(path: string, init?: any): Promise<any>;
+export declare function spritesJson<T = any>(path: string, init?: any): Promise<T>;
+export declare function spritesText(path: string, init?: any): Promise<{
+    status: number;
+    ok: boolean;
+    text: string;
+}>;
+export declare function toSpritesPreviewUrl(spriteUrl: string, port: number): string;
+export declare function asSpritesSandbox(sprite: {
+    name: string;
+    id?: string;
+    url?: string;
+}): SpritesSandbox;
+export declare function getSpritesByName(name: string): Promise<{
+    ok: true;
+    sprite: any;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+export declare function provisionSpritesSandbox(params: {
+    sandboxId: string;
+    config: SandboxConfig;
+}): Promise<SpritesSandbox>;
+export declare function spritesExec(params: {
+    spriteName: string;
+    command: string;
+    args?: string[];
+    stdin?: string | Buffer;
+}): Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}>;
+export declare function parseSpritesCheckpointIdFromNdjson(text: string): string | null;
+//# sourceMappingURL=sprites.d.ts.map

package/dist/providers/sprites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprites.d.ts","sourceRoot":"","sources":["../../src/providers/sprites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA0BhD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAiBzE;AAED,wBAAsB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAe/E;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAIxD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAc3E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,cAAc,CAkBjB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBnF;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,aAAa,CAAA;CACtB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiC1B;AA6CD,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACxB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAyChE;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB9E"}

package/dist/providers/sprites.js

@@ -0,0 +1,234 @@
+function normalizeBaseUrl(raw) {
+    const trimmed = String(raw ?? "").trim();
+    if (!trimmed)
+        return "";
+    return trimmed.endsWith("/") ? trimmed.slice(0, -1) : trimmed;
+}
+function sanitizeSpritesString(value) {
+    return value.includes("\0") ? value.replace(/\0/g, "") : value;
+}
+function getSpritesConfig() {
+    const token = String(process.env.SPRITES_API_TOKEN ?? process.env.SPRITE_TOKEN ?? "").trim();
+    if (!token) {
+        throw new Error("Missing required Sprites token env var: SPRITES_API_TOKEN (or SPRITE_TOKEN)");
+    }
+    const baseUrl = normalizeBaseUrl(String(process.env.SPRITES_API_BASE_URL ?? process.env.SPRITES_API_URL ?? "").trim()) || "https://api.sprites.dev";
+    return { baseUrl, token };
+}
+export async function spritesFetch(path, init) {
+    const { baseUrl, token } = getSpritesConfig();
+    const fetchFn = globalThis?.fetch;
+    if (typeof fetchFn !== "function") {
+        throw new Error("fetch_not_available");
+    }
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    const url = `${baseUrl}${normalizedPath}`;
+    return await fetchFn(url, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            ...(init?.headers ?? {}),
+        },
+    });
+}
+export async function spritesJson(path, init) {
+    const res = await spritesFetch(path, {
+        ...init,
+        headers: {
+            Accept: "application/json",
+            ...(init?.headers ?? {}),
+        },
+    });
+    if (!res?.ok) {
+        const text = await res?.text?.().catch(() => "");
+        throw new Error(`sprites_http_${res?.status ?? "unknown"}: ${text || "request_failed"}`);
+    }
+    return (await res.json().catch(() => ({})));
+}
+export async function spritesText(path, init) {
+    const res = await spritesFetch(path, init);
+    const text = await res?.text?.().catch(() => "");
+    return { ok: Boolean(res?.ok), status: Number(res?.status ?? 0), text: String(text ?? "") };
+}
+export function toSpritesPreviewUrl(spriteUrl, port) {
+    const base = String(spriteUrl ?? "").trim();
+    if (!base)
+        return "";
+    try {
+        const u = new URL(base);
+        if (Number.isFinite(port) && port > 0) {
+            u.port = String(Math.floor(port));
+        }
+        const next = u.toString();
+        return next.endsWith("/") ? next.slice(0, -1) : next;
+    }
+    catch {
+        if (!port)
+            return base;
+        return base.replace(/\/+$/, "") + ":" + String(Math.floor(port));
+    }
+}
+export function asSpritesSandbox(sprite) {
+    const name = String(sprite?.name ?? "").trim();
+    const url = typeof sprite?.url === "string" ? sprite.url : undefined;
+    return {
+        __provider: "sprites",
+        name,
+        id: sprite?.id ? String(sprite.id) : undefined,
+        url,
+        getPreviewLink: async (port) => {
+            const base = url ?? "";
+            const next = toSpritesPreviewUrl(base, port);
+            return { url: next };
+        },
+        domain: async (port) => {
+            const base = url ?? "";
+            return toSpritesPreviewUrl(base, port);
+        },
+    };
+}
+export async function getSpritesByName(name) {
+    const safeName = String(name ?? "").trim();
+    if (!safeName)
+        return { ok: false, status: 400, error: "sprites_name_required" };
+    const res = await spritesFetch(`/v1/sprites/${encodeURIComponent(safeName)}`, {
+        method: "GET",
+        headers: { Accept: "application/json" },
+    });
+    if (!res?.ok) {
+        const text = await res?.text?.().catch(() => "");
+        return {
+            ok: false,
+            status: Number(res?.status ?? 0),
+            error: text || `sprites_http_${res?.status ?? "unknown"}`,
+        };
+    }
+    const json = await res.json().catch(() => ({}));
+    return { ok: true, sprite: json };
+}
+export async function provisionSpritesSandbox(params) {
+    const requestedName = String(params.config?.sprites?.name ?? "").trim();
+    const name = requestedName || `ekairos-${params.sandboxId}`;
+    const existing = await getSpritesByName(name);
+    if (existing.ok) {
+        const sprite = existing.sprite ?? {};
+        return asSpritesSandbox({
+            name: String(sprite?.name ?? name),
+            id: sprite?.id ? String(sprite.id) : undefined,
+            url: typeof sprite?.url === "string" ? sprite.url : undefined,
+        });
+    }
+    const waitForCapacity = params.config?.sprites?.waitForCapacity ?? true;
+    const auth = params.config?.sprites?.urlSettings?.auth ?? "public";
+    const body = {
+        name,
+        wait_for_capacity: Boolean(waitForCapacity),
+        url_settings: { auth },
+    };
+    const created = await spritesJson("/v1/sprites", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    return asSpritesSandbox({
+        name: String(created?.name ?? name),
+        id: created?.id ? String(created.id) : undefined,
+        url: typeof created?.url === "string" ? created.url : undefined,
+    });
+}
+function normalizeSpritesExecResult(payload) {
+    const exitCodeRaw = payload?.exit_code ??
+        payload?.exitCode ??
+        payload?.code ??
+        payload?.status ??
+        payload?.result?.exit_code ??
+        payload?.result?.exitCode;
+    const exitCode = Number(exitCodeRaw ?? 0);
+    const stdout = typeof payload?.stdout === "string"
+        ? payload.stdout
+        : typeof payload?.output === "string"
+            ? payload.output
+            : typeof payload?.out === "string"
+                ? payload.out
+                : typeof payload?.result?.stdout === "string"
+                    ? payload.result.stdout
+                    : "";
+    const stderr = typeof payload?.stderr === "string"
+        ? payload.stderr
+        : typeof payload?.error === "string"
+            ? payload.error
+            : typeof payload?.err === "string"
+                ? payload.err
+                : typeof payload?.result?.stderr === "string"
+                    ? payload.result.stderr
+                    : "";
+    return {
+        exitCode: Number.isFinite(exitCode) ? exitCode : 0,
+        stdout: sanitizeSpritesString(stdout),
+        stderr: sanitizeSpritesString(stderr),
+    };
+}
+export async function spritesExec(params) {
+    const spriteName = String(params.spriteName ?? "").trim();
+    if (!spriteName)
+        throw new Error("sprites_name_required");
+    const parts = [String(params.command ?? "").trim(), ...(Array.isArray(params.args) ? params.args : [])].filter(Boolean);
+    if (parts.length === 0)
+        throw new Error("sprites_command_required");
+    const search = new URLSearchParams();
+    for (const part of parts) {
+        search.append("cmd", String(part));
+    }
+    const hasStdin = typeof params.stdin === "string" || Buffer.isBuffer(params.stdin);
+    if (hasStdin) {
+        search.set("stdin", "true");
+    }
+    const path = `/v1/sprites/${encodeURIComponent(spriteName)}/exec?${search.toString()}`;
+    const init = {
+        method: "POST",
+    };
+    if (hasStdin) {
+        init.body = params.stdin;
+    }
+    const res = await spritesFetch(path, init);
+    const text = await res?.text?.().catch(() => "");
+    const parsed = (() => {
+        try {
+            return text ? JSON.parse(text) : {};
+        }
+        catch {
+            return { stdout: String(text ?? "") };
+        }
+    })();
+    if (!res?.ok) {
+        const err = typeof parsed?.error === "string" ? parsed.error : text;
+        throw new Error(err || `sprites_exec_http_${res?.status ?? "unknown"}`);
+    }
+    return normalizeSpritesExecResult(parsed);
+}
+export function parseSpritesCheckpointIdFromNdjson(text) {
+    const lines = String(text ?? "")
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+    const candidates = [];
+    for (const line of lines) {
+        try {
+            const evt = JSON.parse(line);
+            const data = typeof evt?.data === "string" ? evt.data : "";
+            if (!data)
+                continue;
+            const m = data.match(/\bID:\s*(v[0-9]+)\b/i) || data.match(/\bCheckpoint\s+(v[0-9]+)\b/i);
+            if (m?.[1]) {
+                candidates.push(String(m[1]));
+            }
+        }
+        catch {
+            // ignore invalid ndjson lines
+        }
+    }
+    if (candidates.length === 0)
+        return null;
+    return candidates[candidates.length - 1] ?? null;
+}
+//# sourceMappingURL=sprites.js.map