@replayio/app-building 1.20.0 → 1.22.0

package/README.md

@@ -80,7 +80,7 @@ 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`, `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), `imageRef`, `webhookUrl`/`webhookSecret`, `taskWebhookUrl` (GET endpoint for external task queue), `detached`, `initialPrompt`, `localPort`, `absorbTasks`, `namePrefix` (default: `"app-building"`). |
 | `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`. |
@@ -182,6 +182,19 @@ Set `config.absorbTasks = true` to have the container absorb task files from oth
 at startup. This is off by default. When enabled, the container scans `tasks/` for task files
 belonging to other containers, merges their tasks into its own queue, and deletes the foreign files.
 
+### External task queue
+
+Set `config.taskWebhookUrl` to a GET endpoint that returns tasks to process. When the
+local task queue is empty, the container GETs this URL (with the same `Bearer` token from
+`webhookSecret`) and expects a JSON response:
+
+- `{ "tasks": [{ "skill": "...", "subtasks": [...], ... }, ...] }` — process these tasks
+- `{}` or `{ "tasks": [] }` — no tasks available, go idle
+
+The first task is processed immediately; any remaining tasks are added to the local queue.
+Tasks support the same fields as local tasks: `skill`, `subtasks`, `app`, `command`,
+`maxAttempts`, `timeoutMinutes`.
+
 ## Webhooks
 
 Set `webhookUrl` on `ContainerConfig` to receive real-time notifications of container activity. The container POSTs JSON to that URL on key events (no retries; failures are logged to stderr). Set `webhookSecret` to include a `Bearer` token in the `Authorization` header for authenticating webhook requests.

package/dist/container.d.ts

@@ -19,6 +19,8 @@ export interface ContainerConfig {
     imageRef?: string;
     webhookUrl?: string;
     webhookSecret?: string;
+    /** GET endpoint to fetch the next task when the local queue is empty. Uses webhookSecret for auth. */
+    taskWebhookUrl?: string;
     /** Start the container in detached mode. It will exit after processing all messages and tasks. */
     detached?: boolean;
     /** Initial prompt to queue at container startup (before the HTTP server accepts external requests). */

package/dist/container.js

@@ -35,7 +35,7 @@ export function buildImage(config) {
     if (!config.projectRoot)
         throw new Error("projectRoot is required for local Docker operations");
     console.log("Building Docker image...");
-    execFileSync("docker", ["build", "--network", "host", "-t", IMAGE_NAME, config.projectRoot], {
+    execFileSync("docker", ["build", "--platform", "linux/amd64", "--network", "host", "-t", IMAGE_NAME, config.projectRoot], {
         stdio: "inherit",
         timeout: 600000,
     });
@@ -49,7 +49,7 @@ function ensureImageExists(projectRoot) {
     }
     catch {
         console.log("Building Docker image...");
-        execFileSync("docker", ["build", "--network", "host", "-t", IMAGE_NAME, projectRoot], {
+        execFileSync("docker", ["build", "--platform", "linux/amd64", "--network", "host", "-t", IMAGE_NAME, projectRoot], {
             stdio: "inherit",
             timeout: 600000,
         });
@@ -102,6 +102,8 @@ function buildExtraEnv(config, containerName) {
     };
     if (config.webhookUrl)
         extra.WEBHOOK_URL = config.webhookUrl;
+    if (config.taskWebhookUrl)
+        extra.TASK_WEBHOOK_URL = config.taskWebhookUrl;
     if (config.webhookSecret)
         extra.WEBHOOK_SECRET = config.webhookSecret;
     if (config.detached)
@@ -128,7 +130,7 @@ async function startLocalContainer(config, repo) {
     const extra = buildExtraEnv(config, containerName);
     extra.PORT = String(containerPort);
     const containerEnv = buildContainerEnv(repo, config.infisical, extra);
-    const args = ["run", "-d", "--rm", "--name", containerName];
+    const args = ["run", "--platform", "linux/amd64", "-d", "--rm", "--name", containerName];
     args.push("-p", `${hostPort}:${containerPort}`);
     for (const [k, v] of Object.entries(containerEnv)) {
         args.push("--env", `${k}=${v}`);
@@ -331,7 +333,7 @@ export function spawnTestContainer(config) {
     ensureImageExists(config.projectRoot);
     const uniqueId = Math.random().toString(36).slice(2, 8);
     const containerName = `app-building-test-${uniqueId}`;
-    const args = ["run", "-it", "--rm", "--name", containerName];
+    const args = ["run", "--platform", "linux/amd64", "-it", "--rm", "--name", containerName];
     args.push("-v", `${config.projectRoot}:/repo`);
     args.push("-w", "/repo");
     args.push("--network", "host");

package/package.json

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