@desplega.ai/agent-swarm 1.92.2 → 1.94.0

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,
@@ -65,6 +66,7 @@ import type {
   ScriptRun,
   ScriptRunJournalEntry,
   ScriptRunKind,
+  ScriptRunListItem,
   ScriptRunStatus,
   Service,
   ServiceStatus,
@@ -999,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;
@@ -1017,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;
@@ -1041,6 +1046,8 @@ type AgentTaskRow = {
   swarmVersion: string | null;
   provider: string | null;
   providerMeta: string | null;
+  harnessVariant: string | null;
+  harnessVariantMeta: string | null;
   totalCostUsd?: number | null;
 };
 
@@ -1085,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,
@@ -1102,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" | null) ?? undefined,
+    model: row.model ?? undefined,
+    modelTier: parseModelTier(row.modelTier) ?? undefined,
     scheduleId: row.scheduleId ?? undefined,
     workflowRunId: row.workflowRunId ?? undefined,
     workflowRunStepId: row.workflowRunStepId ?? undefined,
@@ -1127,6 +1137,8 @@ function rowToAgentTask(row: AgentTaskRow): AgentTask {
     swarmVersion: row.swarmVersion ?? undefined,
     provider: (row.provider as ProviderName | null) ?? undefined,
     providerMeta: parseProviderMeta(row.provider as ProviderName | null, row.providerMeta),
+    harnessVariant: row.harnessVariant ?? undefined,
+    harnessVariantMeta: row.harnessVariantMeta ? JSON.parse(row.harnessVariantMeta) : undefined,
     totalCostUsd: row.totalCostUsd ?? undefined,
   };
 }
