@replayio/app-building 1.27.0 → 1.29.0

package/README.md

@@ -80,7 +80,8 @@ The agent can also run `list-secrets` to see which secrets are available, and `s
 
 | Export | Description |
 |---|---|
-| `ContainerConfig` | `infisical` (required `InfisicalConfig`), optional `projectRoot` (local Docker only), `registry`, `flyToken`/`flyApp` (set both for remote Fly.io), `imageRef`, `webhookUrl`/`webhookSecret`, `taskWebhookUrl` (GET endpoint for external task queue), `addTaskWebhookUrl` (POST endpoint for tasks added by `add-task` script), `detached`, `initialPrompt`, `localPort`, `absorbTasks`, `namePrefix` (default: `"app-building"`). |
+| `ContainerConfig` | `infisical` (required `InfisicalConfig`), optional `projectRoot` (local Docker only), `registry`, `flyToken`/`flyApp` (set both for remote Fly.io), `flyGuest` (override Fly Machine guest sizing; default: 16 performance CPUs / 32 GiB), `flyVolumeSizeGb` (override Fly Volume size in GiB; default: 50), `imageRef`, `webhookUrl`/`webhookSecret`, `taskWebhookUrl` (GET endpoint for external task queue), `addTaskWebhookUrl` (POST endpoint for tasks added by `add-task` script), `detached`, `initialPrompt`, `localPort`, `absorbTasks`, `namePrefix` (default: `"app-building"`). |
+| `FlyGuest` | Fly Machine guest spec: `cpu_kind` (`"shared"` \| `"performance"`), `cpus`, `memory_mb`. |
 | `RepoOptions` | Per-invocation git settings: `repoUrl`, `cloneBranch`, `pushBranch`. |
 | `AgentState` | Returned by `startContainer`. Contains `type`, `containerName`, `port`, `baseUrl`, and Fly-specific fields for remote containers. |
 | `ContainerRegistry` | Interface for container registry storage. Methods: `log`, `markStopped`, `clearStopped`, `getRecent`, `find`, `findAlive`. |

package/dist/index.d.ts

@@ -74,6 +74,12 @@ declare function createBranchSecret(config: InfisicalConfig, branch: string, nam
  */
 declare function getInfisicalConfig(envVars: Record<string, string>): Promise<InfisicalConfig>;
 
+interface FlyGuest {
+    cpu_kind: "shared" | "performance";
+    cpus: number;
+    memory_mb: number;
+}
+
 interface AgentState {
     type: "local" | "remote";
     containerName: string;
@@ -109,11 +115,16 @@ interface ContainerConfig {
     namePrefix?: string;
     /** Agent command override (e.g. "codex", "gemini"). Default: "claude". */
     agentCommand?: string;
+    /** Override the Fly Machine guest sizing. Default: 16 performance CPUs, 32 GiB memory. */
+    flyGuest?: FlyGuest;
+    /** Override the Fly Volume size in GiB. Default: 50. */
+    flyVolumeSizeGb?: number;
 }
 interface RepoOptions {
     repoUrl: string;
     cloneBranch: string;
-    pushBranch: string;
+    /** If omitted, the container clones the repo but never commits or pushes. */
+    pushBranch?: string;
 }
 declare function loadDotEnv(projectRoot: string): Record<string, string>;
 declare function buildImage(config: ContainerConfig): void;
@@ -121,7 +132,7 @@ declare function buildImage(config: ContainerConfig): void;
  * Start a container (local Docker or remote Fly.io based on config).
  * If flyToken and flyApp are set, starts remotely; otherwise locally.
  */
-declare function startContainer(config: ContainerConfig, repo: RepoOptions): Promise<AgentState>;
+declare function startContainer(config: ContainerConfig, repo: RepoOptions | null): Promise<AgentState>;
 /**
  * Stop a container by its state or registry entry.
  */
@@ -185,4 +196,4 @@ interface Task {
  */
 declare function findReadyTask(pendingTasks: Task[], completedTasks: Pick<Task, "id" | "parentTaskId">[]): Task | null;
 
-export { type AgentState, type ContainerConfig, type ContainerRegistry, FileContainerRegistry, type HttpOptions, type InfisicalConfig, type RegistryEntry, type RepoOptions, type Task, buildImage, createBranchSecret, fetchBranchSecrets, fetchGlobalSecrets, fetchInfisicalSecrets, findReadyTask, getImageRef, getInfisicalConfig, httpGet, httpOptsFor, httpPost, infisicalLogin, loadDotEnv, probeAlive, spawnTestContainer, startContainer, stopContainer };
+export { type AgentState, type ContainerConfig, type ContainerRegistry, FileContainerRegistry, type FlyGuest, type HttpOptions, type InfisicalConfig, type RegistryEntry, type RepoOptions, type Task, buildImage, createBranchSecret, fetchBranchSecrets, fetchGlobalSecrets, fetchInfisicalSecrets, findReadyTask, getImageRef, getInfisicalConfig, httpGet, httpOptsFor, httpPost, infisicalLogin, loadDotEnv, probeAlive, spawnTestContainer, startContainer, stopContainer };

package/dist/index.js

@@ -39,13 +39,21 @@ async function deleteVolume(app, token, volumeId) {
     method: "DELETE"
   });
 }
-async function createMachine(app, token, image, env, name) {
+var DEFAULT_GUEST = {
+  cpu_kind: "performance",
+  cpus: 16,
+  memory_mb: 32768
+};
+var DEFAULT_VOLUME_SIZE_GB = 50;
+async function createMachine(app, token, image, env, name, options = {}) {
+  const guest = options.guest ?? DEFAULT_GUEST;
+  const volumeSizeGb = options.volumeSizeGb ?? DEFAULT_VOLUME_SIZE_GB;
   const volumeName = `repo_${name.replace(/-/g, "_")}`.slice(0, 30);
   const regions = ["dfw", "iad", "ord", "sjc"];
   let cleanupDone;
   for (const region of regions) {
     console.log(`Creating machine in region ${region}...`);
-    const volumeId = await createVolume(app, token, volumeName, region, 50);
+    const volumeId = await createVolume(app, token, volumeName, region, volumeSizeGb);
     if (!cleanupDone) {
       cleanupDone = listVolumes(app, token).then((vols) => Promise.all(
         vols.map(async ({ id, attached_machine_id }) => {
@@ -67,11 +75,7 @@ async function createMachine(app, token, image, env, name) {
             env,
             auto_destroy: true,
             restart: { policy: "on-failure", max_retries: 3 },
-            guest: {
-              cpu_kind: "performance",
-              cpus: 16,
-              memory_mb: 32768
-            },
+            guest,
             mounts: [{ volume: volumeId, path: "/repo" }],
             services: [
               {
@@ -215,19 +219,25 @@ function findFreePort() {
 }
 function buildContainerEnv(repo, infisical, extra = {}) {
   const env = {
-    REPO_URL: repo.repoUrl,
-    CLONE_BRANCH: repo.cloneBranch,
-    PUSH_BRANCH: repo.pushBranch,
-    GIT_AUTHOR_NAME: "App Builder",
-    GIT_AUTHOR_EMAIL: "app-builder@localhost",
-    GIT_COMMITTER_NAME: "App Builder",
-    GIT_COMMITTER_EMAIL: "app-builder@localhost",
     PLAYWRIGHT_BROWSERS_PATH: "/opt/playwright",
     INFISICAL_TOKEN: infisical.token,
     INFISICAL_PROJECT_ID: infisical.projectId,
     INFISICAL_ENVIRONMENT: infisical.environment,
     ...extra
   };
+  if (repo) {
+    env.REPO_URL = repo.repoUrl;
+    env.CLONE_BRANCH = repo.cloneBranch;
+    if (repo.pushBranch) {
+      env.PUSH_BRANCH = repo.pushBranch;
+      env.GIT_AUTHOR_NAME = "App Builder";
+      env.GIT_AUTHOR_EMAIL = "app-builder@localhost";
+      env.GIT_COMMITTER_NAME = "App Builder";
+      env.GIT_COMMITTER_EMAIL = "app-builder@localhost";
+    }
+  } else {
+    env.NO_REPO = "1";
+  }
   if (process.env.DEBUG) {
     env.DEBUG = process.env.DEBUG;
   }
@@ -342,7 +352,10 @@ async function startRemoteContainerImpl(config, repo) {
   let volumeId = "";
   for (let attempt = 0; attempt < 5; attempt++) {
     try {
-      const result = await createMachine(config.flyApp, config.flyToken, imageRef, containerEnv, machineName);
+      const result = await createMachine(config.flyApp, config.flyToken, imageRef, containerEnv, machineName, {
+        guest: config.flyGuest,
+        volumeSizeGb: config.flyVolumeSizeGb
+      });
       machineId = result.machineId;
       volumeId = result.volumeId;
       break;

package/package.json

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