@agentuity/sandbox 3.0.12 → 3.1.1

package/dist/resolve.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { type APIClient } from '@agentuity/api';
+/**
+ * Data schema for sandbox resolve endpoint
+ */
+export declare const SandboxResolveDataSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    region: z.ZodString;
+    status: z.ZodString;
+    orgId: z.ZodString;
+    projectId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Response schema for sandbox resolve endpoint using standardized discriminated union
+ */
+export declare const SandboxResolveResponseSchema: 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.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        region: z.ZodString;
+        status: z.ZodString;
+        orgId: z.ZodString;
+        projectId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "success">;
+/**
+ * Resolved sandbox info returned from the CLI API
+ */
+export type ResolvedSandboxInfo = z.infer<typeof SandboxResolveDataSchema>;
+/**
+ * Error thrown when sandbox resolution fails.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await sandboxResolve(client, 'sbx_123');
+ * } catch (error) {
+ *   if (error._tag === 'SandboxResolveError') {
+ *     console.error(`Sandbox not found: ${error.sandboxId}`);
+ *   }
+ * }
+ * ```
+ */
+export declare const SandboxResolveError: {
+    new (args?: ({
+        sandboxId?: string;
+        statusCode?: number;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("@agentuity/adapter").RichError & {
+        readonly _tag: "SandboxResolveError";
+    } & Readonly<{
+        sandboxId?: string;
+        statusCode?: number;
+    }>;
+    readonly defaultMessage?: string;
+};
+/**
+ * Resolve a sandbox by ID across all organizations the user has access to.
+ * Uses the CLI API endpoint which searches across all user's orgs.
+ *
+ * @param client - API client configured for CLI endpoints
+ * @param sandboxId - The sandbox ID to resolve
+ * @returns Resolved sandbox info including region and orgId
+ * @throws {SandboxResolveError} If sandbox not found or request fails
+ */
+export declare function sandboxResolve(client: APIClient, sandboxId: string): Promise<ResolvedSandboxInfo>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAiC,MAAM,gBAAgB,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;iBAYqC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;8BAA0D,CAAC;AAEpG;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB;;oBACnB,MAAM;qBACL,MAAM;;;;;;;;;;;CAChB,CAAC;AAEL;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAiC9B"}

package/dist/resolve.js

@@ -0,0 +1,76 @@
+import { StructuredError } from '@agentuity/core';
+import { z } from 'zod';
+import { APIResponseSchemaOptionalData } from '@agentuity/api';
+/**
+ * Data schema for sandbox resolve endpoint
+ */
+export const SandboxResolveDataSchema = z
+    .object({
+    id: z.string().describe('Unique identifier for the sandbox.'),
+    name: z.string().nullable().describe('Sandbox name, or null if unnamed.'),
+    region: z.string().describe('Cloud region where the sandbox is running.'),
+    status: z.string().describe('Current status of the sandbox.'),
+    orgId: z.string().describe('Organization ID that owns the sandbox.'),
+    projectId: z
+        .string()
+        .nullable()
+        .describe('Project ID the sandbox belongs to, or null if unassigned.'),
+})
+    .describe('Resolved sandbox information from cross-organization lookup.');
+/**
+ * Response schema for sandbox resolve endpoint using standardized discriminated union
+ */
+export const SandboxResolveResponseSchema = APIResponseSchemaOptionalData(SandboxResolveDataSchema);
+/**
+ * Error thrown when sandbox resolution fails.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await sandboxResolve(client, 'sbx_123');
+ * } catch (error) {
+ *   if (error._tag === 'SandboxResolveError') {
+ *     console.error(`Sandbox not found: ${error.sandboxId}`);
+ *   }
+ * }
+ * ```
+ */
+export const SandboxResolveError = StructuredError('SandboxResolveError')();
+/**
+ * Resolve a sandbox by ID across all organizations the user has access to.
+ * Uses the CLI API endpoint which searches across all user's orgs.
+ *
+ * @param client - API client configured for CLI endpoints
+ * @param sandboxId - The sandbox ID to resolve
+ * @returns Resolved sandbox info including region and orgId
+ * @throws {SandboxResolveError} If sandbox not found or request fails
+ */
+export async function sandboxResolve(client, sandboxId) {
+    const response = await client.get(`/cli/sandbox/${sandboxId}`, SandboxResolveResponseSchema);
+    if (!response.success) {
+        // Extract status code from error code if present (e.g., "NOT_FOUND" -> 404)
+        // Fall back to 404 if no code is provided
+        const statusCode = response.code === 'NOT_FOUND' ? 404 : response.code ? 400 : 404;
+        throw new SandboxResolveError({
+            message: response.message || 'Sandbox not found',
+            sandboxId,
+            statusCode,
+        });
+    }
+    if (!response.data) {
+        throw new SandboxResolveError({
+            message: 'Sandbox not found',
+            sandboxId,
+            statusCode: 404,
+        });
+    }
+    return {
+        id: response.data.id,
+        name: response.data.name,
+        region: response.data.region,
+        status: response.data.status,
+        orgId: response.data.orgId,
+        projectId: response.data.projectId,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACvC,MAAM,CAAC;IACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACzE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACzE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACpE,SAAS,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;CACvE,CAAC;KACD,QAAQ,CAAC,8DAA8D,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;AAOpG;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC,qBAAqB,CAAC,EAGrE,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAiB,EACjB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAChC,gBAAgB,SAAS,EAAE,EAC3B,4BAA4B,CAC5B,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACvB,4EAA4E;QAC5E,0CAA0C;QAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACnF,MAAM,IAAI,mBAAmB,CAAC;YAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,mBAAmB;YAChD,SAAS;YACT,UAAU;SACV,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,mBAAmB,CAAC;YAC7B,OAAO,EAAE,mBAAmB;YAC5B,SAAS;YACT,UAAU,EAAE,GAAG;SACf,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;QACpB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI;QACxB,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QAC5B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QAC5B,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK;QAC1B,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;KAClC,CAAC;AACH,CAAC"}

package/dist/resume.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { type APIClient } from '@agentuity/api';
+export declare const ResumeResponseSchema: 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>;
+}, z.core.$strip>], "success">;
+export declare const SandboxResumeParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SandboxResumeParams = z.infer<typeof SandboxResumeParamsSchema>;
+/**
+ * Resumes a paused sandbox from its checkpoint.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID to resume
+ * @throws {SandboxResponseError} If the sandbox is not found or resume fails
+ */
+export declare function sandboxResume(client: APIClient, params: SandboxResumeParams): Promise<void>;
+//# sourceMappingURL=resume.d.ts.map

package/dist/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../src/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAA2B,MAAM,gBAAgB,CAAC;AAGzE,eAAO,MAAM,oBAAoB;;;;;;8BAA4B,CAAC;AAE9D,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBjG"}

package/dist/resume.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { APIResponseSchemaNoData } from '@agentuity/api';
+import { throwSandboxError } from './util.js';
+export const ResumeResponseSchema = APIResponseSchemaNoData();
+export const SandboxResumeParamsSchema = z.object({
+    sandboxId: z.string().describe('Sandbox ID to resume'),
+    orgId: z.string().optional().describe('Optional org id for CLI auth context'),
+});
+/**
+ * Resumes a paused sandbox from its checkpoint.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID to resume
+ * @throws {SandboxResponseError} If the sandbox is not found or resume fails
+ */
+export async function sandboxResume(client, params) {
+    const { sandboxId, orgId } = params;
+    const queryParams = new URLSearchParams();
+    if (orgId) {
+        queryParams.set('orgId', orgId);
+    }
+    const queryString = queryParams.toString();
+    const url = `/sandbox/${encodeURIComponent(sandboxId)}/resume${queryString ? `?${queryString}` : ''}`;
+    const resp = await client.post(url, undefined, ResumeResponseSchema);
+    if (resp.success) {
+        return;
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+//# sourceMappingURL=resume.js.map

package/dist/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../src/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,EAAE,CAAC;AAE9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAC7E,CAAC,CAAC;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAiB,EAAE,MAA2B;IACjF,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,kBAAkB,CAAC,SAAS,CAAC,UAAU,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAEtG,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC7B,GAAG,EACH,SAAS,EACT,oBAAoB,CACpB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;IACR,CAAC;IAED,iBAAiB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,73 @@
+import type { Logger } from '@agentuity/client';
+import type { Readable, Writable } from 'node:stream';
+import { z } from 'zod';
+import { APIClient } from '@agentuity/api';
+import { type SandboxRunResult } from './types.ts';
+export declare const SandboxRunParamsSchema: z.ZodObject<{
+    options: z.ZodObject<{
+        projectId: z.ZodOptional<z.ZodString>;
+        runtime: z.ZodOptional<z.ZodString>;
+        runtimeId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        resources: z.ZodOptional<z.ZodObject<{
+            memory: z.ZodOptional<z.ZodString>;
+            cpu: z.ZodOptional<z.ZodString>;
+            disk: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        network: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            port: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        stream: z.ZodOptional<z.ZodObject<{
+            stdout: z.ZodOptional<z.ZodString>;
+            stderr: z.ZodOptional<z.ZodString>;
+            stdin: z.ZodOptional<z.ZodString>;
+            timestamps: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        timeout: z.ZodOptional<z.ZodObject<{
+            idle: z.ZodOptional<z.ZodString>;
+            execution: z.ZodOptional<z.ZodString>;
+            paused: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        }, z.core.$strip>>>;
+        snapshot: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        command: z.ZodObject<{
+            exec: z.ZodArray<z.ZodString>;
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                content: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    orgId: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+    stdin: z.ZodOptional<z.ZodCustom<Readable, Readable>>;
+    stdout: z.ZodOptional<z.ZodCustom<Writable, Writable>>;
+    stderr: z.ZodOptional<z.ZodCustom<Writable, Writable>>;
+    logger: z.ZodOptional<z.ZodCustom<Logger, Logger>>;
+}, z.core.$strip>;
+export type SandboxRunParams = z.infer<typeof SandboxRunParamsSchema>;
+/**
+ * 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 declare function sandboxRun(client: APIClient, params: SandboxRunParams): Promise<SandboxRunResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAwB,MAAM,gBAAgB,CAAC;AAMjE,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkC5E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAgT3B"}