@replayio/app-building 1.5.0 → 1.7.0

package/README.md

@@ -108,12 +108,15 @@ await stopRemoteContainer(config, state);
 | Export | Description |
 |---|---|
 | `createApp(token, name, org?)` | Create a Fly app and allocate IPs. |
-| `createMachine(app, token, image, env, name)` | Create a Fly machine. Returns machine ID. |
+| `createMachine(app, token, image, env, name, volumeId?)` | Create a Fly machine. If `volumeId` is provided, mounts it at `/repo`. Returns machine ID. |
 | `waitForMachine(app, token, machineId, timeout?)` | Wait for a machine to reach `started` state. |
 | `destroyMachine(app, token, machineId)` | Force-destroy a machine. |
 | `listMachines(app, token)` | List all machines for an app. |
+| `createVolume(app, token, name, sizeGb?)` | Create a Fly volume (default 50 GB). Returns volume ID. |
+| `deleteVolume(app, token, volumeId)` | Delete a Fly volume. |
+| `listVolumes(app, token)` | List all volumes for an app. |
 
-**Types:** `FlyMachineInfo`
+**Types:** `FlyMachineInfo`, `FlyVolumeInfo`
 
 ### Image ref
 
@@ -190,8 +193,8 @@ Every POST body has this shape:
 | `message.started` | Message processing begins | `iteration`, `prompt` |
 | `message.done` | Message processing complete | `messageId`, `cost_usd`, `duration_ms`, `num_turns` |
 | `message.error` | Message processing failed | `messageId`, `error` |
-| `task.started` | Task processing begins | `iteration`, `pendingTasks` |
-| `task.done` | Task processing complete | `tasksProcessed`, `totalCost` |
+| `task.started` | Task processing begins | `iteration`, `skill`, `subtasks` |
+| `task.done` | Task processing complete | `skill`, `cost`, `totalCost`, `failed` |
 | `log` | Each log line | `line` |
 
 ### Example

package/dist/container.d.ts

