@agentuity/server 0.0.105 → 0.0.107

package/dist/api/sandbox/run.js

@@ -0,0 +1,269 @@
+import { sandboxCreate } from './create';
+import { sandboxDestroy } from './destroy';
+import { sandboxGet } from './get';
+import { SandboxResponseError, writeAndDrain } from './util';
+import { getServiceUrls } from '../../config';
+const POLL_INTERVAL_MS = 500;
+const MAX_POLL_ATTEMPTS = 7200;
+/**
+ * Creates a sandbox, executes a command, and waits for completion.
+ *
+ * This is a high-level convenience function that handles the full lifecycle:
+ * creating a sandbox, streaming I/O, polling for completion, and cleanup.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including command options, I/O streams, and timeout settings
+ * @returns The run result including exit code and duration
+ * @throws {SandboxResponseError} If sandbox creation fails, execution times out, or is cancelled
+ */
+export async function sandboxRun(client, params) {
+    const { options, orgId, region, apiKey, signal, stdin, stdout, stderr, logger } = params;
+    const started = Date.now();
+    let stdinStreamId;
+    let stdinStreamUrl;
+    // If stdin is provided and has data, create a stream for it
+    if (stdin && region && apiKey) {
+        const streamResult = await createStdinStream(region, apiKey, orgId, logger);
+        stdinStreamId = streamResult.id;
+        stdinStreamUrl = streamResult.url;
+        logger?.debug('created stdin stream: %s', stdinStreamId);
+    }
+    const createResponse = await sandboxCreate(client, {
+        options: {
+            ...options,
+            command: {
+                exec: options.command.exec,
+                files: options.command.files,
+                mode: 'oneshot',
+            },
+            stream: {
+                ...options.stream,
+                stdin: stdinStreamId,
+            },
+        },
+        orgId,
+    });
+    const sandboxId = createResponse.sandboxId;
+    const stdoutStreamUrl = createResponse.stdoutStreamUrl;
+    const stderrStreamUrl = createResponse.stderrStreamUrl;
+    logger?.debug('sandbox created: %s, stdoutUrl: %s, stderrUrl: %s', sandboxId, stdoutStreamUrl ?? 'none', stderrStreamUrl ?? 'none');
+    const abortController = new AbortController();
+    const streamPromises = [];
+    try {
+        // Start stdin streaming if we have stdin and a stream URL
+        if (stdin && stdinStreamUrl && apiKey) {
+            const stdinPromise = streamStdinToUrl(stdin, stdinStreamUrl, apiKey, abortController.signal, logger);
+            streamPromises.push(stdinPromise);
+        }
+        // Check if stdout and stderr are the same stream (combined output)
+        const isCombinedOutput = stdoutStreamUrl && stderrStreamUrl && stdoutStreamUrl === stderrStreamUrl;
+        if (isCombinedOutput) {
+            // Stream combined output to stdout only to avoid duplicates
+            if (stdout) {
+                logger?.debug('using combined output stream (stdout === stderr)');
+                const combinedPromise = streamUrlToWritable(stdoutStreamUrl, stdout, abortController.signal, logger);
+                streamPromises.push(combinedPromise);
+            }
+        }
+        else {
+            // Start stdout streaming
+            if (stdoutStreamUrl && stdout) {
+                const stdoutPromise = streamUrlToWritable(stdoutStreamUrl, stdout, abortController.signal, logger);
+                streamPromises.push(stdoutPromise);
+            }
+            // Start stderr streaming
+            if (stderrStreamUrl && stderr) {
+                const stderrPromise = streamUrlToWritable(stderrStreamUrl, stderr, abortController.signal, logger);
+                streamPromises.push(stderrPromise);
+            }
+        }
+        // Poll for sandbox completion in parallel with streaming
+        let attempts = 0;
+        let finalStatus = null;
+        while (attempts < MAX_POLL_ATTEMPTS) {
+            if (signal?.aborted) {
+                abortController.abort();
+                throw new SandboxResponseError({
+                    message: 'Sandbox execution cancelled',
+                    sandboxId,
+                });
+            }
+            await sleep(POLL_INTERVAL_MS);
+            attempts++;
+            try {
+                const sandboxInfo = await sandboxGet(client, { sandboxId, orgId });
+                if (sandboxInfo.status === 'terminated') {
+                    finalStatus = 'terminated';
+                    break;
+                }
+                if (sandboxInfo.status === 'failed') {
+                    finalStatus = 'failed';
+                    break;
+                }
+            }
+            catch {
+                // Ignore polling errors, continue
+                continue;
+            }
+        }
+        // Sandbox completed - wait for streams to complete naturally (EOF)
+        // Pulse closes streams when the sandbox terminates, so streams should EOF
+        // We must wait for streams to fully drain before returning
+        logger?.debug('waiting for streams to complete...');
+        await Promise.allSettled(streamPromises);
+        logger?.debug('streams completed');
+        if (finalStatus === 'terminated') {
+            return {
+                sandboxId,
+                exitCode: 0,
+                durationMs: Date.now() - started,
+            };
+        }
+        if (finalStatus === 'failed') {
+            return {
+                sandboxId,
+                exitCode: 1,
+                durationMs: Date.now() - started,
+            };
+        }
+        throw new SandboxResponseError({
+            message: 'Sandbox execution polling timed out',
+            sandboxId,
+        });
+    }
+    catch (error) {
+        abortController.abort();
+        try {
+            await sandboxDestroy(client, { sandboxId, orgId });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+async function createStdinStream(region, apiKey, orgId, logger) {
+    const urls = getServiceUrls(region);
+    const streamBaseUrl = urls.stream;
+    // Build URL with orgId query param for CLI token validation
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `${streamBaseUrl}${queryString ? `?${queryString}` : ''}`;
+    logger?.trace('creating stdin stream: %s', url);
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            name: `sandbox-stdin-${Date.now()}`,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to create stdin stream: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    logger?.debug('created stdin stream: %s', data.id);
+    // Include orgId in the URL for subsequent PUT requests (needed for CLI token auth)
+    const putQueryString = orgId ? `?orgId=${encodeURIComponent(orgId)}` : '';
+    return {
+        id: data.id,
+        url: `${streamBaseUrl}/${data.id}${putQueryString}`,
+    };
+}
+async function streamStdinToUrl(stdin, url, apiKey, signal, logger) {
+    try {
+        logger?.debug('streaming stdin to: %s', url);
+        // Convert Node.js Readable to a web ReadableStream for fetch body
+        let controllerClosed = false;
+        const webStream = new ReadableStream({
+            start(controller) {
+                stdin.on('data', (chunk) => {
+                    if (!signal.aborted && !controllerClosed) {
+                        controller.enqueue(chunk);
+                    }
+                });
+                stdin.on('end', () => {
+                    if (!controllerClosed) {
+                        controllerClosed = true;
+                        controller.close();
+                    }
+                });
+                stdin.on('error', (err) => {
+                    if (!controllerClosed) {
+                        controllerClosed = true;
+                        controller.error(err);
+                    }
+                });
+                signal.addEventListener('abort', () => {
+                    if (!controllerClosed) {
+                        controllerClosed = true;
+                        controller.close();
+                    }
+                });
+            },
+        });
+        const response = await fetch(url, {
+            method: 'PUT',
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: webStream,
+            signal,
+            duplex: 'half',
+        });
+        if (!response.ok) {
+            logger?.debug('stdin stream PUT failed: %d', response.status);
+        }
+        else {
+            logger?.debug('stdin stream completed');
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'AbortError') {
+            logger?.debug('stdin stream aborted (expected on completion)');
+        }
+        else {
+            logger?.debug('stdin stream error: %s', err);
+        }
+    }
+}
+async function streamUrlToWritable(url, writable, signal, logger) {
+    try {
+        logger?.debug('fetching stream: %s', url);
+        const response = await fetch(url, { signal });
+        logger?.debug('stream response status: %d', response.status);
+        if (!response.ok || !response.body) {
+            logger?.debug('stream response not ok or no body');
+            return;
+        }
+        const reader = response.body.getReader();
+        // Read until EOF - Pulse will block until data is available
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                logger?.debug('stream EOF');
+                break;
+            }
+            if (value) {
+                logger?.debug('stream chunk: %d bytes', value.length);
+                await writeAndDrain(writable, value);
+            }
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'AbortError') {
+            logger?.debug('stream aborted');
+            return;
+        }
+        logger?.debug('stream error: %s', err);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,89 @@
+import { APIClient } from '../api';
+export interface SnapshotFileInfo {
+    path: string;
+    size: number;
+}
+export interface SnapshotInfo {
+    snapshotId: string;
+    sandboxId: string;
+    tag?: string | null;
+    sizeBytes: number;
+    fileCount: number;
+    parentSnapshotId?: string | null;
+    createdAt: string;
+    downloadUrl?: string;
+    files?: SnapshotFileInfo[];
+}
+export interface SnapshotCreateParams {
+    sandboxId: string;
+    tag?: string;
+    orgId?: string;
+}
+export interface SnapshotGetParams {
+    snapshotId: string;
+    orgId?: string;
+}
+export interface SnapshotListParams {
+    sandboxId?: string;
+    limit?: number;
+    offset?: number;
+    orgId?: string;
+}
+export interface SnapshotListResponse {
+    snapshots: SnapshotInfo[];
+    total: number;
+}
+export interface SnapshotDeleteParams {
+    snapshotId: string;
+    orgId?: string;
+}
+export interface SnapshotTagParams {
+    snapshotId: string;
+    tag: string | null;
+    orgId?: string;
+}
+/**
+ * Creates a snapshot of a sandbox's current state.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and optional tag
+ * @returns The created snapshot information
+ * @throws {SandboxResponseError} If the snapshot creation fails
+ */
+export declare function snapshotCreate(client: APIClient, params: SnapshotCreateParams): Promise<SnapshotInfo>;
+/**
+ * Retrieves detailed information about a specific snapshot.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the snapshot ID
+ * @returns Snapshot information including files and download URL
+ * @throws {SandboxResponseError} If the snapshot is not found or request fails
+ */
+export declare function snapshotGet(client: APIClient, params: SnapshotGetParams): Promise<SnapshotInfo>;
+/**
+ * Lists snapshots with optional filtering and pagination.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Optional parameters for filtering by sandbox and pagination
+ * @returns Paginated list of snapshots with total count
+ * @throws {SandboxResponseError} If the request fails
+ */
+export declare function snapshotList(client: APIClient, params?: SnapshotListParams): Promise<SnapshotListResponse>;
+/**
+ * Deletes a snapshot and releases its storage.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the snapshot ID to delete
+ * @throws {SandboxResponseError} If the snapshot is not found or deletion fails
+ */
+export declare function snapshotDelete(client: APIClient, params: SnapshotDeleteParams): Promise<void>;
+/**
+ * Updates or removes the tag on a snapshot.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including snapshot ID and new tag (or null to remove)
+ * @returns Updated snapshot information
+ * @throws {SandboxResponseError} If the snapshot is not found or update fails
+ */
+export declare function snapshotTag(client: APIClient, params: SnapshotTagParams): Promise<SnapshotInfo>;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA8C,MAAM,QAAQ,CAAC;AAyC/E,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAaD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAqBvB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CAevB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,GAAE,kBAAuB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CAgBvB"}

package/dist/api/sandbox/snapshot.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIResponseSchemaNoData } from '../api';
+import { SandboxResponseError } from './util';
+const SNAPSHOT_API_VERSION = '2025-06-26';
+const SnapshotFileInfoSchema = z
+    .object({
+    path: z.string().describe('File path within the snapshot'),
+    size: z.number().describe('File size in bytes'),
+})
+    .describe('Information about a file in a snapshot');
+const SnapshotInfoSchema = z
+    .object({
+    snapshotId: z.string().describe('Unique identifier for the snapshot'),
+    sandboxId: z.string().describe('ID of the sandbox this snapshot was created from'),
+    tag: z.string().nullable().optional().describe('User-defined tag for the snapshot'),
+    sizeBytes: z.number().describe('Total size of the snapshot in bytes'),
+    fileCount: z.number().describe('Number of files in the snapshot'),
+    parentSnapshotId: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('ID of the parent snapshot (for incremental snapshots)'),
+    createdAt: z.string().describe('ISO timestamp when the snapshot was created'),
+    downloadUrl: z.string().optional().describe('URL to download the snapshot archive'),
+    files: z.array(SnapshotFileInfoSchema).optional().describe('List of files in the snapshot'),
+})
+    .describe('Detailed information about a snapshot');
+const SnapshotCreateResponseSchema = APIResponseSchema(SnapshotInfoSchema);
+const SnapshotGetResponseSchema = APIResponseSchema(SnapshotInfoSchema);
+const SnapshotListDataSchema = z
+    .object({
+    snapshots: z.array(SnapshotInfoSchema).describe('List of snapshot entries'),
+    total: z.number().describe('Total number of snapshots matching the query'),
+})
+    .describe('Paginated list of snapshots');
+const SnapshotListResponseSchema = APIResponseSchema(SnapshotListDataSchema);
+const SnapshotDeleteResponseSchema = APIResponseSchemaNoData();
+function buildQueryString(params) {
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            query.set(key, String(value));
+        }
+    }
+    const str = query.toString();
+    return str ? `?${str}` : '';
+}
+/**
+ * Creates a snapshot of a sandbox's current state.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and optional tag
+ * @returns The created snapshot information
+ * @throws {SandboxResponseError} If the snapshot creation fails
+ */
+export async function snapshotCreate(client, params) {
+    const { sandboxId, tag, orgId } = params;
+    const queryString = buildQueryString({ orgId });
+    const url = `/sandbox/${SNAPSHOT_API_VERSION}/${sandboxId}/snapshot${queryString}`;
+    const body = {};
+    if (tag) {
+        body.tag = tag;
+    }
+    const resp = await client.post(url, body, SnapshotCreateResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new SandboxResponseError({ message: resp.message });
+}
+/**
+ * Retrieves detailed information about a specific snapshot.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the snapshot ID
+ * @returns Snapshot information including files and download URL
+ * @throws {SandboxResponseError} If the snapshot is not found or request fails
+ */
+export async function snapshotGet(client, params) {
+    const { snapshotId, orgId } = params;
+    const queryString = buildQueryString({ orgId });
+    const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots/${snapshotId}${queryString}`;
+    const resp = await client.get(url, SnapshotGetResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new SandboxResponseError({ message: resp.message });
+}
+/**
+ * Lists snapshots with optional filtering and pagination.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Optional parameters for filtering by sandbox and pagination
+ * @returns Paginated list of snapshots with total count
+ * @throws {SandboxResponseError} If the request fails
+ */
+export async function snapshotList(client, params = {}) {
+    const { sandboxId, limit, offset, orgId } = params;
+    const queryString = buildQueryString({ sandboxId, limit, offset, orgId });
+    const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots${queryString}`;
+    const resp = await client.get(url, SnapshotListResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new SandboxResponseError({ message: resp.message });
+}
+/**
+ * Deletes a snapshot and releases its storage.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the snapshot ID to delete
+ * @throws {SandboxResponseError} If the snapshot is not found or deletion fails
+ */
+export async function snapshotDelete(client, params) {
+    const { snapshotId, orgId } = params;
+    const queryString = buildQueryString({ orgId });
+    const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots/${snapshotId}${queryString}`;
+    const resp = await client.delete(url, SnapshotDeleteResponseSchema);
+    if (!resp.success) {
+        throw new SandboxResponseError({ message: resp.message });
+    }
+}
+/**
+ * Updates or removes the tag on a snapshot.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including snapshot ID and new tag (or null to remove)
+ * @returns Updated snapshot information
+ * @throws {SandboxResponseError} If the snapshot is not found or update fails
+ */
+export async function snapshotTag(client, params) {
+    const { snapshotId, tag, orgId } = params;
+    const queryString = buildQueryString({ orgId });
+    const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots/${snapshotId}${queryString}`;
+    const resp = await client.patch(url, { tag }, SnapshotGetResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new SandboxResponseError({ message: resp.message });
+}
+//# sourceMappingURL=snapshot.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { EventEmitter } from 'node:events';
+interface WritableWithDrain extends EventEmitter {
+    write(chunk: Uint8Array): boolean;
+}
+/**
+ * Error thrown when a sandbox API request fails.
+ *
+ * Includes optional context about which sandbox or execution caused the error.
+ */
+export declare const SandboxResponseError: {
+    new (args?: ({
+        /** The sandbox ID associated with the error, if applicable */
+        sandboxId?: string;
+        /** The execution ID associated with the error, if applicable */
+        executionId?: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("@agentuity/core").RichError & {
+        readonly _tag: "SandboxResponseError";
+    } & Readonly<{
+        /** The sandbox ID associated with the error, if applicable */
+        sandboxId?: string;
+        /** The execution ID associated with the error, if applicable */
+        executionId?: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+/** Current sandbox API version */
+export declare const API_VERSION = "2025-03-17";
+/**
+ * Write a chunk to a writable stream and wait for it to drain if necessary.
+ * Properly cleans up event listeners to avoid memory leaks.
+ */
+export declare function writeAndDrain(writable: WritableWithDrain, chunk: Uint8Array): Promise<void>;
+export {};
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,iBAAkB,SAAQ,YAAY;IAC/C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;QAChC,8DAA8D;oBAClD,MAAM;QAClB,gEAAgE;sBAClD,MAAM;;;;;;;QAHpB,8DAA8D;oBAClD,MAAM;QAClB,gEAAgE;sBAClD,MAAM;;;CACjB,CAAC;AAEL,kCAAkC;AAClC,eAAO,MAAM,WAAW,eAAe,CAAC;AAExC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B3F"}

package/dist/api/sandbox/util.js

@@ -0,0 +1,45 @@
+import { StructuredError } from '@agentuity/core';
+/**
+ * Error thrown when a sandbox API request fails.
+ *
+ * Includes optional context about which sandbox or execution caused the error.
+ */
+export const SandboxResponseError = StructuredError('SandboxResponseError')();
+/** Current sandbox API version */
+export const API_VERSION = '2025-03-17';
+/**
+ * Write a chunk to a writable stream and wait for it to drain if necessary.
+ * Properly cleans up event listeners to avoid memory leaks.
+ */
+export function writeAndDrain(writable, chunk) {
+    return new Promise((resolve, reject) => {
+        let needsDrain;
+        try {
+            needsDrain = !writable.write(chunk);
+        }
+        catch (err) {
+            reject(err);
+            return;
+        }
+        if (needsDrain) {
+            const cleanup = () => {
+                writable.removeListener('drain', onDrain);
+                writable.removeListener('error', onError);
+            };
+            const onDrain = () => {
+                cleanup();
+                resolve();
+            };
+            const onError = (err) => {
+                cleanup();
+                reject(err);
+            };
+            writable.once('drain', onDrain);
+            writable.once('error', onError);
+        }
+        else {
+            resolve();
+        }
+    });
+}
+//# sourceMappingURL=util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/api/sandbox/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC,sBAAsB,CAAC,EAKvE,CAAC;AAEL,kCAAkC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAA2B,EAAE,KAAiB;IAC3E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,UAAmB,CAAC;QACxB,IAAI,CAAC;YACJ,UAAU,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,CAAC;YACZ,OAAO;QACR,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACpB,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC1C,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3C,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACpB,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;YACX,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,CAAC,GAAU,EAAE,EAAE;gBAC9B,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,CAAC,CAAC;YACb,CAAC,CAAC;YACF,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -4,6 +4,7 @@ export interface ServiceUrls {
     vector: string;
     catalyst: string;
     otel: string;
+    sandbox: string;
 }
 /**
  * Get service URLs from environment variables with fallback defaults

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAU3D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAW3D"}

package/dist/config.js

@@ -9,6 +9,7 @@ export function getServiceUrls(region) {
         vector: process.env.AGENTUITY_VECTOR_URL || transportUrl,
         catalyst: process.env.AGENTUITY_CATALYST_URL || transportUrl,
         otel: process.env.AGENTUITY_OTLP_URL || buildRegionalURL(region, 'otel'),
+        sandbox: process.env.AGENTUITY_SANDBOX_URL || transportUrl,
     };
 }
 function getDomainSuffix(region) {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEjG,OAAO;QACN,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,YAAY;QACxD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC;KACxE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAe;IACvC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,cAAc,CAAC;IACvB,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAe,EAAE,QAAiB;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC/B,OAAO,WAAW,QAAQ,IAAI,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,WAAW,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAClD,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEjG,OAAO;QACN,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,YAAY;QACxD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,YAAY;QAC5D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC;QACxE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,YAAY;KAC1D,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAe;IACvC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,cAAc,CAAC;IACvB,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAe,EAAE,QAAiB;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC/B,OAAO,WAAW,QAAQ,IAAI,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,WAAW,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAClD,CAAC"}

package/dist/runtime-bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bootstrap.d.ts","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,uBAAuB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,IAAI,CAuC/E"}
+{"version":3,"file":"runtime-bootstrap.d.ts","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,uBAAuB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,IAAI,CA0C/E"}