@desplega.ai/agent-swarm 1.145.0 → 1.147.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.145.0",
+    "version": "1.147.0",
     "description": "Multi-agent orchestration API for Claude Code, Codex, and Gemini CLI. Enables task distribution, agent communication, and service discovery.\n\nMCP tools are documented separately in [MCP.md](./MCP.md)."
   },
   "servers": [
@@ -1463,6 +1463,7 @@
               "system.error",
               "system.profile_sync_rejected",
               "system.profile_sync_reconciled",
+              "system.profile_sync_conflict",
               "script.global_upsert",
               "schedule.deleted"
             ]
@@ -2290,7 +2291,8 @@
             "type": "string",
             "enum": [
               "text/html",
-              "application/json"
+              "application/json",
+              "image/svg+xml"
             ]
           },
           "authMode": {
@@ -2385,7 +2387,8 @@
             "type": "string",
             "enum": [
               "text/html",
-              "application/json"
+              "application/json",
+              "image/svg+xml"
             ]
           },
           "authMode": {
@@ -2759,6 +2762,44 @@
           "review"
         ]
       },
+      "RepoGuidelinesInput": {
+        "type": [
+          "object",
+          "null"
+        ],
+        "properties": {
+          "prChecks": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 50
+          },
+          "mergeChecks": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 50
+          },
+          "allowMerge": {
+            "type": "boolean",
+            "default": false
+          },
+          "review": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 50
+          }
+        },
+        "required": [
+          "prChecks",
+          "mergeChecks",
+          "review"
+        ]
+      },
       "ScriptRun": {
         "type": "object",
         "properties": {
@@ -9982,6 +10023,35 @@
                   },
                   "changeReason": {
                     "type": "string"
+                  },
+                  "expectedHashes": {
+                    "type": "object",
+                    "properties": {
+                      "soulMd": {
+                        "type": "string",
+                        "pattern": "^[0-9a-f]{64}$"
+                      },
+                      "identityMd": {
+                        "type": "string",
+                        "pattern": "^[0-9a-f]{64}$"
+                      },
+                      "toolsMd": {
+                        "type": "string",
+                        "pattern": "^[0-9a-f]{64}$"
+                      },
+                      "claudeMd": {
+                        "type": "string",
+                        "pattern": "^[0-9a-f]{64}$"
+                      },
+                      "setupScript": {
+                        "type": "string",
+                        "pattern": "^[0-9a-f]{64}$"
+                      },
+                      "heartbeatMd": {
+                        "type": "string",
+                        "pattern": "^[0-9a-f]{64}$"
+                      }
+                    }
                   }
                 }
               }
@@ -14920,6 +14990,7 @@
                       "system.error",
                       "system.profile_sync_rejected",
                       "system.profile_sync_reconciled",
+                      "system.profile_sync_conflict",
                       "script.global_upsert",
                       "schedule.deleted"
                     ]
@@ -15067,6 +15138,7 @@
                 "system.error",
                 "system.profile_sync_rejected",
                 "system.profile_sync_reconciled",
+                "system.profile_sync_conflict",
                 "script.global_upsert",
                 "schedule.deleted"
               ]
@@ -15247,6 +15319,7 @@
                             "system.error",
                             "system.profile_sync_rejected",
                             "system.profile_sync_reconciled",
+                            "system.profile_sync_conflict",
                             "script.global_upsert",
                             "schedule.deleted"
                           ]
