@desplega.ai/agent-swarm 1.81.1 → 1.83.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.81.1",
+    "version": "1.83.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": [
@@ -360,6 +360,7 @@
       },
       "get": {
         "summary": "List all agents",
+        "description": "Returns agents WITHOUT the six identity-markdown blobs (`claudeMd`/`soulMd`/`identityMd`/`toolsMd`/`heartbeatMd`/`setupScript`) by default — they bloat the list by ~16 KB/agent and the overview never renders them. Pass `fields=full` to restore them, or fetch a single agent via `GET /api/agents/{id}`.",
         "tags": [
           "Agents"
         ],
@@ -379,6 +380,18 @@
             "required": false,
             "name": "include",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "full",
+                "slim"
+              ]
+            },
+            "required": false,
+            "name": "fields",
+            "in": "query"
           }
         ],
         "responses": {
@@ -823,6 +836,7 @@
                           "env",
                           "file",
                           "side-effect-pending",
+                          "sdk-delegated",
                           null
                         ],
                         "default": null
@@ -4524,6 +4538,7 @@
       },
       "get": {
         "summary": "List pages",
+        "description": "Returns pages WITHOUT the heavy `body` (the full HTML/JSON document) and `passwordHash` by default — list views never render the body. Pass `fields=full` to restore `body`. Fetch a full page via `GET /api/pages/{id}`.",
         "tags": [
           "Pages"
         ],
@@ -4563,6 +4578,18 @@
             "required": false,
             "name": "offset",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "full",
+                "slim"
+              ]
+            },
+            "required": false,
+            "name": "fields",
+            "in": "query"
           }
         ],
         "responses": {
@@ -6731,6 +6758,7 @@
       },
       "get": {
         "summary": "List schedules",
+        "description": "Returns schedules with the full `taskTemplate` replaced by a short `taskTemplatePreview` by default — list views never render the full template. Pass `fields=full` to restore `taskTemplate`. Fetch the full template via `GET /api/schedules/{id}`.",
         "tags": [
           "Schedules"
         ],
@@ -6783,6 +6811,18 @@
             "required": false,
             "name": "hideCompleted",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "full",
+                "slim"
+              ]
+            },
+            "required": false,
+            "name": "fields",
+            "in": "query"
           }
         ],
         "responses": {
@@ -7312,6 +7352,7 @@
     "/api/sessions": {
       "get": {
         "summary": "List recent task sessions (root tasks + chain summary)",
+        "description": "Each item's `root` is a slim task summary by default — the full `task` text is replaced with a bounded `taskPreview` and completion/integration blobs are dropped. Pass `fields=full` to restore the full root `AgentTask`. The full root + descendant chain are on `GET /api/sessions/{rootTaskId}`.",
         "tags": [
           "Sessions"
         ],
@@ -7367,6 +7408,18 @@
             "required": false,
             "name": "requestedByUserId",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "full",
+                "slim"
+              ]
+            },
+            "required": false,
+            "name": "fields",
+            "in": "query"
           }
         ],
         "responses": {
@@ -7416,6 +7469,7 @@
     "/api/skills": {
       "get": {
         "summary": "List skills with optional filters",
+        "description": "Returns skills WITHOUT the heavy `content` (full SKILL.md) by default — list views never render it. Pass `fields=full` to include `content` (e.g. for SDK consumers that read it from the list).",
         "tags": [
           "Skills"
         ],
@@ -7464,6 +7518,18 @@
             "required": false,
             "name": "search",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "full",
+                "slim"
+              ]
+            },
+            "required": false,
+            "name": "fields",
+            "in": "query"
           }
         ],
         "responses": {
@@ -8931,6 +8997,25 @@
         }
       }
     },
+    "/api/metrics": {
+      "get": {
+        "summary": "Lightweight swarm-wide counts",
+        "description": "Single JSON object of cheap `COUNT(*)` metrics — tasks (by status), agents (by status), workflows (total + enabled), pages, active sessions, skills. Use this instead of fetching full list payloads just to count. Powers UI footers/sidebars and MCP context.",
+        "tags": [
+          "Stats"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Swarm metrics counts"
+          }
+        }
+      }
+    },
     "/api/services": {
       "get": {
         "summary": "List all registered services",
@@ -9355,6 +9440,7 @@
     "/api/tasks": {
       "get": {
         "summary": "List tasks with filters",
+        "description": "Returns tasks with the full `task` text replaced by a bounded `taskPreview` and completion/integration blobs dropped by default — list views only need the preview. Pass `fields=full` to restore the full `AgentTask`. Fetch a single task in full via `GET /api/tasks/{id}`.",
         "tags": [
           "Tasks"
         ],
@@ -9446,6 +9532,18 @@
             "required": false,
             "name": "offset",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "full",
+                "slim"
+              ]
+            },
+            "required": false,
+            "name": "fields",
+            "in": "query"
           }
         ],
         "responses": {
@@ -9698,7 +9796,8 @@
     },
     "/api/tasks/{id}": {
       "get": {
-        "summary": "Get task details with logs",
+        "summary": "Get task details with logs and attachments",
+        "description": "Returns the full `AgentTask` row decorated with `logs` (capped by `logsLimit`) and `attachments` (pointer-based artifacts stored on the task, ordered by `created_at`).",
         "tags": [
           "Tasks"
         ],
@@ -9715,11 +9814,21 @@
             "required": true,
             "name": "id",
             "in": "path"
+          },
+          {
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1000
+            },
+            "required": false,
+            "name": "logsLimit",
+            "in": "query"
           }
         ],
         "responses": {
           "200": {
-            "description": "Task with logs"
+            "description": "Task with logs and attachments"
           },
           "404": {
             "description": "Task not found"
@@ -11223,6 +11332,7 @@
     "/api/workflows": {
       "get": {
         "summary": "List all workflows",
+        "description": "Returns workflows WITHOUT the heavy `definition` (the full DAG) by default — the list view only needs a `nodeCount`, which is included. Pass `fields=full` to restore `definition` + trigger config. Fetch the full workflow via `GET /api/workflows/{id}`.",
         "tags": [
           "Workflows"
         ],
@@ -11231,6 +11341,20 @@
             "bearerAuth": []
           }
         ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "full",
+                "slim"
+              ]
+            },
+            "required": false,
+            "name": "fields",
+            "in": "query"
+          }
+        ],
         "responses": {
           "200": {
             "description": "Workflow list"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.81.1",
+  "version": "1.83.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",
@@ -85,7 +85,8 @@
     "pm2-status": "pm2 status swarm-api swarm-ui swarm-lead swarm-worker",
     "seed": "bun scripts/seed.ts",
     "seed:clean": "bun scripts/seed.ts --clean",
-    "seed:people": "bun scripts/seed-people.ts"
+    "seed:people": "bun scripts/seed-people.ts",
+    "seed:scripts": "bun scripts/seed-scripts.ts"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",