@computesdk/archil 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# @computesdk/archil
+
+[Archil](https://archil.com) provider for [ComputeSDK](https://www.computesdk.com).
+
+`create` provisions a new Archil disk (no mounts — archil-managed storage)
+and `runCommand` executes shell commands in a managed container with that
+disk attached via the control-plane `exec` endpoint. `destroy` deletes the
+disk. `getById` accepts either a disk id or a disk name.
+
+## Install
+
+```bash
+npm install @computesdk/archil
+```
+
+The provider talks to the Archil control plane directly over HTTP — no
+additional Archil SDK is required.
+
+## Configuration
+
+| Option    | Env var            | Required | Description                                |
+| --------- | ------------------ | -------- | ------------------------------------------ |
+| `apiKey`  | `ARCHIL_API_KEY`   | yes      | Archil control-plane API key               |
+| `region`  | `ARCHIL_REGION`    | yes      | Archil region (e.g. `aws-us-east-1`)       |
+| `baseUrl` | —                  | no       | Override control-plane URL (for testing)   |
+
+## Usage
+
+```ts
+import { archil } from '@computesdk/archil';
+
+const provider = archil();
+
+// Create a fresh disk. Pass a name to control it; omit for auto-generated.
+const { sandbox } = await provider.sandbox.create({ name: 'my-workspace' });
+
+const result = await provider.sandbox.runCommand(sandbox, 'echo hello > /mnt/note && cat /mnt/note');
+console.log(result.stdout); // "hello"
+
+// Look up later by name or by id:
+const byName = await provider.sandbox.getById('my-workspace');
+const byId = await provider.sandbox.getById(sandbox.sandboxId);
+
+await provider.sandbox.destroy(sandbox.sandboxId);
+```
+
+Disk names must match `^[a-zA-Z0-9_-]+$` and be 1–100 characters.
+
+## Supported operations
+
+| Method        | Supported | Notes                                                       |
+| ------------- | --------- | ----------------------------------------------------------- |
+| `create`      | ✅        | Creates a new disk with archil-managed storage (no mounts). |
+| `getById`     | ✅        | Accepts either the disk id or the disk name.                |
+| `list`        | ✅        | Lists all disks visible to the API key.                     |
+| `destroy`     | ✅        | Deletes the disk.                                           |
+| `runCommand`  | ✅        | Calls Archil's HTTP `exec` endpoint and waits for completion. |
+| `runCode`     | ✅        | Wraps code in `node -e` or `python3 -c`. Requires explicit `runtime`. |
+| `getInfo`     | ✅        |                                                             |
+| `getUrl`      | ❌        | Each exec runs in a fresh ephemeral container — no port to expose. |
+| `filesystem`  | ✅        | Implemented via shell commands (`cat`, `find`, `mkdir`, etc.). |
+
+## Limitations
+
+- Each `exec` call provisions a fresh container — there is no persistent
+  state between calls beyond what is written to the disk.
+- Responses are truncated to ~5 MB by the Archil control plane.
+- `getUrl` is not supported — each exec runs in a fresh ephemeral container,
+  so there is no long-lived process to expose a port on.
+- Filesystem operations are implemented as shell commands, so each call
+  costs one HTTP round trip.

package/dist/index.d.mts

@@ -0,0 +1,40 @@
+import * as _computesdk_provider from '@computesdk/provider';
+
+/**
+ * Archil Provider
+ *
+ * Executes commands against an Archil disk via the Archil control-plane HTTP
+ * API. Archil is exec-only — each command runs in an Archil-managed container
+ * with the configured disk mounted, then returns stdout, stderr, and exit code.
+ * There is no sandbox lifecycle to manage; "create" just resolves a handle to
+ * the target disk.
+ */
+interface ArchilConfig {
+    /** Archil API key. Falls back to ARCHIL_API_KEY env var. */
+    apiKey?: string;
+    /** Archil region (e.g. "aws-us-east-1"). Falls back to ARCHIL_REGION env var. */
+    region?: string;
+    /** Override the control-plane base URL (useful for testing). */
+    baseUrl?: string;
+}
+interface DiskResponse {
+    id: string;
+    name: string;
+    organization: string;
+    status: string;
+    provider: string;
+    region: string;
+    createdAt: string;
+}
+interface ResolvedConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+interface ArchilSandbox {
+    disk: DiskResponse;
+    resolved: ResolvedConfig;
+    createdAt: Date;
+}
+declare const archil: (config?: ArchilConfig) => _computesdk_provider.Provider<ArchilSandbox, any, any>;
+
+export { type ArchilConfig, type ArchilSandbox, archil };

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import * as _computesdk_provider from '@computesdk/provider';
+
+/**
+ * Archil Provider
+ *
+ * Executes commands against an Archil disk via the Archil control-plane HTTP
+ * API. Archil is exec-only — each command runs in an Archil-managed container
+ * with the configured disk mounted, then returns stdout, stderr, and exit code.
+ * There is no sandbox lifecycle to manage; "create" just resolves a handle to
+ * the target disk.
+ */
+interface ArchilConfig {
+    /** Archil API key. Falls back to ARCHIL_API_KEY env var. */
+    apiKey?: string;
+    /** Archil region (e.g. "aws-us-east-1"). Falls back to ARCHIL_REGION env var. */
+    region?: string;
+    /** Override the control-plane base URL (useful for testing). */
+    baseUrl?: string;
+}
+interface DiskResponse {
+    id: string;
+    name: string;
+    organization: string;
+    status: string;
+    provider: string;
+    region: string;
+    createdAt: string;
+}
+interface ResolvedConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+interface ArchilSandbox {
+    disk: DiskResponse;
+    resolved: ResolvedConfig;
+    createdAt: Date;
+}
+declare const archil: (config?: ArchilConfig) => _computesdk_provider.Provider<ArchilSandbox, any, any>;
+
+export { type ArchilConfig, type ArchilSandbox, archil };

package/dist/index.js

@@ -0,0 +1,324 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  archil: () => archil
+});
+module.exports = __toCommonJS(index_exports);
+var import_provider = require("@computesdk/provider");
+var REGION_COLORS = {
+  "gcp-us-central1": "blue"
+};
+function regionToBaseUrl(region) {
+  const dash = region.indexOf("-");
+  if (dash <= 0 || dash === region.length - 1) {
+    throw new Error(
+      `Invalid Archil region "${region}". Expected "{cloud}-{suffix}", e.g. "aws-us-east-1".`
+    );
+  }
+  const cloud = region.slice(0, dash);
+  const suffix = region.slice(dash + 1);
+  const color = REGION_COLORS[region] ?? "green";
+  return `https://control.${color}.${suffix}.${cloud}.prod.archil.com`;
+}
+function resolveConfig(config) {
+  const apiKey = config.apiKey ?? process.env.ARCHIL_API_KEY;
+  const region = config.region ?? process.env.ARCHIL_REGION;
+  if (!apiKey) {
+    throw new Error(
+      'Missing API key for Archil.\n\nPass it: archil({ apiKey: "..." })\nOr set ARCHIL_API_KEY in your environment.'
+    );
+  }
+  let baseUrl = config.baseUrl;
+  if (!baseUrl) {
+    if (!region) {
+      throw new Error(
+        'Missing region for Archil.\n\nPass it: archil({ region: "..." })\nOr set ARCHIL_REGION in your environment.\nExamples: "aws-us-east-1", "aws-eu-west-1", "gcp-us-central1".'
+      );
+    }
+    baseUrl = regionToBaseUrl(region);
+  }
+  return { apiKey, baseUrl };
+}
+function authHeader(apiKey) {
+  return `key-${apiKey.replace(/^key-/, "")}`;
+}
+async function callApi(resolved, method, path, body) {
+  const response = await fetch(`${resolved.baseUrl}${path}`, {
+    method,
+    headers: {
+      Authorization: authHeader(resolved.apiKey),
+      ...body ? { "Content-Type": "application/json" } : {}
+    },
+    body: body ? JSON.stringify(body) : void 0
+  });
+  let payload = null;
+  try {
+    payload = await response.json();
+  } catch {
+    payload = null;
+  }
+  if (!response.ok || !payload || payload.success === false) {
+    const message = payload && payload.error || `Archil API ${method} ${path} failed with status ${response.status}`;
+    throw new Error(message);
+  }
+  return payload.data;
+}
+function generateDiskName() {
+  const random = Math.random().toString(36).slice(2, 10);
+  return `computesdk-${Date.now()}-${random}`;
+}
+async function lookupDiskByName(resolved, name) {
+  const disks = await callApi(resolved, "GET", "/api/disks");
+  return disks.find((d) => d.name === name) ?? null;
+}
+function shellEscape(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function wrapCommand(command, options) {
+  let wrapped = command;
+  const envEntries = Object.entries(options?.env ?? {});
+  if (!envEntries.some(([key]) => key === "HOME")) {
+    envEntries.unshift(["HOME", process.env.HOME || "/tmp"]);
+  }
+  const envPrefix = envEntries.map(([k, v]) => `${k}=${shellEscape(String(v))}`).join(" ");
+  wrapped = `${envPrefix} ${wrapped}`;
+  if (options?.cwd) {
+    wrapped = `cd ${shellEscape(options.cwd)} && ${wrapped}`;
+  }
+  if (options?.background) {
+    wrapped = `nohup sh -c ${shellEscape(wrapped)} > /dev/null 2>&1 &`;
+  }
+  return wrapped;
+}
+async function execOnDisk(sandbox, command) {
+  return callApi(
+    sandbox.resolved,
+    "POST",
+    `/api/disks/${encodeURIComponent(sandbox.disk.id)}/exec`,
+    { command }
+  );
+}
+var _provider = (0, import_provider.defineProvider)({
+  name: "archil",
+  methods: {
+    sandbox: {
+      create: async (config, options) => {
+        const resolved = resolveConfig(config);
+        const name = (options?.name ?? generateDiskName()).trim();
+        const created = await callApi(
+          resolved,
+          "POST",
+          "/api/disks",
+          { name }
+        );
+        const disk = await callApi(
+          resolved,
+          "GET",
+          `/api/disks/${encodeURIComponent(created.diskId)}`
+        );
+        return {
+          sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+          sandboxId: disk.id
+        };
+      },
+      getById: async (config, sandboxId) => {
+        const resolved = resolveConfig(config);
+        try {
+          const disk = await callApi(
+            resolved,
+            "GET",
+            `/api/disks/${encodeURIComponent(sandboxId)}`
+          );
+          return {
+            sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+            sandboxId: disk.id
+          };
+        } catch {
+        }
+        try {
+          const disk = await lookupDiskByName(resolved, sandboxId);
+          if (!disk) return null;
+          return {
+            sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+            sandboxId: disk.id
+          };
+        } catch {
+          return null;
+        }
+      },
+      list: async (config) => {
+        const resolved = resolveConfig(config);
+        const disks = await callApi(resolved, "GET", "/api/disks");
+        return disks.map((disk) => ({
+          sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+          sandboxId: disk.id
+        }));
+      },
+      destroy: async (config, sandboxId) => {
+        const resolved = resolveConfig(config);
+        await callApi(
+          resolved,
+          "DELETE",
+          `/api/disks/${encodeURIComponent(sandboxId)}`
+        );
+      },
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        try {
+          const result = await execOnDisk(sandbox, wrapCommand(command, options));
+          return {
+            stdout: result.stdout ?? "",
+            stderr: result.stderr ?? "",
+            exitCode: result.exitCode,
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 1,
+            durationMs: Date.now() - startTime
+          };
+        }
+      },
+      runCode: async (sandbox, code, runtime, _config) => {
+        if (!runtime) {
+          throw new Error(
+            'Archil runCode requires an explicit runtime. Pass runtime: "node" or runtime: "python".'
+          );
+        }
+        if (runtime !== "node" && runtime !== "python") {
+          throw new Error(
+            `Archil runCode does not support runtime "${runtime}". Supported runtimes: "node", "python".`
+          );
+        }
+        const interpreter = runtime === "python" ? "python3" : "node";
+        const flag = runtime === "python" ? "-c" : "-e";
+        const command = `${interpreter} ${flag} ${shellEscape(code)}`;
+        const result = await execOnDisk(sandbox, command);
+        const stdout = result.stdout ?? "";
+        const stderr = result.stderr ?? "";
+        const output = stderr ? `${stdout}${stdout && stderr ? "\n" : ""}${stderr}` : stdout;
+        if (result.exitCode !== 0) {
+          const syntaxErrorPattern = runtime === "python" ? /\bSyntaxError\b|invalid syntax/i : /\bSyntaxError\b|Unexpected token|Unexpected identifier/i;
+          if (syntaxErrorPattern.test(output)) {
+            throw new Error(output || `${runtime} syntax error`);
+          }
+        }
+        return {
+          output,
+          exitCode: result.exitCode,
+          language: runtime
+        };
+      },
+      getInfo: async (sandbox) => {
+        return {
+          id: sandbox.disk.id,
+          provider: "archil",
+          runtime: "node",
+          status: sandbox.disk.status === "ready" ? "running" : "stopped",
+          createdAt: new Date(sandbox.disk.createdAt),
+          timeout: 0,
+          metadata: {
+            name: sandbox.disk.name,
+            organization: sandbox.disk.organization,
+            region: sandbox.disk.region,
+            provider: sandbox.disk.provider
+          }
+        };
+      },
+      getUrl: async (_sandbox, options) => {
+        throw new Error(
+          `Archil exec runs each command in a fresh ephemeral container that exits when the command returns, so there is no long-lived process to expose port ${options.port} on. getUrl is not supported.`
+        );
+      },
+      filesystem: {
+        readFile: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to read ${path}: ${result.stderr}`);
+          }
+          return result.stdout;
+        },
+        writeFile: async (sandbox, path, content, runCommand) => {
+          const parent = path.substring(0, path.lastIndexOf("/"));
+          if (parent) {
+            await runCommand(sandbox, `mkdir -p ${shellEscape(parent)}`);
+          }
+          const encoded = Buffer.from(content, "utf8").toString("base64");
+          const result = await runCommand(
+            sandbox,
+            `printf %s ${shellEscape(encoded)} | base64 -d > ${shellEscape(path)}`
+          );
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to write ${path}: ${result.stderr}`);
+          }
+        },
+        mkdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);
+          }
+        },
+        readdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(
+            sandbox,
+            `find ${shellEscape(path)} -mindepth 1 -maxdepth 1 -printf '%y\\t%s\\t%T@\\t%f\\n'`
+          );
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to list directory ${path}: ${result.stderr}`);
+          }
+          const entries = [];
+          for (const line of result.stdout.split("\n")) {
+            if (!line) continue;
+            const [typeChar, sizeStr, mtimeStr, ...nameParts] = line.split("	");
+            const name = nameParts.join("	");
+            entries.push({
+              name,
+              type: typeChar === "d" ? "directory" : "file",
+              size: parseInt(sizeStr, 10) || 0,
+              modified: new Date(parseFloat(mtimeStr) * 1e3)
+            });
+          }
+          return entries;
+        },
+        exists: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `test -e ${shellEscape(path)}`);
+          return result.exitCode === 0;
+        },
+        remove: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to remove ${path}: ${result.stderr}`);
+          }
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    }
+  }
+});
+var archil = (config = {}) => _provider(config);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  archil
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Archil Provider\n *\n * Executes commands against an Archil disk via the Archil control-plane HTTP\n * API. Archil is exec-only — each command runs in an Archil-managed container\n * with the configured disk mounted, then returns stdout, stderr, and exit code.\n * There is no sandbox lifecycle to manage; \"create\" just resolves a handle to\n * the target disk.\n */\n\nimport { defineProvider } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n} from 'computesdk';\n\n// Per-region color overrides. Default is \"green\" for any region not listed here.\nconst REGION_COLORS: Record<string, string> = {\n  'gcp-us-central1': 'blue',\n};\n\nfunction regionToBaseUrl(region: string): string {\n  const dash = region.indexOf('-');\n  if (dash <= 0 || dash === region.length - 1) {\n    throw new Error(\n      `Invalid Archil region \"${region}\". Expected \"{cloud}-{suffix}\", e.g. \"aws-us-east-1\".`,\n    );\n  }\n  const cloud = region.slice(0, dash);\n  const suffix = region.slice(dash + 1);\n  const color = REGION_COLORS[region] ?? 'green';\n  return `https://control.${color}.${suffix}.${cloud}.prod.archil.com`;\n}\n\nexport interface ArchilConfig {\n  /** Archil API key. Falls back to ARCHIL_API_KEY env var. */\n  apiKey?: string;\n  /** Archil region (e.g. \"aws-us-east-1\"). Falls back to ARCHIL_REGION env var. */\n  region?: string;\n  /** Override the control-plane base URL (useful for testing). */\n  baseUrl?: string;\n}\n\ninterface DiskResponse {\n  id: string;\n  name: string;\n  organization: string;\n  status: string;\n  provider: string;\n  region: string;\n  createdAt: string;\n}\n\ninterface ExecTiming {\n  totalMs: number;\n  queueMs: number;\n  executeMs: number;\n}\n\ninterface ExecResponse {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n  timing: ExecTiming;\n}\n\ninterface ResolvedConfig {\n  apiKey: string;\n  baseUrl: string;\n}\n\ninterface ArchilSandbox {\n  disk: DiskResponse;\n  resolved: ResolvedConfig;\n  createdAt: Date;\n}\n\nfunction resolveConfig(config: ArchilConfig): ResolvedConfig {\n  const apiKey = config.apiKey ?? process.env.ARCHIL_API_KEY;\n  const region = config.region ?? process.env.ARCHIL_REGION;\n\n  if (!apiKey) {\n    throw new Error(\n      'Missing API key for Archil.\\n\\n' +\n        'Pass it: archil({ apiKey: \"...\" })\\n' +\n        'Or set ARCHIL_API_KEY in your environment.',\n    );\n  }\n\n  let baseUrl = config.baseUrl;\n  if (!baseUrl) {\n    if (!region) {\n      throw new Error(\n        'Missing region for Archil.\\n\\n' +\n          'Pass it: archil({ region: \"...\" })\\n' +\n          'Or set ARCHIL_REGION in your environment.\\n' +\n          'Examples: \"aws-us-east-1\", \"aws-eu-west-1\", \"gcp-us-central1\".',\n      );\n    }\n    baseUrl = regionToBaseUrl(region);\n  }\n\n  return { apiKey, baseUrl };\n}\n\nfunction authHeader(apiKey: string): string {\n  return `key-${apiKey.replace(/^key-/, '')}`;\n}\n\nasync function callApi<T>(\n  resolved: ResolvedConfig,\n  method: 'GET' | 'POST' | 'DELETE',\n  path: string,\n  body?: unknown,\n): Promise<T> {\n  const response = await fetch(`${resolved.baseUrl}${path}`, {\n    method,\n    headers: {\n      Authorization: authHeader(resolved.apiKey),\n      ...(body ? { 'Content-Type': 'application/json' } : {}),\n    },\n    body: body ? JSON.stringify(body) : undefined,\n  });\n\n  type Envelope = { success?: boolean; data?: T; error?: string };\n  let payload: Envelope | null = null;\n  try {\n    payload = (await response.json()) as Envelope;\n  } catch {\n    payload = null;\n  }\n\n  if (!response.ok || !payload || payload.success === false) {\n    const message =\n      (payload && payload.error) ||\n      `Archil API ${method} ${path} failed with status ${response.status}`;\n    throw new Error(message);\n  }\n\n  return payload.data as T;\n}\n\n// Archil disk names must match /^[a-zA-Z0-9_-]+$/ and be 1–100 chars.\nfunction generateDiskName(): string {\n  const random = Math.random().toString(36).slice(2, 10);\n  return `computesdk-${Date.now()}-${random}`;\n}\n\nasync function lookupDiskByName(\n  resolved: ResolvedConfig,\n  name: string,\n): Promise<DiskResponse | null> {\n  const disks = await callApi<DiskResponse[]>(resolved, 'GET', '/api/disks');\n  return disks.find((d) => d.name === name) ?? null;\n}\n\nfunction shellEscape(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\nfunction wrapCommand(command: string, options?: RunCommandOptions): string {\n  let wrapped = command;\n\n  const envEntries = Object.entries(options?.env ?? {});\n  if (!envEntries.some(([key]) => key === 'HOME')) {\n    envEntries.unshift(['HOME', process.env.HOME || '/tmp']);\n  }\n  const envPrefix = envEntries\n    .map(([k, v]) => `${k}=${shellEscape(String(v))}`)\n    .join(' ');\n  wrapped = `${envPrefix} ${wrapped}`;\n\n  if (options?.cwd) {\n    wrapped = `cd ${shellEscape(options.cwd)} && ${wrapped}`;\n  }\n\n  if (options?.background) {\n    wrapped = `nohup sh -c ${shellEscape(wrapped)} > /dev/null 2>&1 &`;\n  }\n\n  return wrapped;\n}\n\nasync function execOnDisk(sandbox: ArchilSandbox, command: string): Promise<ExecResponse> {\n  return callApi<ExecResponse>(\n    sandbox.resolved,\n    'POST',\n    `/api/disks/${encodeURIComponent(sandbox.disk.id)}/exec`,\n    { command },\n  );\n}\n\nconst _provider = defineProvider<ArchilSandbox, ArchilConfig>({\n  name: 'archil',\n  methods: {\n    sandbox: {\n      create: async (config: ArchilConfig, options?: CreateSandboxOptions) => {\n        const resolved = resolveConfig(config);\n        const name = ((options?.name as string | undefined) ?? generateDiskName()).trim();\n        const created = await callApi<{ diskId: string }>(\n          resolved,\n          'POST',\n          '/api/disks',\n          { name },\n        );\n        const disk = await callApi<DiskResponse>(\n          resolved,\n          'GET',\n          `/api/disks/${encodeURIComponent(created.diskId)}`,\n        );\n        return {\n          sandbox: { disk, resolved, createdAt: new Date() },\n          sandboxId: disk.id,\n        };\n      },\n\n      getById: async (config: ArchilConfig, sandboxId: string) => {\n        const resolved = resolveConfig(config);\n        // Try as disk id first; fall back to name lookup via list.\n        try {\n          const disk = await callApi<DiskResponse>(\n            resolved,\n            'GET',\n            `/api/disks/${encodeURIComponent(sandboxId)}`,\n          );\n          return {\n            sandbox: { disk, resolved, createdAt: new Date() },\n            sandboxId: disk.id,\n          };\n        } catch {\n          // not an id — try name\n        }\n        try {\n          const disk = await lookupDiskByName(resolved, sandboxId);\n          if (!disk) return null;\n          return {\n            sandbox: { disk, resolved, createdAt: new Date() },\n            sandboxId: disk.id,\n          };\n        } catch {\n          return null;\n        }\n      },\n\n      list: async (config: ArchilConfig) => {\n        const resolved = resolveConfig(config);\n        const disks = await callApi<DiskResponse[]>(resolved, 'GET', '/api/disks');\n        return disks.map((disk) => ({\n          sandbox: { disk, resolved, createdAt: new Date() },\n          sandboxId: disk.id,\n        }));\n      },\n\n      destroy: async (config: ArchilConfig, sandboxId: string) => {\n        const resolved = resolveConfig(config);\n        await callApi<null>(\n          resolved,\n          'DELETE',\n          `/api/disks/${encodeURIComponent(sandboxId)}`,\n        );\n      },\n\n      runCommand: async (\n        sandbox: ArchilSandbox,\n        command: string,\n        options?: RunCommandOptions,\n      ): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          const result = await execOnDisk(sandbox, wrapCommand(command, options));\n          return {\n            stdout: result.stdout ?? '',\n            stderr: result.stderr ?? '',\n            exitCode: result.exitCode,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 1,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      runCode: async (\n        sandbox: ArchilSandbox,\n        code: string,\n        runtime?: Runtime,\n        _config?: ArchilConfig,\n      ): Promise<CodeResult> => {\n        if (!runtime) {\n          throw new Error(\n            'Archil runCode requires an explicit runtime. Pass runtime: \"node\" or runtime: \"python\".',\n          );\n        }\n        if (runtime !== 'node' && runtime !== 'python') {\n          throw new Error(\n            `Archil runCode does not support runtime \"${runtime}\". Supported runtimes: \"node\", \"python\".`,\n          );\n        }\n        const interpreter = runtime === 'python' ? 'python3' : 'node';\n        const flag = runtime === 'python' ? '-c' : '-e';\n        const command = `${interpreter} ${flag} ${shellEscape(code)}`;\n\n        const result = await execOnDisk(sandbox, command);\n        const stdout = result.stdout ?? '';\n        const stderr = result.stderr ?? '';\n        const output = stderr ? `${stdout}${stdout && stderr ? '\\n' : ''}${stderr}` : stdout;\n\n        if (result.exitCode !== 0) {\n          const syntaxErrorPattern =\n            runtime === 'python'\n              ? /\\bSyntaxError\\b|invalid syntax/i\n              : /\\bSyntaxError\\b|Unexpected token|Unexpected identifier/i;\n          if (syntaxErrorPattern.test(output)) {\n            throw new Error(output || `${runtime} syntax error`);\n          }\n        }\n\n        return {\n          output,\n          exitCode: result.exitCode,\n          language: runtime,\n        };\n      },\n\n      getInfo: async (sandbox: ArchilSandbox): Promise<SandboxInfo> => {\n        return {\n          id: sandbox.disk.id,\n          provider: 'archil',\n          runtime: 'node',\n          status: sandbox.disk.status === 'ready' ? 'running' : 'stopped',\n          createdAt: new Date(sandbox.disk.createdAt),\n          timeout: 0,\n          metadata: {\n            name: sandbox.disk.name,\n            organization: sandbox.disk.organization,\n            region: sandbox.disk.region,\n            provider: sandbox.disk.provider,\n          },\n        };\n      },\n\n      getUrl: async (\n        _sandbox: ArchilSandbox,\n        options: { port: number; protocol?: string },\n      ): Promise<string> => {\n        throw new Error(\n          `Archil exec runs each command in a fresh ephemeral container that exits when the command returns, ` +\n            `so there is no long-lived process to expose port ${options.port} on. ` +\n            `getUrl is not supported.`,\n        );\n      },\n\n      filesystem: {\n        readFile: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to read ${path}: ${result.stderr}`);\n          }\n          return result.stdout;\n        },\n\n        writeFile: async (sandbox, path, content, runCommand) => {\n          const parent = path.substring(0, path.lastIndexOf('/'));\n          if (parent) {\n            await runCommand(sandbox, `mkdir -p ${shellEscape(parent)}`);\n          }\n          // base64-pipe to avoid heredoc/quoting hazards on arbitrary content.\n          const encoded = Buffer.from(content, 'utf8').toString('base64');\n          const result = await runCommand(\n            sandbox,\n            `printf %s ${shellEscape(encoded)} | base64 -d > ${shellEscape(path)}`,\n          );\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to write ${path}: ${result.stderr}`);\n          }\n        },\n\n        mkdir: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n          }\n        },\n\n        readdir: async (sandbox, path, runCommand) => {\n          // Tab-separated: type<TAB>size<TAB>mtime-iso<TAB>name. Robust to spaces in names.\n          const result = await runCommand(\n            sandbox,\n            `find ${shellEscape(path)} -mindepth 1 -maxdepth 1 -printf '%y\\\\t%s\\\\t%T@\\\\t%f\\\\n'`,\n          );\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to list directory ${path}: ${result.stderr}`);\n          }\n          const entries: FileEntry[] = [];\n          for (const line of result.stdout.split('\\n')) {\n            if (!line) continue;\n            const [typeChar, sizeStr, mtimeStr, ...nameParts] = line.split('\\t');\n            const name = nameParts.join('\\t');\n            entries.push({\n              name,\n              type: typeChar === 'd' ? 'directory' : 'file',\n              size: parseInt(sizeStr, 10) || 0,\n              modified: new Date(parseFloat(mtimeStr) * 1000),\n            });\n          }\n          return entries;\n        },\n\n        exists: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `test -e ${shellEscape(path)}`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n          }\n        },\n      },\n\n      getInstance: (sandbox: ArchilSandbox): ArchilSandbox => sandbox,\n    },\n  },\n});\n\nexport const archil = (config: ArchilConfig = {}) => _provider(config);\n\nexport type { ArchilSandbox };\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,299 @@
+// src/index.ts
+import { defineProvider } from "@computesdk/provider";
+var REGION_COLORS = {
+  "gcp-us-central1": "blue"
+};
+function regionToBaseUrl(region) {
+  const dash = region.indexOf("-");
+  if (dash <= 0 || dash === region.length - 1) {
+    throw new Error(
+      `Invalid Archil region "${region}". Expected "{cloud}-{suffix}", e.g. "aws-us-east-1".`
+    );
+  }
+  const cloud = region.slice(0, dash);
+  const suffix = region.slice(dash + 1);
+  const color = REGION_COLORS[region] ?? "green";
+  return `https://control.${color}.${suffix}.${cloud}.prod.archil.com`;
+}
+function resolveConfig(config) {
+  const apiKey = config.apiKey ?? process.env.ARCHIL_API_KEY;
+  const region = config.region ?? process.env.ARCHIL_REGION;
+  if (!apiKey) {
+    throw new Error(
+      'Missing API key for Archil.\n\nPass it: archil({ apiKey: "..." })\nOr set ARCHIL_API_KEY in your environment.'
+    );
+  }
+  let baseUrl = config.baseUrl;
+  if (!baseUrl) {
+    if (!region) {
+      throw new Error(
+        'Missing region for Archil.\n\nPass it: archil({ region: "..." })\nOr set ARCHIL_REGION in your environment.\nExamples: "aws-us-east-1", "aws-eu-west-1", "gcp-us-central1".'
+      );
+    }
+    baseUrl = regionToBaseUrl(region);
+  }
+  return { apiKey, baseUrl };
+}
+function authHeader(apiKey) {
+  return `key-${apiKey.replace(/^key-/, "")}`;
+}
+async function callApi(resolved, method, path, body) {
+  const response = await fetch(`${resolved.baseUrl}${path}`, {
+    method,
+    headers: {
+      Authorization: authHeader(resolved.apiKey),
+      ...body ? { "Content-Type": "application/json" } : {}
+    },
+    body: body ? JSON.stringify(body) : void 0
+  });
+  let payload = null;
+  try {
+    payload = await response.json();
+  } catch {
+    payload = null;
+  }
+  if (!response.ok || !payload || payload.success === false) {
+    const message = payload && payload.error || `Archil API ${method} ${path} failed with status ${response.status}`;
+    throw new Error(message);
+  }
+  return payload.data;
+}
+function generateDiskName() {
+  const random = Math.random().toString(36).slice(2, 10);
+  return `computesdk-${Date.now()}-${random}`;
+}
+async function lookupDiskByName(resolved, name) {
+  const disks = await callApi(resolved, "GET", "/api/disks");
+  return disks.find((d) => d.name === name) ?? null;
+}
+function shellEscape(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function wrapCommand(command, options) {
+  let wrapped = command;
+  const envEntries = Object.entries(options?.env ?? {});
+  if (!envEntries.some(([key]) => key === "HOME")) {
+    envEntries.unshift(["HOME", process.env.HOME || "/tmp"]);
+  }
+  const envPrefix = envEntries.map(([k, v]) => `${k}=${shellEscape(String(v))}`).join(" ");
+  wrapped = `${envPrefix} ${wrapped}`;
+  if (options?.cwd) {
+    wrapped = `cd ${shellEscape(options.cwd)} && ${wrapped}`;
+  }
+  if (options?.background) {
+    wrapped = `nohup sh -c ${shellEscape(wrapped)} > /dev/null 2>&1 &`;
+  }
+  return wrapped;
+}
+async function execOnDisk(sandbox, command) {
+  return callApi(
+    sandbox.resolved,
+    "POST",
+    `/api/disks/${encodeURIComponent(sandbox.disk.id)}/exec`,
+    { command }
+  );
+}
+var _provider = defineProvider({
+  name: "archil",
+  methods: {
+    sandbox: {
+      create: async (config, options) => {
+        const resolved = resolveConfig(config);
+        const name = (options?.name ?? generateDiskName()).trim();
+        const created = await callApi(
+          resolved,
+          "POST",
+          "/api/disks",
+          { name }
+        );
+        const disk = await callApi(
+          resolved,
+          "GET",
+          `/api/disks/${encodeURIComponent(created.diskId)}`
+        );
+        return {
+          sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+          sandboxId: disk.id
+        };
+      },
+      getById: async (config, sandboxId) => {
+        const resolved = resolveConfig(config);
+        try {
+          const disk = await callApi(
+            resolved,
+            "GET",
+            `/api/disks/${encodeURIComponent(sandboxId)}`
+          );
+          return {
+            sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+            sandboxId: disk.id
+          };
+        } catch {
+        }
+        try {
+          const disk = await lookupDiskByName(resolved, sandboxId);
+          if (!disk) return null;
+          return {
+            sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+            sandboxId: disk.id
+          };
+        } catch {
+          return null;
+        }
+      },
+      list: async (config) => {
+        const resolved = resolveConfig(config);
+        const disks = await callApi(resolved, "GET", "/api/disks");
+        return disks.map((disk) => ({
+          sandbox: { disk, resolved, createdAt: /* @__PURE__ */ new Date() },
+          sandboxId: disk.id
+        }));
+      },
+      destroy: async (config, sandboxId) => {
+        const resolved = resolveConfig(config);
+        await callApi(
+          resolved,
+          "DELETE",
+          `/api/disks/${encodeURIComponent(sandboxId)}`
+        );
+      },
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        try {
+          const result = await execOnDisk(sandbox, wrapCommand(command, options));
+          return {
+            stdout: result.stdout ?? "",
+            stderr: result.stderr ?? "",
+            exitCode: result.exitCode,
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 1,
+            durationMs: Date.now() - startTime
+          };
+        }
+      },
+      runCode: async (sandbox, code, runtime, _config) => {
+        if (!runtime) {
+          throw new Error(
+            'Archil runCode requires an explicit runtime. Pass runtime: "node" or runtime: "python".'
+          );
+        }
+        if (runtime !== "node" && runtime !== "python") {
+          throw new Error(
+            `Archil runCode does not support runtime "${runtime}". Supported runtimes: "node", "python".`
+          );
+        }
+        const interpreter = runtime === "python" ? "python3" : "node";
+        const flag = runtime === "python" ? "-c" : "-e";
+        const command = `${interpreter} ${flag} ${shellEscape(code)}`;
+        const result = await execOnDisk(sandbox, command);
+        const stdout = result.stdout ?? "";
+        const stderr = result.stderr ?? "";
+        const output = stderr ? `${stdout}${stdout && stderr ? "\n" : ""}${stderr}` : stdout;
+        if (result.exitCode !== 0) {
+          const syntaxErrorPattern = runtime === "python" ? /\bSyntaxError\b|invalid syntax/i : /\bSyntaxError\b|Unexpected token|Unexpected identifier/i;
+          if (syntaxErrorPattern.test(output)) {
+            throw new Error(output || `${runtime} syntax error`);
+          }
+        }
+        return {
+          output,
+          exitCode: result.exitCode,
+          language: runtime
+        };
+      },
+      getInfo: async (sandbox) => {
+        return {
+          id: sandbox.disk.id,
+          provider: "archil",
+          runtime: "node",
+          status: sandbox.disk.status === "ready" ? "running" : "stopped",
+          createdAt: new Date(sandbox.disk.createdAt),
+          timeout: 0,
+          metadata: {
+            name: sandbox.disk.name,
+            organization: sandbox.disk.organization,
+            region: sandbox.disk.region,
+            provider: sandbox.disk.provider
+          }
+        };
+      },
+      getUrl: async (_sandbox, options) => {
+        throw new Error(
+          `Archil exec runs each command in a fresh ephemeral container that exits when the command returns, so there is no long-lived process to expose port ${options.port} on. getUrl is not supported.`
+        );
+      },
+      filesystem: {
+        readFile: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to read ${path}: ${result.stderr}`);
+          }
+          return result.stdout;
+        },
+        writeFile: async (sandbox, path, content, runCommand) => {
+          const parent = path.substring(0, path.lastIndexOf("/"));
+          if (parent) {
+            await runCommand(sandbox, `mkdir -p ${shellEscape(parent)}`);
+          }
+          const encoded = Buffer.from(content, "utf8").toString("base64");
+          const result = await runCommand(
+            sandbox,
+            `printf %s ${shellEscape(encoded)} | base64 -d > ${shellEscape(path)}`
+          );
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to write ${path}: ${result.stderr}`);
+          }
+        },
+        mkdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);
+          }
+        },
+        readdir: async (sandbox, path, runCommand) => {
+          const result = await runCommand(
+            sandbox,
+            `find ${shellEscape(path)} -mindepth 1 -maxdepth 1 -printf '%y\\t%s\\t%T@\\t%f\\n'`
+          );
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to list directory ${path}: ${result.stderr}`);
+          }
+          const entries = [];
+          for (const line of result.stdout.split("\n")) {
+            if (!line) continue;
+            const [typeChar, sizeStr, mtimeStr, ...nameParts] = line.split("	");
+            const name = nameParts.join("	");
+            entries.push({
+              name,
+              type: typeChar === "d" ? "directory" : "file",
+              size: parseInt(sizeStr, 10) || 0,
+              modified: new Date(parseFloat(mtimeStr) * 1e3)
+            });
+          }
+          return entries;
+        },
+        exists: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `test -e ${shellEscape(path)}`);
+          return result.exitCode === 0;
+        },
+        remove: async (sandbox, path, runCommand) => {
+          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);
+          if (result.exitCode !== 0) {
+            throw new Error(`Failed to remove ${path}: ${result.stderr}`);
+          }
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    }
+  }
+});
+var archil = (config = {}) => _provider(config);
+export {
+  archil
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Archil Provider\n *\n * Executes commands against an Archil disk via the Archil control-plane HTTP\n * API. Archil is exec-only — each command runs in an Archil-managed container\n * with the configured disk mounted, then returns stdout, stderr, and exit code.\n * There is no sandbox lifecycle to manage; \"create\" just resolves a handle to\n * the target disk.\n */\n\nimport { defineProvider } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n} from 'computesdk';\n\n// Per-region color overrides. Default is \"green\" for any region not listed here.\nconst REGION_COLORS: Record<string, string> = {\n  'gcp-us-central1': 'blue',\n};\n\nfunction regionToBaseUrl(region: string): string {\n  const dash = region.indexOf('-');\n  if (dash <= 0 || dash === region.length - 1) {\n    throw new Error(\n      `Invalid Archil region \"${region}\". Expected \"{cloud}-{suffix}\", e.g. \"aws-us-east-1\".`,\n    );\n  }\n  const cloud = region.slice(0, dash);\n  const suffix = region.slice(dash + 1);\n  const color = REGION_COLORS[region] ?? 'green';\n  return `https://control.${color}.${suffix}.${cloud}.prod.archil.com`;\n}\n\nexport interface ArchilConfig {\n  /** Archil API key. Falls back to ARCHIL_API_KEY env var. */\n  apiKey?: string;\n  /** Archil region (e.g. \"aws-us-east-1\"). Falls back to ARCHIL_REGION env var. */\n  region?: string;\n  /** Override the control-plane base URL (useful for testing). */\n  baseUrl?: string;\n}\n\ninterface DiskResponse {\n  id: string;\n  name: string;\n  organization: string;\n  status: string;\n  provider: string;\n  region: string;\n  createdAt: string;\n}\n\ninterface ExecTiming {\n  totalMs: number;\n  queueMs: number;\n  executeMs: number;\n}\n\ninterface ExecResponse {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n  timing: ExecTiming;\n}\n\ninterface ResolvedConfig {\n  apiKey: string;\n  baseUrl: string;\n}\n\ninterface ArchilSandbox {\n  disk: DiskResponse;\n  resolved: ResolvedConfig;\n  createdAt: Date;\n}\n\nfunction resolveConfig(config: ArchilConfig): ResolvedConfig {\n  const apiKey = config.apiKey ?? process.env.ARCHIL_API_KEY;\n  const region = config.region ?? process.env.ARCHIL_REGION;\n\n  if (!apiKey) {\n    throw new Error(\n      'Missing API key for Archil.\\n\\n' +\n        'Pass it: archil({ apiKey: \"...\" })\\n' +\n        'Or set ARCHIL_API_KEY in your environment.',\n    );\n  }\n\n  let baseUrl = config.baseUrl;\n  if (!baseUrl) {\n    if (!region) {\n      throw new Error(\n        'Missing region for Archil.\\n\\n' +\n          'Pass it: archil({ region: \"...\" })\\n' +\n          'Or set ARCHIL_REGION in your environment.\\n' +\n          'Examples: \"aws-us-east-1\", \"aws-eu-west-1\", \"gcp-us-central1\".',\n      );\n    }\n    baseUrl = regionToBaseUrl(region);\n  }\n\n  return { apiKey, baseUrl };\n}\n\nfunction authHeader(apiKey: string): string {\n  return `key-${apiKey.replace(/^key-/, '')}`;\n}\n\nasync function callApi<T>(\n  resolved: ResolvedConfig,\n  method: 'GET' | 'POST' | 'DELETE',\n  path: string,\n  body?: unknown,\n): Promise<T> {\n  const response = await fetch(`${resolved.baseUrl}${path}`, {\n    method,\n    headers: {\n      Authorization: authHeader(resolved.apiKey),\n      ...(body ? { 'Content-Type': 'application/json' } : {}),\n    },\n    body: body ? JSON.stringify(body) : undefined,\n  });\n\n  type Envelope = { success?: boolean; data?: T; error?: string };\n  let payload: Envelope | null = null;\n  try {\n    payload = (await response.json()) as Envelope;\n  } catch {\n    payload = null;\n  }\n\n  if (!response.ok || !payload || payload.success === false) {\n    const message =\n      (payload && payload.error) ||\n      `Archil API ${method} ${path} failed with status ${response.status}`;\n    throw new Error(message);\n  }\n\n  return payload.data as T;\n}\n\n// Archil disk names must match /^[a-zA-Z0-9_-]+$/ and be 1–100 chars.\nfunction generateDiskName(): string {\n  const random = Math.random().toString(36).slice(2, 10);\n  return `computesdk-${Date.now()}-${random}`;\n}\n\nasync function lookupDiskByName(\n  resolved: ResolvedConfig,\n  name: string,\n): Promise<DiskResponse | null> {\n  const disks = await callApi<DiskResponse[]>(resolved, 'GET', '/api/disks');\n  return disks.find((d) => d.name === name) ?? null;\n}\n\nfunction shellEscape(value: string): string {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\nfunction wrapCommand(command: string, options?: RunCommandOptions): string {\n  let wrapped = command;\n\n  const envEntries = Object.entries(options?.env ?? {});\n  if (!envEntries.some(([key]) => key === 'HOME')) {\n    envEntries.unshift(['HOME', process.env.HOME || '/tmp']);\n  }\n  const envPrefix = envEntries\n    .map(([k, v]) => `${k}=${shellEscape(String(v))}`)\n    .join(' ');\n  wrapped = `${envPrefix} ${wrapped}`;\n\n  if (options?.cwd) {\n    wrapped = `cd ${shellEscape(options.cwd)} && ${wrapped}`;\n  }\n\n  if (options?.background) {\n    wrapped = `nohup sh -c ${shellEscape(wrapped)} > /dev/null 2>&1 &`;\n  }\n\n  return wrapped;\n}\n\nasync function execOnDisk(sandbox: ArchilSandbox, command: string): Promise<ExecResponse> {\n  return callApi<ExecResponse>(\n    sandbox.resolved,\n    'POST',\n    `/api/disks/${encodeURIComponent(sandbox.disk.id)}/exec`,\n    { command },\n  );\n}\n\nconst _provider = defineProvider<ArchilSandbox, ArchilConfig>({\n  name: 'archil',\n  methods: {\n    sandbox: {\n      create: async (config: ArchilConfig, options?: CreateSandboxOptions) => {\n        const resolved = resolveConfig(config);\n        const name = ((options?.name as string | undefined) ?? generateDiskName()).trim();\n        const created = await callApi<{ diskId: string }>(\n          resolved,\n          'POST',\n          '/api/disks',\n          { name },\n        );\n        const disk = await callApi<DiskResponse>(\n          resolved,\n          'GET',\n          `/api/disks/${encodeURIComponent(created.diskId)}`,\n        );\n        return {\n          sandbox: { disk, resolved, createdAt: new Date() },\n          sandboxId: disk.id,\n        };\n      },\n\n      getById: async (config: ArchilConfig, sandboxId: string) => {\n        const resolved = resolveConfig(config);\n        // Try as disk id first; fall back to name lookup via list.\n        try {\n          const disk = await callApi<DiskResponse>(\n            resolved,\n            'GET',\n            `/api/disks/${encodeURIComponent(sandboxId)}`,\n          );\n          return {\n            sandbox: { disk, resolved, createdAt: new Date() },\n            sandboxId: disk.id,\n          };\n        } catch {\n          // not an id — try name\n        }\n        try {\n          const disk = await lookupDiskByName(resolved, sandboxId);\n          if (!disk) return null;\n          return {\n            sandbox: { disk, resolved, createdAt: new Date() },\n            sandboxId: disk.id,\n          };\n        } catch {\n          return null;\n        }\n      },\n\n      list: async (config: ArchilConfig) => {\n        const resolved = resolveConfig(config);\n        const disks = await callApi<DiskResponse[]>(resolved, 'GET', '/api/disks');\n        return disks.map((disk) => ({\n          sandbox: { disk, resolved, createdAt: new Date() },\n          sandboxId: disk.id,\n        }));\n      },\n\n      destroy: async (config: ArchilConfig, sandboxId: string) => {\n        const resolved = resolveConfig(config);\n        await callApi<null>(\n          resolved,\n          'DELETE',\n          `/api/disks/${encodeURIComponent(sandboxId)}`,\n        );\n      },\n\n      runCommand: async (\n        sandbox: ArchilSandbox,\n        command: string,\n        options?: RunCommandOptions,\n      ): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          const result = await execOnDisk(sandbox, wrapCommand(command, options));\n          return {\n            stdout: result.stdout ?? '',\n            stderr: result.stderr ?? '',\n            exitCode: result.exitCode,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 1,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      runCode: async (\n        sandbox: ArchilSandbox,\n        code: string,\n        runtime?: Runtime,\n        _config?: ArchilConfig,\n      ): Promise<CodeResult> => {\n        if (!runtime) {\n          throw new Error(\n            'Archil runCode requires an explicit runtime. Pass runtime: \"node\" or runtime: \"python\".',\n          );\n        }\n        if (runtime !== 'node' && runtime !== 'python') {\n          throw new Error(\n            `Archil runCode does not support runtime \"${runtime}\". Supported runtimes: \"node\", \"python\".`,\n          );\n        }\n        const interpreter = runtime === 'python' ? 'python3' : 'node';\n        const flag = runtime === 'python' ? '-c' : '-e';\n        const command = `${interpreter} ${flag} ${shellEscape(code)}`;\n\n        const result = await execOnDisk(sandbox, command);\n        const stdout = result.stdout ?? '';\n        const stderr = result.stderr ?? '';\n        const output = stderr ? `${stdout}${stdout && stderr ? '\\n' : ''}${stderr}` : stdout;\n\n        if (result.exitCode !== 0) {\n          const syntaxErrorPattern =\n            runtime === 'python'\n              ? /\\bSyntaxError\\b|invalid syntax/i\n              : /\\bSyntaxError\\b|Unexpected token|Unexpected identifier/i;\n          if (syntaxErrorPattern.test(output)) {\n            throw new Error(output || `${runtime} syntax error`);\n          }\n        }\n\n        return {\n          output,\n          exitCode: result.exitCode,\n          language: runtime,\n        };\n      },\n\n      getInfo: async (sandbox: ArchilSandbox): Promise<SandboxInfo> => {\n        return {\n          id: sandbox.disk.id,\n          provider: 'archil',\n          runtime: 'node',\n          status: sandbox.disk.status === 'ready' ? 'running' : 'stopped',\n          createdAt: new Date(sandbox.disk.createdAt),\n          timeout: 0,\n          metadata: {\n            name: sandbox.disk.name,\n            organization: sandbox.disk.organization,\n            region: sandbox.disk.region,\n            provider: sandbox.disk.provider,\n          },\n        };\n      },\n\n      getUrl: async (\n        _sandbox: ArchilSandbox,\n        options: { port: number; protocol?: string },\n      ): Promise<string> => {\n        throw new Error(\n          `Archil exec runs each command in a fresh ephemeral container that exits when the command returns, ` +\n            `so there is no long-lived process to expose port ${options.port} on. ` +\n            `getUrl is not supported.`,\n        );\n      },\n\n      filesystem: {\n        readFile: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to read ${path}: ${result.stderr}`);\n          }\n          return result.stdout;\n        },\n\n        writeFile: async (sandbox, path, content, runCommand) => {\n          const parent = path.substring(0, path.lastIndexOf('/'));\n          if (parent) {\n            await runCommand(sandbox, `mkdir -p ${shellEscape(parent)}`);\n          }\n          // base64-pipe to avoid heredoc/quoting hazards on arbitrary content.\n          const encoded = Buffer.from(content, 'utf8').toString('base64');\n          const result = await runCommand(\n            sandbox,\n            `printf %s ${shellEscape(encoded)} | base64 -d > ${shellEscape(path)}`,\n          );\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to write ${path}: ${result.stderr}`);\n          }\n        },\n\n        mkdir: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n          }\n        },\n\n        readdir: async (sandbox, path, runCommand) => {\n          // Tab-separated: type<TAB>size<TAB>mtime-iso<TAB>name. Robust to spaces in names.\n          const result = await runCommand(\n            sandbox,\n            `find ${shellEscape(path)} -mindepth 1 -maxdepth 1 -printf '%y\\\\t%s\\\\t%T@\\\\t%f\\\\n'`,\n          );\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to list directory ${path}: ${result.stderr}`);\n          }\n          const entries: FileEntry[] = [];\n          for (const line of result.stdout.split('\\n')) {\n            if (!line) continue;\n            const [typeChar, sizeStr, mtimeStr, ...nameParts] = line.split('\\t');\n            const name = nameParts.join('\\t');\n            entries.push({\n              name,\n              type: typeChar === 'd' ? 'directory' : 'file',\n              size: parseInt(sizeStr, 10) || 0,\n              modified: new Date(parseFloat(mtimeStr) * 1000),\n            });\n          }\n          return entries;\n        },\n\n        exists: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `test -e ${shellEscape(path)}`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox, path, runCommand) => {\n          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n          }\n        },\n      },\n\n      getInstance: (sandbox: ArchilSandbox): ArchilSandbox => sandbox,\n    },\n  },\n});\n\nexport const archil = (config: ArchilConfig = {}) => _provider(config);\n\nexport type { ArchilSandbox };\n"],"mappings":";AAUA,SAAS,sBAAsB;AAY/B,IAAM,gBAAwC;AAAA,EAC5C,mBAAmB;AACrB;AAEA,SAAS,gBAAgB,QAAwB;AAC/C,QAAM,OAAO,OAAO,QAAQ,GAAG;AAC/B,MAAI,QAAQ,KAAK,SAAS,OAAO,SAAS,GAAG;AAC3C,UAAM,IAAI;AAAA,MACR,0BAA0B,MAAM;AAAA,IAClC;AAAA,EACF;AACA,QAAM,QAAQ,OAAO,MAAM,GAAG,IAAI;AAClC,QAAM,SAAS,OAAO,MAAM,OAAO,CAAC;AACpC,QAAM,QAAQ,cAAc,MAAM,KAAK;AACvC,SAAO,mBAAmB,KAAK,IAAI,MAAM,IAAI,KAAK;AACpD;AA6CA,SAAS,cAAc,QAAsC;AAC3D,QAAM,SAAS,OAAO,UAAU,QAAQ,IAAI;AAC5C,QAAM,SAAS,OAAO,UAAU,QAAQ,IAAI;AAE5C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AAEA,MAAI,UAAU,OAAO;AACrB,MAAI,CAAC,SAAS;AACZ,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR;AAAA,MAIF;AAAA,IACF;AACA,cAAU,gBAAgB,MAAM;AAAA,EAClC;AAEA,SAAO,EAAE,QAAQ,QAAQ;AAC3B;AAEA,SAAS,WAAW,QAAwB;AAC1C,SAAO,OAAO,OAAO,QAAQ,SAAS,EAAE,CAAC;AAC3C;AAEA,eAAe,QACb,UACA,QACA,MACA,MACY;AACZ,QAAM,WAAW,MAAM,MAAM,GAAG,SAAS,OAAO,GAAG,IAAI,IAAI;AAAA,IACzD;AAAA,IACA,SAAS;AAAA,MACP,eAAe,WAAW,SAAS,MAAM;AAAA,MACzC,GAAI,OAAO,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;AAAA,IACvD;AAAA,IACA,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,EACtC,CAAC;AAGD,MAAI,UAA2B;AAC/B,MAAI;AACF,cAAW,MAAM,SAAS,KAAK;AAAA,EACjC,QAAQ;AACN,cAAU;AAAA,EACZ;AAEA,MAAI,CAAC,SAAS,MAAM,CAAC,WAAW,QAAQ,YAAY,OAAO;AACzD,UAAM,UACH,WAAW,QAAQ,SACpB,cAAc,MAAM,IAAI,IAAI,uBAAuB,SAAS,MAAM;AACpE,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AAEA,SAAO,QAAQ;AACjB;AAGA,SAAS,mBAA2B;AAClC,QAAM,SAAS,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE;AACrD,SAAO,cAAc,KAAK,IAAI,CAAC,IAAI,MAAM;AAC3C;AAEA,eAAe,iBACb,UACA,MAC8B;AAC9B,QAAM,QAAQ,MAAM,QAAwB,UAAU,OAAO,YAAY;AACzE,SAAO,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,KAAK;AAC/C;AAEA,SAAS,YAAY,OAAuB;AAC1C,SAAO,IAAI,MAAM,QAAQ,MAAM,OAAO,CAAC;AACzC;AAEA,SAAS,YAAY,SAAiB,SAAqC;AACzE,MAAI,UAAU;AAEd,QAAM,aAAa,OAAO,QAAQ,SAAS,OAAO,CAAC,CAAC;AACpD,MAAI,CAAC,WAAW,KAAK,CAAC,CAAC,GAAG,MAAM,QAAQ,MAAM,GAAG;AAC/C,eAAW,QAAQ,CAAC,QAAQ,QAAQ,IAAI,QAAQ,MAAM,CAAC;AAAA,EACzD;AACA,QAAM,YAAY,WACf,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,OAAO,CAAC,CAAC,CAAC,EAAE,EAChD,KAAK,GAAG;AACX,YAAU,GAAG,SAAS,IAAI,OAAO;AAEjC,MAAI,SAAS,KAAK;AAChB,cAAU,MAAM,YAAY,QAAQ,GAAG,CAAC,OAAO,OAAO;AAAA,EACxD;AAEA,MAAI,SAAS,YAAY;AACvB,cAAU,eAAe,YAAY,OAAO,CAAC;AAAA,EAC/C;AAEA,SAAO;AACT;AAEA,eAAe,WAAW,SAAwB,SAAwC;AACxF,SAAO;AAAA,IACL,QAAQ;AAAA,IACR;AAAA,IACA,cAAc,mBAAmB,QAAQ,KAAK,EAAE,CAAC;AAAA,IACjD,EAAE,QAAQ;AAAA,EACZ;AACF;AAEA,IAAM,YAAY,eAA4C;AAAA,EAC5D,MAAM;AAAA,EACN,SAAS;AAAA,IACP,SAAS;AAAA,MACP,QAAQ,OAAO,QAAsB,YAAmC;AACtE,cAAM,WAAW,cAAc,MAAM;AACrC,cAAM,QAAS,SAAS,QAA+B,iBAAiB,GAAG,KAAK;AAChF,cAAM,UAAU,MAAM;AAAA,UACpB;AAAA,UACA;AAAA,UACA;AAAA,UACA,EAAE,KAAK;AAAA,QACT;AACA,cAAM,OAAO,MAAM;AAAA,UACjB;AAAA,UACA;AAAA,UACA,cAAc,mBAAmB,QAAQ,MAAM,CAAC;AAAA,QAClD;AACA,eAAO;AAAA,UACL,SAAS,EAAE,MAAM,UAAU,WAAW,oBAAI,KAAK,EAAE;AAAA,UACjD,WAAW,KAAK;AAAA,QAClB;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,QAAsB,cAAsB;AAC1D,cAAM,WAAW,cAAc,MAAM;AAErC,YAAI;AACF,gBAAM,OAAO,MAAM;AAAA,YACjB;AAAA,YACA;AAAA,YACA,cAAc,mBAAmB,SAAS,CAAC;AAAA,UAC7C;AACA,iBAAO;AAAA,YACL,SAAS,EAAE,MAAM,UAAU,WAAW,oBAAI,KAAK,EAAE;AAAA,YACjD,WAAW,KAAK;AAAA,UAClB;AAAA,QACF,QAAQ;AAAA,QAER;AACA,YAAI;AACF,gBAAM,OAAO,MAAM,iBAAiB,UAAU,SAAS;AACvD,cAAI,CAAC,KAAM,QAAO;AAClB,iBAAO;AAAA,YACL,SAAS,EAAE,MAAM,UAAU,WAAW,oBAAI,KAAK,EAAE;AAAA,YACjD,WAAW,KAAK;AAAA,UAClB;AAAA,QACF,QAAQ;AACN,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,MAEA,MAAM,OAAO,WAAyB;AACpC,cAAM,WAAW,cAAc,MAAM;AACrC,cAAM,QAAQ,MAAM,QAAwB,UAAU,OAAO,YAAY;AACzE,eAAO,MAAM,IAAI,CAAC,UAAU;AAAA,UAC1B,SAAS,EAAE,MAAM,UAAU,WAAW,oBAAI,KAAK,EAAE;AAAA,UACjD,WAAW,KAAK;AAAA,QAClB,EAAE;AAAA,MACJ;AAAA,MAEA,SAAS,OAAO,QAAsB,cAAsB;AAC1D,cAAM,WAAW,cAAc,MAAM;AACrC,cAAM;AAAA,UACJ;AAAA,UACA;AAAA,UACA,cAAc,mBAAmB,SAAS,CAAC;AAAA,QAC7C;AAAA,MACF;AAAA,MAEA,YAAY,OACV,SACA,SACA,YAC2B;AAC3B,cAAM,YAAY,KAAK,IAAI;AAC3B,YAAI;AACF,gBAAM,SAAS,MAAM,WAAW,SAAS,YAAY,SAAS,OAAO,CAAC;AACtE,iBAAO;AAAA,YACL,QAAQ,OAAO,UAAU;AAAA,YACzB,QAAQ,OAAO,UAAU;AAAA,YACzB,UAAU,OAAO;AAAA,YACjB,YAAY,KAAK,IAAI,IAAI;AAAA,UAC3B;AAAA,QACF,SAAS,OAAO;AACd,iBAAO;AAAA,YACL,QAAQ;AAAA,YACR,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,YAC7D,UAAU;AAAA,YACV,YAAY,KAAK,IAAI,IAAI;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAAA,MAEA,SAAS,OACP,SACA,MACA,SACA,YACwB;AACxB,YAAI,CAAC,SAAS;AACZ,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AAAA,QACF;AACA,YAAI,YAAY,UAAU,YAAY,UAAU;AAC9C,gBAAM,IAAI;AAAA,YACR,4CAA4C,OAAO;AAAA,UACrD;AAAA,QACF;AACA,cAAM,cAAc,YAAY,WAAW,YAAY;AACvD,cAAM,OAAO,YAAY,WAAW,OAAO;AAC3C,cAAM,UAAU,GAAG,WAAW,IAAI,IAAI,IAAI,YAAY,IAAI,CAAC;AAE3D,cAAM,SAAS,MAAM,WAAW,SAAS,OAAO;AAChD,cAAM,SAAS,OAAO,UAAU;AAChC,cAAM,SAAS,OAAO,UAAU;AAChC,cAAM,SAAS,SAAS,GAAG,MAAM,GAAG,UAAU,SAAS,OAAO,EAAE,GAAG,MAAM,KAAK;AAE9E,YAAI,OAAO,aAAa,GAAG;AACzB,gBAAM,qBACJ,YAAY,WACR,oCACA;AACN,cAAI,mBAAmB,KAAK,MAAM,GAAG;AACnC,kBAAM,IAAI,MAAM,UAAU,GAAG,OAAO,eAAe;AAAA,UACrD;AAAA,QACF;AAEA,eAAO;AAAA,UACL;AAAA,UACA,UAAU,OAAO;AAAA,UACjB,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,YAAiD;AAC/D,eAAO;AAAA,UACL,IAAI,QAAQ,KAAK;AAAA,UACjB,UAAU;AAAA,UACV,SAAS;AAAA,UACT,QAAQ,QAAQ,KAAK,WAAW,UAAU,YAAY;AAAA,UACtD,WAAW,IAAI,KAAK,QAAQ,KAAK,SAAS;AAAA,UAC1C,SAAS;AAAA,UACT,UAAU;AAAA,YACR,MAAM,QAAQ,KAAK;AAAA,YACnB,cAAc,QAAQ,KAAK;AAAA,YAC3B,QAAQ,QAAQ,KAAK;AAAA,YACrB,UAAU,QAAQ,KAAK;AAAA,UACzB;AAAA,QACF;AAAA,MACF;AAAA,MAEA,QAAQ,OACN,UACA,YACoB;AACpB,cAAM,IAAI;AAAA,UACR,sJACsD,QAAQ,IAAI;AAAA,QAEpE;AAAA,MACF;AAAA,MAEA,YAAY;AAAA,QACV,UAAU,OAAO,SAAS,MAAM,eAAe;AAC7C,gBAAM,SAAS,MAAM,WAAW,SAAS,OAAO,YAAY,IAAI,CAAC,EAAE;AACnE,cAAI,OAAO,aAAa,GAAG;AACzB,kBAAM,IAAI,MAAM,kBAAkB,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,UAC5D;AACA,iBAAO,OAAO;AAAA,QAChB;AAAA,QAEA,WAAW,OAAO,SAAS,MAAM,SAAS,eAAe;AACvD,gBAAM,SAAS,KAAK,UAAU,GAAG,KAAK,YAAY,GAAG,CAAC;AACtD,cAAI,QAAQ;AACV,kBAAM,WAAW,SAAS,YAAY,YAAY,MAAM,CAAC,EAAE;AAAA,UAC7D;AAEA,gBAAM,UAAU,OAAO,KAAK,SAAS,MAAM,EAAE,SAAS,QAAQ;AAC9D,gBAAM,SAAS,MAAM;AAAA,YACnB;AAAA,YACA,aAAa,YAAY,OAAO,CAAC,kBAAkB,YAAY,IAAI,CAAC;AAAA,UACtE;AACA,cAAI,OAAO,aAAa,GAAG;AACzB,kBAAM,IAAI,MAAM,mBAAmB,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,UAC7D;AAAA,QACF;AAAA,QAEA,OAAO,OAAO,SAAS,MAAM,eAAe;AAC1C,gBAAM,SAAS,MAAM,WAAW,SAAS,YAAY,YAAY,IAAI,CAAC,EAAE;AACxE,cAAI,OAAO,aAAa,GAAG;AACzB,kBAAM,IAAI,MAAM,8BAA8B,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,UACxE;AAAA,QACF;AAAA,QAEA,SAAS,OAAO,SAAS,MAAM,eAAe;AAE5C,gBAAM,SAAS,MAAM;AAAA,YACnB;AAAA,YACA,QAAQ,YAAY,IAAI,CAAC;AAAA,UAC3B;AACA,cAAI,OAAO,aAAa,GAAG;AACzB,kBAAM,IAAI,MAAM,4BAA4B,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,UACtE;AACA,gBAAM,UAAuB,CAAC;AAC9B,qBAAW,QAAQ,OAAO,OAAO,MAAM,IAAI,GAAG;AAC5C,gBAAI,CAAC,KAAM;AACX,kBAAM,CAAC,UAAU,SAAS,UAAU,GAAG,SAAS,IAAI,KAAK,MAAM,GAAI;AACnE,kBAAM,OAAO,UAAU,KAAK,GAAI;AAChC,oBAAQ,KAAK;AAAA,cACX;AAAA,cACA,MAAM,aAAa,MAAM,cAAc;AAAA,cACvC,MAAM,SAAS,SAAS,EAAE,KAAK;AAAA,cAC/B,UAAU,IAAI,KAAK,WAAW,QAAQ,IAAI,GAAI;AAAA,YAChD,CAAC;AAAA,UACH;AACA,iBAAO;AAAA,QACT;AAAA,QAEA,QAAQ,OAAO,SAAS,MAAM,eAAe;AAC3C,gBAAM,SAAS,MAAM,WAAW,SAAS,WAAW,YAAY,IAAI,CAAC,EAAE;AACvE,iBAAO,OAAO,aAAa;AAAA,QAC7B;AAAA,QAEA,QAAQ,OAAO,SAAS,MAAM,eAAe;AAC3C,gBAAM,SAAS,MAAM,WAAW,SAAS,UAAU,YAAY,IAAI,CAAC,EAAE;AACtE,cAAI,OAAO,aAAa,GAAG;AACzB,kBAAM,IAAI,MAAM,oBAAoB,IAAI,KAAK,OAAO,MAAM,EAAE;AAAA,UAC9D;AAAA,QACF;AAAA,MACF;AAAA,MAEA,aAAa,CAAC,YAA0C;AAAA,IAC1D;AAAA,EACF;AACF,CAAC;AAEM,IAAM,SAAS,CAAC,SAAuB,CAAC,MAAM,UAAU,MAAM;","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@computesdk/archil",
+  "version": "0.2.0",
+  "description": "Archil provider for ComputeSDK - exec commands against an Archil disk",
+  "author": "ComputeSDK",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "computesdk": "2.6.0",
+    "@computesdk/provider": "1.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@computesdk/test-utils": "1.6.1"
+  },
+  "keywords": [
+    "computesdk",
+    "archil",
+    "exec",
+    "code-execution",
+    "provider",
+    "disk"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/archil"
+  },
+  "homepage": "https://www.computesdk.com",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint"
+  }
+}