@alibaba-group/opensandbox 0.1.0-dev1

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAExG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE1F,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,8BAA8B,EAC9B,SAAS,EACT,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,4CAA4C,EAC5C,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// 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 { InvalidArgumentException, SandboxApiException, SandboxError, SandboxException, SandboxInternalException, SandboxReadyTimeoutException, SandboxUnhealthyException, } from "./core/exceptions.js";
+export { DefaultAdapterFactory, createDefaultAdapterFactory } from "./factory/defaultAdapterFactory.js";
+export { ConnectionConfig } from "./config/connection.js";
+export { SandboxManager } from "./manager.js";
+export { ExecutionEventDispatcher } from "./models/executionEventDispatcher.js";
+export { DEFAULT_ENTRYPOINT, DEFAULT_EXECD_PORT, DEFAULT_RESOURCE_LIMITS, DEFAULT_TIMEOUT_SECONDS, DEFAULT_READY_TIMEOUT_SECONDS, DEFAULT_HEALTH_CHECK_POLLING_INTERVAL_MILLIS, DEFAULT_REQUEST_TIMEOUT_SECONDS, } from "./core/constants.js";
+export { Sandbox } from "./sandbox.js";

package/dist/internal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * INTERNAL / ADVANCED ENTRYPOINT
+ *
+ * This subpath exposes low-level OpenAPI clients and adapters for advanced integrations.
+ * It is intentionally NOT exported from the root entrypoint (`@alibaba-group/opensandbox`),
+ * because generated OpenAPI types are not considered stable public API.
+ *
+ * Import path:
+ * - `@alibaba-group/opensandbox/internal`
+ */
+export { createLifecycleClient } from "./openapi/lifecycleClient.js";
+export type { LifecycleClient } from "./openapi/lifecycleClient.js";
+export { createExecdClient } from "./openapi/execdClient.js";
+export type { ExecdClient } from "./openapi/execdClient.js";
+export type { paths as LifecyclePaths } from "./api/lifecycle.js";
+export type { paths as ExecdPaths } from "./api/execd.js";
+export { SandboxesAdapter } from "./adapters/sandboxesAdapter.js";
+export { HealthAdapter } from "./adapters/healthAdapter.js";
+export { MetricsAdapter } from "./adapters/metricsAdapter.js";
+export { FilesystemAdapter } from "./adapters/filesystemAdapter.js";
+export { CommandsAdapter } from "./adapters/commandsAdapter.js";
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,YAAY,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/internal.js

@@ -0,0 +1,30 @@
+// 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.
+/**
+ * INTERNAL / ADVANCED ENTRYPOINT
+ *
+ * This subpath exposes low-level OpenAPI clients and adapters for advanced integrations.
+ * It is intentionally NOT exported from the root entrypoint (`@alibaba-group/opensandbox`),
+ * because generated OpenAPI types are not considered stable public API.
+ *
+ * Import path:
+ * - `@alibaba-group/opensandbox/internal`
+ */
+export { createLifecycleClient } from "./openapi/lifecycleClient.js";
+export { createExecdClient } from "./openapi/execdClient.js";
+export { SandboxesAdapter } from "./adapters/sandboxesAdapter.js";
+export { HealthAdapter } from "./adapters/healthAdapter.js";
+export { MetricsAdapter } from "./adapters/metricsAdapter.js";
+export { FilesystemAdapter } from "./adapters/filesystemAdapter.js";
+export { CommandsAdapter } from "./adapters/commandsAdapter.js";

package/dist/manager.d.ts

