@agentuity/core 1.0.31 → 1.0.33

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

@@ -0,0 +1,69 @@
+import type { ExecuteOptions, Execution } from '../../services/sandbox.ts';
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+export declare const ExecuteRequestSchema: z.ZodObject<{
+    command: z.ZodArray<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+    timeout: z.ZodOptional<z.ZodString>;
+    stream: z.ZodOptional<z.ZodObject<{
+        stdout: z.ZodOptional<z.ZodString>;
+        stderr: z.ZodOptional<z.ZodString>;
+        timestamps: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ExecuteDataSchema: z.ZodObject<{
+    executionId: z.ZodString;
+    status: z.ZodEnum<{
+        running: "running";
+        failed: "failed";
+        queued: "queued";
+        completed: "completed";
+        timeout: "timeout";
+        cancelled: "cancelled";
+    }>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+    stderrStreamUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ExecuteResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        executionId: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            queued: "queued";
+            completed: "completed";
+            timeout: "timeout";
+            cancelled: "cancelled";
+        }>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+        stderrStreamUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+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":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAmB,MAAM,2BAA2B,CAAC;AAC5F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAG9D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAsB8B,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAWoB,CAAC;AAEnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;8BAAuC,CAAC;AAE1E,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,CAqEpB"}

package/dist/api/sandbox/execute.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { SandboxBusyError, throwSandboxError } from "./util.js";
+export const ExecuteRequestSchema = z
+    .object({
+    command: z.array(z.string()).describe('Command and arguments to execute'),
+    files: z
+        .array(z.object({
+        path: z.string().describe('File path relative to workspace'),
+        content: z.string().describe('Base64-encoded file content'),
+    }))
+        .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');
+export 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');
+export 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 && options.files.length > 0) {
+        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/${sandboxId}/execute${queryString ? `?${queryString}` : ''}`;
+    let resp;
+    try {
+        resp = await client.post(url, body, ExecuteResponseSchema, ExecuteRequestSchema, signal ?? options.signal);
+    }
+    catch (error) {
+        // Detect 409 Conflict (sandbox busy) and throw a specific error.
+        // The sandbox API client is configured with maxRetries: 0 to fail fast
+        // when sandbox is busy (retrying wouldn't help - sandbox is still busy).
+        // Convert APIErrorResponse with status 409 to SandboxBusyError for clarity.
+        if (error &&
+            typeof error === 'object' &&
+            '_tag' in error &&
+            error._tag === 'APIErrorResponse' &&
+            'status' in error &&
+            error.status === 409) {
+            throw new SandboxBusyError({
+                message: 'Sandbox is currently busy executing another command. Please wait for the current execution to complete before submitting a new one.',
+                sandboxId,
+            });
+        }
+        throw error;
+    }
+    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,
+        };
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+//# sourceMappingURL=execute.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/api/sandbox/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KACnC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACzE,KAAK,EAAE,CAAC;SACN,KAAK,CACL,CAAC,CAAC,MAAM,CAAC;QACR,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KAC3D,CAAC,CACF;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,iCAAiC,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAChF,MAAM,EAAE,CAAC;SACP,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACrE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KACtF,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;CACzD,CAAC;KACD,QAAQ,CAAC,mDAAmD,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAChC,MAAM,CAAC;IACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACvE,MAAM,EAAE,CAAC;SACP,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;SAC1E,QAAQ,CAAC,iCAAiC,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC7E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAChF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAClF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAClF,CAAC;KACD,QAAQ,CAAC,sCAAsC,CAAC,CAAC;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;AAS1E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAiB,EACjB,MAA4B;IAE5B,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACrD,MAAM,IAAI,GAAyC;QAClD,OAAO,EAAE,OAAO,CAAC,OAAO;KACxB,CAAC;IAEF,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACrC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,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,SAAS,WAAW,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAEnF,IAAI,IAA2C,CAAC;IAChD,IAAI,CAAC;QACJ,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CACvB,GAAG,EACH,IAAI,EACJ,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,IAAI,OAAO,CAAC,MAAM,CACxB,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACzB,iEAAiE;QACjE,uEAAuE;QACvE,yEAAyE;QACzE,4EAA4E;QAC5E,IACC,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,MAAM,IAAI,KAAK;YACd,KAA0B,CAAC,IAAI,KAAK,kBAAkB;YACvD,QAAQ,IAAI,KAAK;YAChB,KAA4B,CAAC,MAAM,KAAK,GAAG,EAC3C,CAAC;YACF,MAAM,IAAI,gBAAgB,CAAC;gBAC1B,OAAO,EACN,qIAAqI;gBACtI,SAAS;aACT,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;YACN,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAyB;YAC3C,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe;YAC1C,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe;SAC1C,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,169 @@
+import type { ExecutionStatus } from '../../services/sandbox.ts';
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+export declare const ExecutionInfoSchema: z.ZodObject<{
+    executionId: z.ZodString;
+    sandboxId: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        running: "running";
+        failed: "failed";
+        queued: "queued";
+        completed: "completed";
+        timeout: "timeout";
+        cancelled: "cancelled";
+    }>;
+    command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+    stderrStreamUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ExecutionGetResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        executionId: z.ZodString;
+        sandboxId: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            queued: "queued";
+            completed: "completed";
+            timeout: "timeout";
+            cancelled: "cancelled";
+        }>;
+        command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+        stderrStreamUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const ExecutionListDataSchema: z.ZodObject<{
+    executions: z.ZodArray<z.ZodObject<{
+        executionId: z.ZodString;
+        sandboxId: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            queued: "queued";
+            completed: "completed";
+            timeout: "timeout";
+            cancelled: "cancelled";
+        }>;
+        command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+        stderrStreamUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ExecutionListResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        executions: z.ZodArray<z.ZodObject<{
+            executionId: z.ZodString;
+            sandboxId: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            status: z.ZodEnum<{
+                running: "running";
+                failed: "failed";
+                queued: "queued";
+                completed: "completed";
+                timeout: "timeout";
+                cancelled: "cancelled";
+            }>;
+            command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            exitCode: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            completedAt: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+            stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+            stderrStreamUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export interface ExecutionInfo {
+    executionId: string;
+    sandboxId: string;
+    type?: string;
+    status: ExecutionStatus;
+    command?: string[];
+    exitCode?: number;
+    durationMs?: number;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+    stdoutStreamUrl?: string;
+    stderrStreamUrl?: string;
+}
+export interface ExecutionGetParams {
+    executionId: string;
+    orgId?: string;
+    /**
+     * Optional wait duration for long-polling. If specified, the server will hold
+     * the connection open until the execution reaches a terminal state (completed,
+     * failed, timeout, cancelled) or the wait duration expires.
+     *
+     * Format: duration string like "30s", "1m", "5m"
+     * Maximum: 5 minutes (server will cap at this value)
+     *
+     * If not specified, returns immediately with current status.
+     */
+    wait?: string;
+}
+/**
+ * Retrieves detailed information about a specific execution.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the execution ID and optional wait duration
+ * @returns Detailed execution information including status, timing, and errors
+ * @throws {SandboxResponseError} If the execution is not found or request fails
+ *
+ * @example
+ * // Immediate return (current behavior)
+ * const info = await executionGet(client, { executionId: 'exec_123' });
+ *
+ * @example
+ * // Long-poll: wait up to 60 seconds for completion
+ * const info = await executionGet(client, { executionId: 'exec_123', wait: '60s' });
+ */
+export declare function executionGet(client: APIClient, params: ExecutionGetParams): Promise<ExecutionInfo>;
+export interface ExecutionListParams {
+    sandboxId: string;
+    orgId?: string;
+    limit?: number;
+}
+export interface ExecutionListResponse {
+    executions: ExecutionInfo[];
+}
+/**
+ * Lists all executions for a specific sandbox.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID and optional limit
+ * @returns List of execution information for the sandbox
+ * @throws {SandboxResponseError} If the sandbox is not found or request fails
+ */
+export declare function executionList(client: APIClient, params: ExecutionListParams): Promise<ExecutionListResponse>;
+//# sourceMappingURL=execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../../src/api/sandbox/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAG9D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;iBAoB4B,CAAC;AAE7D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAAyC,CAAC;AAEjF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;iBAIU,CAAC;AAE/C,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAA6C,CAAC;AAEtF,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAmCxB;AAED,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAqChC"}

package/dist/api/sandbox/execution.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { throwSandboxError } from "./util.js";
+export const ExecutionInfoSchema = z
+    .object({
+    executionId: z.string().describe('Unique identifier for the execution'),
+    sandboxId: z.string().describe('ID of the sandbox where the execution ran'),
+    type: z
+        .string()
+        .optional()
+        .describe('Type of execution (e.g., exec, write_files, read_file)'),
+    status: z
+        .enum(['queued', 'running', 'completed', 'failed', 'timeout', 'cancelled'])
+        .describe('Current status of the execution'),
+    command: z.array(z.string()).optional().describe('Command that was executed'),
+    exitCode: z.number().optional().describe('Exit code of the executed command'),
+    durationMs: z.number().optional().describe('Execution duration in milliseconds'),
+    startedAt: z.string().optional().describe('ISO timestamp when execution started'),
+    completedAt: z.string().optional().describe('ISO timestamp when execution completed'),
+    error: z.string().optional().describe('Error message if execution failed'),
+    stdoutStreamUrl: z.string().optional().describe('URL to stream stdout output'),
+    stderrStreamUrl: z.string().optional().describe('URL to stream stderr output'),
+})
+    .describe('Detailed information about a command execution');
+export const ExecutionGetResponseSchema = APIResponseSchema(ExecutionInfoSchema);
+export const ExecutionListDataSchema = z
+    .object({
+    executions: z.array(ExecutionInfoSchema).describe('List of executions'),
+})
+    .describe('List of executions for a sandbox');
+export const ExecutionListResponseSchema = APIResponseSchema(ExecutionListDataSchema);
+/**
+ * Retrieves detailed information about a specific execution.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the execution ID and optional wait duration
+ * @returns Detailed execution information including status, timing, and errors
+ * @throws {SandboxResponseError} If the execution is not found or request fails
+ *
+ * @example
+ * // Immediate return (current behavior)
+ * const info = await executionGet(client, { executionId: 'exec_123' });
+ *
+ * @example
+ * // Long-poll: wait up to 60 seconds for completion
+ * const info = await executionGet(client, { executionId: 'exec_123', wait: '60s' });
+ */
+export async function executionGet(client, params) {
+    const { executionId, orgId, wait } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    if (wait) {
+        queryParams.set('wait', wait);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/execution/${executionId}${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.get(url, ExecutionGetResponseSchema);
+    if (resp.success) {
+        return {
+            executionId: resp.data.executionId,
+            sandboxId: resp.data.sandboxId,
+            type: resp.data.type,
+            status: resp.data.status,
+            command: resp.data.command,
+            exitCode: resp.data.exitCode,
+            durationMs: resp.data.durationMs,
+            startedAt: resp.data.startedAt,
+            completedAt: resp.data.completedAt,
+            error: resp.data.error,
+            stdoutStreamUrl: resp.data.stdoutStreamUrl,
+            stderrStreamUrl: resp.data.stderrStreamUrl,
+        };
+    }
+    throwSandboxError(resp, { executionId });
+}
+/**
+ * Lists all executions for a specific sandbox.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID and optional limit
+ * @returns List of execution information for the sandbox
+ * @throws {SandboxResponseError} If the sandbox is not found or request fails
+ */
+export async function executionList(client, params) {
+    const { sandboxId, orgId, limit } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    if (limit !== undefined) {
+        queryParams.set('limit', String(limit));
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/sandboxes/${sandboxId}/executions${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.get(url, ExecutionListResponseSchema);
+    if (resp.success) {
+        return {
+            executions: resp.data.executions.map((exec) => ({
+                executionId: exec.executionId,
+                sandboxId: exec.sandboxId,
+                type: exec.type,
+                status: exec.status,
+                command: exec.command,
+                exitCode: exec.exitCode,
+                durationMs: exec.durationMs,
+                startedAt: exec.startedAt,
+                completedAt: exec.completedAt,
+                error: exec.error,
+                stdoutStreamUrl: exec.stdoutStreamUrl,
+                stderrStreamUrl: exec.stderrStreamUrl,
+            })),
+        };
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+//# sourceMappingURL=execution.js.map

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

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