@alibaba-group/opensandbox 0.1.1-dev0 → 0.1.2-dev0

package/dist/sandbox.js

@@ -1,303 +0,0 @@
-// Copyright 2026 Alibaba Group Holding Ltd.
-// 
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-// 
-//     http://www.apache.org/licenses/LICENSE-2.0
-// 
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import { DEFAULT_ENTRYPOINT, DEFAULT_EXECD_PORT, DEFAULT_HEALTH_CHECK_POLLING_INTERVAL_MILLIS, DEFAULT_READY_TIMEOUT_SECONDS, DEFAULT_RESOURCE_LIMITS, DEFAULT_TIMEOUT_SECONDS, } from "./core/constants.js";
-import { ConnectionConfig } from "./config/connection.js";
-import { createDefaultAdapterFactory } from "./factory/defaultAdapterFactory.js";
-import { SandboxReadyTimeoutException } from "./core/exceptions.js";
-function sleep(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
-function toImageSpec(image) {
-    if (typeof image === "string")
-        return { uri: image };
-    return { uri: image.uri, auth: image.auth };
-}
-export class Sandbox {
-    id;
-    connectionConfig;
-    /**
-     * Lifecycle (sandbox management) service.
-     */
-    sandboxes;
-    /**
-     * Execd services.
-     */
-    commands;
-    /**
-     * High-level filesystem facade (JS-friendly).
-     */
-    files;
-    health;
-    metrics;
-    /**
-     * Internal state kept out of the public instance shape.
-     *
-     * This avoids nominal typing issues when multiple copies of the SDK exist in a dependency graph.
-     */
-    static _priv = new WeakMap();
-    constructor(opts) {
-        this.id = opts.id;
-        this.connectionConfig = opts.connectionConfig;
-        Sandbox._priv.set(this, {
-            adapterFactory: opts.adapterFactory,
-            lifecycleBaseUrl: opts.lifecycleBaseUrl,
-            execdBaseUrl: opts.execdBaseUrl,
-        });
-        this.sandboxes = opts.sandboxes;
-        this.commands = opts.commands;
-        this.files = opts.files;
-        this.health = opts.health;
-        this.metrics = opts.metrics;
-    }
-    static async create(opts) {
-        const baseConnectionConfig = opts.connectionConfig instanceof ConnectionConfig
-            ? opts.connectionConfig
-            : new ConnectionConfig(opts.connectionConfig);
-        const connectionConfig = baseConnectionConfig.withTransportIfMissing();
-        const lifecycleBaseUrl = connectionConfig.getBaseUrl();
-        const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
-        let sandboxes;
-        try {
-            sandboxes = adapterFactory.createLifecycleStack({
-                connectionConfig,
-                lifecycleBaseUrl,
-            }).sandboxes;
-        }
-        catch (err) {
-            await connectionConfig.closeTransport();
-            throw err;
-        }
-        const req = {
-            image: toImageSpec(opts.image),
-            entrypoint: opts.entrypoint ?? DEFAULT_ENTRYPOINT,
-            timeout: Math.floor(opts.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS),
-            resourceLimits: opts.resource ?? DEFAULT_RESOURCE_LIMITS,
-            env: opts.env ?? {},
-            metadata: opts.metadata ?? {},
-            extensions: opts.extensions ?? {},
-        };
-        let sandboxId;
-        try {
-            const created = await sandboxes.createSandbox(req);
-            sandboxId = created.id;
-            const endpoint = await sandboxes.getSandboxEndpoint(sandboxId, DEFAULT_EXECD_PORT);
-            const execdBaseUrl = `${connectionConfig.protocol}://${endpoint.endpoint}`;
-            const { commands, files, health, metrics } = adapterFactory.createExecdStack({
-                connectionConfig,
-                execdBaseUrl,
-            });
-            const sbx = new Sandbox({
-                id: sandboxId,
-                connectionConfig,
-                adapterFactory,
-                lifecycleBaseUrl,
-                execdBaseUrl,
-                sandboxes,
-                commands,
-                files,
-                health,
-                metrics,
-            });
-            if (!(opts.skipHealthCheck ?? false)) {
-                await sbx.waitUntilReady({
-                    readyTimeoutSeconds: opts.readyTimeoutSeconds ?? DEFAULT_READY_TIMEOUT_SECONDS,
-                    pollingIntervalMillis: opts.healthCheckPollingInterval ??
-                        DEFAULT_HEALTH_CHECK_POLLING_INTERVAL_MILLIS,
-                    healthCheck: opts.healthCheck,
-                });
-            }
-            return sbx;
-        }
-        catch (err) {
-            if (sandboxId) {
-                try {
-                    await sandboxes.deleteSandbox(sandboxId);
-                }
-                catch {
-                    // Ignore cleanup failure; surface original error.
-                }
-            }
-            await connectionConfig.closeTransport();
-            throw err;
-        }
-    }
-    static async connect(opts) {
-        const baseConnectionConfig = opts.connectionConfig instanceof ConnectionConfig
-            ? opts.connectionConfig
-            : new ConnectionConfig(opts.connectionConfig);
-        const connectionConfig = baseConnectionConfig.withTransportIfMissing();
-        const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
-        const lifecycleBaseUrl = connectionConfig.getBaseUrl();
-        let sandboxes;
-        try {
-            sandboxes = adapterFactory.createLifecycleStack({
-                connectionConfig,
-                lifecycleBaseUrl,
-            }).sandboxes;
-        }
-        catch (err) {
-            await connectionConfig.closeTransport();
-            throw err;
-        }
-        try {
-            const endpoint = await sandboxes.getSandboxEndpoint(opts.sandboxId, DEFAULT_EXECD_PORT);
-            const execdBaseUrl = `${connectionConfig.protocol}://${endpoint.endpoint}`;
-            const { commands, files, health, metrics } = adapterFactory.createExecdStack({
-                connectionConfig,
-                execdBaseUrl,
-            });
-            const sbx = new Sandbox({
-                id: opts.sandboxId,
-                connectionConfig,
-                adapterFactory,
-                lifecycleBaseUrl,
-                execdBaseUrl,
-                sandboxes,
-                commands,
-                files,
-                health,
-                metrics,
-            });
-            if (!(opts.skipHealthCheck ?? false)) {
-                await sbx.waitUntilReady({
-                    readyTimeoutSeconds: opts.readyTimeoutSeconds ?? DEFAULT_READY_TIMEOUT_SECONDS,
-                    pollingIntervalMillis: opts.healthCheckPollingInterval ??
-                        DEFAULT_HEALTH_CHECK_POLLING_INTERVAL_MILLIS,
-                    healthCheck: opts.healthCheck,
-                });
-            }
-            return sbx;
-        }
-        catch (err) {
-            await connectionConfig.closeTransport();
-            throw err;
-        }
-    }
-    async getInfo() {
-        return await this.sandboxes.getSandbox(this.id);
-    }
-    async isHealthy() {
-        try {
-            return await this.health.ping();
-        }
-        catch {
-            return false;
-        }
-    }
-    async getMetrics() {
-        return await this.metrics.getMetrics();
-    }
-    async pause() {
-        await this.sandboxes.pauseSandbox(this.id);
-    }
-    /**
-     * Resume a paused sandbox and return a fresh, connected Sandbox instance.
-     *
-     * After resume, the execd endpoint may change, so this method returns a new
-     * {@link Sandbox} instance with a refreshed execd base URL.
-     */
-    async resume(opts = {}) {
-        await this.sandboxes.resumeSandbox(this.id);
-        return await Sandbox.connect({
-            sandboxId: this.id,
-            connectionConfig: this.connectionConfig,
-            adapterFactory: Sandbox._priv.get(this).adapterFactory,
-            skipHealthCheck: opts.skipHealthCheck ?? false,
-            readyTimeoutSeconds: opts.readyTimeoutSeconds,
-            healthCheckPollingInterval: opts.healthCheckPollingInterval,
-        });
-    }
-    /**
-     * Resume a paused sandbox by id, then connect to its execd endpoint.
-     */
-    static async resume(opts) {
-        const baseConnectionConfig = opts.connectionConfig instanceof ConnectionConfig
-            ? opts.connectionConfig
-            : new ConnectionConfig(opts.connectionConfig);
-        const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
-        const resumeConnectionConfig = baseConnectionConfig.withTransportIfMissing();
-        const lifecycleBaseUrl = resumeConnectionConfig.getBaseUrl();
-        let sandboxes;
-        try {
-            sandboxes = adapterFactory.createLifecycleStack({
-                connectionConfig: resumeConnectionConfig,
-                lifecycleBaseUrl,
-            }).sandboxes;
-            await sandboxes.resumeSandbox(opts.sandboxId);
-        }
-        catch (err) {
-            await resumeConnectionConfig.closeTransport();
-            throw err;
-        }
-        await resumeConnectionConfig.closeTransport();
-        return await Sandbox.connect({ ...opts, connectionConfig: baseConnectionConfig, adapterFactory });
-    }
-    async kill() {
-        await this.sandboxes.deleteSandbox(this.id);
-    }
-    /**
-     * Release any client-side resources (e.g. Node.js HTTP agents) owned by this Sandbox instance.
-     */
-    async close() {
-        await this.connectionConfig.closeTransport();
-    }
-    /**
-     * Renew expiration by setting expiresAt to now + timeoutSeconds.
-     */
-    async renew(timeoutSeconds) {
-        const expiresAt = new Date(Date.now() + timeoutSeconds * 1000).toISOString();
-        return await this.sandboxes.renewSandboxExpiration(this.id, { expiresAt });
-    }
-    /**
-     * Get sandbox endpoint for a port (STRICT: no scheme), e.g. "localhost:44772" or "domain/route/.../44772".
-     */
-    async getEndpoint(port) {
-        return await this.sandboxes.getSandboxEndpoint(this.id, port);
-    }
-    /**
-     * Get absolute endpoint URL with scheme (convenience for HTTP clients).
-     */
-    async getEndpointUrl(port) {
-        const ep = await this.getEndpoint(port);
-        return `${this.connectionConfig.protocol}://${ep.endpoint}`;
-    }
-    async waitUntilReady(opts) {
-        const deadline = Date.now() + opts.readyTimeoutSeconds * 1000;
-        // Wait until execd becomes reachable and passes health check.
-        while (true) {
-            if (Date.now() > deadline) {
-                throw new SandboxReadyTimeoutException({
-                    message: `Sandbox not ready: timed out waiting for health check (timeoutSeconds=${opts.readyTimeoutSeconds})`,
-                });
-            }
-            try {
-                if (opts.healthCheck) {
-                    const ok = await opts.healthCheck(this);
-                    if (ok)
-                        return;
-                }
-                else {
-                    const ok = await this.health.ping();
-                    if (ok)
-                        return;
-                }
-            }
-            catch {
-                // ignore and retry
-            }
-            await sleep(opts.pollingIntervalMillis);
-        }
-    }
-}
-//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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

package/dist/services/execdCommands.d.ts

@@ -1,19 +0,0 @@
-import type { ExecutionHandlers } from "../models/execution.js";
-import type { CommandExecution, RunCommandOpts, ServerStreamEvent } from "../models/execd.js";
-export interface ExecdCommands {
-    /**
-     * Run a command and stream server events (SSE). This is the lowest-level API.
-     */
-    runStream(command: string, opts?: RunCommandOpts, signal?: AbortSignal): AsyncIterable<ServerStreamEvent>;
-    /**
-     * Convenience: run a command, consume the stream, and build a structured execution result.
-     */
-    run(command: string, opts?: RunCommandOpts, handlers?: ExecutionHandlers, signal?: AbortSignal): Promise<CommandExecution>;
-    /**
-     * Interrupt the current execution in the given context/session.
-     *
-     * Note: Execd spec uses `DELETE /command?id=<sessionId>`.
-     */
-    interrupt(sessionId: string): Promise<void>;
-}
-//# sourceMappingURL=execdCommands.d.ts.map

package/dist/services/execdCommands.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execdCommands.d.ts","sourceRoot":"","sources":["../../src/services/execdCommands.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE9F,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAE1G;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE3H;;;;OAIG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C"}

package/dist/services/execdCommands.js

@@ -1,15 +0,0 @@
-// Copyright 2026 Alibaba Group Holding Ltd.
-// 
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-// 
-//     http://www.apache.org/licenses/LICENSE-2.0
-// 
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-export {};
-//# sourceMappingURL=execdCommands.js.map

package/dist/services/execdCommands.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execdCommands.js","sourceRoot":"","sources":["../../src/services/execdCommands.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,GAAG;AACH,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,GAAG;AACH,iDAAiD;AACjD,GAAG;AACH,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC"}

package/dist/services/execdHealth.d.ts

@@ -1,4 +0,0 @@
-export interface ExecdHealth {
-    ping(): Promise<boolean>;
-}
-//# sourceMappingURL=execdHealth.d.ts.map

package/dist/services/execdHealth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execdHealth.d.ts","sourceRoot":"","sources":["../../src/services/execdHealth.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B"}

package/dist/services/execdHealth.js

@@ -1,15 +0,0 @@
-// Copyright 2026 Alibaba Group Holding Ltd.
-// 
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-// 
-//     http://www.apache.org/licenses/LICENSE-2.0
-// 
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-export {};
-//# sourceMappingURL=execdHealth.js.map

package/dist/services/execdHealth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execdHealth.js","sourceRoot":"","sources":["../../src/services/execdHealth.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,GAAG;AACH,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,GAAG;AACH,iDAAiD;AACjD,GAAG;AACH,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC"}

package/dist/services/execdMetrics.d.ts

@@ -1,5 +0,0 @@
-import type { SandboxMetrics } from "../models/execd.js";
-export interface ExecdMetrics {
-    getMetrics(): Promise<SandboxMetrics>;
-}
-//# sourceMappingURL=execdMetrics.d.ts.map

package/dist/services/execdMetrics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execdMetrics.d.ts","sourceRoot":"","sources":["../../src/services/execdMetrics.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACvC"}

package/dist/services/execdMetrics.js

@@ -1,15 +0,0 @@
-// Copyright 2026 Alibaba Group Holding Ltd.
-// 
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-// 
-//     http://www.apache.org/licenses/LICENSE-2.0
-// 
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-export {};
-//# sourceMappingURL=execdMetrics.js.map

package/dist/services/execdMetrics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execdMetrics.js","sourceRoot":"","sources":["../../src/services/execdMetrics.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,GAAG;AACH,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,GAAG;AACH,iDAAiD;AACjD,GAAG;AACH,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC"}

package/dist/services/filesystem.d.ts

@@ -1,30 +0,0 @@
-import type { SearchFilesResponse } from "../models/filesystem.js";
-import type { ContentReplaceEntry, FileInfo, MoveEntry, SearchEntry, SetPermissionEntry, WriteEntry } from "../models/filesystem.js";
-/**
- * High-level filesystem facade (JS-friendly).
- *
- * This interface provides a convenience layer over the underlying execd filesystem API:
- * it offers common operations (read/write/search/move/delete) and supports streaming I/O for large files.
- */
-export interface SandboxFiles {
-    getFileInfo(paths: string[]): Promise<Record<string, FileInfo>>;
-    search(entry: SearchEntry): Promise<SearchFilesResponse>;
-    createDirectories(entries: Pick<WriteEntry, "path" | "mode" | "owner" | "group">[]): Promise<void>;
-    deleteDirectories(paths: string[]): Promise<void>;
-    writeFiles(entries: WriteEntry[]): Promise<void>;
-    readFile(path: string, opts?: {
-        encoding?: string;
-        range?: string;
-    }): Promise<string>;
-    readBytes(path: string, opts?: {
-        range?: string;
-    }): Promise<Uint8Array>;
-    readBytesStream(path: string, opts?: {
-        range?: string;
-    }): AsyncIterable<Uint8Array>;
-    deleteFiles(paths: string[]): Promise<void>;
-    moveFiles(entries: MoveEntry[]): Promise<void>;
-    replaceContents(entries: ContentReplaceEntry[]): Promise<void>;
-    setPermissions(entries: SetPermissionEntry[]): Promise<void>;
-}
-//# sourceMappingURL=filesystem.d.ts.map

package/dist/services/filesystem.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/services/filesystem.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,UAAU,EACX,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEzD,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACxE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAEpF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}

