@desplega.ai/agent-swarm 1.79.4 → 1.80.1

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.79.4",
+    "version": "1.80.1",
     "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": [
@@ -2147,7 +2147,8 @@
                     "type": "string",
                     "enum": [
                       "auto",
-                      "manual"
+                      "manual",
+                      "auto-inferred"
                     ]
                   },
                   "preCompactTokens": {
@@ -2161,6 +2162,18 @@
                   "cumulativeOutputTokens": {
                     "type": "integer",
                     "minimum": 0
+                  },
+                  "contextFormula": {
+                    "type": "string",
+                    "enum": [
+                      "input-cache-output",
+                      "input-cache-no-output",
+                      "input-output-no-cache",
+                      "peak-proxy",
+                      "pi-delegated",
+                      "harness-reported",
+                      "unknown"
+                    ]
                   }
                 },
                 "required": [
@@ -2702,7 +2715,8 @@
                       "workflow.run.end",
                       "system.boot",
                       "system.migration",
-                      "system.error"
+                      "system.error",
+                      "script.global_upsert"
                     ]
                   },
                   "status": {
@@ -2816,7 +2830,8 @@
                 "workflow.run.end",
                 "system.boot",
                 "system.migration",
-                "system.error"
+                "system.error",
+                "script.global_upsert"
               ]
             },
             "required": false,
@@ -2966,7 +2981,8 @@
                             "workflow.run.end",
                             "system.boot",
                             "system.migration",
-                            "system.error"
+                            "system.error",
+                            "script.global_upsert"
                           ]
                         },
                         "status": {
@@ -4159,6 +4175,36 @@
             "description": "Memory not found"
           }
         }
+      },
+      "get": {
+        "summary": "Get a single memory by ID",
+        "tags": [
+          "Memory"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "required": true,
+            "name": "id",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Memory details"
+          },
+          "404": {
+            "description": "Memory not found"
+          }
+        }
       }
     },
     "/api/memory/rate": {
@@ -5393,8 +5439,12 @@
                             "type": "string",
                             "enum": [
                               "claude",
+                              "claude-managed",
                               "codex",
-                              "pi"
+                              "pi",
+                              "opencode",
+                              "devin",
+                              "gemini"
                             ]
                           },
                           "model": {
@@ -5405,7 +5455,10 @@
                             "enum": [
                               "input",
                               "cached_input",
-                              "output"
+                              "output",
+                              "cache_write",
+                              "runtime_hour",
+                              "acu"
                             ]
                           },
                           "effectiveFrom": {
@@ -5462,8 +5515,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5485,7 +5542,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -5515,8 +5575,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5538,7 +5602,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -5580,8 +5647,12 @@
                       "type": "string",
                       "enum": [
                         "claude",
+                        "claude-managed",
                         "codex",
-                        "pi"
+                        "pi",
+                        "opencode",
+                        "devin",
+                        "gemini"
                       ]
                     },
                     "model": {
@@ -5592,7 +5663,10 @@
                       "enum": [
                         "input",
                         "cached_input",
-                        "output"
+                        "output",
+                        "cache_write",
+                        "runtime_hour",
+                        "acu"
                       ]
                     },
                     "effectiveFrom": {
@@ -5649,8 +5723,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5672,7 +5750,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -5692,8 +5773,12 @@
                       "type": "string",
                       "enum": [
                         "claude",
+                        "claude-managed",
                         "codex",
-                        "pi"
+                        "pi",
+                        "opencode",
+                        "devin",
+                        "gemini"
                       ]
                     },
                     "model": {
@@ -5704,7 +5789,10 @@
                       "enum": [
                         "input",
                         "cached_input",
-                        "output"
+                        "output",
+                        "cache_write",
+                        "runtime_hour",
+                        "acu"
                       ]
                     },
                     "effectiveFrom": {
@@ -5758,8 +5846,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5781,7 +5873,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -6633,6 +6728,68 @@
             "description": "Duplicate name"
           }
         }
