@desplega.ai/agent-swarm 1.92.2 → 1.94.0

package/README.md

@@ -46,7 +46,7 @@
 
 ## What it does
 
-Agent Swarm runs a team of AI agents that coordinate autonomously. A **lead agent** receives tasks ( from Slack, GitHub, GitLab, Linear, Jira, email, or the API) breaks them down, and delegates to **worker agents** running in isolated environments (Docker). Workers execute tasks, ship solutions, and write their learnings back to a shared memory so the whole swarm gets smarter every session.
+Agent Swarm runs a team of AI agents that coordinate autonomously. A **lead agent** receives tasks (from Slack, GitHub, GitLab, Linear, Jira, email, or the API), breaks them down, and delegates to **worker agents** running in isolated environments (Docker). Workers execute tasks, ship solutions, and write their learnings back to a shared memory so the whole swarm gets smarter every session.
 
 You can run agents for Marketing, Product, UX, Engineering, Support, Operations, HR, Finance, or any role you can think of. A centralized Lead coordinates them, and they share the learnings horizontally. That's the true difference between [*AI First*](https://www.pleasedontdeploy.com/i/197193364/ai-first) and [*AI Native*](https://www.pleasedontdeploy.com/i/197193364/third-the-ai-native-metamorphosis).
 
@@ -127,7 +127,7 @@ Check [our templates](https://templates.agent-swarm.dev) for a quick start.
 - **Workflow engine with Human-in-the-Loop** — DAG-based automation with approval gates, retries, and structured I/O. [Workflows →](https://docs.agent-swarm.dev/docs/concepts/workflows)
 - **Scheduled & recurring tasks** — cron-based automation for standing work. [Scheduling →](https://docs.agent-swarm.dev/docs/concepts/scheduling)
 - **Durable script workflows** — launch background script runs, inspect their journals, and track them from the dashboard when a one-shot `script-run` is too small. [Guide →](https://docs.agent-swarm.dev/docs/guides/script-workflow-runs)
-- **Harness & LLM agnostic** — run with Claude Code, Claude Bridge, OpenAI Codex, pi-mono, Devin, Claude Managed Agents, raw LLMs, or opencode. [Harness config →](https://docs.agent-swarm.dev/docs/guides/harness-configuration) · [Add a new provider →](https://docs.agent-swarm.dev/docs/guides/harness-providers)
+- **Harness & LLM agnostic** — run with Claude Code, Claude Bridge, OpenAI Codex, pi-mono, Devin, Claude Managed Agents, raw LLMs, or opencode. Tasks, schedules, and workflow agent-task nodes can use portable `modelTier` intent (`smol`, `regular`, `smart`, `ultra`) and resolve it per worker/provider at run time. [Harness config →](https://docs.agent-swarm.dev/docs/guides/harness-configuration) · [Add a new provider →](https://docs.agent-swarm.dev/docs/guides/harness-providers)
 - **Follow-up continuity across all harnesses** — child tasks inherit a bounded prior-task context preamble built from the task chain, so continuity survives restarts and works the same across every provider. [Task lifecycle →](https://docs.agent-swarm.dev/docs/concepts/task-lifecycle)
 - **Skills & MCP servers** — reusable procedural knowledge, bundled skill reference files, and per-agent MCP servers with scope cascade. [MCP tools →](https://docs.agent-swarm.dev/docs/reference/mcp-tools)
 - **External tool-router access** — the `x` command and `swarm_x` MCP tool let humans and agents execute approved third-party routes such as Composio without baking bespoke MCP servers first. [CLI →](https://docs.agent-swarm.dev/docs/reference/cli) · [Composio →](https://docs.agent-swarm.dev/docs/integrations/composio)

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.92.2",
+    "version": "1.94.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": [
@@ -2740,6 +2740,59 @@
         }
       }
     },
+    "/api/keys/clear-rate-limit": {
+      "post": {
+        "summary": "Clear rate-limited status for a key after a successful use proves it is healthy",
+        "tags": [
+          "API Keys"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "keyType": {
+                    "type": "string"
+                  },
+                  "keySuffix": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 10
+                  },
+                  "scope": {
+                    "type": "string"
+                  },
+                  "scopeId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "keyType",
+                  "keySuffix"
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Rate limit cleared (or key was not rate-limited)"
+          },
+          "400": {
+            "description": "Validation error"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/events": {
       "post": {
         "summary": "Store a single event",
@@ -6841,6 +6894,15 @@
                   "model": {
                     "type": "string"
                   },
+                  "modelTier": {
+                    "type": "string",
+                    "enum": [
+                      "smol",
+                      "regular",
+                      "smart",
+                      "ultra"
+                    ]
+                  },
                   "scheduleType": {
                     "type": "string",
                     "enum": [
@@ -7088,6 +7150,19 @@
                   "model": {
                     "type": "string"
                   },
+                  "modelTier": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "enum": [
+                      "smol",
+                      "regular",
+                      "smart",
+                      "ultra",
+                      null
+                    ]
+                  },
                   "nextRunAt": {
                     "type": [
                       "string",
@@ -7244,6 +7319,14 @@
             "name": "agentId",
             "in": "query"
           },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "name": "scriptName",
+            "in": "query"
+          },
           {
             "schema": {
               "type": "integer",
@@ -9196,6 +9279,143 @@
         }
       }
     },
+    "/api/scripts": {
+      "get": {
+        "operationId": "scripts_list",
+        "summary": "List saved scripts",
+        "description": "Dashboard read: lean projection without source. Scratch scripts are excluded unless includeScratch=true.",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "global",
+                "agent"
+              ]
+            },
+            "required": false,
+            "name": "scope",
+            "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "true",
+                "false"
+              ]
+            },
+            "required": false,
+            "name": "includeScratch",
+            "in": "query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Saved scripts"
+          },
+          "400": {
+            "description": "Validation error"
+          }
+        }
+      }
+    },
+    "/api/scripts/type-defs": {
+      "get": {
+        "operationId": "scripts_type_defs",
+        "summary": "Get script SDK and stdlib type definitions",
+        "description": "Static .d.ts blobs for editor integration (e.g. Monaco extraLibs). Cacheable.",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "SDK and stdlib type definition blobs"
+          }
+        }
+      }
+    },
+    "/api/scripts/{id}": {
+      "get": {
+        "operationId": "scripts_get",
+        "summary": "Get a saved script by id",
+        "description": "Dashboard read: full record including source and parsed signature.",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "required": true,
+            "name": "id",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Script detail"
+          },
+          "404": {
+            "description": "Script not found"
+          }
+        }
+      }
+    },
+    "/api/scripts/{id}/versions": {
+      "get": {
+        "operationId": "scripts_versions",
+        "summary": "List versions of a saved script",
+        "description": "Dashboard read: version history, newest first.",
+        "tags": [
+          "Scripts"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "required": true,
+            "name": "id",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Script versions"
+          },
+          "404": {
+            "description": "Script not found"
+          }
+        }
+      }
+    },
     "/api/mcp-bridge": {
       "post": {
         "summary": "Generic MCP tool proxy for the scripts SDK bridge",
@@ -10692,6 +10912,18 @@
                   },
                   "requestedByUserId": {
                     "type": "string"
+                  },
+                  "model": {
+                    "type": "string"
+                  },
+                  "modelTier": {
+                    "type": "string",
+                    "enum": [
+                      "smol",
+                      "regular",
+                      "smart",
+                      "ultra"
+                    ]
                   }
                 },
                 "required": [
@@ -10711,9 +10943,9 @@
         }
       }
     },
