@replayio/app-building 1.22.0 → 1.23.0

package/README.md

@@ -182,6 +182,21 @@ 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.
 
+### Task structure
+
+Each task in the queue (local or webhook) has the following fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | Auto-assigned | UUID for coordination. Auto-assigned by `add-task` if not provided. Included in `task.started`/`task.done` webhook events. |
+| `skill` | `string` | Yes | Path to the skill file (e.g. `skills/tasks/build/writeApp.md`). |
+| `subtasks` | `string[]` | Yes | List of subtask descriptions. |
+| `app` | `string` | No | App name (directory under `apps/`). |
+| `prompt` | `string` | No | Raw prompt for message-derived tasks (no skill file). |
+| `command` | `string` | No | Custom command to run instead of the default `claude` CLI. |
+| `maxAttempts` | `number` | No | Maximum attempts before giving up. Default: 5. |
+| `timeoutMinutes` | `number` | No | Per-attempt time limit in minutes. Agent is killed if exceeded. |
+
 ### External task queue
 
 Set `config.taskWebhookUrl` to a GET endpoint that returns tasks to process. When the
@@ -192,8 +207,7 @@ local task queue is empty, the container GETs this URL (with the same `Bearer` t
 - `{}` 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`.
+Tasks use the same structure documented above.
 
 ## Webhooks
 
@@ -231,8 +245,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`, `skill`, `subtasks`, `prompt` |
-| `task.done` | Task processing complete | `skill`, `subtasks`, `prompt`, `cost`, `totalCost`, `failed`, `pendingTasks`, `duration_ms` |
+| `task.started` | Task processing begins | `id`, `iteration`, `skill`, `subtasks`, `prompt` |
+| `task.done` | Task processing complete | `id`, `skill`, `subtasks`, `prompt`, `cost`, `totalCost`, `failed`, `pendingTasks`, `duration_ms` |
 | `log` | Each log line | `line` |
 
 ### Example

package/package.json

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