+      },
+      "get": {
+        "summary": "List schedules",
+        "tags": [
+          "Schedules"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "true",
+                "false"
+              ]
+            },
+            "required": false,
+            "name": "enabled",
+            "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "name": "name",
+            "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "recurring",
+                "one_time"
+              ]
+            },
+            "required": false,
+            "name": "scheduleType",
+            "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "true",
+                "false"
+              ]
+            },
+            "required": false,
+            "name": "hideCompleted",
+            "in": "query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of schedules"
+          }
+        }
       }
     },
     "/api/schedules/{id}/run": {
@@ -6951,13 +7108,27 @@
                     "type": "integer"
                   },
                   "cacheWriteTokens": {
-                    "type": "integer"
+                    "type": [
+                      "integer",
+                      "null"
+                    ]
+                  },
+                  "reasoningOutputTokens": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "thinkingTokens": {
+                    "type": "integer",
+                    "minimum": 0
                   },
                   "durationMs": {
                     "type": "integer"
                   },
                   "numTurns": {
-                    "type": "integer"
+                    "type": [
+                      "integer",
+                      "null"
+                    ]
                   },
                   "model": {
                     "type": "string"
@@ -6969,9 +7140,12 @@
                     "type": "string",
                     "enum": [
                       "claude",
+                      "claude-managed",
                       "codex",
                       "pi",
-                      "opencode"
+                      "opencode",
+                      "devin",
+                      "gemini"
                     ]
                   },
                   "createdAt": {
@@ -7647,6 +7821,296 @@
         }
       }
     },
