@desplega.ai/agent-swarm 1.93.0 → 1.95.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.93.0",
+    "version": "1.95.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": [
@@ -6894,6 +6894,15 @@
                   "model": {
                     "type": "string"
                   },
+                  "modelTier": {
+                    "type": "string",
+                    "enum": [
+                      "smol",
+                      "regular",
+                      "smart",
+                      "ultra"
+                    ]
+                  },
                   "scheduleType": {
                     "type": "string",
                     "enum": [
@@ -7141,6 +7150,19 @@
                   "model": {
                     "type": "string"
                   },
+                  "modelTier": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "enum": [
+                      "smol",
+                      "regular",
+                      "smart",
+                      "ultra",
+                      null
+                    ]
+                  },
                   "nextRunAt": {
                     "type": [
                       "string",
@@ -7297,6 +7319,14 @@
             "name": "agentId",
             "in": "query"
           },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "name": "scriptName",
+            "in": "query"
+          },
           {
             "schema": {
               "type": "integer",
@@ -9249,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",
@@ -10745,6 +10912,18 @@
                   },
                   "requestedByUserId": {
                     "type": "string"
+                  },
+                  "model": {
+                    "type": "string"
+                  },
+                  "modelTier": {
+                    "type": "string",
+                    "enum": [
+                      "smol",
+                      "regular",
+                      "smart",
+                      "ultra"
+                    ]
                   }
                 },
                 "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.93.0",
+  "version": "1.95.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",
@@ -108,13 +108,14 @@
     "@ai-sdk/openai": "^3.0.41",
     "@anthropic-ai/sdk": "^0.93.0",
     "@asteasolutions/zod-to-openapi": "^8.0.0",
+    "@aws-sdk/client-bedrock": "3.1048.0",
     "@desplega.ai/business-use": "^0.4.2",
     "@desplega.ai/localtunnel": "^2.2.0",
-    "@inkjs/ui": "^2.0.0",
-    "@linear/sdk": "^77.0.0",
     "@earendil-works/pi-agent-core": "^0.79.1",
     "@earendil-works/pi-ai": "^0.79.1",
     "@earendil-works/pi-coding-agent": "^0.79.1",
+    "@inkjs/ui": "^2.0.0",
+    "@linear/sdk": "^77.0.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@openai/codex-sdk": "^0.139.0",
     "@opencode-ai/sdk": "^1.16.2",

package/src/be/db.ts

@@ -2,6 +2,7 @@ import { Database } from "bun:sqlite";
 import { parseProviderMeta } from "@/utils/provider-metadata.ts";
 import pkg from "../../package.json";
 import { addEyesReactionOnTaskStart } from "../github/task-reactions";
+import { type ModelTier, parseModelTier } from "../model-tiers";
 import { configureDbResolver } from "../prompts/resolver";
 import type {
   ActiveSession,
@@ -1000,6 +1001,8 @@ type AgentTaskRow = {
   slackThreadTs: string | null;
   slackUserId: string | null;
   slackReplySent: number;
+  slackProgressMessageTs: string | null;
+  slackTreeRootMessageTs: string | null;
   vcsProvider: string | null;
   vcsRepo: string | null;
   vcsEventType: string | null;
@@ -1018,6 +1021,7 @@ type AgentTaskRow = {
   parentTaskId: string | null;
   claudeSessionId: string | null;
   model: string | null;
+  modelTier: string | null;
   scheduleId: string | null;
   workflowRunId: string | null;
   workflowRunStepId: string | null;
@@ -1088,6 +1092,8 @@ function rowToAgentTask(row: AgentTaskRow): AgentTask {
     slackThreadTs: row.slackThreadTs ?? undefined,
     slackUserId: row.slackUserId ?? undefined,
     slackReplySent: !!row.slackReplySent,
+    slackProgressMessageTs: row.slackProgressMessageTs ?? undefined,
+    slackTreeRootMessageTs: row.slackTreeRootMessageTs ?? undefined,
     vcsProvider: (row.vcsProvider as "github" | "gitlab" | null) ?? undefined,
     vcsRepo: row.vcsRepo ?? undefined,
     vcsEventType: row.vcsEventType ?? undefined,
@@ -1105,7 +1111,8 @@ function rowToAgentTask(row: AgentTaskRow): AgentTask {
     dir: row.dir ?? undefined,
     parentTaskId: row.parentTaskId ?? undefined,
     claudeSessionId: row.claudeSessionId ?? undefined,
-    model: (row.model as "haiku" | "sonnet" | "opus" | "fable" | null) ?? undefined,
+    model: row.model ?? undefined,
+    modelTier: parseModelTier(row.modelTier) ?? undefined,
     scheduleId: row.scheduleId ?? undefined,
     workflowRunId: row.workflowRunId ?? undefined,
     workflowRunStepId: row.workflowRunStepId ?? undefined,
@@ -1161,6 +1168,7 @@ function rowToAgentTaskSummary(row: AgentTaskRow): AgentTaskSummary {
     parentTaskId: t.parentTaskId,
     scheduleId: t.scheduleId,
     model: t.model,
+    modelTier: t.modelTier,
     provider: t.provider,
     requestedByUserId: t.requestedByUserId,
     progress: t.progress,
@@ -1363,6 +1371,30 @@ export function markTaskSlackReplySent(taskId: string): void {
   getDb().run(`UPDATE agent_tasks SET slackReplySent = 1 WHERE id = ?`, [taskId]);
 }
 
+export function setSlackMessageTracking(
+  taskId: string,
+  fields: {
+    slackProgressMessageTs?: string | null;
+    slackTreeRootMessageTs?: string | null;
+  },
+): void {
+  const sets: string[] = [];
+  const args: (string | null)[] = [];
+
+  if (Object.hasOwn(fields, "slackProgressMessageTs")) {
+    sets.push("slackProgressMessageTs = ?");
+    args.push(fields.slackProgressMessageTs ?? null);
+  }
+  if (Object.hasOwn(fields, "slackTreeRootMessageTs")) {
+    sets.push("slackTreeRootMessageTs = ?");
+    args.push(fields.slackTreeRootMessageTs ?? null);
+  }
+  if (sets.length === 0) return;
+
+  args.push(taskId);
+  getDb().run(`UPDATE agent_tasks SET ${sets.join(", ")} WHERE id = ?`, args);
+}
+
 export function getChildTasks(parentTaskId: string): AgentTask[] {
   return getDb()
     .prepare<AgentTaskRow, [string]>(
@@ -2850,6 +2882,7 @@ export interface CreateTaskOptions {
   dir?: string;
   parentTaskId?: string;
   model?: string;
+  modelTier?: ModelTier;
   scheduleId?: string;
   workflowRunId?: string;
   workflowRunStepId?: string;
@@ -3056,9 +3089,9 @@ export function createTaskExtended(task: string, options?: CreateTaskOptions): A
         vcsProvider, vcsRepo, vcsEventType, vcsNumber, vcsCommentId, vcsAuthor, vcsUrl,
         vcsInstallationId, vcsNodeId,
         agentmailInboxId, agentmailMessageId, agentmailThreadId,
-        mentionMessageId, mentionChannelId, dir, parentTaskId, model, scheduleId,
+        mentionMessageId, mentionChannelId, dir, parentTaskId, model, modelTier, scheduleId,
         workflowRunId, workflowRunStepId, outputSchema, followUpConfig, requestedByUserId, contextKey, swarmVersion, createdAt, lastUpdatedAt, created_by, updated_by
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
     )
     .get(
       id,
@@ -3093,6 +3126,7 @@ export function createTaskExtended(task: string, options?: CreateTaskOptions): A
       options?.dir ?? null,
       options?.parentTaskId ?? null,
       options?.model ?? null,
+      options?.modelTier ?? null,
       options?.scheduleId ?? null,
       options?.workflowRunId ?? null,
       options?.workflowRunStepId ?? null,
@@ -5266,6 +5300,7 @@ type ScheduledTaskRow = {
   lastErrorAt: string | null;
   lastErrorMessage: string | null;
   model: string | null;
+  modelTier: string | null;
   scheduleType: string;
   createdAt: string;
   lastUpdatedAt: string;
@@ -5306,7 +5341,8 @@ function rowToScheduledTask(row: ScheduledTaskRow): ScheduledTask {
     consecutiveErrors: row.consecutiveErrors ?? 0,
     lastErrorAt: normalizeDate(row.lastErrorAt) ?? undefined,
     lastErrorMessage: row.lastErrorMessage ?? undefined,
-    model: (row.model as "haiku" | "sonnet" | "opus" | "fable" | null) ?? undefined,
+    model: row.model ?? undefined,
+    modelTier: parseModelTier(row.modelTier) ?? undefined,
     scheduleType: row.scheduleType as "recurring" | "one_time",
     createdAt: normalizeDateRequired(row.createdAt),
     lastUpdatedAt: normalizeDateRequired(row.lastUpdatedAt),
@@ -5401,6 +5437,7 @@ export interface CreateScheduledTaskData {
   createdByAgentId?: string;
   timezone?: string;
   model?: string;
+  modelTier?: ModelTier;
   scheduleType?: "recurring" | "one_time";
 }
 
@@ -5413,8 +5450,8 @@ export function createScheduledTask(data: CreateScheduledTaskData): ScheduledTas
       `INSERT INTO scheduled_tasks (
         id, name, description, cronExpression, intervalMs, taskTemplate,
         taskType, tags, priority, targetAgentId, enabled, nextRunAt,
-        createdByAgentId, timezone, model, scheduleType, createdAt, lastUpdatedAt
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
+        createdByAgentId, timezone, model, modelTier, scheduleType, createdAt, lastUpdatedAt
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
     )
     .get(
       id,
@@ -5432,6 +5469,7 @@ export function createScheduledTask(data: CreateScheduledTaskData): ScheduledTas
       data.createdByAgentId ?? null,
       data.timezone ?? "UTC",
       data.model ?? null,
+      data.modelTier ?? null,
       data.scheduleType ?? "recurring",
       now,
       now,
@@ -5459,6 +5497,7 @@ export interface UpdateScheduledTaskData {
   lastErrorAt?: string | null;
   lastErrorMessage?: string | null;
   model?: string | null;
+  modelTier?: ModelTier | null;
   scheduleType?: "recurring" | "one_time";
   lastUpdatedAt?: string;
 }
@@ -5538,6 +5577,10 @@ export function updateScheduledTask(
     updates.push("model = ?");
     params.push(data.model);
   }
+  if (data.modelTier !== undefined) {
+    updates.push("modelTier = ?");
+    params.push(data.modelTier);
+  }
   if (data.scheduleType !== undefined) {
     updates.push("scheduleType = ?");
     params.push(data.scheduleType);
@@ -9394,6 +9437,7 @@ type McpServerRow = {
   headers: string | null;
   envConfigKeys: string | null;
   headerConfigKeys: string | null;
+  extraAuthorizeParams: string | null;
   authMethod: string | null;
   isEnabled: number;
   version: number;
@@ -9425,6 +9469,7 @@ function rowToMcpServer(row: McpServerRow): McpServer {
     headers: row.headers,
     envConfigKeys: row.envConfigKeys,
     headerConfigKeys: row.headerConfigKeys,
+    extraAuthorizeParams: row.extraAuthorizeParams,
     authMethod: (row.authMethod as McpServer["authMethod"]) ?? "static",
     isEnabled: row.isEnabled === 1,
     version: row.version,
@@ -9463,6 +9508,7 @@ export interface McpServerInsert {
   headers?: string;
   envConfigKeys?: string;
   headerConfigKeys?: string;
+  extraAuthorizeParams?: string;
 }
 
 export function createMcpServer(data: McpServerInsert): McpServer {
@@ -9474,9 +9520,9 @@ export function createMcpServer(data: McpServerInsert): McpServer {
       `INSERT INTO mcp_servers (
         id, name, description, scope, ownerAgentId, transport,
         command, args, url, headers,
-        envConfigKeys, headerConfigKeys,
+        envConfigKeys, headerConfigKeys, extraAuthorizeParams,
         isEnabled, version, createdAt, lastUpdatedAt
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, 1, ?, ?) RETURNING *`,
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, 1, ?, ?) RETURNING *`,
     )
     .get(
       id,
@@ -9491,6 +9537,7 @@ export function createMcpServer(data: McpServerInsert): McpServer {
       data.headers ?? null,
       data.envConfigKeys ?? null,
       data.headerConfigKeys ?? null,
+      data.extraAuthorizeParams ?? null,
       now,
       now,
     );
@@ -9553,6 +9600,10 @@ export function updateMcpServer(
     sets.push("headerConfigKeys = ?");
     params.push(updates.headerConfigKeys ?? null);
   }
+  if (updates.extraAuthorizeParams !== undefined) {
+    sets.push("extraAuthorizeParams = ?");
+    params.push(updates.extraAuthorizeParams ?? null);
+  }
   if (updates.isEnabled !== undefined) {
     sets.push("isEnabled = ?");
     params.push(updates.isEnabled ? 1 : 0);
@@ -9574,6 +9625,7 @@ export function updateMcpServer(
     "headers",
     "envConfigKeys",
     "headerConfigKeys",
+    "extraAuthorizeParams",
     "transport",
   ];
   if (configFields.some((f) => (updates as Record<string, unknown>)[f] !== undefined)) {
@@ -11801,6 +11853,7 @@ export function getScriptRunByIdempotencyKey(idempotencyKey: string): ScriptRun
 export function listScriptRuns(opts?: {
   status?: ScriptRunStatus;
   agentId?: string;
+  scriptName?: string;
   limit?: number;
   offset?: number;
 }): ScriptRunListItem[] {
@@ -11814,6 +11867,10 @@ export function listScriptRuns(opts?: {
     conditions.push("agentId = ?");
     params.push(opts.agentId);
   }
+  if (opts?.scriptName) {
+    conditions.push("scriptName = ?");
+    params.push(opts.scriptName);
+  }
 
   const limit = opts?.limit ?? 50;
   const offset = opts?.offset ?? 0;
@@ -11842,7 +11899,11 @@ export function listScriptRuns(opts?: {
   return rows.map(rowToScriptRunListItem);
 }
 
-export function countScriptRuns(opts?: { status?: ScriptRunStatus; agentId?: string }): number {
+export function countScriptRuns(opts?: {
+  status?: ScriptRunStatus;
+  agentId?: string;
+  scriptName?: string;
+}): number {
   const conditions: string[] = [];
   const params: string[] = [];
   if (opts?.status) {
@@ -11853,6 +11914,10 @@ export function countScriptRuns(opts?: { status?: ScriptRunStatus; agentId?: str
     conditions.push("agentId = ?");
     params.push(opts.agentId);
   }
+  if (opts?.scriptName) {
+    conditions.push("scriptName = ?");
+    params.push(opts.scriptName);
+  }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   const row = getDb()
     .prepare<{ count: number }, string[]>(`SELECT COUNT(*) AS count FROM script_runs ${where}`)

package/src/be/migrations/090_model_tiers.sql

@@ -0,0 +1,2 @@
+ALTER TABLE agent_tasks ADD COLUMN modelTier TEXT;
+ALTER TABLE scheduled_tasks ADD COLUMN modelTier TEXT;

package/src/be/migrations/091_seed_swarm_operations_metrics.sql

@@ -0,0 +1,12 @@
+-- Keep the seeded system dashboard aligned with the production swarm dashboard.
+-- Migration 081 created the starter row; this forward migration updates both
+-- fresh installs and existing databases without rewriting the applied seed.
+
+UPDATE metrics
+SET
+  title = 'Swarm operations overview',
+  description = 'A starter dashboard mixing raw SQL widgets with chart and table visualizations.',
+  definition = '{"version":1,"widgets":[{"id":"tasks-created-per-day","title":"Tasks created per day","description":"Daily task volume for the selected time range.","query":{"sql":"SELECT date(createdAt) AS day, COUNT(*) AS tasks FROM agent_tasks WHERE createdAt >= datetime(''now'', ?) GROUP BY day ORDER BY day","params":["{{rangeModifier}}"],"maxRows":100},"viz":{"type":"line","x":"day","y":"tasks","columns":[{"key":"day","label":"Day"},{"key":"tasks","label":"Tasks","format":"integer"}],"format":"integer"}},{"id":"usage-by-user","title":"Usage by user","description":"Tasks requested and session cost by user for the selected time range, requester filter, and agent filter.","query":{"sql":"SELECT COALESCE(u.name, ''Unassigned'') AS user, COUNT(DISTINCT t.id) AS tasks, ROUND(COALESCE(SUM(sc.totalCostUsd), 0), 4) AS cost_usd FROM agent_tasks t LEFT JOIN users u ON u.id = t.requestedByUserId LEFT JOIN session_costs sc ON sc.taskId = t.id WHERE t.createdAt >= datetime(''now'', ?) AND (? = '''' OR COALESCE(u.id, '''') = ? OR COALESCE(u.name, '''') LIKE ''%'' || ? || ''%'') AND (? = '''' OR COALESCE(t.agentId, '''') = ?) GROUP BY COALESCE(u.name, ''Unassigned'') ORDER BY cost_usd DESC, tasks DESC","params":["{{rangeModifier}}","{{userFilter}}","{{userFilter}}","{{userFilter}}","{{agentFilter}}","{{agentFilter}}"],"maxRows":100},"viz":{"type":"bar","x":"user","y":"tasks","columns":[{"key":"user","label":"User"},{"key":"tasks","label":"Tasks","format":"integer"},{"key":"cost_usd","label":"Cost","format":"currency"}],"format":"integer"}},{"id":"usage-by-model","title":"Usage by model","description":"Tasks, sessions, tokens, and total cost by model for the selected time range and agent filter.","query":{"sql":"SELECT model, COUNT(DISTINCT taskId) AS tasks, COUNT(*) AS sessions, SUM(inputTokens + outputTokens) AS tokens, ROUND(SUM(totalCostUsd), 2) AS cost_usd FROM session_costs WHERE createdAt >= datetime(''now'', ?) AND (? = '''' OR agentId = ?) GROUP BY model ORDER BY cost_usd DESC","params":["{{rangeModifier}}","{{agentFilter}}","{{agentFilter}}"],"maxRows":100},"viz":{"type":"bar","x":"model","y":"cost_usd","columns":[{"key":"model","label":"Model"},{"key":"tasks","label":"Tasks","format":"integer"},{"key":"sessions","label":"Sessions","format":"integer"},{"key":"tokens","label":"Tokens","format":"integer"},{"key":"cost_usd","label":"Cost","format":"currency"}],"format":"currency"}},{"id":"avg-cost-per-task-by-model","title":"Avg cost per task by model","description":"Average session cost per task, grouped by model, for the selected time range and agent filter.","query":{"sql":"SELECT model, COUNT(DISTINCT taskId) AS tasks, ROUND(SUM(totalCostUsd) * 1.0 / NULLIF(COUNT(DISTINCT taskId), 0), 4) AS avg_cost_per_task FROM session_costs WHERE createdAt >= datetime(''now'', ?) AND (? = '''' OR agentId = ?) GROUP BY model ORDER BY avg_cost_per_task DESC","params":["{{rangeModifier}}","{{agentFilter}}","{{agentFilter}}"],"maxRows":100},"viz":{"type":"bar","x":"model","y":"avg_cost_per_task","columns":[{"key":"model","label":"Model"},{"key":"tasks","label":"Tasks","format":"integer"},{"key":"avg_cost_per_task","label":"Avg cost / task","format":"currency"}],"format":"currency"}},{"id":"avg-task-time-by-model","title":"Avg task time by model","description":"Average wall-clock task duration (minutes) by model for finished tasks in the selected time range and agent filter.","query":{"sql":"SELECT model, COUNT(*) AS tasks, ROUND(AVG((julianday(finishedAt) - julianday(createdAt)) * 1440), 1) AS avg_minutes FROM agent_tasks WHERE finishedAt IS NOT NULL AND model IS NOT NULL AND createdAt >= datetime(''now'', ?) AND (? = '''' OR agentId = ?) GROUP BY model ORDER BY tasks DESC","params":["{{rangeModifier}}","{{agentFilter}}","{{agentFilter}}"],"maxRows":100},"viz":{"type":"bar","x":"model","y":"avg_minutes","columns":[{"key":"model","label":"Model"},{"key":"tasks","label":"Tasks","format":"integer"},{"key":"avg_minutes","label":"Avg time","format":"duration"}],"format":"duration"}},{"id":"cost-per-minute-by-model","title":"Cost per minute by model","description":"Total session cost divided by active session minutes, grouped by model. Active minutes = sum of session durations.","query":{"sql":"SELECT model, ROUND(SUM(durationMs) / 60000.0, 1) AS active_minutes, ROUND(SUM(totalCostUsd), 2) AS cost_usd, ROUND(SUM(totalCostUsd) / NULLIF(SUM(durationMs) / 60000.0, 0), 4) AS cost_per_minute FROM session_costs WHERE createdAt >= datetime(''now'', ?) AND (? = '''' OR agentId = ?) AND durationMs > 0 GROUP BY model ORDER BY cost_per_minute DESC","params":["{{rangeModifier}}","{{agentFilter}}","{{agentFilter}}"],"maxRows":100},"viz":{"type":"bar","x":"model","y":"cost_per_minute","columns":[{"key":"model","label":"Model"},{"key":"active_minutes","label":"Active minutes","format":"number"},{"key":"cost_usd","label":"Total cost","format":"currency"},{"key":"cost_per_minute","label":"Cost / min","format":"currency"}],"format":"currency"}},{"id":"cost-per-minute-by-agent","title":"Cost per minute by agent","description":"Total session cost divided by active session minutes, grouped by agent.","query":{"sql":"SELECT COALESCE(a.name, sc.agentId, ''unknown'') AS agent, ROUND(SUM(sc.durationMs) / 60000.0, 1) AS active_minutes, ROUND(SUM(sc.totalCostUsd), 2) AS cost_usd, ROUND(SUM(sc.totalCostUsd) / NULLIF(SUM(sc.durationMs) / 60000.0, 0), 4) AS cost_per_minute FROM session_costs sc LEFT JOIN agents a ON a.id = sc.agentId WHERE sc.createdAt >= datetime(''now'', ?) AND (? = '''' OR sc.agentId = ?) AND sc.durationMs > 0 GROUP BY agent ORDER BY cost_per_minute DESC","params":["{{rangeModifier}}","{{agentFilter}}","{{agentFilter}}"],"maxRows":100},"viz":{"type":"bar","x":"agent","y":"cost_per_minute","columns":[{"key":"agent","label":"Agent"},{"key":"active_minutes","label":"Active minutes","format":"number"},{"key":"cost_usd","label":"Total cost","format":"currency"},{"key":"cost_per_minute","label":"Cost / min","format":"currency"}],"format":"currency"}},{"id":"agent-performance","title":"Tasks, avg time & cost by agent","description":"Finished tasks per agent with average wall-clock duration and average cost per task for the selected time range.","query":{"sql":"SELECT COALESCE(a.name, t.agentId, ''unassigned'') AS agent, COUNT(*) AS tasks, ROUND(AVG((julianday(t.finishedAt) - julianday(t.createdAt)) * 1440), 1) AS avg_minutes, ROUND(COALESCE(SUM(sc.cost), 0), 2) AS cost_usd, ROUND(COALESCE(SUM(sc.cost), 0) / COUNT(*), 4) AS avg_cost_per_task, ROUND(COALESCE(SUM(sc.cost), 0) / NULLIF(SUM(sc.dur) / 60000.0, 0), 4) AS cost_per_minute FROM agent_tasks t LEFT JOIN agents a ON a.id = t.agentId LEFT JOIN (SELECT taskId, SUM(totalCostUsd) AS cost, SUM(durationMs) AS dur FROM session_costs GROUP BY taskId) sc ON sc.taskId = t.id WHERE t.finishedAt IS NOT NULL AND t.createdAt >= datetime(''now'', ?) AND (? = '''' OR COALESCE(t.agentId, '''') = ?) GROUP BY agent ORDER BY tasks DESC","params":["{{rangeModifier}}","{{agentFilter}}","{{agentFilter}}"],"maxRows":100},"viz":{"type":"table","columns":[{"key":"agent","label":"Agent"},{"key":"tasks","label":"Tasks","format":"integer"},{"key":"avg_minutes","label":"Avg time","format":"duration"},{"key":"avg_cost_per_task","label":"Avg cost / task","format":"currency"},{"key":"cost_usd","label":"Total cost","format":"currency"},{"key":"cost_per_minute","label":"Cost / min","format":"currency"}]}},{"id":"task-outcomes-by-day","title":"Task outcomes by day","description":"Completed and failed tasks for the selected time range.","query":{"sql":"SELECT date(finishedAt) AS day, SUM(CASE WHEN status = ''completed'' THEN 1 ELSE 0 END) AS completed, SUM(CASE WHEN status = ''failed'' THEN 1 ELSE 0 END) AS failed FROM agent_tasks WHERE finishedAt IS NOT NULL AND finishedAt >= datetime(''now'', ?) GROUP BY day ORDER BY day","params":["{{rangeModifier}}"],"maxRows":100},"viz":{"type":"multi-line","x":"day","series":["completed","failed"],"columns":[{"key":"day","label":"Day"},{"key":"completed","label":"Completed","format":"integer"},{"key":"failed","label":"Failed","format":"integer"}],"format":"integer"}},{"id":"recent-task-outcomes","title":"Recent task outcomes","description":"Task status breakdown for tasks created in the selected time range.","query":{"sql":"SELECT status, COUNT(*) AS tasks FROM agent_tasks WHERE createdAt >= datetime(''now'', ?) GROUP BY status ORDER BY tasks DESC","params":["{{rangeModifier}}"],"maxRows":100},"viz":{"type":"table","columns":[{"key":"status","label":"Status"},{"key":"tasks","label":"Tasks","format":"integer"}]}}],"variables":[{"key":"rangeModifier","label":"Time range","type":"select","defaultValue":"-30 days","options":[{"label":"Last 7 days","value":"-7 days"},{"label":"Last 30 days","value":"-30 days"},{"label":"Last 90 days","value":"-90 days"}]},{"key":"userFilter","label":"Requester user ID or name","type":"text","defaultValue":""},{"key":"agentFilter","label":"Agent ID","type":"text","defaultValue":""}],"layout":{"columns":3},"refreshSeconds":60}',
+  updatedAt = CURRENT_TIMESTAMP
+WHERE agentId = 'system'
+  AND slug = 'swarm-operations-overview';

package/src/be/migrations/092_metrics_dashboard_combobox_filters.sql

@@ -0,0 +1,68 @@
+-- Convert the seeded system dashboard user/agent filters from free-text inputs
+-- to dynamic select variables. The UI renders select variables with resolved
+-- options as searchable comboboxes.
+
+UPDATE metrics
+SET
+  definition = json_set(
+    replace(
+      replace(
+        replace(
+          replace(
+            replace(
+              definition,
+              '? = '''' OR COALESCE(u.id, '''') = ? OR COALESCE(u.name, '''') LIKE ''%'' || ? || ''%''',
+              '? = ''all'' OR COALESCE(u.id, '''') = ? OR COALESCE(u.name, '''') LIKE ''%'' || ? || ''%'''
+            ),
+            '? = '''' OR agentId = ?',
+            '? = ''all'' OR agentId = ?'
+          ),
+          '? = '''' OR sc.agentId = ?',
+          '? = ''all'' OR sc.agentId = ?'
+        ),
+        '? = '''' OR COALESCE(t.agentId, '''') = ?',
+        '? = ''all'' OR COALESCE(t.agentId, '''') = ?'
+      ),
+      '? = '''' OR COALESCE(agentId, '''') = ?',
+      '? = ''all'' OR COALESCE(agentId, '''') = ?'
+    ),
+    '$.variables',
+    json('[
+      {
+        "key": "rangeModifier",
+        "label": "Time range",
+        "type": "select",
+        "defaultValue": "-30 days",
+        "options": [
+          { "label": "Last 7 days", "value": "-7 days" },
+          { "label": "Last 30 days", "value": "-30 days" },
+          { "label": "Last 90 days", "value": "-90 days" }
+        ]
+      },
+      {
+        "key": "userFilter",
+        "label": "Requester",
+        "type": "select",
+        "defaultValue": "all",
+        "optionsQuery": {
+          "sql": "SELECT id, label FROM (SELECT ''all'' AS id, ''All requesters'' AS label, 0 AS sort_key UNION ALL SELECT id, COALESCE(NULLIF(name, ''''), email, id) AS label, 1 AS sort_key FROM users WHERE id IS NOT NULL) ORDER BY sort_key, label COLLATE NOCASE",
+          "valueKey": "id",
+          "labelKey": "label"
+        }
+      },
+      {
+        "key": "agentFilter",
+        "label": "Agent",
+        "type": "select",
+        "defaultValue": "all",
+        "optionsQuery": {
+          "sql": "SELECT id, label FROM (SELECT ''all'' AS id, ''All agents'' AS label, 0 AS sort_key UNION ALL SELECT id, COALESCE(NULLIF(name, ''''), id) AS label, 1 AS sort_key FROM agents WHERE id IS NOT NULL) ORDER BY sort_key, label COLLATE NOCASE",
+          "valueKey": "id",
+          "labelKey": "label"
+        }
+      }
+    ]')
+  ),
+  updatedAt = CURRENT_TIMESTAMP
+WHERE agentId = 'system'
+  AND slug = 'swarm-operations-overview';

package/src/be/migrations/093_slack_message_tracking.sql

@@ -0,0 +1,6 @@
+-- Persist Slack message timestamps used by the watcher to update progress in place.
+-- Without this, a server restart drops process-local maps and the next watcher
+-- tick posts a duplicate progress/tree message in the same Slack thread.
+
+ALTER TABLE agent_tasks ADD COLUMN slackProgressMessageTs TEXT;
+ALTER TABLE agent_tasks ADD COLUMN slackTreeRootMessageTs TEXT;

package/src/be/migrations/094_mcp_extra_authorize_params.sql

@@ -0,0 +1,4 @@
+-- Extra OAuth authorize-request params, applied at authorize time only.
+-- JSON object string of flat string->string pairs, e.g. {"access_type":"offline","prompt":"consent"}.
+-- NULL (default) => authorize URL is unchanged from today. Provider-agnostic.
+ALTER TABLE mcp_servers ADD COLUMN extraAuthorizeParams TEXT;