@@ -6,6 +6,7 @@ export interface AgentState {
     baseUrl: string;
     flyApp?: string;
     flyMachineId?: string;
+    flyVolumeId?: string;
 }
 export interface ContainerConfig {
     projectRoot?: string;

package/dist/container.js

@@ -1,7 +1,7 @@
 import { execFileSync, spawn } from "child_process";
 import { readFileSync, existsSync } from "fs";
 import { resolve } from "path";
-import { createMachine, waitForMachine, destroyMachine, listMachines } from "./fly";
+import { createMachine, waitForMachine, destroyMachine, listMachines, createVolume, deleteVolume } from "./fly";
 import { getImageRef } from "./image-ref";
 const IMAGE_NAME = "app-building";
 function debugLog(...args) {
@@ -215,12 +215,16 @@ export async function startRemoteContainer(config, repo) {
             console.log(`  ${m.id} (${m.name}) — ${m.state}`);
         }
     }
+    // Create a volume for /repo storage
+    console.log("Creating Fly volume...");
+    const volumeId = await createVolume(config.flyApp, config.flyToken, `repo-${uniqueId}`);
+    console.log(`Volume created: ${volumeId}`);
     // Retry machine creation — the registry tag may take a moment to propagate
     console.log("Creating Fly machine...");
     let machineId = "";
     for (let attempt = 0; attempt < 5; attempt++) {
         try {
-            machineId = await createMachine(config.flyApp, config.flyToken, imageRef, containerEnv, machineName);
+            machineId = await createMachine(config.flyApp, config.flyToken, imageRef, containerEnv, machineName, volumeId);
             break;
         }
         catch (err) {
@@ -230,6 +234,8 @@ export async function startRemoteContainer(config, repo) {
                 await new Promise((r) => setTimeout(r, 5000));
                 continue;
             }
+            // Clean up volume if machine creation fails
+            await deleteVolume(config.flyApp, config.flyToken, volumeId).catch(() => { });
             throw err;
         }
     }
@@ -243,6 +249,7 @@ export async function startRemoteContainer(config, repo) {
         baseUrl,
         flyApp: config.flyApp,
         flyMachineId: machineId,
+        flyVolumeId: volumeId,
     };
     config.registry.log(agentState);
     console.log("Waiting for machine to start...");
@@ -269,9 +276,10 @@ export async function startRemoteContainer(config, repo) {
         await new Promise((r) => setTimeout(r, interval));
     }
     if (!ready) {
-        // Clean up machine if we can't reach it
+        // Clean up machine and volume if we can't reach it
         console.log("Timed out waiting for machine, destroying...");
         await destroyMachine(config.flyApp, config.flyToken, machineId).catch(() => { });
+        await deleteVolume(config.flyApp, config.flyToken, volumeId).catch(() => { });
         throw new Error("Remote container did not become ready within timeout");
     }
     return agentState;
@@ -285,6 +293,13 @@ export async function stopRemoteContainer(config, state) {
     console.log(`Destroying Fly machine ${state.flyMachineId}...`);
     await destroyMachine(state.flyApp, config.flyToken, state.flyMachineId);
     console.log("Machine destroyed.");
+    if (state.flyVolumeId) {
+        console.log(`Deleting Fly volume ${state.flyVolumeId}...`);
+        await deleteVolume(state.flyApp, config.flyToken, state.flyVolumeId).catch((err) => {
+            console.log(`Warning: failed to delete volume: ${err instanceof Error ? err.message : err}`);
+        });
+        console.log("Volume deleted.");
+    }
     config.registry.markStopped(state.containerName);
 }
 export function stopContainer(config, containerName) {

package/dist/fly.d.ts

@@ -2,11 +2,21 @@
  * Create a Fly app via the Machines API and allocate IPs so .fly.dev DNS works.
  */
 export declare function createApp(token: string, name: string, org?: string): Promise<void>;
+/**
+ * Create a Fly Volume in the app's primary region.
+ * Returns the volume ID.
+ */
+export declare function createVolume(app: string, token: string, name: string, sizeGb?: number): Promise<string>;
+/**
+ * Delete a Fly Volume.
+ */
+export declare function deleteVolume(app: string, token: string, volumeId: string): Promise<void>;
 /**
  * Create a Fly Machine with the given image and env vars.
+ * If volumeId is provided, it is mounted at /repo.
  * Returns the machine ID.
  */
-export declare function createMachine(app: string, token: string, image: string, env: Record<string, string>, name: string): Promise<string>;
+export declare function createMachine(app: string, token: string, image: string, env: Record<string, string>, name: string, volumeId?: string): Promise<string>;
 /**
  * Wait for a Fly Machine to reach the "started" state.
  */
@@ -26,3 +36,16 @@ export interface FlyMachineInfo {
  * List all machines for a Fly app.
  */
 export declare function listMachines(app: string, token: string): Promise<FlyMachineInfo[]>;
+export interface FlyVolumeInfo {
+    id: string;
+    name: string;
+    state: string;
+    size_gb: number;
+    region: string;
+    created_at: string;
+    attached_machine_id: string | null;
+}
+/**
+ * List all volumes for a Fly app.
+ */
+export declare function listVolumes(app: string, token: string): Promise<FlyVolumeInfo[]>;

package/dist/fly.js

@@ -52,39 +52,66 @@ export async function createApp(token, name, org) {
     await gqlFetch(allocateMutation, { input: { appId: name, type: "v6" } });
 }
 /**
- * Create a Fly Machine with the given image and env vars.
- * Returns the machine ID.
+ * Create a Fly Volume in the app's primary region.
+ * Returns the volume ID.
  */
-export async function createMachine(app, token, image, env, name) {
-    const res = await flyFetch(`/apps/${app}/machines`, token, {
+export async function createVolume(app, token, name, sizeGb = 50) {
+    const res = await flyFetch(`/apps/${app}/volumes`, token, {
         method: "POST",
         body: JSON.stringify({
             name,
-            config: {
-                image,
-                env,
-                auto_destroy: true,
-                restart: { policy: "no" },
-                guest: {
-                    cpu_kind: "performance",
-                    cpus: 16,
-                    memory_mb: 32768,
-                },
-                services: [
-                    {
-                        ports: [{ port: 443, handlers: ["tls", "http"] }],
-                        protocol: "tcp",
-                        internal_port: 3000,
-                        autostart: false,
-                        autostop: "off",
-                    },
-                ],
-            },
+            size_gb: sizeGb,
+            encrypted: true,
+            require_unique_zone: false,
         }),
     });
     const data = (await res.json());
     return data.id;
 }
+/**
+ * Delete a Fly Volume.
+ */
+export async function deleteVolume(app, token, volumeId) {
+    await flyFetch(`/apps/${app}/volumes/${volumeId}`, token, {
+        method: "DELETE",
+    });
+}
+/**
+ * Create a Fly Machine with the given image and env vars.
+ * If volumeId is provided, it is mounted at /repo.
+ * Returns the machine ID.
+ */
+export async function createMachine(app, token, image, env, name, volumeId) {
+    const config = {
+        image,
+        env,
+        auto_destroy: true,
+        restart: { policy: "no" },
+        guest: {
+            cpu_kind: "performance",
+            cpus: 16,
+            memory_mb: 32768,
+        },
+        services: [
+            {
+                ports: [{ port: 443, handlers: ["tls", "http"] }],
+                protocol: "tcp",
+                internal_port: 3000,
+                autostart: false,
+                autostop: "off",
+            },
+        ],
+    };
+    if (volumeId) {
+        config.mounts = [{ volume: volumeId, path: "/repo" }];
+    }
+    const res = await flyFetch(`/apps/${app}/machines`, token, {
+        method: "POST",
+        body: JSON.stringify({ name, config }),
+    });
+    const data = (await res.json());
+    return data.id;
+}
 /**
  * Wait for a Fly Machine to reach the "started" state.
  */
@@ -117,3 +144,10 @@ export async function listMachines(app, token) {
     const res = await flyFetch(`/apps/${app}/machines`, token);
     return (await res.json());
 }
+/**
+ * List all volumes for a Fly app.
+ */
+export async function listVolumes(app, token) {
+    const res = await flyFetch(`/apps/${app}/volumes`, token);
+    return (await res.json());
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@replayio/app-building",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Library for managing agentic app-building containers",
   "type": "module",
   "exports": {