+    "/api/scripts/upsert": {
+      "post": {
+        "operationId": "scripts_upsert",
+        "summary": "Create or update a reusable script",
+        "description": "Explicit script upserts run a TypeScript typecheck before writing.",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200
+                  },
+                  "source": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "description": {
+                    "type": "string",
+                    "default": ""
+                  },
+                  "intent": {
+                    "type": "string",
+                    "default": ""
+                  },
+                  "scope": {
+                    "type": "string",
+                    "enum": [
+                      "global",
+                      "agent"
+                    ],
+                    "default": "agent"
+                  },
+                  "fsMode": {
+                    "type": "string",
+                    "enum": [
+                      "none",
+                      "workspace-rw"
+                    ],
+                    "default": "none"
+                  }
+                },
+                "required": [
+                  "name",
+                  "source"
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Script upserted"
+          },
+          "400": {
+            "description": "Validation or typecheck failure"
+          },
+          "403": {
+            "description": "Global write requires lead agent"
+          }
+        }
+      }
+    },
+    "/api/scripts/run": {
+      "post": {
+        "operationId": "scripts_run",
+        "summary": "Run a reusable or inline script",
+        "description": "Inline source skips typecheck and is auto-saved as a scratch script only on success.",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200
+                  },
+                  "source": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "args": {},
+                  "intent": {
+                    "type": "string",
+                    "default": ""
+                  },
+                  "scope": {
+                    "type": "string",
+                    "enum": [
+                      "global",
+                      "agent"
+                    ]
+                  },
+                  "fsMode": {
+                    "type": "string",
+                    "enum": [
+                      "none",
+                      "workspace-rw"
+                    ],
+                    "default": "none"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Script run completed"
+          },
+          "400": {
+            "description": "Validation error"
+          },
+          "404": {
+            "description": "Script not found"
+          },
+          "501": {
+            "description": "workspace-rw scripts are not supported in v1"
+          }
+        }
+      }
+    },
+    "/api/scripts/search": {
+      "post": {
+        "operationId": "scripts_search",
+        "summary": "Search reusable scripts",
+        "description": "Phase 3 search is substring-only over script name and metadata.",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "query": {
+                    "type": "string",
+                    "default": ""
+                  },
+                  "scope": {
+                    "type": "string",
+                    "enum": [
+                      "global",
+                      "agent"
+                    ]
+                  },
+                  "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 100,
+                    "default": 10
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Matching scripts"
+          },
+          "400": {
+            "description": "Validation error"
+          }
+        }
+      }
+    },
+    "/api/scripts/{name}": {
+      "delete": {
+        "operationId": "scripts_delete",
+        "summary": "Delete a reusable script",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "required": true,
+            "name": "name",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "global",
+                "agent"
+              ],
+              "default": "agent"
+            },
+            "required": false,
+            "name": "scope",
+            "in": "query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Delete result"
+          },
+          "400": {
+            "description": "Validation error"
+          },
+          "403": {
+            "description": "Global delete requires lead agent"
+          }
+        }
+      }
+    },
+    "/api/scripts/{name}/types": {
+      "get": {
+        "operationId": "scripts_types",
+        "summary": "Get script signature and authoring types",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "required": true,
+            "name": "name",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "global",
+                "agent"
+              ]
+            },
+            "required": false,
+            "name": "scope",
+            "in": "query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Script signature and type blobs"
+          },
+          "404": {
+            "description": "Script not found"
+          }
+        }
+      }
+    },
     "/api/mcp-oauth/{mcpServerId}/metadata": {
       "get": {
         "summary": "Probe OAuth metadata (PRMD + AS) for an MCP server",
@@ -10344,7 +10808,7 @@
                             },
                             "type": {
                               "type": "string",
-                              "description": "Executor type: 'agent-task', 'script', 'raw-llm', 'validate', 'property-match'"
+                              "description": "Executor type: 'agent-task', 'script', 'swarm-script', 'raw-llm', 'validate', 'property-match'"
                             },
                             "label": {
                               "type": "string",
@@ -10353,7 +10817,7 @@
                             "config": {
                               "type": "object",
                               "additionalProperties": {},
-                              "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+                              "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
                             },
                             "next": {
                               "anyOf": [
@@ -10682,7 +11146,7 @@
                             },
                             "type": {
                               "type": "string",
-                              "description": "Executor type: 'agent-task', 'script', 'raw-llm', 'validate', 'property-match'"
+                              "description": "Executor type: 'agent-task', 'script', 'swarm-script', 'raw-llm', 'validate', 'property-match'"
                             },
                             "label": {
                               "type": "string",
@@ -10691,7 +11155,7 @@
                             "config": {
                               "type": "object",
                               "additionalProperties": {},
-                              "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+                              "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
                             },
                             "next": {
                               "anyOf": [
@@ -11000,7 +11464,7 @@
                           "properties": {
                             "type": {
                               "type": "string",
-                              "description": "Executor type: 'agent-task', 'script', 'raw-llm', 'validate', 'property-match'"
+                              "description": "Executor type: 'agent-task', 'script', 'swarm-script', 'raw-llm', 'validate', 'property-match'"
                             },
                             "label": {
                               "type": "string",
@@ -11009,7 +11473,7 @@
                             "config": {
                               "type": "object",
                               "additionalProperties": {},
-                              "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+                              "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
                             },
                             "next": {
                               "anyOf": [
@@ -11155,7 +11619,7 @@
                         },
                         "type": {
                           "type": "string",
-                          "description": "Executor type: 'agent-task', 'script', 'raw-llm', 'validate', 'property-match'"
+                          "description": "Executor type: 'agent-task', 'script', 'swarm-script', 'raw-llm', 'validate', 'property-match'"
                         },
                         "label": {
                           "type": "string",
@@ -11164,7 +11628,7 @@
                         "config": {
                           "type": "object",
                           "additionalProperties": {},
-                          "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+                          "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
                         },
                         "next": {
                           "anyOf": [
@@ -11390,7 +11854,7 @@
                 "properties": {
                   "type": {
                     "type": "string",
-                    "description": "Executor type: 'agent-task', 'script', 'raw-llm', 'validate', 'property-match'"
+                    "description": "Executor type: 'agent-task', 'script', 'swarm-script', 'raw-llm', 'validate', 'property-match'"
                   },
                   "label": {
                     "type": "string",
@@ -11399,7 +11863,7 @@
                   "config": {
                     "type": "object",
                     "additionalProperties": {},
-                    "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+                    "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode? }. Values support {{interpolation}} from the node's inputs context. NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
                   },
                   "next": {
                     "anyOf": [