@agentuity/sandbox 3.0.12 → 3.1.1

package/dist/execution.js

@@ -0,0 +1,120 @@
+import { ExecutionStatusSchema } from './types.js';
+import { z } from 'zod';
+import { APIResponseSchema } from '@agentuity/api';
+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: ExecutionStatusSchema.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'),
+    outputTruncated: z
+        .boolean()
+        .optional()
+        .describe('Whether the captured output was truncated due to size limits'),
+})
+    .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);
+export const ExecutionGetParamsSchema = z.object({
+    executionId: z.string().describe('execution id'),
+    orgId: z.string().optional().describe('organization id'),
+    /** Optional wait duration for long-polling. */
+    wait: z.string().optional().describe('wait duration for long-polling'),
+    /** Optional AbortSignal to cancel the in-flight request. */
+    signal: z.custom().optional().describe('abort signal for cancellation'),
+});
+/**
+ * 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, signal } = 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, signal);
+    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,
+            outputTruncated: resp.data.outputTruncated,
+        };
+    }
+    throwSandboxError(resp, { executionId });
+}
+export const ExecutionListParamsSchema = z.object({
+    sandboxId: z.string().describe('sandbox id'),
+    orgId: z.string().optional().describe('organization id'),
+    limit: z.number().optional().describe('limit'),
+});
+/**
+ * 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 resp.data;
+    }
+    throwSandboxError(resp, { sandboxId });
+}
+//# sourceMappingURL=execution.js.map

package/dist/execution.js.map

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

package/dist/files.d.ts

@@ -0,0 +1,283 @@
+import { z } from 'zod';
+import { APIClient } from '@agentuity/api';
+export declare const FileToWriteSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export declare const WriteFilesRequestSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const WriteFilesDataSchema: z.ZodObject<{
+    filesWritten: z.ZodNumber;
+}, z.core.$strip>;
+export declare const WriteFilesResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodOptional<z.ZodObject<{
+        filesWritten: z.ZodNumber;
+    }, z.core.$strip>>;
+    filesWritten: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "success">;
+export declare const WriteFilesParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    files: z.ZodArray<z.ZodCustom<{
+        path: string;
+        content: Uint8Array<ArrayBuffer>;
+    }, {
+        path: string;
+        content: Uint8Array<ArrayBuffer>;
+    }>>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type WriteFilesParams = z.infer<typeof WriteFilesParamsSchema>;
+export type WriteFilesResult = z.infer<typeof WriteFilesDataSchema>;
+/**
+ * Writes files to a sandbox workspace.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and files to write
+ * @returns The result including number of files written
+ * @throws {SandboxResponseError} If the write request fails
+ */
+export declare function sandboxWriteFiles(client: APIClient, params: WriteFilesParams): Promise<WriteFilesResult>;
+export declare const ReadFileParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    path: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type ReadFileParams = z.infer<typeof ReadFileParamsSchema>;
+/**
+ * Reads a file from a sandbox workspace.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and file path
+ * @returns A ReadableStream of the file contents
+ * @throws {SandboxResponseError} If the read request fails
+ */
+export declare function sandboxReadFile(client: APIClient, params: ReadFileParams): Promise<ReadableStream<Uint8Array>>;
+export declare const MkDirRequestSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const MkDirResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>], "success">;
+export declare const MkDirParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    path: z.ZodString;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type MkDirParams = z.infer<typeof MkDirParamsSchema>;
+/**
+ * Creates a directory in a sandbox workspace.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID, path, and recursive flag
+ * @throws {SandboxResponseError} If the mkdir request fails
+ */
+export declare function sandboxMkDir(client: APIClient, params: MkDirParams): Promise<void>;
+export declare const RmDirRequestSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const RmDirResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    found: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>], "success">;
+export declare const RmDirParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    path: z.ZodString;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type RmDirParams = z.infer<typeof RmDirParamsSchema>;
+/**
+ * Removes a directory from a sandbox workspace.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID, path, and recursive flag
+ * @returns Object with `found` indicating whether the directory existed before removal
+ * @throws {SandboxResponseError} If the rmdir request fails
+ */
+export declare function sandboxRmDir(client: APIClient, params: RmDirParams): Promise<{
+    found: boolean;
+}>;
+export declare const RmFileRequestSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export declare const RmFileResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    found: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>], "success">;
+export declare const RmFileParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    path: z.ZodString;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type RmFileParams = z.infer<typeof RmFileParamsSchema>;
+/**
+ * Removes a file from a sandbox workspace.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and path
+ * @returns Object with `found` indicating whether the file existed before removal
+ * @throws {SandboxResponseError} If the rm request fails
+ */
+export declare function sandboxRmFile(client: APIClient, params: RmFileParams): Promise<{
+    found: boolean;
+}>;
+export declare const FileInfoSchema: z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+    isDir: z.ZodBoolean;
+    isSymlink: z.ZodOptional<z.ZodBoolean>;
+    linkTarget: z.ZodOptional<z.ZodString>;
+    mode: z.ZodString;
+    modTime: z.ZodString;
+}, z.core.$strip>;
+export declare const ListFilesDataSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+        isDir: z.ZodBoolean;
+        isSymlink: z.ZodOptional<z.ZodBoolean>;
+        linkTarget: z.ZodOptional<z.ZodString>;
+        mode: z.ZodString;
+        modTime: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ListFilesResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            size: z.ZodNumber;
+            isDir: z.ZodBoolean;
+            isSymlink: z.ZodOptional<z.ZodBoolean>;
+            linkTarget: z.ZodOptional<z.ZodString>;
+            mode: z.ZodString;
+            modTime: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export type FileInfo = z.infer<typeof FileInfoSchema>;
+export declare const ListFilesParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type ListFilesParams = z.infer<typeof ListFilesParamsSchema>;
+export type ListFilesResult = z.infer<typeof ListFilesDataSchema>;
+/**
+ * Lists files in a sandbox workspace directory.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and optional path
+ * @returns The list of files and directories
+ * @throws {SandboxResponseError} If the list request fails
+ */
+export declare function sandboxListFiles(client: APIClient, params: ListFilesParams): Promise<ListFilesResult>;
+export type ArchiveFormat = 'zip' | 'tar.gz';
+export declare const DownloadArchiveParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        "tar.gz": "tar.gz";
+        zip: "zip";
+    }>>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type DownloadArchiveParams = z.infer<typeof DownloadArchiveParamsSchema>;
+/**
+ * Downloads files from a sandbox as a compressed archive.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID, path, and format
+ * @returns A ReadableStream of the archive contents
+ * @throws {SandboxResponseError} If the download request fails
+ */
+export declare function sandboxDownloadArchive(client: APIClient, params: DownloadArchiveParams): Promise<ReadableStream<Uint8Array>>;
+export declare const UploadArchiveParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    archive: z.ZodUnion<readonly [z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodCustom<ArrayBuffer, ArrayBuffer>, z.ZodCustom<ReadableStream<Uint8Array<ArrayBufferLike>>, ReadableStream<Uint8Array<ArrayBufferLike>>>]>;
+    path: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        "tar.gz": "tar.gz";
+        zip: "zip";
+    }>, z.ZodLiteral<"">]>>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type UploadArchiveParams = z.infer<typeof UploadArchiveParamsSchema>;
+export declare const UploadArchiveResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>], "success">;
+/**
+ * Uploads a compressed archive to a sandbox and extracts it.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID, archive data, path, and optional format
+ * @throws {SandboxResponseError} If the upload request fails
+ */
+export declare function sandboxUploadArchive(client: APIClient, params: UploadArchiveParams): Promise<void>;
+export declare const SetEnvRequestSchema: z.ZodObject<{
+    env: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const SetEnvDataSchema: z.ZodObject<{
+    env: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export declare const SetEnvResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        env: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const SetEnvParamsSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    env: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>;
+    orgId: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strip>;
+export type SetEnvParams = z.infer<typeof SetEnvParamsSchema>;
+export type SetEnvResult = z.infer<typeof SetEnvDataSchema>;
+/**
+ * Sets environment variables on a sandbox. Pass null to delete a variable.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including sandbox ID and env key/value pairs
+ * @returns The current environment variables after the update
+ * @throws {SandboxResponseError} If the request fails
+ */
+export declare function sandboxSetEnv(client: APIClient, params: SetEnvParams): Promise<SetEnvResult>;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK3C,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;iBAIqB,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;iBAIa,CAAC;AAE/C,eAAO,MAAM,wBAAwB;;;;;;;;;8BAUnC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAgC3B;AAED,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAgCrC;AAED,eAAO,MAAM,kBAAkB;;;iBAKoB,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;;8BAQ9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BxF;AAED,eAAO,MAAM,kBAAkB;;;iBAKoB,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;;;8BAe9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA4B7B;AAED,eAAO,MAAM,mBAAmB;;iBAIc,CAAC;AAE/C,eAAO,MAAM,oBAAoB;;;;;;8BAe/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA2B7B;AAED,eAAO,MAAM,cAAc;;;;;;;;iBAQzB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAE9B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;8BASlC,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,GACrB,OAAO,CAAC,eAAe,CAAC,CA0B1B;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7C,eAAO,MAAM,2BAA2B;;;;;;;;;iBAMtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAqCrC;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAgBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;;;8BAQtC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,mBAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED,eAAO,MAAM,mBAAmB;;iBAI9B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;8BAS/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,YAAY,CAAC,CA2BvB"}