@@ -21430,7 +21503,8 @@
                     "type": "string",
                     "enum": [
                       "text/html",
-                      "application/json"
+                      "application/json",
+                      "image/svg+xml"
                     ]
                   },
                   "authMode": {
@@ -21646,7 +21720,8 @@
                             "type": "string",
                             "enum": [
                               "text/html",
-                              "application/json"
+                              "application/json",
+                              "image/svg+xml"
                             ]
                           },
                           "authMode": {
@@ -21838,7 +21913,8 @@
                     "type": "string",
                     "enum": [
                       "text/html",
-                      "application/json"
+                      "application/json",
+                      "image/svg+xml"
                     ]
                   },
                   "authMode": {
@@ -22256,7 +22332,7 @@
     },
     "/p/{id}": {
       "get": {
-        "summary": "Render a page (HTML inline; JSON redirects to SPA)",
+        "summary": "Render a page (HTML/SVG inline; JSON redirects to SPA)",
         "tags": [
           "Pages"
         ],
@@ -22272,7 +22348,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Rendered HTML page"
+            "description": "Rendered HTML page or raw SVG image"
           },
           "302": {
             "description": "Redirect to SPA for JSON content"
@@ -22347,7 +22423,8 @@
                       "type": "string",
                       "enum": [
                         "text/html",
-                        "application/json"
+                        "application/json",
+                        "image/svg+xml"
                       ]
                     },
                     "authMode": {
@@ -23312,6 +23389,9 @@
                             "requestedBy": {
                               "type": "object",
                               "properties": {
+                                "id": {
+                                  "type": "string"
+                                },
                                 "name": {
                                   "type": "string",
                                   "minLength": 1
@@ -23396,6 +23476,9 @@
                             "requestedBy": {
                               "type": "object",
                               "properties": {
+                                "id": {
+                                  "type": "string"
+                                },
                                 "name": {
                                   "type": "string",
                                   "minLength": 1
@@ -24141,7 +24224,7 @@
                     ]
                   },
                   "guidelines": {
-                    "$ref": "#/components/schemas/RepoGuidelines"
+                    "$ref": "#/components/schemas/RepoGuidelinesInput"
                   }
                 }
               }
@@ -24352,7 +24435,7 @@
                     "$ref": "#/components/schemas/RepoHooks"
                   },
                   "guidelines": {
-                    "$ref": "#/components/schemas/RepoGuidelines"
+                    "$ref": "#/components/schemas/RepoGuidelinesInput"
                   }
                 },
                 "required": [
@@ -25429,6 +25512,9 @@
                     "createdByAgentId": {
                       "type": "string"
                     },
+                    "parentTaskId": {
+                      "type": "string"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -25783,6 +25869,9 @@
                               "createdByAgentId": {
                                 "type": "string"
                               },
+                              "parentTaskId": {
+                                "type": "string"
+                              },
                               "timezone": {
                                 "type": "string",
                                 "default": "UTC"
@@ -25964,6 +26053,9 @@
                               "createdByAgentId": {
                                 "type": "string"
                               },
+                              "parentTaskId": {
+                                "type": "string"
+                              },
                               "timezone": {
                                 "type": "string",
                                 "default": "UTC"
@@ -26188,6 +26280,9 @@
                         "createdByAgentId": {
                           "type": "string"
                         },
+                        "parentTaskId": {
+                          "type": "string"
+                        },
                         "timezone": {
                           "type": "string",
                           "default": "UTC"
@@ -26427,6 +26522,9 @@
                     "createdByAgentId": {
                       "type": "string"
                     },
+                    "parentTaskId": {
+                      "type": "string"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -26786,6 +26884,9 @@
                     "createdByAgentId": {
                       "type": "string"
                     },
+                    "parentTaskId": {
+                      "type": "string"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -27166,6 +27267,9 @@
                     "createdByAgentId": {
                       "type": "string"
                     },
+                    "parentTaskId": {
+                      "type": "string"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -34190,6 +34294,132 @@
         }
       }
     },
+    "/api/sessions/tokens": {
+      "post": {
+        "summary": "Mint an ephemeral session token for an ACP provider session",
+        "description": "Returns a short-lived aseph_ bearer for use by the ACP adapter in place of the full operator key. The token expires at the requested TTL and is actively revoked when the session ends. Only the operator key may mint session tokens.",
+        "tags": [
+          "Sessions"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "agentId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "taskId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "ttlMs": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "maximum": 604800000
+                  }
+                },
+                "required": [
+                  "agentId",
+                  "taskId",
+                  "ttlMs"
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Minted token plaintext (returned once) and its stable token ID",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "tokenId": {
+                      "type": "string"
+                    },
+                    "plaintext": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "tokenId",
+                    "plaintext"
+                  ]
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/sessions/tokens/{tokenId}": {
+      "delete": {
+        "summary": "Revoke an ephemeral session token",
+        "description": "Revokes an aseph_ bearer token by ID. No-op if already revoked.",
+        "tags": [
+          "Sessions"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "name": "tokenId",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Token revoked (or was already revoked)"
+          },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/sessions": {
       "get": {
         "summary": "List recent task sessions (root tasks + chain summary)",
@@ -38802,6 +39032,9 @@
                           "createdByAgentId": {
                             "type": "string"
                           },
+                          "parentTaskId": {
+                            "type": "string"
+                          },
                           "timezone": {
                             "type": "string",
                             "default": "UTC"
@@ -41208,7 +41441,25 @@
                     "tasks": {
                       "type": "array",
                       "items": {
-                        "$ref": "#/components/schemas/AgentTask"
+                        "allOf": [
+                          {
+                            "$ref": "#/components/schemas/AgentTask"
+                          },
+                          {
+                            "type": "object",
+                            "properties": {
+                              "attachments": {
+                                "type": "array",
+                                "items": {
+                                  "$ref": "#/components/schemas/TaskAttachment"
+                                }
+                              }
+                            },
+                            "required": [
+                              "attachments"
+                            ]
+                          }
+                        ]
                       }
                     }
                   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.145.0",
+  "version": "1.147.0",
   "description": "agent-swarm.dev — an open-source operating system for AI work: a lead agent breaks goals into tasks, routes them to specialized workers such as Claude Code or Codex, runs each worker in an isolated container, and preserves shared memory, tools, schedules, and review gates so delegated work compounds across sessions.",
   "keywords": [
     "agent-swarm.dev",

package/plugin/commands/start-worker.md

@@ -20,9 +20,8 @@ To do so, use the `agent-swarm` MCP server and call the `join-swarm` with a name
 
 ## Tools Reference
 
-### Polling for tasks
+### Your tasks
 
-- `poll-task` - Wait for new task assignments for you
 - `get-tasks` - List tasks with filters (status, unassigned, tags), use `mineOnly` to true to see only your tasks
 - `get-task-details` - Deep dive into a specific task's progress and output
 
@@ -39,13 +38,9 @@ To do so, use the `agent-swarm` MCP server and call the `join-swarm` with a name
 
 ## Workflow
 
-1. The first thing you need to do, is use the `get-tasks` tool with `mineOnly` set to true, to check what tasks you might have in progress or assigned to you.
-  1.1. If there's a task that is in progress, you should resume working on it!
-2. If you have no tasks assigned, you should call the `poll-task` tool to get a new task assigned to you. This will poll for a while and return either with:
-  2.1. A new task assigned to you
-  2.2. A message indicating there's no tasks available right now
-3. If 2.2, start polling immediately FOREVER. Only stop if you get interrupted by the user, if not, just keep polling.
-4. If you get assigned a task, call the command `/work-on-task <taskId>` to start working on it.
+1. Call `get-tasks` with `mineOnly` set to true to see the tasks assigned to you.
+2. If one is `pending` or `in_progress`, call `/work-on-task <taskId>` and work on it.
+3. Otherwise stop. The swarm assigns tasks to you and opens each one with `/work-on-task <taskId>`; you do not poll.
 
 ## Filesystem
 

package/plugin/pi-skills/start-worker/SKILL.md

@@ -21,9 +21,8 @@ To do so, use the `agent-swarm` MCP server and call the `join-swarm` with a name
 
 ## Tools Reference
 
-### Polling for tasks
+### Your tasks
 
-- `poll-task` - Wait for new task assignments for you
 - `get-tasks` - List tasks with filters (status, unassigned, tags), use `mineOnly` to true to see only your tasks
 - `get-task-details` - Deep dive into a specific task's progress and output
 
@@ -40,13 +39,9 @@ To do so, use the `agent-swarm` MCP server and call the `join-swarm` with a name
 
 ## Workflow
 
-1. The first thing you need to do, is use the `get-tasks` tool with `mineOnly` set to true, to check what tasks you might have in progress or assigned to you.
-  1.1. If there's a task that is in progress, you should resume working on it!
-2. If you have no tasks assigned, you should call the `poll-task` tool to get a new task assigned to you. This will poll for a while and return either with:
-  2.1. A new task assigned to you
-  2.2. A message indicating there's no tasks available right now
-3. If 2.2, start polling immediately FOREVER. Only stop if you get interrupted by the user, if not, just keep polling.
-4. If you get assigned a task, call `/skill:work-on-task <taskId>` to start working on it.
+1. Call `get-tasks` with `mineOnly` set to true to see the tasks assigned to you.
+2. If one is `pending` or `in_progress`, call `/skill:work-on-task <taskId>` and work on it.
+3. Otherwise stop. The swarm assigns tasks to you and opens each one with `/skill:work-on-task <taskId>`; you do not poll.
 
 ## Filesystem