-    "/api/tasks/{id}/claude-session": {
+    "/api/tasks/{id}/session": {
       "put": {
-        "summary": "Update Claude session ID for a task",
+        "summary": "Update provider session ID and harness metadata for a task",
         "tags": [
           "Tasks"
         ],
@@ -10800,6 +11032,13 @@
                       "providerMeta": {
                         "type": "object",
                         "properties": {}
+                      },
+                      "harnessVariant": {
+                        "type": "string"
+                      },
+                      "harnessVariantMeta": {
+                        "type": "object",
+                        "additionalProperties": {}
                       }
                     },
                     "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.92.2",
+  "version": "1.94.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",
@@ -112,11 +112,11 @@
     "@desplega.ai/localtunnel": "^2.2.0",
     "@inkjs/ui": "^2.0.0",
     "@linear/sdk": "^77.0.0",
-    "@earendil-works/pi-agent-core": "^0.78.1",
-    "@earendil-works/pi-ai": "^0.78.1",
-    "@earendil-works/pi-coding-agent": "^0.78.1",
+    "@earendil-works/pi-agent-core": "^0.79.1",
+    "@earendil-works/pi-ai": "^0.79.1",
+    "@earendil-works/pi-coding-agent": "^0.79.1",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@openai/codex-sdk": "^0.137.0",
+    "@openai/codex-sdk": "^0.139.0",
     "@opencode-ai/sdk": "^1.16.2",
     "@openfort/openfort-node": "^0.9.1",
     "@opentelemetry/api": "^1.9.1",