@agentuity/sandbox 3.0.12 → 3.1.1

package/dist/disk-checkpoint.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIResponseSchemaNoData } from '@agentuity/api';
+import { throwSandboxError } from './util.js';
+// --- Schemas ---
+export const DiskCheckpointInfoSchema = z.object({
+    id: z.string().describe('Globally unique checkpoint ID (ckpt_xxx)'),
+    name: z.string().describe('User-provided checkpoint name'),
+    createdAt: z.string().describe('ISO timestamp of creation'),
+    parent: z.string().describe('Parent checkpoint name (empty for base)'),
+});
+const CreateDiskCheckpointDataSchema = DiskCheckpointInfoSchema;
+export const CreateDiskCheckpointResponseSchema = APIResponseSchema(CreateDiskCheckpointDataSchema);
+const ListDiskCheckpointsDataSchema = z.object({
+    checkpoints: z.array(DiskCheckpointInfoSchema),
+});
+export const ListDiskCheckpointsResponseSchema = APIResponseSchema(ListDiskCheckpointsDataSchema);
+export const RestoreDiskCheckpointResponseSchema = APIResponseSchemaNoData();
+export const DeleteDiskCheckpointResponseSchema = APIResponseSchemaNoData();
+// --- Params ---
+export const DiskCheckpointCreateParamsSchema = z.object({
+    sandboxId: z.string().describe('Sandbox ID for checkpoint creation'),
+    name: z.string().describe('Name to assign to the new checkpoint'),
+    orgId: z.string().optional().describe('Optional org id for CLI auth context'),
+});
+export const DiskCheckpointListParamsSchema = z.object({
+    sandboxId: z.string().describe('Sandbox ID to list checkpoints for'),
+    orgId: z.string().optional().describe('Optional org id for CLI auth context'),
+});
+export const DiskCheckpointRestoreParamsSchema = z.object({
+    sandboxId: z.string().describe('Sandbox ID to restore'),
+    checkpointId: z.string().describe('Checkpoint ID to restore from'),
+    orgId: z.string().optional().describe('Optional org id for CLI auth context'),
+});
+export const DiskCheckpointDeleteParamsSchema = z.object({
+    sandboxId: z.string().describe('Sandbox ID containing the checkpoint'),
+    checkpointId: z.string().describe('Checkpoint ID to delete'),
+    orgId: z.string().optional().describe('Optional org id for CLI auth context'),
+});
+// --- API Functions ---
+/**
+ * Creates a new disk checkpoint for a sandbox.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID and checkpoint name
+ * @throws {SandboxResponseError} If the sandbox is not found or checkpoint creation fails
+ */
+export async function diskCheckpointCreate(client, params) {
+    const { sandboxId, name, orgId } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/${encodeURIComponent(sandboxId)}/checkpoint${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.post(url, { name }, CreateDiskCheckpointResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+/**
+ * Lists all disk checkpoints for a sandbox.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID
+ * @throws {SandboxResponseError} If the sandbox is not found or listing fails
+ */
+export async function diskCheckpointList(client, params) {
+    const { sandboxId, orgId } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/checkpoints/${encodeURIComponent(sandboxId)}${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.get(url, ListDiskCheckpointsResponseSchema);
+    if (resp.success) {
+        return resp.data.checkpoints;
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+/**
+ * Restores a sandbox to a specific disk checkpoint.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID and checkpoint ID
+ * @throws {SandboxResponseError} If the sandbox or checkpoint is not found, or restore fails
+ */
+export async function diskCheckpointRestore(client, params) {
+    const { sandboxId, checkpointId, orgId } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/${encodeURIComponent(sandboxId)}/checkpoint/${encodeURIComponent(checkpointId)}/restore${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.post(url, undefined, RestoreDiskCheckpointResponseSchema);
+    if (resp.success) {
+        return;
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+/**
+ * Deletes a disk checkpoint from a sandbox.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID and checkpoint ID
+ * @throws {SandboxResponseError} If the sandbox or checkpoint is not found, or deletion fails
+ */
+export async function diskCheckpointDelete(client, params) {
+    const { sandboxId, checkpointId, orgId } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/${encodeURIComponent(sandboxId)}/checkpoint/${encodeURIComponent(checkpointId)}${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.delete(url, DeleteDiskCheckpointResponseSchema);
+    if (resp.success) {
+        return;
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+//# sourceMappingURL=disk-checkpoint.js.map

package/dist/disk-checkpoint.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { type APIClient } from '@agentuity/api';
+export declare const SandboxEventInfoSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    sandboxId: z.ZodString;
+    type: z.ZodString;
+    event: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const SandboxEventListDataSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        eventId: z.ZodString;
+        sandboxId: z.ZodString;
+        type: z.ZodString;
+        event: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SandboxEventListResponseSchema: 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<{
+        events: z.ZodArray<z.ZodObject<{
+            eventId: z.ZodString;
+            sandboxId: z.ZodString;
+            type: z.ZodString;
+            event: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export type SandboxEventInfo = z.infer<typeof SandboxEventInfoSchema>;
+export declare const SandboxEventListParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, z.core.$strip>;
+export type SandboxEventListParams = z.infer<typeof SandboxEventListParamsSchema>;
+export type SandboxEventListResponse = z.infer<typeof SandboxEventListDataSchema>;
+/**
+ * Lists all events for a specific sandbox, ordered by creation time (oldest first by default).
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID, optional limit, and sort direction
+ * @returns List of event information for the sandbox
+ * @throws {SandboxResponseError} If the sandbox is not found or request fails
+ */
+export declare function sandboxEventList(client: APIClient, params: SandboxEventListParams): Promise<SandboxEventListResponse>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,gBAAgB,CAAC;AAInE,eAAO,MAAM,sBAAsB;;;;;;iBAQY,CAAC;AAEhD,eAAO,MAAM,0BAA0B;;;;;;;;iBAIG,CAAC;AAE3C,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;8BAAgD,CAAC;AAE5F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,4BAA4B;;;;;;;;iBAKvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAElF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,sBAAsB,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAyBnC"}

package/dist/events.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { APIResponseSchema } from '@agentuity/api';
+import { SortDirectionSchema } from '@agentuity/client';
+import { throwSandboxError } from './util.js';
+export const SandboxEventInfoSchema = z
+    .object({
+    eventId: z.string().describe('Unique identifier for the event'),
+    sandboxId: z.string().describe('ID of the sandbox this event belongs to'),
+    type: z.string().describe('Type of event (e.g., create, destroy, lifecycle:started)'),
+    event: z.record(z.string(), z.unknown()).describe('Event data payload'),
+    createdAt: z.string().describe('ISO timestamp when the event was recorded'),
+})
+    .describe('Information about a sandbox event');
+export const SandboxEventListDataSchema = z
+    .object({
+    events: z.array(SandboxEventInfoSchema).describe('List of sandbox events'),
+})
+    .describe('List of events for a sandbox');
+export const SandboxEventListResponseSchema = APIResponseSchema(SandboxEventListDataSchema);
+export const SandboxEventListParamsSchema = z.object({
+    sandboxId: z.string().describe('sandbox id'),
+    orgId: z.string().optional().describe('organization id'),
+    limit: z.number().optional().describe('limit'),
+    direction: SortDirectionSchema.optional().describe('sort direction (default: asc)'),
+});
+/**
+ * Lists all events for a specific sandbox, ordered by creation time (oldest first by default).
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID, optional limit, and sort direction
+ * @returns List of event information for the sandbox
+ * @throws {SandboxResponseError} If the sandbox is not found or request fails
+ */
+export async function sandboxEventList(client, params) {
+    const { sandboxId, orgId, limit, direction } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    if (limit !== undefined) {
+        queryParams.set('limit', String(limit));
+    }
+    if (direction) {
+        queryParams.set('direction', direction);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/sandboxes/${sandboxId}/events${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.get(url, SandboxEventListResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/execute.d.ts

@@ -0,0 +1,99 @@
+import type { Execution } from './types.ts';
+import { z } from 'zod';
+import type { APIClient } from '@agentuity/api';
+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<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        timeout: "timeout";
+    }>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+    stderrStreamUrl: z.ZodOptional<z.ZodString>;
+    outputTruncated: z.ZodOptional<z.ZodBoolean>;
+}, 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<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            timeout: "timeout";
+        }>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        stdoutStreamUrl: z.ZodOptional<z.ZodString>;
+        stderrStreamUrl: z.ZodOptional<z.ZodString>;
+        outputTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    autoResumed: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>], "success">;
+export declare const SandboxExecuteParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    options: z.ZodCustom<{
+        command: string[];
+        files?: {
+            path: string;
+            content: Uint8Array<ArrayBuffer>;
+        }[] | undefined;
+        timeout?: string | undefined;
+        stream?: {
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+            timestamps?: boolean | undefined;
+        } | undefined;
+        signal?: AbortSignal | undefined;
+    }, {
+        command: string[];
+        files?: {
+            path: string;
+            content: Uint8Array<ArrayBuffer>;
+        }[] | undefined;
+        timeout?: string | undefined;
+        stream?: {
+            stdout?: string | undefined;
+            stderr?: string | undefined;
+            timestamps?: boolean | undefined;
+        } | undefined;
+        signal?: AbortSignal | undefined;
+    }>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type SandboxExecuteParams = z.infer<typeof SandboxExecuteParamsSchema>;
+/**
+ * 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/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,SAAS,EAAmB,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAsB8B,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;iBAeoB,CAAC;AAEnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;8BAYhC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,SAAS,CAAC,CAqFpB"}

package/dist/execute.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { SandboxBusyError, SandboxNotFoundError, throwSandboxError } from './util.js';
+import { base64Encode } from './base64.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'),
+    outputTruncated: z
+        .boolean()
+        .optional()
+        .describe('Whether the captured output was truncated due to size limits'),
+})
+    .describe('Response data from command execution');
+export const ExecuteResponseSchema = z.discriminatedUnion('success', [
+    z.object({
+        success: z.literal(false),
+        message: z.string(),
+        code: z.string().optional(),
+    }),
+    z.object({
+        success: z.literal(true),
+        data: ExecuteDataSchema,
+        /** True if the sandbox was automatically resumed from a suspended state */
+        autoResumed: z.boolean().optional(),
+    }),
+]);
+export const SandboxExecuteParamsSchema = z.object({
+    sandboxId: z.string().describe('Sandbox ID where command should execute'),
+    options: z.custom().describe('Command execution options'),
+    orgId: z.string().optional().describe('Optional org id for CLI auth context'),
+    signal: z.custom().optional().describe('Optional abort signal for cancellation'),
+});
+/**
+ * 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: base64Encode(f.content),
+        }));
+    }
+    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) {
+        if (error &&
+            typeof error === 'object' &&
+            '_tag' in error &&
+            error._tag === 'APIErrorResponse' &&
+            'status' in error) {
+            const status = error.status;
+            // Detect 404 Not Found — sandbox may not exist or may still be initializing.
+            // The server normally handles the creating→idle wait transparently, but this
+            // provides a clear typed error if a 404 reaches the SDK for any reason.
+            if (status === 404) {
+                throw new SandboxNotFoundError({
+                    message: 'Sandbox not found. If you just created this sandbox, it may still be initializing. The server should handle this automatically — if this persists, the sandbox may have been destroyed.',
+                    sandboxId,
+                });
+            }
+            // 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 (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,
+            outputTruncated: resp.data.outputTruncated,
+            autoResumed: resp.autoResumed,
+        };
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

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

package/dist/execution.d.ts

@@ -0,0 +1,150 @@
+import { z } from 'zod';
+import { type APIClient } from '@agentuity/api';
+export declare const ExecutionInfoSchema: z.ZodObject<{
+    executionId: z.ZodString;
+    sandboxId: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        timeout: "timeout";
+    }>;
+    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>;
+    outputTruncated: z.ZodOptional<z.ZodBoolean>;
+}, 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<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            timeout: "timeout";
+        }>;
+        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>;
+        outputTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, 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<{
+            cancelled: "cancelled";
+            completed: "completed";
+            failed: "failed";
+            queued: "queued";
+            running: "running";
+            timeout: "timeout";
+        }>;
+        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>;
+        outputTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, 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<{
+                cancelled: "cancelled";
+                completed: "completed";
+                failed: "failed";
+                queued: "queued";
+                running: "running";
+                timeout: "timeout";
+            }>;
+            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>;
+            outputTruncated: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export type ExecutionInfo = z.infer<typeof ExecutionInfoSchema>;
+export declare const ExecutionGetParamsSchema: z.ZodObject<{
+    executionId: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+    wait: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type ExecutionGetParams = z.infer<typeof ExecutionGetParamsSchema>;
+/**
+ * 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 declare const ExecutionListParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ExecutionListParams = z.infer<typeof ExecutionListParamsSchema>;
+export type ExecutionListResponse = z.infer<typeof ExecutionListDataSchema>;
+/**
+ * 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/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,gBAAgB,CAAC;AAGnE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;iBAsB4B,CAAC;AAE7D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAAyC,CAAC;AAEjF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;iBAIU,CAAC;AAE/C,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAA6C,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;iBAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAED,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAsBhC"}