@freestyle-sh/with-uv 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# @freestyle-sh/with-uv
+
+Python runtime via [uv](https://github.com/astral-sh/uv) for [Freestyle](https://freestyle.sh) VMs.
+
+## Installation
+
+```bash
+npm install @freestyle-sh/with-uv freestyle-sandboxes
+```
+
+## Usage
+
+```typescript
+import { freestyle } from "freestyle-sandboxes";
+import { VmUv } from "@freestyle-sh/with-uv";
+
+const { vm } = await freestyle.vms.create({
+  with: {
+    uv: new VmUv(),
+  },
+});
+
+const res = await vm.uv.runCode(
+  "import json; print(json.dumps({ 'hello': 'world' }))"
+);
+
+console.log(res);
+// { result: { hello: 'world' }, stdout: '{"hello": "world"}\n', statusCode: 0 }
+```
+
+## Options
+
+```typescript
+new VmUv({
+  version: "0.5.0",      // Optional: specific uv version
+  pythonVersion: "3.13", // Optional: Python version (default: "3.14")
+})
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `version` | `string` | `undefined` | uv version to install. If not specified, installs the latest version. |
+| `pythonVersion` | `string` | `"3.14"` | Python version to install via uv. |
+
+## API
+
+### `vm.uv.runCode(code: string)`
+
+Executes Python code using uv's managed Python runtime.
+
+**Returns:** `Promise<RunCodeResponse>`
+
+```typescript
+type RunCodeResponse<Result> = {
+  result: Result;      // Parsed JSON from stdout (if valid JSON)
+  stdout?: string;     // Raw stdout output
+  stderr?: string;     // Raw stderr output
+  statusCode?: number; // Exit code
+};
+```
+
+## Documentation
+
+- [Freestyle Documentation](https://docs.freestyle.sh)
+- [uv Documentation](https://docs.astral.sh/uv/)

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { VmWith, VmWithInstance, CreateVmOptions } from 'freestyle-sandboxes';
+import { VmRunCodeInstance, JSONValue, RunCodeResponse, VmRunCode } from '@freestyle-sh/with-type-run-code';
+
+type UvOptions = {
+    version?: string;
+    pythonVersion?: string;
+};
+type UvResolvedOptions = {
+    version?: string;
+    pythonVersion: string;
+};
+declare class VmUv extends VmWith<VmUvInstance> implements VmRunCode<VmRunCodeInstance> {
+    options: UvResolvedOptions;
+    constructor(options?: UvOptions);
+    configure(existingConfig: CreateVmOptions): CreateVmOptions | Promise<CreateVmOptions>;
+    createInstance(): VmUvInstance;
+    installServiceName(): string;
+}
+declare class VmUvInstance extends VmWithInstance implements VmRunCodeInstance {
+    builder: VmUv;
+    constructor(builder: VmUv);
+    runCode<Result extends JSONValue = any>(code: string): Promise<RunCodeResponse<Result>>;
+}
+
+export { VmUv };

package/dist/index.js

@@ -0,0 +1,81 @@
+import { VmWith, VmTemplate, VmWithInstance } from 'freestyle-sandboxes';
+
+class VmUv extends VmWith {
+  options;
+  constructor(options) {
+    super();
+    this.options = {
+      version: options?.version,
+      pythonVersion: options?.pythonVersion ?? "3.14"
+    };
+  }
+  configure(existingConfig) {
+    const versionArg = this.options.version ? `UV_VERSION="${this.options.version}" ` : "";
+    const installScript = `#!/bin/bash
+set -e
+export UV_INSTALL_DIR="/opt/uv/bin"
+${versionArg}curl -LsSf https://astral.sh/uv/install.sh | sh
+/opt/uv/bin/uv python install ${this.options.pythonVersion}
+/opt/uv/bin/uv --version
+`;
+    const uvInit = `export PATH="/opt/uv/bin:$PATH"
+`;
+    const uvConfig = {
+      template: new VmTemplate({
+        additionalFiles: {
+          "/opt/install-uv.sh": {
+            content: installScript
+          },
+          "/etc/profile.d/uv.sh": {
+            content: uvInit
+          }
+        },
+        systemd: {
+          services: [
+            {
+              name: "install-uv",
+              mode: "oneshot",
+              deleteAfterSuccess: true,
+              exec: ["bash /opt/install-uv.sh"],
+              timeoutSec: 300
+            }
+          ]
+        }
+      })
+    };
+    return this.compose(existingConfig, uvConfig);
+  }
+  createInstance() {
+    return new VmUvInstance(this);
+  }
+  installServiceName() {
+    return "install-uv.service";
+  }
+}
+class VmUvInstance extends VmWithInstance {
+  builder;
+  constructor(builder) {
+    super();
+    this.builder = builder;
+  }
+  async runCode(code) {
+    const result = await this.vm.exec({
+      command: `/opt/uv/bin/uv run python -c "${code.replace(/"/g, '\\"')}"`
+    });
+    let parsedResult = void 0;
+    if (result.stdout) {
+      try {
+        parsedResult = JSON.parse(result.stdout);
+      } catch (e) {
+      }
+    }
+    return {
+      result: parsedResult,
+      stdout: result.stdout ?? void 0,
+      stderr: result.stderr ?? void 0,
+      statusCode: result.statusCode ?? -1
+    };
+  }
+}
+
+export { VmUv };

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@freestyle-sh/with-uv",
+  "version": "0.1.0",
+  "private": false,
+  "dependencies": {
+    "freestyle-sandboxes": "^0.1.2",
+    "@freestyle-sh/with-type-run-code": "^0.1.0"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "source": "./src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "pkgroll"
+  }
+}