@@ -0,0 +1,40 @@
+import { ConnectionConfig, type ConnectionConfigOptions } from "./config/connection.js";
+import type { AdapterFactory } from "./factory/adapterFactory.js";
+import type { ListSandboxesResponse, SandboxId, SandboxInfo } from "./models/sandboxes.js";
+export interface SandboxManagerOptions {
+    connectionConfig?: ConnectionConfig | ConnectionConfigOptions;
+    adapterFactory?: AdapterFactory;
+}
+export interface SandboxFilter {
+    states?: string[];
+    metadata?: Record<string, string>;
+    page?: number;
+    pageSize?: number;
+}
+/**
+ * Administrative interface for managing sandboxes (list/get/pause/resume/kill/renew).
+ *
+ * For interacting *inside* a sandbox, use {@link Sandbox}.
+ */
+export declare class SandboxManager {
+    private readonly sandboxes;
+    private constructor();
+    static create(opts?: SandboxManagerOptions): SandboxManager;
+    listSandboxInfos(filter?: SandboxFilter): Promise<ListSandboxesResponse>;
+    getSandboxInfo(sandboxId: SandboxId): Promise<SandboxInfo>;
+    killSandbox(sandboxId: SandboxId): Promise<void>;
+    pauseSandbox(sandboxId: SandboxId): Promise<void>;
+    resumeSandbox(sandboxId: SandboxId): Promise<void>;
+    /**
+     * Renew expiration by setting expiresAt to now + timeoutSeconds.
+     */
+    renewSandbox(sandboxId: SandboxId, timeoutSeconds: number): Promise<void>;
+    /**
+     * No-op for now (fetch-based implementation doesn't own a pooled transport).
+     *
+     * This method exists so callers can consistently release resources when using
+     * a custom {@link AdapterFactory} implementation.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAExF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAG3F,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,CAAC;IAC9D,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,IAAI,GAAE,qBAA0B,GAAG,cAAc;IAU/D,gBAAgB,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAS5E,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAI1D,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/E;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/manager.js

@@ -0,0 +1,71 @@
+// 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 { ConnectionConfig } from "./config/connection.js";
+import { createDefaultAdapterFactory } from "./factory/defaultAdapterFactory.js";
+/**
+ * Administrative interface for managing sandboxes (list/get/pause/resume/kill/renew).
+ *
+ * For interacting *inside* a sandbox, use {@link Sandbox}.
+ */
+export class SandboxManager {
+    sandboxes;
+    constructor(opts) {
+        this.sandboxes = opts.sandboxes;
+    }
+    static create(opts = {}) {
+        const connectionConfig = opts.connectionConfig instanceof ConnectionConfig
+            ? opts.connectionConfig
+            : new ConnectionConfig(opts.connectionConfig);
+        const lifecycleBaseUrl = connectionConfig.getBaseUrl();
+        const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
+        const { sandboxes } = adapterFactory.createLifecycleStack({ connectionConfig, lifecycleBaseUrl });
+        return new SandboxManager({ sandboxes });
+    }
+    listSandboxInfos(filter = {}) {
+        return this.sandboxes.listSandboxes({
+            states: filter.states,
+            metadata: filter.metadata,
+            page: filter.page,
+            pageSize: filter.pageSize,
+        });
+    }
+    getSandboxInfo(sandboxId) {
+        return this.sandboxes.getSandbox(sandboxId);
+    }
+    killSandbox(sandboxId) {
+        return this.sandboxes.deleteSandbox(sandboxId);
+    }
+    pauseSandbox(sandboxId) {
+        return this.sandboxes.pauseSandbox(sandboxId);
+    }
+    resumeSandbox(sandboxId) {
+        return this.sandboxes.resumeSandbox(sandboxId);
+    }
+    /**
+     * Renew expiration by setting expiresAt to now + timeoutSeconds.
+     */
+    async renewSandbox(sandboxId, timeoutSeconds) {
+        const expiresAt = new Date(Date.now() + timeoutSeconds * 1000).toISOString();
+        await this.sandboxes.renewSandboxExpiration(sandboxId, { expiresAt });
+    }
+    /**
+     * No-op for now (fetch-based implementation doesn't own a pooled transport).
+     *
+     * This method exists so callers can consistently release resources when using
+     * a custom {@link AdapterFactory} implementation.
+     */
+    async close() {
+        // no-op
+    }
+}

package/dist/models/execd.d.ts

@@ -0,0 +1,54 @@
+import type { Execution } from "./execution.js";
+/**
+ * Domain models for execd interactions.
+ *
+ * IMPORTANT:
+ * - These are NOT OpenAPI-generated types.
+ * - They are intentionally stable and JS-friendly.
+ */
+export interface ServerStreamEvent extends Record<string, unknown> {
+    type: "init" | "stdout" | "stderr" | "result" | "execution_count" | "execution_complete" | "error" | string;
+    timestamp?: number;
+    text?: string;
+    results?: Record<string, unknown>;
+    error?: Record<string, unknown>;
+}
+export interface RunCommandRequest extends Record<string, unknown> {
+    command: string;
+    cwd?: string;
+    background?: boolean;
+}
+export interface CodeContextRequest extends Record<string, unknown> {
+    language: string;
+}
+export type SupportedLanguage = "python" | "go" | "javascript" | "typescript" | "bash" | "java";
+export interface RunCommandOpts {
+    /**
+     * Working directory for command execution (maps to API `cwd`).
+     */
+    workingDirectory?: string;
+    /**
+     * Run command in detached mode.
+     */
+    background?: boolean;
+}
+export type CommandExecution = Execution;
+export interface Metrics extends Record<string, unknown> {
+    cpu_count?: number;
+    cpu_used_pct?: number;
+    mem_total_mib?: number;
+    mem_used_mib?: number;
+    timestamp?: number;
+}
+/**
+ * Normalized, JS-friendly metrics.
+ */
+export interface SandboxMetrics {
+    cpuCount: number;
+    cpuUsedPercentage: number;
+    memoryTotalMiB: number;
+    memoryUsedMiB: number;
+    timestamp: number;
+}
+export type PingResponse = Record<string, unknown>;
+//# sourceMappingURL=execd.d.ts.map

package/dist/models/execd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execd.d.ts","sourceRoot":"","sources":["../../src/models/execd.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,IAAI,EACA,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,iBAAiB,GACjB,oBAAoB,GACpB,OAAO,GACP,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,IAAI,GACJ,YAAY,GACZ,YAAY,GACZ,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEzC,MAAM,WAAW,OAAQ,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/models/execd.js

@@ -0,0 +1,14 @@
+// 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 {};

package/dist/models/execution.d.ts

@@ -0,0 +1,52 @@
+export interface OutputMessage {
+    text: string;
+    timestamp: number;
+    isError?: boolean;
+}
+export interface ExecutionResult {
+    text?: string;
+    timestamp: number;
+    /**
+     * Raw mime map from execd event (e.g. "text/plain", "text/html", ...)
+     */
+    raw?: Record<string, unknown>;
+}
+export interface ExecutionError {
+    name: string;
+    value: string;
+    timestamp: number;
+    traceback: string[];
+}
+export interface ExecutionComplete {
+    timestamp: number;
+    executionTimeMs: number;
+}
+export interface ExecutionInit {
+    id: string;
+    timestamp: number;
+}
+export interface Execution {
+    id?: string;
+    executionCount?: number;
+    logs: {
+        stdout: OutputMessage[];
+        stderr: OutputMessage[];
+    };
+    result: ExecutionResult[];
+    error?: ExecutionError;
+    complete?: ExecutionComplete;
+}
+export interface ExecutionHandlers {
+    /**
+     * Optional low-level hook for every server-sent event (SSE) received.
+     * Kept as `unknown` to avoid coupling to a specific OpenAPI schema module.
+     */
+    onEvent?: (ev: unknown) => void | Promise<void>;
+    onStdout?: (msg: OutputMessage) => void | Promise<void>;
+    onStderr?: (msg: OutputMessage) => void | Promise<void>;
+    onResult?: (res: ExecutionResult) => void | Promise<void>;
+    onExecutionComplete?: (c: ExecutionComplete) => void | Promise<void>;
+    onError?: (err: ExecutionError) => void | Promise<void>;
+    onInit?: (init: ExecutionInit) => void | Promise<void>;
+}
+//# sourceMappingURL=execution.d.ts.map

package/dist/models/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/models/execution.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE;QACJ,MAAM,EAAE,aAAa,EAAE,CAAC;QACxB,MAAM,EAAE,aAAa,EAAE,CAAC;KACzB,CAAC;IACF,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD"}

package/dist/models/execution.js

@@ -0,0 +1,14 @@
+// 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 {};

package/dist/models/executionEventDispatcher.d.ts

@@ -0,0 +1,15 @@
+import type { Execution, ExecutionHandlers } from "./execution.js";
+import type { ServerStreamEvent } from "./execd.js";
+/**
+ * Dispatches streamed execution events to handlers.
+ *
+ * This mutates the provided `execution` object (appending logs/results and setting fields like
+ * `id`, `executionCount`, and `complete`) and invokes optional callbacks in {@link ExecutionHandlers}.
+ */
+export declare class ExecutionEventDispatcher {
+    private readonly execution;
+    private readonly handlers?;
+    constructor(execution: Execution, handlers?: ExecutionHandlers | undefined);
+    dispatch(ev: ServerStreamEvent): Promise<void>;
+}
+//# sourceMappingURL=executionEventDispatcher.d.ts.map

package/dist/models/executionEventDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionEventDispatcher.d.ts","sourceRoot":"","sources":["../../src/models/executionEventDispatcher.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAqC,iBAAiB,EAAiD,MAAM,gBAAgB,CAAC;AACrJ,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASpD;;;;;GAKG;AACH,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,iBAAiB,YAAA;IAGzC,QAAQ,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CA4DrD"}

package/dist/models/executionEventDispatcher.js

@@ -0,0 +1,95 @@
+// 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.
+function extractText(results) {
+    if (!results || typeof results !== "object")
+        return undefined;
+    const r = results;
+    const v = r["text/plain"] ?? r.text ?? r.textPlain;
+    return v == null ? undefined : String(v);
+}
+/**
+ * Dispatches streamed execution events to handlers.
+ *
+ * This mutates the provided `execution` object (appending logs/results and setting fields like
+ * `id`, `executionCount`, and `complete`) and invokes optional callbacks in {@link ExecutionHandlers}.
+ */
+export class ExecutionEventDispatcher {
+    execution;
+    handlers;
+    constructor(execution, handlers) {
+        this.execution = execution;
+        this.handlers = handlers;
+    }
+    async dispatch(ev) {
+        await this.handlers?.onEvent?.(ev);
+        const ts = ev.timestamp ?? Date.now();
+        switch (ev.type) {
+            case "init": {
+                const id = ev.text ?? "";
+                if (id)
+                    this.execution.id = id;
+                const init = { id, timestamp: ts };
+                await this.handlers?.onInit?.(init);
+                return;
+            }
+            case "stdout": {
+                const msg = { text: ev.text ?? "", timestamp: ts, isError: false };
+                this.execution.logs.stdout.push(msg);
+                await this.handlers?.onStdout?.(msg);
+                return;
+            }
+            case "stderr": {
+                const msg = { text: ev.text ?? "", timestamp: ts, isError: true };
+                this.execution.logs.stderr.push(msg);
+                await this.handlers?.onStderr?.(msg);
+                return;
+            }
+            case "result": {
+                const r = { text: extractText(ev.results), timestamp: ts, raw: ev.results };
+                this.execution.result.push(r);
+                await this.handlers?.onResult?.(r);
+                return;
+            }
+            case "execution_count": {
+                const c = ev.execution_count;
+                if (typeof c === "number")
+                    this.execution.executionCount = c;
+                return;
+            }
+            case "execution_complete": {
+                const ms = ev.execution_time;
+                const complete = { timestamp: ts, executionTimeMs: typeof ms === "number" ? ms : 0 };
+                this.execution.complete = complete;
+                await this.handlers?.onExecutionComplete?.(complete);
+                return;
+            }
+            case "error": {
+                const e = ev.error;
+                if (e) {
+                    const err = {
+                        name: String(e.ename ?? e.name ?? ""),
+                        value: String(e.evalue ?? e.value ?? ""),
+                        timestamp: ts,
+                        traceback: Array.isArray(e.traceback) ? e.traceback.map(String) : [],
+                    };
+                    this.execution.error = err;
+                    await this.handlers?.onError?.(err);
+                }
+                return;
+            }
+            default:
+                return;
+        }
+    }
+}

package/dist/models/filesystem.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Domain models for filesystem.
+ *
+ * IMPORTANT:
+ * - These are NOT OpenAPI-generated types.
+ * - They are intentionally stable and JS-friendly.
+ */
+export interface FileInfo extends Record<string, unknown> {
+    path: string;
+    size?: number;
+    /**
+     * Last modification time.
+     */
+    modifiedAt?: Date;
+    /**
+     * Creation time.
+     */
+    createdAt?: Date;
+    mode?: number;
+    owner?: string;
+    group?: string;
+}
+export interface Permission extends Record<string, unknown> {
+    mode: number;
+    owner?: string;
+    group?: string;
+}
+export interface FileMetadata extends Record<string, unknown> {
+    path: string;
+    mode?: number;
+    owner?: string;
+    group?: string;
+}
+export interface RenameFileItem extends Record<string, unknown> {
+    src: string;
+    dest: string;
+}
+export interface ReplaceFileContentItem extends Record<string, unknown> {
+    old: string;
+    new: string;
+}
+export type FilesInfoResponse = Record<string, FileInfo>;
+export type SearchFilesResponse = FileInfo[];
+export interface WriteEntry {
+    path: string;
+    /**
+     * File data to upload.
+     *
+     * Supports:
+     * - string / bytes / Blob (in-memory)
+     * - AsyncIterable<Uint8Array> or ReadableStream<Uint8Array> (streaming upload for large files)
+     */
+    data?: string | Uint8Array | ArrayBuffer | Blob | AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>;
+    mode?: number;
+    owner?: string;
+    group?: string;
+}
+export interface SearchEntry {
+    path: string;
+    pattern?: string;
+}
+export interface MoveEntry {
+    src: string;
+    dest: string;
+}
+export interface ContentReplaceEntry {
+    path: string;
+    oldContent: string;
+    newContent: string;
+}
+export interface SetPermissionEntry {
+    path: string;
+    mode: number;
+    owner?: string;
+    group?: string;
+}
+//# sourceMappingURL=filesystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/models/filesystem.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AAEH,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAuB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,EAAE,CAAC;AAG7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/models/filesystem.js

@@ -0,0 +1,14 @@
+// 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 {};