@agentuity/server 0.0.105 → 0.0.107

package/dist/api/sandbox/client.d.ts

@@ -0,0 +1,125 @@
+import type { Logger, SandboxCreateOptions, SandboxInfo, ExecuteOptions as CoreExecuteOptions, Execution, FileToWrite } from '@agentuity/core';
+import type { Writable } from 'node:stream';
+import { type SandboxCreateResponse } from './create';
+/**
+ * Extended execute options that support piping output to writable streams
+ */
+export interface ExecuteOptions extends CoreExecuteOptions {
+    /**
+     * Pipe stdout/stderr to writable streams (e.g., process.stdout)
+     */
+    pipe?: {
+        stdout?: Writable;
+        stderr?: Writable;
+    };
+}
+export interface SandboxClientOptions {
+    /**
+     * API key for authentication.
+     * Defaults to process.env.AGENTUITY_SDK_KEY || process.env.AGENTUITY_CLI_KEY
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the sandbox API.
+     * Defaults to process.env.AGENTUITY_SANDBOX_URL ||
+     *   process.env.AGENTUITY_CATALYST_URL ||
+     *   process.env.AGENTUITY_TRANSPORT_URL ||
+     *   regional catalyst URL
+     */
+    url?: string;
+    /**
+     * Organization ID for multi-tenant operations
+     */
+    orgId?: string;
+    /**
+     * Custom logger instance
+     */
+    logger?: Logger;
+}
+/**
+ * A sandbox instance returned by SandboxClient.create()
+ */
+export interface SandboxInstance {
+    /**
+     * Unique sandbox identifier
+     */
+    id: string;
+    /**
+     * Sandbox status at creation time
+     */
+    status: SandboxCreateResponse['status'];
+    /**
+     * URL to stream stdout output
+     */
+    stdoutStreamUrl?: string;
+    /**
+     * URL to stream stderr output
+     */
+    stderrStreamUrl?: string;
+    /**
+     * Execute a command in the sandbox
+     */
+    execute(options: ExecuteOptions): Promise<Execution>;
+    /**
+     * Get current sandbox information
+     */
+    get(): Promise<SandboxInfo>;
+    /**
+     * Destroy the sandbox and release all resources
+     */
+    destroy(): Promise<void>;
+}
+/**
+ * Convenience client for sandbox operations.
+ *
+ * @example
+ * ```typescript
+ * const client = new SandboxClient();
+ * const sandbox = await client.create();
+ * const result = await sandbox.execute({ command: ['echo', 'hello'] });
+ * await sandbox.destroy();
+ * ```
+ */
+export declare class SandboxClient {
+    #private;
+    constructor(options?: SandboxClientOptions);
+    /**
+     * Create a new sandbox instance
+     *
+     * @param options - Optional sandbox configuration
+     * @returns A sandbox instance with execute and destroy methods
+     */
+    create(options?: SandboxCreateOptions): Promise<SandboxInstance>;
+    /**
+     * Get sandbox information by ID
+     *
+     * @param sandboxId - The sandbox ID
+     * @returns Sandbox information
+     */
+    get(sandboxId: string): Promise<SandboxInfo>;
+    /**
+     * Destroy a sandbox by ID
+     *
+     * @param sandboxId - The sandbox ID to destroy
+     */
+    destroy(sandboxId: string): Promise<void>;
+    /**
+     * Write files to a sandbox workspace
+     *
+     * @param sandboxId - The sandbox ID
+     * @param files - Array of files to write with path and content
+     * @param signal - Optional AbortSignal to cancel the operation
+     * @returns The number of files written
+     */
+    writeFiles(sandboxId: string, files: FileToWrite[], signal?: AbortSignal): Promise<number>;
+    /**
+     * Read a file from a sandbox workspace
+     *
+     * @param sandboxId - The sandbox ID
+     * @param path - Path to the file relative to the sandbox workspace
+     * @param signal - Optional AbortSignal to cancel the operation
+     * @returns A ReadableStream of the file contents
+     */
+    readFile(sandboxId: string, path: string, signal?: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/sandbox/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,MAAM,EACN,oBAAoB,EACpB,WAAW,EACX,cAAc,IAAI,kBAAkB,EACpC,SAAS,EACT,WAAW,EACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAiFrE;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACzD;;OAEG;IACH,IAAI,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,QAAQ,CAAC;QAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;KAClB,CAAC;CACF;AAED,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAExC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAErD;;OAEG;IACH,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;;gBAIb,OAAO,GAAE,oBAAyB;IAoB9C;;;;;OAKG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IA2EtE;;;;;OAKG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIlD;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;;;;;;OAOG;IACG,UAAU,CACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC;IAUlB;;;;;;;OAOG;IACG,QAAQ,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;CAQtC"}

package/dist/api/sandbox/client.js

@@ -0,0 +1,202 @@
+import { APIClient } from '../api';
+import { sandboxCreate } from './create';
+import { sandboxDestroy } from './destroy';
+import { sandboxGet } from './get';
+import { sandboxExecute } from './execute';
+import { sandboxWriteFiles, sandboxReadFile } from './files';
+import { executionGet } from './execution';
+import { ConsoleLogger } from '../../logger';
+import { getServiceUrls } from '../../config';
+const POLL_INTERVAL_MS = 100;
+const MAX_POLL_TIME_MS = 300000; // 5 minutes
+/**
+ * Poll for execution completion
+ */
+async function waitForExecution(client, executionId, orgId, signal) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < MAX_POLL_TIME_MS) {
+        if (signal?.aborted) {
+            throw new DOMException('The operation was aborted.', 'AbortError');
+        }
+        const info = await executionGet(client, { executionId, orgId });
+        if (info.status === 'completed' ||
+            info.status === 'failed' ||
+            info.status === 'timeout' ||
+            info.status === 'cancelled') {
+            return info;
+        }
+        await new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(resolve, POLL_INTERVAL_MS);
+            signal?.addEventListener('abort', () => {
+                clearTimeout(timeoutId);
+                reject(new DOMException('The operation was aborted.', 'AbortError'));
+            }, { once: true });
+        });
+    }
+    throw new Error(`Execution ${executionId} timed out waiting for completion`);
+}
+/**
+ * Pipes a remote stream URL to a local writable stream
+ */
+async function pipeStreamToWritable(streamUrl, writable) {
+    const response = await fetch(streamUrl);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch stream: ${response.status} ${response.statusText}`);
+    }
+    if (!response.body) {
+        return;
+    }
+    const reader = response.body.getReader();
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value) {
+                writable.write(value);
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/**
+ * Convenience client for sandbox operations.
+ *
+ * @example
+ * ```typescript
+ * const client = new SandboxClient();
+ * const sandbox = await client.create();
+ * const result = await sandbox.execute({ command: ['echo', 'hello'] });
+ * await sandbox.destroy();
+ * ```
+ */
+export class SandboxClient {
+    #client;
+    #orgId;
+    constructor(options = {}) {
+        const apiKey = options.apiKey || process.env.AGENTUITY_SDK_KEY || process.env.AGENTUITY_CLI_KEY;
+        const region = process.env.AGENTUITY_REGION ?? 'usc';
+        const serviceUrls = getServiceUrls(region);
+        const url = options.url ||
+            process.env.AGENTUITY_SANDBOX_URL ||
+            process.env.AGENTUITY_CATALYST_URL ||
+            process.env.AGENTUITY_TRANSPORT_URL ||
+            serviceUrls.sandbox;
+        const logger = options.logger ?? new ConsoleLogger('warn');
+        this.#client = new APIClient(url, logger, apiKey ?? '', {});
+        this.#orgId = options.orgId;
+    }
+    /**
+     * Create a new sandbox instance
+     *
+     * @param options - Optional sandbox configuration
+     * @returns A sandbox instance with execute and destroy methods
+     */
+    async create(options) {
+        const response = await sandboxCreate(this.#client, {
+            options,
+            orgId: this.#orgId,
+        });
+        const sandboxId = response.sandboxId;
+        const client = this.#client;
+        const orgId = this.#orgId;
+        return {
+            id: sandboxId,
+            status: response.status,
+            stdoutStreamUrl: response.stdoutStreamUrl,
+            stderrStreamUrl: response.stderrStreamUrl,
+            async execute(executeOptions) {
+                const { pipe, ...coreOptions } = executeOptions;
+                const initialResult = await sandboxExecute(client, {
+                    sandboxId,
+                    options: coreOptions,
+                    orgId,
+                    signal: coreOptions.signal,
+                });
+                // If pipe options provided, stream the output to the writable streams
+                if (pipe) {
+                    const streamPromises = [];
+                    if (pipe.stdout && initialResult.stdoutStreamUrl) {
+                        streamPromises.push(pipeStreamToWritable(initialResult.stdoutStreamUrl, pipe.stdout));
+                    }
+                    if (pipe.stderr && initialResult.stderrStreamUrl) {
+                        streamPromises.push(pipeStreamToWritable(initialResult.stderrStreamUrl, pipe.stderr));
+                    }
+                    // Wait for all streams to complete
+                    if (streamPromises.length > 0) {
+                        await Promise.all(streamPromises);
+                    }
+                }
+                // Wait for execution to complete and get final result with exit code
+                const finalResult = await waitForExecution(client, initialResult.executionId, orgId, coreOptions.signal);
+                return {
+                    executionId: finalResult.executionId,
+                    status: finalResult.status,
+                    exitCode: finalResult.exitCode,
+                    durationMs: finalResult.durationMs,
+                    stdoutStreamUrl: initialResult.stdoutStreamUrl,
+                    stderrStreamUrl: initialResult.stderrStreamUrl,
+                };
+            },
+            async get() {
+                return sandboxGet(client, { sandboxId, orgId });
+            },
+            async destroy() {
+                return sandboxDestroy(client, { sandboxId, orgId });
+            },
+        };
+    }
+    /**
+     * Get sandbox information by ID
+     *
+     * @param sandboxId - The sandbox ID
+     * @returns Sandbox information
+     */
+    async get(sandboxId) {
+        return sandboxGet(this.#client, { sandboxId, orgId: this.#orgId });
+    }
+    /**
+     * Destroy a sandbox by ID
+     *
+     * @param sandboxId - The sandbox ID to destroy
+     */
+    async destroy(sandboxId) {
+        return sandboxDestroy(this.#client, { sandboxId, orgId: this.#orgId });
+    }
+    /**
+     * Write files to a sandbox workspace
+     *
+     * @param sandboxId - The sandbox ID
+     * @param files - Array of files to write with path and content
+     * @param signal - Optional AbortSignal to cancel the operation
+     * @returns The number of files written
+     */
+    async writeFiles(sandboxId, files, signal) {
+        const result = await sandboxWriteFiles(this.#client, {
+            sandboxId,
+            files,
+            orgId: this.#orgId,
+            signal,
+        });
+        return result.filesWritten;
+    }
+    /**
+     * Read a file from a sandbox workspace
+     *
+     * @param sandboxId - The sandbox ID
+     * @param path - Path to the file relative to the sandbox workspace
+     * @param signal - Optional AbortSignal to cancel the operation
+     * @returns A ReadableStream of the file contents
+     */
+    async readFile(sandboxId, path, signal) {
+        return sandboxReadFile(this.#client, {
+            sandboxId,
+            path,
+            orgId: this.#orgId,
+            signal,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/sandbox/client.js.map

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

package/dist/api/sandbox/create.d.ts

@@ -0,0 +1,24 @@
+import { APIClient } from '../api';
+import type { SandboxCreateOptions, SandboxStatus } from '@agentuity/core';
+export interface SandboxCreateResponse {
+    sandboxId: string;
+    status: SandboxStatus;
+    stdoutStreamId?: string;
+    stdoutStreamUrl?: string;
+    stderrStreamId?: string;
+    stderrStreamUrl?: string;
+}
+export interface SandboxCreateParams {
+    options?: SandboxCreateOptions;
+    orgId?: string;
+}
+/**
+ * Creates a new sandbox instance.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters for creating the sandbox
+ * @returns The created sandbox response including sandbox ID and stream URLs
+ * @throws {SandboxResponseError} If the sandbox creation fails
+ */
+export declare function sandboxCreate(client: APIClient, params?: SandboxCreateParams): Promise<SandboxCreateResponse>;
+//# sourceMappingURL=create.d.ts.map

package/dist/api/sandbox/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAqB,MAAM,QAAQ,CAAC;AAEtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAkF3E,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,GAAE,mBAAwB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAuDhC"}

package/dist/api/sandbox/create.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+import { APIResponseSchema } from '../api';
+import { SandboxResponseError, API_VERSION } from './util';
+const SandboxCreateRequestSchema = z
+    .object({
+    resources: z
+        .object({
+        memory: z.string().optional().describe('Memory limit (e.g., "512Mi", "1Gi")'),
+        cpu: z.string().optional().describe('CPU limit (e.g., "0.5", "1")'),
+        disk: z.string().optional().describe('Disk size limit (e.g., "1Gi", "10Gi")'),
+    })
+        .optional()
+        .describe('Resource constraints for the sandbox'),
+    env: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('Environment variables to set in the sandbox'),
+    network: z
+        .object({
+        enabled: z.boolean().optional().describe('Whether network access is enabled'),
+    })
+        .optional()
+        .describe('Network configuration for the sandbox'),
+    stream: z
+        .object({
+        stdout: z.string().optional().describe('Stream ID for stdout output'),
+        stderr: z.string().optional().describe('Stream ID for stderr output'),
+        stdin: z.string().optional().describe('Stream ID for stdin input'),
+        timestamps: z.boolean().optional().describe('Whether to include timestamps in output'),
+    })
+        .optional()
+        .describe('Stream configuration for I/O redirection'),
+    timeout: z
+        .object({
+        idle: z.string().optional().describe('Idle timeout duration (e.g., "5m", "1h")'),
+        execution: z.string().optional().describe('Maximum execution time (e.g., "30m", "2h")'),
+    })
+        .optional()
+        .describe('Timeout settings for the sandbox'),
+    command: z
+        .object({
+        exec: z.array(z.string()).describe('Command and arguments to execute'),
+        files: z
+            .array(z.object({
+            path: z
+                .string()
+                .describe('Path to the file relative to the sandbox workspace'),
+            content: z.string().describe('Base64-encoded file content'),
+        }))
+            .optional()
+            .describe('Files to write before execution'),
+        mode: z
+            .enum(['oneshot', 'interactive'])
+            .optional()
+            .describe('Execution mode: oneshot runs once, interactive keeps running'),
+    })
+        .optional()
+        .describe('Initial command to run in the sandbox'),
+    snapshot: z.string().optional().describe('Snapshot ID to restore the sandbox from'),
+    dependencies: z
+        .array(z.string())
+        .optional()
+        .describe('Apt packages to install when creating the sandbox'),
+})
+    .describe('Request body for creating a new sandbox');
+const SandboxCreateDataSchema = z
+    .object({
+    sandboxId: z.string().describe('Unique identifier for the created sandbox'),
+    status: z
+        .enum(['creating', 'idle', 'running', 'terminated', 'failed'])
+        .describe('Current status of the sandbox'),
+    stdoutStreamId: z.string().optional().describe('Stream ID for reading stdout'),
+    stdoutStreamUrl: z.string().optional().describe('URL for streaming stdout output'),
+    stderrStreamId: z.string().optional().describe('Stream ID for reading stderr'),
+    stderrStreamUrl: z.string().optional().describe('URL for streaming stderr output'),
+})
+    .describe('Response data from sandbox creation');
+const SandboxCreateResponseSchema = APIResponseSchema(SandboxCreateDataSchema);
+/**
+ * Creates a new sandbox instance.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters for creating the sandbox
+ * @returns The created sandbox response including sandbox ID and stream URLs
+ * @throws {SandboxResponseError} If the sandbox creation fails
+ */
+export async function sandboxCreate(client, params = {}) {
+    const { options = {}, orgId } = params;
+    const body = {};
+    if (options.resources) {
+        body.resources = options.resources;
+    }
+    if (options.env) {
+        body.env = options.env;
+    }
+    if (options.network) {
+        body.network = options.network;
+    }
+    if (options.stream) {
+        body.stream = options.stream;
+    }
+    if (options.timeout) {
+        body.timeout = options.timeout;
+    }
+    if (options.command) {
+        body.command = {
+            exec: options.command.exec,
+            mode: options.command.mode,
+            files: options.command.files?.map((f) => ({
+                path: f.path,
+                content: f.content.toString('base64'),
+            })),
+        };
+    }
+    if (options.snapshot) {
+        body.snapshot = options.snapshot;
+    }
+    if (options.dependencies && options.dependencies.length > 0) {
+        body.dependencies = options.dependencies;
+    }
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/${API_VERSION}${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.post(url, body, SandboxCreateResponseSchema, SandboxCreateRequestSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new SandboxResponseError({ message: resp.message });
+}
+//# sourceMappingURL=create.js.map

package/dist/api/sandbox/create.js.map

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

package/dist/api/sandbox/destroy.d.ts

@@ -0,0 +1,14 @@
+import { APIClient } from '../api';
+export interface SandboxDestroyParams {
+    sandboxId: string;
+    orgId?: string;
+}
+/**
+ * Destroys a sandbox and releases all associated resources.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID to destroy
+ * @throws {SandboxResponseError} If the sandbox is not found or destruction fails
+ */
+export declare function sandboxDestroy(client: APIClient, params: SandboxDestroyParams): Promise<void>;
+//# sourceMappingURL=destroy.d.ts.map

package/dist/api/sandbox/destroy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/destroy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA2B,MAAM,QAAQ,CAAC;AAK5D,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/api/sandbox/destroy.js

@@ -0,0 +1,25 @@
+import { APIResponseSchemaNoData } from '../api';
+import { SandboxResponseError, API_VERSION } from './util';
+const DestroyResponseSchema = APIResponseSchemaNoData();
+/**
+ * Destroys a sandbox and releases all associated resources.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID to destroy
+ * @throws {SandboxResponseError} If the sandbox is not found or destruction fails
+ */
+export async function sandboxDestroy(client, params) {
+    const { sandboxId, orgId } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/${API_VERSION}/${sandboxId}${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.delete(url, DestroyResponseSchema);
+    if (resp.success) {
+        return;
+    }
+    throw new SandboxResponseError({ message: resp.message, sandboxId });
+}
+//# sourceMappingURL=destroy.js.map

package/dist/api/sandbox/destroy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.js","sourceRoot":"","sources":["../../../src/api/sandbox/destroy.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE3D,MAAM,qBAAqB,GAAG,uBAAuB,EAAE,CAAC;AAOxD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAiB,EACjB,MAA4B;IAE5B,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;IAC1C,IAAI,KAAK,EAAE,CAAC;QACX,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,YAAY,WAAW,IAAI,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAE1F,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAC/B,GAAG,EACH,qBAAqB,CACrB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;IACR,CAAC;IAED,MAAM,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/api/sandbox/execute.d.ts

@@ -0,0 +1,18 @@
+import { APIClient } from '../api';
+import type { ExecuteOptions, Execution } from '@agentuity/core';
+export interface SandboxExecuteParams {
+    sandboxId: string;
+    options: ExecuteOptions;
+    orgId?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Executes a command in an existing sandbox.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and execution options
+ * @returns The execution result including status and stream URLs
+ * @throws {SandboxResponseError} If the execution request fails
+ */
+export declare function sandboxExecute(client: APIClient, params: SandboxExecuteParams): Promise<Execution>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/api/sandbox/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAqB,MAAM,QAAQ,CAAC;AAGtD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAiClF,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,SAAS,CAAC,CA8CpB"}

package/dist/api/sandbox/execute.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { APIResponseSchema } from '../api';
+import { SandboxResponseError, API_VERSION } from './util';
+import { FileToWriteSchema } from './files';
+const ExecuteRequestSchema = z
+    .object({
+    command: z.array(z.string()).describe('Command and arguments to execute'),
+    files: z.array(FileToWriteSchema).optional().describe('Files to write before execution'),
+    timeout: z.string().optional().describe('Execution timeout (e.g., "30s", "5m")'),
+    stream: z
+        .object({
+        stdout: z.string().optional().describe('Stream ID for stdout output'),
+        stderr: z.string().optional().describe('Stream ID for stderr output'),
+        timestamps: z.boolean().optional().describe('Whether to include timestamps in output'),
+    })
+        .optional()
+        .describe('Stream configuration for output redirection'),
+})
+    .describe('Request body for executing a command in a sandbox');
+const ExecuteDataSchema = z
+    .object({
+    executionId: z.string().describe('Unique identifier for the execution'),
+    status: z
+        .enum(['queued', 'running', 'completed', 'failed', 'timeout', 'cancelled'])
+        .describe('Current status of the execution'),
+    exitCode: z.number().optional().describe('Exit code of the executed command'),
+    durationMs: z.number().optional().describe('Execution duration in milliseconds'),
+    stdoutStreamUrl: z.string().optional().describe('URL for streaming stdout output'),
+    stderrStreamUrl: z.string().optional().describe('URL for streaming stderr output'),
+})
+    .describe('Response data from command execution');
+const ExecuteResponseSchema = APIResponseSchema(ExecuteDataSchema);
+/**
+ * Executes a command in an existing sandbox.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and execution options
+ * @returns The execution result including status and stream URLs
+ * @throws {SandboxResponseError} If the execution request fails
+ */
+export async function sandboxExecute(client, params) {
+    const { sandboxId, options, orgId, signal } = params;
+    const body = {
+        command: options.command,
+    };
+    if (options.files) {
+        body.files = options.files.map((f) => ({
+            path: f.path,
+            content: f.content.toString('base64'),
+        }));
+    }
+    if (options.timeout) {
+        body.timeout = options.timeout;
+    }
+    if (options.stream) {
+        body.stream = options.stream;
+    }
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/${API_VERSION}/${sandboxId}/execute${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.post(url, body, ExecuteResponseSchema, ExecuteRequestSchema, signal ?? options.signal);
+    if (resp.success) {
+        return {
+            executionId: resp.data.executionId,
+            status: resp.data.status,
+            exitCode: resp.data.exitCode,
+            durationMs: resp.data.durationMs,
+            stdoutStreamUrl: resp.data.stdoutStreamUrl,
+            stderrStreamUrl: resp.data.stderrStreamUrl,
+        };
+    }
+    throw new SandboxResponseError({ message: resp.message, sandboxId });
+}
+//# sourceMappingURL=execute.js.map