@desplega.ai/agent-swarm 1.87.0 → 1.89.0

package/src/be/db.ts

@@ -42,6 +42,11 @@ import type {
   McpServerScope,
   McpServerTransport,
   McpServerWithInstallInfo,
+  Metric,
+  MetricDefinition,
+  MetricSnapshot,
+  MetricSummary,
+  MetricVersion,
   Page,
   PageAuthMode,
   PageContentType,
@@ -90,6 +95,7 @@ import type {
 } from "../types";
 import { FollowUpConfigSchema, isTerminalTaskStatus } from "../types";
 import { deriveProviderFromKeyType } from "../utils/credentials";
+import { getCurrentRequestUserId } from "../utils/request-auth-context";
 import { scrubSecrets } from "../utils/secret-scrubber";
 import { decryptSecret, encryptSecret, getEncryptionKey, resolveEncryptionKey } from "./crypto";
 import { normalizeDate, normalizeDateRequired } from "./date-utils";
@@ -691,6 +697,14 @@ export function createAgent(
       agent.harnessProvider ?? null,
     );
   if (!row) throw new Error("Failed to create agent");
+  try {
+    installSystemDefaultSkillsForAgent(id);
+  } catch (err) {
+    console.warn(
+      "[db] Failed to install system-default skills for new agent:",
+      (err as Error).message,
+    );
+  }
   try {
     createLogEntry({ eventType: "agent_joined", agentId: id, newValue: agent.status });
   } catch {}
@@ -1264,6 +1278,31 @@ export function getPendingTaskForAgent(agentId: string): AgentTask | null {
   return null;
 }
 
+export function assignUnassignedTaskPending(taskId: string, agentId: string): AgentTask | null {
+  const now = new Date().toISOString();
+  const row = getDb()
+    .prepare<AgentTaskRow, [string, string, string]>(
+      `UPDATE agent_tasks SET agentId = ?, status = 'pending', lastUpdatedAt = ?
+       WHERE id = ? AND status = 'unassigned' RETURNING *`,
+    )
+    .get(agentId, now, taskId);
+
+  if (row) {
+    try {
+      createLogEntry({
+        eventType: "task_status_change",
+        agentId,
+        taskId,
+        oldValue: "unassigned",
+        newValue: "pending",
+        metadata: { pendingDispatch: true },
+      });
+    } catch {}
+  }
+
+  return row ? rowToAgentTask(row) : null;
+}
+
 export function startTask(taskId: string): AgentTask | null {
   const oldTask = getTaskById(taskId);
   if (!oldTask) return null;
@@ -2251,6 +2290,67 @@ export function getPausedTasksForAgent(agentId: string): AgentTask[] {
   return rows.map(rowToAgentTask);
 }
 
+export function getOrphanedInProgressTasksForAgent(
+  agentId: string,
+  minAgeSeconds = 60,
+): AgentTask[] {
+  const cutoff = new Date(Date.now() - minAgeSeconds * 1000).toISOString();
+  const rows = getDb()
+    .prepare<AgentTaskRow, [string, string]>(
+      `SELECT t.* FROM agent_tasks t
+       LEFT JOIN active_sessions s ON s.taskId = t.id
+       WHERE t.agentId = ?
+         AND t.status = 'in_progress'
+         AND t.claudeSessionId IS NULL
+         AND t.lastUpdatedAt < ?
+         AND s.id IS NULL
+         AND t.finishedAt IS NULL
+       ORDER BY t.createdAt ASC, t.rowid ASC`,
+    )
+    .all(agentId, cutoff);
+  return rows.map(rowToAgentTask);
+}
+
+export function resetOrphanedInProgressTasksForAgent(
+  agentId: string,
+  minAgeSeconds = 60,
+): AgentTask[] {
+  const cutoff = new Date(Date.now() - minAgeSeconds * 1000).toISOString();
+  const rows = getDb()
+    .prepare<AgentTaskRow, [string, string]>(
+      `UPDATE agent_tasks
+       SET status = 'pending',
+           lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+       WHERE id IN (
+         SELECT t.id FROM agent_tasks t
+         LEFT JOIN active_sessions s ON s.taskId = t.id
+         WHERE t.agentId = ?
+           AND t.status = 'in_progress'
+           AND t.claudeSessionId IS NULL
+           AND t.lastUpdatedAt < ?
+           AND s.id IS NULL
+           AND t.finishedAt IS NULL
+       )
+       RETURNING *`,
+    )
+    .all(agentId, cutoff);
+
+  for (const row of rows) {
+    try {
+      createLogEntry({
+        eventType: "task_status_change",
+        taskId: row.id,
+        agentId,
+        oldValue: "in_progress",
+        newValue: "pending",
+        metadata: { orphanedInProgressRecovery: true },
+      });
+    } catch {}
+  }
+
+  return rows.map(rowToAgentTask);
+}
+
 /**
  * Get recently cancelled tasks for an agent.
  * Used by hooks to detect task cancellation and stop the worker loop.
@@ -2858,6 +2958,7 @@ export function createTaskExtended(task: string, options?: CreateTaskOptions): A
     }
   }
 
+  const auditUserId = getCurrentRequestUserId() ?? null;
   const row = getDb()
     .prepare<AgentTaskRow, (string | number | null)[]>(
       `INSERT INTO agent_tasks (
@@ -2868,8 +2969,8 @@ export function createTaskExtended(task: string, options?: CreateTaskOptions): A
         vcsInstallationId, vcsNodeId,
         agentmailInboxId, agentmailMessageId, agentmailThreadId,
         mentionMessageId, mentionChannelId, dir, parentTaskId, model, scheduleId,
-        workflowRunId, workflowRunStepId, outputSchema, followUpConfig, requestedByUserId, contextKey, swarmVersion, createdAt, lastUpdatedAt
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
+        workflowRunId, workflowRunStepId, outputSchema, followUpConfig, requestedByUserId, contextKey, swarmVersion, createdAt, lastUpdatedAt, created_by, updated_by
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
     )
     .get(
       id,
@@ -2914,6 +3015,8 @@ export function createTaskExtended(task: string, options?: CreateTaskOptions): A
       pkg.version,
       now,
       now,
+      auditUserId,
+      auditUserId,
     );
 
   if (!row) throw new Error("Failed to create task");
@@ -7204,6 +7307,234 @@ export function getPageVersion(pageId: string, version: number): PageVersion | n
   return row ? rowToPageVersion(row) : null;
 }
 
+// ============================================================================
+// Metrics CRUD + version history
+// ----------------------------------------------------------------------------
+// Config-driven metrics mirror Pages: parent table `metrics` holds the current
+// JSON definition, and `metric_versions` holds pre-update snapshots.
+// ============================================================================
+
+type MetricRow = {
+  id: string;
+  agentId: string;
+  slug: string;
+  title: string;
+  description: string | null;
+  definition: string;
+  createdAt: string;
+  updatedAt: string;
+};
+
+function rowToMetric(row: MetricRow): Metric {
+  return {
+    id: row.id,
+    agentId: row.agentId,
+    slug: row.slug,
+    title: row.title,
+    description: row.description ?? undefined,
+    definition: JSON.parse(row.definition) as MetricDefinition,
+    createdAt: normalizeDateRequired(row.createdAt),
+    updatedAt: normalizeDateRequired(row.updatedAt),
+  };
+}
+
+function rowToMetricSummary(row: MetricRow): MetricSummary {
+  return {
+    id: row.id,
+    agentId: row.agentId,
+    slug: row.slug,
+    title: row.title,
+    description: row.description ?? undefined,
+    createdAt: normalizeDateRequired(row.createdAt),
+    updatedAt: normalizeDateRequired(row.updatedAt),
+  };
+}
+
+export function createMetric(data: {
+  agentId: string;
+  slug: string;
+  title: string;
+  description?: string;
+  definition: MetricDefinition;
+}): Metric {
+  const row = getDb()
+    .prepare<MetricRow, [string, string, string, string | null, string]>(
+      `INSERT INTO metrics (agentId, slug, title, description, definition)
+       VALUES (?, ?, ?, ?, ?) RETURNING *`,
+    )
+    .get(
+      data.agentId,
+      data.slug,
+      data.title,
+      data.description ?? null,
+      JSON.stringify(data.definition),
+    );
+  if (!row) throw new Error("Failed to create metric");
+  return rowToMetric(row);
+}
+
+export function getMetric(id: string): Metric | null {
+  const row = getDb().prepare<MetricRow, [string]>("SELECT * FROM metrics WHERE id = ?").get(id);
+  return row ? rowToMetric(row) : null;
+}
+
+export function getMetricBySlug(agentId: string, slug: string): Metric | null {
+  const row = getDb()
+    .prepare<MetricRow, [string, string]>("SELECT * FROM metrics WHERE agentId = ? AND slug = ?")
+    .get(agentId, slug);
+  return row ? rowToMetric(row) : null;
+}
+
+export function listMetricsByAgent(agentId: string, limit?: number, offset?: number): Metric[];
+export function listMetricsByAgent(
+  agentId: string,
+  limit: number | undefined,
+  offset: number | undefined,
+  opts: { slim: true },
+): MetricSummary[];
+export function listMetricsByAgent(
+  agentId: string,
+  limit = 100,
+  offset = 0,
+  opts?: { slim?: boolean },
+): Metric[] | MetricSummary[] {
+  const rows = getDb()
+    .prepare<MetricRow, [string, number, number]>(
+      "SELECT * FROM metrics WHERE agentId = ? ORDER BY updatedAt DESC LIMIT ? OFFSET ?",
+    )
+    .all(agentId, limit, offset);
+  return opts?.slim ? rows.map(rowToMetricSummary) : rows.map(rowToMetric);
+}
+
+export function listAllMetrics(limit?: number, offset?: number): Metric[];
+export function listAllMetrics(
+  limit: number | undefined,
+  offset: number | undefined,
+  opts: { slim: true },
+): MetricSummary[];
+export function listAllMetrics(
+  limit = 100,
+  offset = 0,
+  opts?: { slim?: boolean },
+): Metric[] | MetricSummary[] {
+  const rows = getDb()
+    .prepare<MetricRow, [number, number]>(
+      "SELECT * FROM metrics ORDER BY updatedAt DESC LIMIT ? OFFSET ?",
+    )
+    .all(limit, offset);
+  return opts?.slim ? rows.map(rowToMetricSummary) : rows.map(rowToMetric);
+}
+
+export function countAllMetrics(): number {
+  const row = getDb().prepare<{ count: number }, []>("SELECT COUNT(*) AS count FROM metrics").get();
+  return row?.count ?? 0;
+}
+
+export function countMetricsByAgent(agentId: string): number {
+  const row = getDb()
+    .prepare<{ count: number }, [string]>("SELECT COUNT(*) AS count FROM metrics WHERE agentId = ?")
+    .get(agentId);
+  return row?.count ?? 0;
+}
+
+export function updateMetric(
+  id: string,
+  data: {
+    title?: string;
+    description?: string | null;
+    definition?: MetricDefinition;
+    slug?: string;
+  },
+): Metric | null {
+  const updates: string[] = [];
+  const params: (string | null)[] = [];
+  if (data.title !== undefined) {
+    updates.push("title = ?");
+    params.push(data.title);
+  }
+  if (data.description !== undefined) {
+    updates.push("description = ?");
+    params.push(data.description ?? null);
+  }
+  if (data.definition !== undefined) {
+    updates.push("definition = ?");
+    params.push(JSON.stringify(data.definition));
+  }
+  if (data.slug !== undefined) {
+    updates.push("slug = ?");
+    params.push(data.slug);
+  }
+  if (updates.length === 0) return getMetric(id);
+  updates.push("updatedAt = ?");
+  params.push(new Date().toISOString());
+  params.push(id);
+  const row = getDb()
+    .prepare<MetricRow, (string | null)[]>(
+      `UPDATE metrics SET ${updates.join(", ")} WHERE id = ? RETURNING *`,
+    )
+    .get(...params);
+  return row ? rowToMetric(row) : null;
+}
+
+export function deleteMetric(id: string): boolean {
+  const result = getDb().run("DELETE FROM metrics WHERE id = ?", [id]);
+  return result.changes > 0;
+}
+
+type MetricVersionRow = {
+  id: string;
+  metricId: string;
+  version: number;
+  snapshot: string;
+  changedByAgentId: string | null;
+  createdAt: string;
+};
+
+function rowToMetricVersion(row: MetricVersionRow): MetricVersion {
+  return {
+    id: row.id,
+    metricId: row.metricId,
+    version: row.version,
+    snapshot: JSON.parse(row.snapshot) as MetricSnapshot,
+    changedByAgentId: row.changedByAgentId ?? undefined,
+    createdAt: normalizeDateRequired(row.createdAt),
+  };
+}
+
+export function createMetricVersion(data: {
+  metricId: string;
+  version: number;
+  snapshot: MetricSnapshot;
+  changedByAgentId?: string;
+}): MetricVersion {
+  const row = getDb()
+    .prepare<MetricVersionRow, [string, number, string, string | null]>(
+      `INSERT INTO metric_versions (metricId, version, snapshot, changedByAgentId)
+       VALUES (?, ?, ?, ?) RETURNING *`,
+    )
+    .get(data.metricId, data.version, JSON.stringify(data.snapshot), data.changedByAgentId ?? null);
+  if (!row) throw new Error("Failed to create metric version");
+  return rowToMetricVersion(row);
+}
+
+export function getMetricVersions(metricId: string): MetricVersion[] {
+  return getDb()
+    .prepare<MetricVersionRow, [string]>(
+      "SELECT * FROM metric_versions WHERE metricId = ? ORDER BY version DESC",
+    )
+    .all(metricId)
+    .map(rowToMetricVersion);
+}
+
+export function getMetricVersion(metricId: string, version: number): MetricVersion | null {
+  const row = getDb()
+    .prepare<MetricVersionRow, [string, number]>(
+      "SELECT * FROM metric_versions WHERE metricId = ? AND version = ?",
+    )
+    .get(metricId, version);
+  return row ? rowToMetricVersion(row) : null;
+}
+
 // ============================================================================
 // Prompt Template Operations
 // ============================================================================
@@ -8247,6 +8578,7 @@ type SkillRow = {
   userInvocable: number;
   version: number;
   isEnabled: number;
+  systemDefault: number;
   createdAt: string;
   lastUpdatedAt: string;
   lastFetchedAt: string | null;
@@ -8276,6 +8608,7 @@ function rowToSkill(row: SkillRow): Skill {
     userInvocable: row.userInvocable === 1,
     version: row.version,
     isEnabled: row.isEnabled === 1,
+    systemDefault: row.systemDefault === 1,
     createdAt: row.createdAt,
     lastUpdatedAt: row.lastUpdatedAt,
     lastFetchedAt: row.lastFetchedAt,
@@ -8300,7 +8633,12 @@ function rowToAgentSkill(row: AgentSkillRow): AgentSkill {
   };
 }
 
-type SkillWithInstallRow = SkillRow & { isActive: number; installedAt: string };
+type SkillWithInstallRow = SkillRow & {
+  isActive: number;
+  installedAt: string;
+  sourceRank?: number;
+  typeRank?: number;
+};
 
 function rowToSkillWithInstall(row: SkillWithInstallRow): SkillWithInstallInfo {
   return {
@@ -8330,6 +8668,7 @@ export interface SkillInsert {
   agent?: string;
   disableModelInvocation?: boolean;
   userInvocable?: boolean;
+  systemDefault?: boolean;
 }
 
 export function createSkill(data: SkillInsert): Skill {
@@ -8342,8 +8681,8 @@ export function createSkill(data: SkillInsert): Skill {
         id, name, description, content, type, scope, ownerAgentId,
         sourceUrl, sourceRepo, sourcePath, sourceBranch, sourceHash, isComplex,
         allowedTools, model, effort, context, agent, disableModelInvocation, userInvocable,
-        version, isEnabled, createdAt, lastUpdatedAt
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, 1, ?, ?) RETURNING *`,
+        version, isEnabled, systemDefault, createdAt, lastUpdatedAt
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, 1, ?, ?, ?) RETURNING *`,
     )
     .get(
       id,
@@ -8366,6 +8705,7 @@ export function createSkill(data: SkillInsert): Skill {
       data.agent ?? null,
       data.disableModelInvocation ? 1 : 0,
       data.userInvocable === false ? 0 : 1,
+      data.systemDefault ? 1 : 0,
       now,
       now,
     );
@@ -8405,6 +8745,10 @@ export function updateSkill(
     sets.push("isEnabled = ?");
     params.push(updates.isEnabled ? 1 : 0);
   }
+  if (updates.systemDefault !== undefined) {
+    sets.push("systemDefault = ?");
+    params.push(updates.systemDefault ? 1 : 0);
+  }
   if (updates.allowedTools !== undefined) {
     sets.push("allowedTools = ?");
     params.push(updates.allowedTools ?? null);
@@ -8516,7 +8860,7 @@ export interface SkillFilters {
  * which is replaced with an empty string so the row still satisfies `Skill`.
  */
 const SKILL_SLIM_COLUMNS =
-  "id, name, description, type, scope, ownerAgentId, sourceUrl, sourceRepo, sourcePath, sourceBranch, sourceHash, isComplex, allowedTools, model, effort, context, agent, disableModelInvocation, userInvocable, version, isEnabled, createdAt, lastUpdatedAt, lastFetchedAt, '' as content";
+  "id, name, description, type, scope, ownerAgentId, sourceUrl, sourceRepo, sourcePath, sourceBranch, sourceHash, isComplex, allowedTools, model, effort, context, agent, disableModelInvocation, userInvocable, version, isEnabled, systemDefault, createdAt, lastUpdatedAt, lastFetchedAt, '' as content";
 
 export function listSkills(filters?: SkillFilters): Skill[] {
   const columns = filters?.includeContent === false ? SKILL_SLIM_COLUMNS : "*";
@@ -8586,6 +8930,19 @@ export function installSkill(agentId: string, skillId: string): AgentSkill {
   return rowToAgentSkill(row);
 }
 
+export function getSystemDefaultSkills(): Skill[] {
+  return getDb()
+    .prepare<SkillRow, []>(
+      "SELECT * FROM skills WHERE systemDefault = 1 AND isEnabled = 1 ORDER BY name ASC",
+    )
+    .all()
+    .map(rowToSkill);
+}
+
+export function installSystemDefaultSkillsForAgent(agentId: string): AgentSkill[] {
+  return getSystemDefaultSkills().map((skill) => installSkill(agentId, skill.id));
+}
+
 export function uninstallSkill(agentId: string, skillId: string): boolean {
   const result = getDb()
     .prepare("DELETE FROM agent_skills WHERE agentId = ? AND skillId = ?")
@@ -8595,15 +8952,23 @@ export function uninstallSkill(agentId: string, skillId: string): boolean {
 
 export function getAgentSkills(agentId: string, activeOnly = true): SkillWithInstallInfo[] {
   const query = `
-    SELECT s.*, as2.isActive, as2.installedAt
+    SELECT s.*, as2.isActive, as2.installedAt, 0 as sourceRank,
+      CASE WHEN s.type = 'personal' THEN 0 ELSE 1 END as typeRank
     FROM skills s
     JOIN agent_skills as2 ON s.id = as2.skillId
     WHERE as2.agentId = ?
       ${activeOnly ? "AND as2.isActive = 1" : ""}
       AND s.isEnabled = 1
+    UNION ALL
+    SELECT s.*, 1 as isActive, s.createdAt as installedAt, 1 as sourceRank,
+      CASE WHEN s.type = 'personal' THEN 0 ELSE 1 END as typeRank
+    FROM skills s
+    WHERE s.systemDefault = 1
+      AND s.isEnabled = 1
     ORDER BY
-      CASE WHEN s.type = 'personal' THEN 0 ELSE 1 END,
-      s.name
+      sourceRank,
+      typeRank,
+      name
   `;
 
   const rows = getDb().prepare<SkillWithInstallRow, [string]>(query).all(agentId);

package/src/be/migrations/080_skill_system_defaults.sql

@@ -0,0 +1,8 @@
+-- 080_skill_system_defaults.sql
+-- Adds a first-class marker for skills that are installed for every agent.
+-- Forward migration: add nullable-safe column with default 0.
+-- Reverse operation, if ever needed: ALTER TABLE skills DROP COLUMN systemDefault;
+
+ALTER TABLE skills ADD COLUMN systemDefault INTEGER NOT NULL DEFAULT 0;
+
+CREATE INDEX IF NOT EXISTS idx_skills_system_default ON skills(systemDefault);

package/src/be/migrations/081_metrics.sql

@@ -0,0 +1,39 @@
+-- Config-driven metrics. Mirrors Pages: parent table holds the current
+-- definition, metric_versions stores pre-update snapshots.
+
+CREATE TABLE IF NOT EXISTS metrics (
+  id           TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  agentId      TEXT NOT NULL,
+  slug         TEXT NOT NULL,
+  title        TEXT NOT NULL,
+  description  TEXT,
+  definition   TEXT NOT NULL,
+  createdAt    TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updatedAt    TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE (agentId, slug)
+);
+
+CREATE INDEX IF NOT EXISTS idx_metrics_agentId ON metrics(agentId);
+CREATE INDEX IF NOT EXISTS idx_metrics_updatedAt ON metrics(updatedAt DESC);
+
+CREATE TABLE IF NOT EXISTS metric_versions (
+  id                  TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  metricId            TEXT NOT NULL REFERENCES metrics(id) ON DELETE CASCADE,
+  version             INTEGER NOT NULL,
+  snapshot            TEXT NOT NULL,
+  changedByAgentId    TEXT,
+  createdAt           TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE (metricId, version)
+);
+
+CREATE INDEX IF NOT EXISTS idx_metric_versions_metricId ON metric_versions(metricId);
+
+INSERT OR IGNORE INTO metrics (agentId, slug, title, description, definition)
+VALUES
+  (
+    'system',
+    'swarm-operations-overview',
+    'Swarm operations overview',
+    'A starter dashboard mixing raw SQL widgets with chart and table visualizations.',
+    '{"version":1,"refreshSeconds":60,"layout":{"columns":2},"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":""}],"widgets":[{"id":"open-tasks","title":"Open tasks","description":"Tasks that are not terminal.","query":{"sql":"SELECT COUNT(*) AS open_tasks FROM agent_tasks WHERE status NOT IN (''completed'', ''failed'', ''cancelled'', ''superseded'')","maxRows":10},"viz":{"type":"stat","value":"open_tasks","format":"integer"}},{"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","format":"integer","columns":[{"key":"day","label":"Day"},{"key":"tasks","label":"Tasks","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","format":"integer","columns":[{"key":"user","label":"User"},{"key":"tasks","label":"Tasks","format":"integer"},{"key":"cost_usd","label":"Cost","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"],"format":"integer","columns":[{"key":"day","label":"Day"},{"key":"completed","label":"Completed","format":"integer"},{"key":"failed","label":"Failed","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"}]}}]}'
+  );

package/src/be/migrations/082_user_audit_fields.sql

@@ -0,0 +1,120 @@
+-- Add nullable user audit columns to mutable/user-facing tables.
+-- Existing rows and system-originated writes remain NULL.
+
+ALTER TABLE agents ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE agents ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE channels ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE channels ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE agent_tasks ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE agent_tasks ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE channel_messages ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE channel_messages ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE services ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE services ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE inbox_messages ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE inbox_messages ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE scheduled_tasks ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE scheduled_tasks ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE swarm_config ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE swarm_config ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE swarm_repos ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE swarm_repos ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE agent_memory ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE agent_memory ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE agentmail_inbox_mappings ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE agentmail_inbox_mappings ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE workflows ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE workflows ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE workflow_runs ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE workflow_runs ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE workflow_run_steps ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE workflow_run_steps ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE workflow_versions ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE workflow_versions ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE prompt_templates ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE prompt_templates ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE prompt_template_history ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE prompt_template_history ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE approval_requests ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE approval_requests ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE mcp_servers ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE mcp_servers ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE mcp_oauth_tokens ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE mcp_oauth_tokens ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE mcp_oauth_pending ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE mcp_oauth_pending ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE task_templates ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE task_templates ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE pages ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE pages ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE page_versions ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE page_versions ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE kv_entries ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE kv_entries ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE scripts ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE scripts ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE script_versions ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE script_versions ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE skills ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE skills ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE users ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE users ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE user_external_ids ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE user_external_ids ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE user_tokens ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE user_tokens ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE task_attachments ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE task_attachments ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE budgets ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE budgets ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE pricing ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE pricing ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE inbox_item_state ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE inbox_item_state ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE metrics ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE metrics ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+ALTER TABLE metric_versions ADD COLUMN created_by TEXT REFERENCES users(id);
+ALTER TABLE metric_versions ADD COLUMN updated_by TEXT REFERENCES users(id);
+
+CREATE INDEX IF NOT EXISTS idx_agent_tasks_created_by ON agent_tasks(created_by) WHERE created_by IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_agent_tasks_updated_by ON agent_tasks(updated_by) WHERE updated_by IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_workflows_created_by ON workflows(created_by) WHERE created_by IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_pages_created_by ON pages(created_by) WHERE created_by IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_scripts_created_by ON scripts(created_by) WHERE created_by IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_skills_created_by ON skills(created_by) WHERE created_by IS NOT NULL;