@@ -1156,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,
@@ -1358,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]>(
@@ -1398,6 +1435,8 @@ export function updateTaskClaudeSessionId(
   provider?: ProviderName,
   providerMeta?: Record<string, unknown>,
   model?: string,
+  harnessVariant?: string,
+  harnessVariantMeta?: Record<string, unknown>,
 ): AgentTask | null {
   const setClauses = ["claudeSessionId = ?", "lastUpdatedAt = ?"];
   const params: (string | null)[] = [claudeSessionId, new Date().toISOString()];
@@ -1414,6 +1453,14 @@ export function updateTaskClaudeSessionId(
     setClauses.push("model = ?");
     params.push(model);
   }
+  if (harnessVariant !== undefined) {
+    setClauses.push("harnessVariant = ?");
+    params.push(harnessVariant);
+  }
+  if (harnessVariantMeta !== undefined) {
+    setClauses.push("harnessVariantMeta = ?");
+    params.push(JSON.stringify(harnessVariantMeta));
+  }
 
   params.push(taskId);
 
@@ -2835,6 +2882,7 @@ export interface CreateTaskOptions {
   dir?: string;
   parentTaskId?: string;
   model?: string;
+  modelTier?: ModelTier;
   scheduleId?: string;
   workflowRunId?: string;
   workflowRunStepId?: string;
@@ -3041,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,
@@ -3078,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,
@@ -5251,6 +5300,7 @@ type ScheduledTaskRow = {
   lastErrorAt: string | null;
   lastErrorMessage: string | null;
   model: string | null;
+  modelTier: string | null;
   scheduleType: string;
   createdAt: string;
   lastUpdatedAt: string;
@@ -5291,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" | 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),
@@ -5386,6 +5437,7 @@ export interface CreateScheduledTaskData {
   createdByAgentId?: string;
   timezone?: string;
   model?: string;
+  modelTier?: ModelTier;
   scheduleType?: "recurring" | "one_time";
 }
 
@@ -5398,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,
@@ -5417,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,
@@ -5444,6 +5497,7 @@ export interface UpdateScheduledTaskData {
   lastErrorAt?: string | null;
   lastErrorMessage?: string | null;
   model?: string | null;
+  modelTier?: ModelTier | null;
   scheduleType?: "recurring" | "one_time";
   lastUpdatedAt?: string;
 }
@@ -5523,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);
@@ -10058,6 +10116,28 @@ export function setApiKeyName(
   return result.changes > 0;
 }
 
+/**
+ * Clear a stale rate-limit record after a successful use proves the key is healthy.
+ */
+export function clearKeyRateLimit(
+  keyType: string,
+  keySuffix: string,
+  scope = "global",
+  scopeId: string | null = null,
+): boolean {
+  const now = new Date().toISOString();
+  const effectiveScopeId = scopeId ?? "";
+  const result = getDb()
+    .prepare(
+      `UPDATE api_key_status
+       SET status = 'available', rateLimitedUntil = NULL, updatedAt = ?
+       WHERE keyType = ? AND keySuffix = ? AND scope = ? AND scopeId = ?
+         AND status = 'rate_limited'`,
+    )
+    .run(now, keyType, keySuffix, scope, effectiveScopeId);
+  return result.changes > 0;
+}
+
 /**
  * Get all key status records for a credential type.
  */
@@ -11574,6 +11654,22 @@ type ScriptRunRow = {
   updated_by: string | null;
 };
 
+type ScriptRunListRow = Pick<
+  ScriptRunRow,
+  | "id"
+  | "agentId"
+  | "scriptName"
+  | "kind"
+  | "status"
+  | "pid"
+  | "startedAt"
+  | "finishedAt"
+  | "error"
+  | "last_heartbeat_at"
+  | "idempotencyKey"
+  | "requestedByUserId"
+>;
+
 function parseJsonColumn(value: string | null): unknown | undefined {
   if (value === null) return undefined;
   return JSON.parse(value);
@@ -11599,6 +11695,23 @@ function rowToScriptRun(row: ScriptRunRow): ScriptRun {
   };
 }
 
+function rowToScriptRunListItem(row: ScriptRunListRow): ScriptRunListItem {
+  return {
+    id: row.id,
+    agentId: row.agentId,
+    scriptName: row.scriptName ?? undefined,
+    kind: row.kind as ScriptRunKind,
+    status: row.status as ScriptRunStatus,
+    pid: row.pid ?? undefined,
+    startedAt: row.startedAt,
+    finishedAt: row.finishedAt ?? undefined,
+    error: row.error ?? undefined,
+    lastHeartbeatAt: row.last_heartbeat_at ?? undefined,
+    idempotencyKey: row.idempotencyKey ?? undefined,
+    requestedByUserId: row.requestedByUserId ?? undefined,
+  };
+}
+
 export function createScriptRun(data: {
   id: string;
   agentId: string;
@@ -11731,9 +11844,10 @@ export function getScriptRunByIdempotencyKey(idempotencyKey: string): ScriptRun
 export function listScriptRuns(opts?: {
   status?: ScriptRunStatus;
   agentId?: string;
+  scriptName?: string;
   limit?: number;
   offset?: number;
-}): ScriptRun[] {
+}): ScriptRunListItem[] {
   const conditions: string[] = [];
   const params: Array<string | number> = [];
   if (opts?.status) {
@@ -11744,20 +11858,43 @@ 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;
   params.push(limit, offset);
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   const rows = getDb()
-    .prepare<ScriptRunRow, Array<string | number>>(
-      `SELECT * FROM script_runs ${where} ORDER BY startedAt DESC LIMIT ? OFFSET ?`,
+    .prepare<ScriptRunListRow, Array<string | number>>(
+      `SELECT
+        id,
+        agentId,
+        scriptName,
+        kind,
+        status,
+        pid,
+        startedAt,
+        finishedAt,
+        error,
+        last_heartbeat_at,
+        idempotencyKey,
+        requestedByUserId
+       FROM script_runs ${where}
+       ORDER BY startedAt DESC
+       LIMIT ? OFFSET ?`,
     )
     .all(...params);
-  return rows.map(rowToScriptRun);
+  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) {
@@ -11768,6 +11905,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/memory/boot-reembed.ts

@@ -13,7 +13,6 @@ import { getEmbeddingProvider, getMemoryStore } from "./index";
 
 const VECTOR_BYTES = EMBEDDING_DIMENSIONS * Float32Array.BYTES_PER_ELEMENT;
 const BATCH_SIZE = 20;
-const BACKFILL_KV_KEY = "memory:reembed:backfill_complete";
 
 export async function runBootReembed(): Promise<void> {
   const db = getDb();

package/src/be/memory/providers/sqlite-store.ts

@@ -488,29 +488,19 @@ export class SqliteMemoryStore implements MemoryStore {
     }
   }
 
-  list(agentId: string, options: MemoryListOptions = {}): AgentMemory[] {
-    const { scope = "all", limit = 20, offset = 0, isLead = false, source } = options;
-    const db = getDb();
-
+  private buildListWhereClause(
+    agentId: string,
+    options: MemoryListOptions,
+  ): { whereClause: string; params: (Buffer | string | number | null)[] } {
+    const { scope = "all", isLead = false, ownerAgentId, source, sourcePath } = options;
     const conditions: string[] = [];
-    const params: (string | number)[] = [];
+    const params: (Buffer | string | number | null)[] = [];
 
-    if (!isLead) {
-      if (scope === "agent") {
-        conditions.push("agentId = ? AND scope = 'agent'");
-        params.push(agentId);
-      } else if (scope === "swarm") {
-        conditions.push("scope = 'swarm'");
-      } else {
-        conditions.push("(agentId = ? OR scope = 'swarm')");
-        params.push(agentId);
-      }
-    } else {
-      if (scope === "agent") {
-        conditions.push("scope = 'agent'");
-      } else if (scope === "swarm") {
-        conditions.push("scope = 'swarm'");
-      }
+    this.addScopeConditions(conditions, params, agentId, scope, isLead);
+
+    if (ownerAgentId) {
+      conditions.push("agentId = ?");
+      params.push(ownerAgentId);
     }
 
     if (source) {
@@ -518,18 +508,45 @@ export class SqliteMemoryStore implements MemoryStore {
       params.push(source);
     }
 
-    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    params.push(limit, offset);
+    const sourcePathNeedle = sourcePath?.trim().toLowerCase();
+    if (sourcePathNeedle) {
+      conditions.push("instr(lower(coalesce(sourcePath, '')), ?) > 0");
+      params.push(sourcePathNeedle);
+    }
+
+    return {
+      whereClause: conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "",
+      params,
+    };
+  }
+
+  list(agentId: string, options: MemoryListOptions = {}): AgentMemory[] {
+    const { limit = 20, offset = 0 } = options;
+    const db = getDb();
+    const { whereClause, params } = this.buildListWhereClause(agentId, options);
+    const queryParams = [...params, limit, offset];
 
     const rows = db
-      .prepare<AgentMemoryRow, (string | number)[]>(
+      .prepare<AgentMemoryRow, (Buffer | string | number | null)[]>(
         `SELECT * FROM agent_memory ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
       )
-      .all(...params);
+      .all(...queryParams);
 
     return rows.map(rowToAgentMemory);
   }
 
+  count(agentId: string, options: MemoryListOptions = {}): number {
+    const db = getDb();
+    const { whereClause, params } = this.buildListWhereClause(agentId, options);
+    const row = db
+      .prepare<{ count: number }, (Buffer | string | number | null)[]>(
+        `SELECT COUNT(*) AS count FROM agent_memory ${whereClause}`,
+      )
+      .get(...params);
+
+    return row?.count ?? 0;
+  }
+
   isSourceProtected(source: AgentMemorySource): boolean {
     return PROTECTED_SOURCES.has(source);
   }

package/src/be/memory/raters/llm-client.ts

@@ -75,6 +75,13 @@ AGENT RESPONSE / SUMMARY:
 
 Score 0..1.`;
 
+const PLACEHOLDER_PREFIX = "$";
+const QUERY_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{query}`;
+const MEMORY_ID_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{memoryId}`;
+const MEMORY_NAME_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{memoryName}`;
+const MEMORY_CONTENT_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{memoryContent}`;
+const RESPONSE_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{response}`;
+
 /**
  * `claude -p --output-format json` returns a JSON envelope of the shape
  * `{ result: string, ... }`. We parse the envelope, then JSON-parse the
@@ -83,11 +90,11 @@ Score 0..1.`;
 type ClaudeCliEnvelope = { result?: unknown };
 
 function buildPrompt(input: LlmRaterInput): string {
-  return PROMPT_TEMPLATE.replace("${query}", input.query)
-    .replace("${memoryId}", input.memory.id)
-    .replace("${memoryName}", input.memory.name)
-    .replace("${memoryContent}", input.memory.content)
-    .replace("${response}", input.response);
+  return PROMPT_TEMPLATE.replace(QUERY_PLACEHOLDER, input.query)
+    .replace(MEMORY_ID_PLACEHOLDER, input.memory.id)
+    .replace(MEMORY_NAME_PLACEHOLDER, input.memory.name)
+    .replace(MEMORY_CONTENT_PLACEHOLDER, input.memory.content)
+    .replace(RESPONSE_PLACEHOLDER, input.response);
 }
 
 function parseScoreAndReasoning(raw: unknown): LlmRaterResult | null {

package/src/be/memory/types.ts

@@ -22,6 +22,7 @@ export interface MemoryStore {
   peek(id: string): AgentMemory | null;
   search(embedding: Float32Array, agentId: string, options: MemorySearchOptions): MemoryCandidate[];
   list(agentId: string, options: MemoryListOptions): AgentMemory[];
+  count(agentId: string, options: MemoryListOptions): number;
   isSourceProtected(source: AgentMemorySource): boolean;
   listForCuration(
     agentId?: string,
@@ -80,7 +81,9 @@ export interface MemoryListOptions {
   limit?: number;
   offset?: number;
   isLead?: boolean;
+  ownerAgentId?: string;
   source?: AgentMemorySource;
+  sourcePath?: string;
 }
 
 export interface MemoryStats {

package/src/be/migrations/088_script_runs_list_indexes.sql

@@ -0,0 +1,10 @@
+-- Keep script run list pages fast as historical rows accumulate.
+
+CREATE INDEX IF NOT EXISTS idx_script_runs_startedAt
+  ON script_runs(startedAt DESC);
+
+CREATE INDEX IF NOT EXISTS idx_script_runs_status_startedAt
+  ON script_runs(status, startedAt DESC);
+
+CREATE INDEX IF NOT EXISTS idx_script_runs_agentId_startedAt
+  ON script_runs(agentId, startedAt DESC);

package/src/be/migrations/089_harness_variant.sql

@@ -0,0 +1,2 @@
+ALTER TABLE agent_tasks ADD COLUMN harnessVariant TEXT;
+ALTER TABLE agent_tasks ADD COLUMN harnessVariantMeta TEXT;

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;