@desplega.ai/agent-swarm 2.0.0 → 2.1.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "2.0.0",
+    "version": "2.1.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": [
@@ -387,6 +387,12 @@
               "max"
             ]
           },
+          "profile": {
+            "type": "string"
+          },
+          "resolvedProfile": {
+            "type": "string"
+          },
           "scheduleId": {
             "type": "string"
           },
@@ -4880,7 +4886,9 @@
                     "eventName": {
                       "type": "string",
                       "enum": [
-                        "slack.message"
+                        "slack.message",
+                        "azure-devops.work_item.assigned",
+                        "azure-devops.work_item.commented"
                       ]
                     }
                   },
@@ -5557,7 +5565,9 @@
                     "eventName": {
                       "type": "string",
                       "enum": [
-                        "slack.message"
+                        "slack.message",
+                        "azure-devops.work_item.assigned",
+                        "azure-devops.work_item.commented"
                       ]
                     }
                   },
@@ -7171,6 +7181,13 @@
                         "createdAt",
                         "updatedAt"
                       ]
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Advisory quickjs-executor compatibility findings for the app's scripts."
                     }
                   },
                   "required": [
@@ -7677,6 +7694,13 @@
                         "orphanFields",
                         "userConfigChanged"
                       ]
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Advisory quickjs-executor compatibility findings for the app's scripts."
                     }
                   },
                   "required": [
@@ -8195,6 +8219,13 @@
                         "orphanFields",
                         "userConfigChanged"
                       ]
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Advisory quickjs-executor compatibility findings for the app's scripts."
                     }
                   },
                   "required": [
@@ -8549,6 +8580,13 @@
                         "orphanFields",
                         "userConfigChanged"
                       ]
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Advisory quickjs-executor compatibility findings for the app's scripts."
                     }
                   },
                   "required": [
@@ -10621,7 +10659,7 @@
       },
       "patch": {
         "summary": "Update an agent's runtime harness and default model",
-        "description": "Updates `agents.harness_provider` and agent-scoped runtime config. The settings apply to future provider sessions. For `model`, `reasoning_effort`, and `claude.transport`: omit the field to leave it unchanged, send `null` to clear the corresponding override, or send a value to set it. A `model` the model catalog does not list is a 400 unless `allow_custom_model` is true. A `latest:` alias is not accepted here (aliases resolve for a task's model and for `MODEL_TIER_*` values); `reasoning_effort` must be one the harness and model support.",
+        "description": "Updates `agents.harness_provider` and agent-scoped runtime config. The settings apply to future provider sessions. For `model`, `reasoning_effort`, and `claude.transport`: omit the field to leave it unchanged, send `null` to clear the corresponding override, or send a value to set it. A `model` the model catalog does not list is a 400 unless `allow_custom_model` is true. A `latest:` alias is not accepted here (aliases resolve for a task's model and for `MODEL_TIER_*` values); `reasoning_effort` must be one the harness and model support. `profile` sets the agent's default model profile (same tri-state): it must exist and run on `harness_provider`, and it cannot be sent with `model`. Sending `model`, or changing the model or effort override by any path, clears the default profile.",
         "tags": [
           "Agents"
         ],
@@ -10694,6 +10732,13 @@
                       null
                     ]
                   },
+                  "profile": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "minLength": 1
+                  },
                   "acp": {
                     "type": "object",
                     "properties": {
@@ -25228,6 +25273,710 @@
         }
       }
     },