package/dist/services/filesystem.js

@@ -1,15 +0,0 @@
-// Copyright 2026 Alibaba Group Holding Ltd.
-// 
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-// 
-//     http://www.apache.org/licenses/LICENSE-2.0
-// 
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-export {};
-//# sourceMappingURL=filesystem.js.map

package/dist/services/filesystem.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../src/services/filesystem.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,GAAG;AACH,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,GAAG;AACH,iDAAiD;AACjD,GAAG;AACH,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC"}

package/dist/services/sandboxes.d.ts

@@ -1,12 +0,0 @@
-import type { CreateSandboxRequest, CreateSandboxResponse, Endpoint, ListSandboxesParams, ListSandboxesResponse, RenewSandboxExpirationRequest, RenewSandboxExpirationResponse, SandboxId, SandboxInfo } from "../models/sandboxes.js";
-export interface Sandboxes {
-    createSandbox(req: CreateSandboxRequest): Promise<CreateSandboxResponse>;
-    getSandbox(sandboxId: SandboxId): Promise<SandboxInfo>;
-    listSandboxes(params?: ListSandboxesParams): Promise<ListSandboxesResponse>;
-    deleteSandbox(sandboxId: SandboxId): Promise<void>;
-    pauseSandbox(sandboxId: SandboxId): Promise<void>;
-    resumeSandbox(sandboxId: SandboxId): Promise<void>;
-    renewSandboxExpiration(sandboxId: SandboxId, req: RenewSandboxExpirationRequest): Promise<RenewSandboxExpirationResponse>;
-    getSandboxEndpoint(sandboxId: SandboxId, port: number): Promise<Endpoint>;
-}
-//# sourceMappingURL=sandboxes.d.ts.map

package/dist/services/sandboxes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxes.d.ts","sourceRoot":"","sources":["../../src/services/sandboxes.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,8BAA8B,EAC9B,SAAS,EACT,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzE,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,aAAa,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5E,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,sBAAsB,CACpB,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,6BAA6B,GACjC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAE3C,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC3E"}

package/dist/services/sandboxes.js

@@ -1,15 +0,0 @@
-// Copyright 2026 Alibaba Group Holding Ltd.
-// 
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-// 
-//     http://www.apache.org/licenses/LICENSE-2.0
-// 
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-export {};
-//# sourceMappingURL=sandboxes.js.map

package/dist/services/sandboxes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxes.js","sourceRoot":"","sources":["../../src/services/sandboxes.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,GAAG;AACH,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,GAAG;AACH,iDAAiD;AACjD,GAAG;AACH,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC"}