+    "/api/model-profiles": {
+      "get": {
+        "summary": "List model profiles",
+        "description": "Every model profile, ordered by harness then name. Filter by `harness` to see what an agent on that harness can run.",
+        "tags": [
+          "Models"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "claude",
+                "codex",
+                "pi",
+                "devin",
+                "claude-managed",
+                "opencode",
+                "acp",
+                "dsh",
+                "amp",
+                "cursor",
+                "grok"
+              ]
+            },
+            "required": false,
+            "name": "harness",
+            "in": "query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Model profiles",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "profiles": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "harness": {
+                            "type": "string",
+                            "enum": [
+                              "claude",
+                              "codex",
+                              "pi",
+                              "devin",
+                              "claude-managed",
+                              "opencode",
+                              "acp",
+                              "dsh",
+                              "amp",
+                              "cursor",
+                              "grok"
+                            ]
+                          },
+                          "model": {
+                            "type": "string"
+                          },
+                          "effort": {
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "enum": [
+                              "off",
+                              "low",
+                              "medium",
+                              "high",
+                              "xhigh",
+                              "max",
+                              null
+                            ]
+                          },
+                          "allowCustomModel": {
+                            "type": "boolean"
+                          },
+                          "description": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "seededFrom": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "createdAt": {
+                            "type": "string"
+                          },
+                          "lastUpdatedAt": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "name",
+                          "harness",
+                          "model",
+                          "effort",
+                          "allowCustomModel",
+                          "description",
+                          "seededFrom",
+                          "createdAt",
+                          "lastUpdatedAt"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "profiles"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "summary": "Create a model profile",
+        "description": "A profile runs on one harness. `model` must run on that harness and be in the model catalog unless `allowCustomModel` is true (a gateway id, a fresh launch); a `latest:` alias is accepted and resolves at claim. `effort` must be a level the harness and model support. Operator only (the shared API key).",
+        "tags": [
+          "Models"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9._-]{0,99}$"
+                  },
+                  "harness": {
+                    "type": "string",
+                    "enum": [
+                      "claude",
+                      "codex",
+                      "pi",
+                      "devin",
+                      "claude-managed",
+                      "opencode",
+                      "acp",
+                      "dsh",
+                      "amp",
+                      "cursor",
+                      "grok"
+                    ]
+                  },
+                  "model": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "effort": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "enum": [
+                      "off",
+                      "low",
+                      "medium",
+                      "high",
+                      "xhigh",
+                      "max",
+                      null
+                    ]
+                  },
+                  "allowCustomModel": {
+                    "type": "boolean",
+                    "default": false
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "maxLength": 500
+                  }
+                },
+                "required": [
+                  "name",
+                  "harness",
+                  "model"
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Profile created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "harness": {
+                      "type": "string",
+                      "enum": [
+                        "claude",
+                        "codex",
+                        "pi",
+                        "devin",
+                        "claude-managed",
+                        "opencode",
+                        "acp",
+                        "dsh",
+                        "amp",
+                        "cursor",
+                        "grok"
+                      ]
+                    },
+                    "model": {
+                      "type": "string"
+                    },
+                    "effort": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "enum": [
+                        "off",
+                        "low",
+                        "medium",
+                        "high",
+                        "xhigh",
+                        "max",
+                        null
+                      ]
+                    },
+                    "allowCustomModel": {
+                      "type": "boolean"
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "seededFrom": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "createdAt": {
+                      "type": "string"
+                    },
+                    "lastUpdatedAt": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "name",
+                    "harness",
+                    "model",
+                    "effort",
+                    "allowCustomModel",
+                    "description",
+                    "seededFrom",
+                    "createdAt",
+                    "lastUpdatedAt"
+                  ]
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A profile with that name exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/model-profiles/{name}": {
+      "get": {
+        "summary": "Get one model profile",
+        "tags": [
+          "Models"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "name": "name",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The model profile",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "harness": {
+                      "type": "string",
+                      "enum": [
+                        "claude",
+                        "codex",
+                        "pi",
+                        "devin",
+                        "claude-managed",
+                        "opencode",
+                        "acp",
+                        "dsh",
+                        "amp",
+                        "cursor",
+                        "grok"
+                      ]
+                    },
+                    "model": {
+                      "type": "string"
+                    },
+                    "effort": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "enum": [
+                        "off",
+                        "low",
+                        "medium",
+                        "high",
+                        "xhigh",
+                        "max",
+                        null
+                      ]
+                    },
+                    "allowCustomModel": {
+                      "type": "boolean"
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "seededFrom": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "createdAt": {
+                      "type": "string"
+                    },
+                    "lastUpdatedAt": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "name",
+                    "harness",
+                    "model",
+                    "effort",
+                    "allowCustomModel",
+                    "description",
+                    "seededFrom",
+                    "createdAt",
+                    "lastUpdatedAt"
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No profile with that name",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "patch": {
+        "summary": "Update a model profile",
+        "description": "Changes the model, effort, custom-model flag or description; the name and harness are fixed. Omit a field to keep it; `effort: null` clears it. Applies to tasks claimed after the change. Operator only (the shared API key).",
+        "tags": [
+          "Models"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "name": "name",
+            "in": "path"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "model": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "effort": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "enum": [
+                      "off",
+                      "low",
+                      "medium",
+                      "high",
+                      "xhigh",
+                      "max",
+                      null
+                    ]
+                  },
+                  "allowCustomModel": {
+                    "type": "boolean"
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "maxLength": 500
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Profile updated",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "harness": {
+                      "type": "string",
+                      "enum": [
+                        "claude",
+                        "codex",
+                        "pi",
+                        "devin",
+                        "claude-managed",
+                        "opencode",
+                        "acp",
+                        "dsh",
+                        "amp",
+                        "cursor",
+                        "grok"
+                      ]
+                    },
+                    "model": {
+                      "type": "string"
+                    },
+                    "effort": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "enum": [
+                        "off",
+                        "low",
+                        "medium",
+                        "high",
+                        "xhigh",
+                        "max",
+                        null
+                      ]
+                    },
+                    "allowCustomModel": {
+                      "type": "boolean"
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "seededFrom": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "createdAt": {
+                      "type": "string"
+                    },
+                    "lastUpdatedAt": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "name",
+                    "harness",
+                    "model",
+                    "effort",
+                    "allowCustomModel",
+                    "description",
+                    "seededFrom",
+                    "createdAt",
+                    "lastUpdatedAt"
+                  ]
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No profile with that name",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "summary": "Delete a model profile",
+        "description": "Refused (409) for a shipped `<harness>-<tier>` seed (edit it instead; it would come back at the next boot), and while an agent has the profile as its default or a task holds it (unfinished, or superseded and still owed its resume). Operator only (the shared API key).",
+        "tags": [
+          "Models"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "name": "name",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Profile deleted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "deleted": {
+                      "type": "boolean",
+                      "enum": [
+                        true
+                      ]
+                    }
+                  },
+                  "required": [
+                    "deleted"
+                  ]
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No profile with that name",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The profile is a seed or still in use",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/models-catalog": {
       "get": {
         "summary": "Get the live model catalog for the picker-reachable providers",
@@ -30322,6 +31071,10 @@
                       "max"
                     ]
                   },
+                  "profile": {
+                    "type": "string",
+                    "minLength": 1
+                  },
                   "draft": {
                     "type": "boolean"
                   }
@@ -48988,6 +49741,13 @@
                     },
                     "contentDeduped": {
                       "type": "boolean"
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Advisory quickjs-executor compatibility findings. Never blocks the save."
                     }
                   },
                   "required": [
@@ -50084,6 +50844,13 @@
                             "string",
                             "null"
                           ]
+                        },
+                        "warnings": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          },
+                          "description": "Advisory quickjs-executor compatibility findings for the script."
                         }
                       },
                       "required": [
@@ -57266,7 +58033,9 @@
                             "eventName": {
                               "type": "string",
                               "enum": [
-                                "slack.message"
+                                "slack.message",
+                                "azure-devops.work_item.assigned",
+                                "azure-devops.work_item.commented"
                               ]
                             }
                           },
@@ -57658,7 +58427,9 @@
                             "eventName": {
                               "type": "string",
                               "enum": [
-                                "slack.message"
+                                "slack.message",
+                                "azure-devops.work_item.assigned",
+                                "azure-devops.work_item.commented"
                               ]
                             }
                           },