@desplega.ai/agent-swarm 1.92.0 → 1.92.1

package/src/be/seed-scripts/catalog/boot-triage.ts

@@ -0,0 +1,221 @@
+import { z } from "zod";
+
+export const argsSchema = z.object({
+  nowIso: z.string().optional().describe("Triage clock override (default: current time)"),
+  failureLookbackMinutes: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("Look back this many minutes for real failures (default 60)"),
+  stuckMinutes: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("Flag in-progress tasks older than this on offline agents (default 5)"),
+  deployWindowMinutes: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("Window around now for merged agent-swarm PRs (default 15)"),
+  repo: z
+    .string()
+    .optional()
+    .describe("Optional GitHub repository in 'owner/name' form for restart/deploy PR detection"),
+});
+
+const BENIGN_FAILURE_RE = /^(superseded_workflow_task|cancelled|reboot-sweep)$/i;
+
+function rowsToObjects(res: any): any[] {
+  const p = res?.data ?? res;
+  const cols: string[] = p?.columns ?? [];
+  return (p?.rows ?? []).map((r: any) =>
+    Array.isArray(r) ? Object.fromEntries(cols.map((c, i) => [c, r[i]])) : r,
+  );
+}
+
+async function query(ctx: any, sql: string, params?: unknown[]): Promise<any[]> {
+  try {
+    return rowsToObjects(await ctx.swarm.db_query({ sql, params }));
+  } catch (error) {
+    return [{ unavailable: error instanceof Error ? error.message : String(error) }];
+  }
+}
+
+function taskPreview(task: unknown): string {
+  return String(task || "").replace(/\s+/g, " ").trim().slice(0, 180);
+}
+
+function summarizeTask(row: any): any {
+  return {
+    id: row.id,
+    status: row.status,
+    taskType: row.taskType || null,
+    agentId: row.agentId || null,
+    agentName: row.agentName || null,
+    scheduleId: row.scheduleId || null,
+    parentTaskId: row.parentTaskId || null,
+    failureReason: row.failureReason || null,
+    createdAt: row.createdAt,
+    lastUpdatedAt: row.lastUpdatedAt,
+    taskPreview: taskPreview(row.task),
+  };
+}
+
+async function recentMergedPrs(
+  ctx: any,
+  repo: string | undefined,
+  nowMs: number,
+  windowMinutes: number,
+): Promise<any> {
+  if (!repo) return { skipped: "repo not provided" };
+  if (!/^[^/\s]+\/[^/\s]+$/.test(repo)) return { error: "repo must be in 'owner/name' form" };
+
+  const windowMs = windowMinutes * 60 * 1000;
+  try {
+    const response = await ctx.stdlib.fetch(
+      "https://api.github.com/repos/" +
+        repo +
+        "/pulls?state=closed&sort=updated&direction=desc&per_page=20",
+      {
+        headers: {
+          Accept: "application/vnd.github+json",
+          "User-Agent": "agent-swarm-boot-triage",
+        },
+      },
+    );
+    if (!response.ok) return { error: `GitHub API ${response.status}` };
+    const prs = (await response.json()) as any[];
+    return prs
+      .filter((pr) => pr?.merged_at)
+      .map((pr) => {
+        const mergedAtMs = Date.parse(pr.merged_at);
+        return {
+          repo,
+          number: pr.number,
+          title: pr.title,
+          url: pr.html_url,
+          mergedAt: pr.merged_at,
+          minutesFromRestart: Math.round((mergedAtMs - nowMs) / 60000),
+        };
+      })
+      .filter((pr) => Math.abs(pr.minutesFromRestart * 60000) <= windowMs);
+  } catch (error) {
+    return { error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+/** Read-only post-restart triage snapshot for the heartbeat.boot-triage prompt. */
+export default async function bootTriage(args: any, ctx: any) {
+  const parsed = argsSchema.safeParse(args || {});
+  if (!parsed.success) return { error: "invalid args: " + parsed.error.message };
+
+  const now = parsed.data.nowIso ? new Date(parsed.data.nowIso) : new Date();
+  const nowMs = now.getTime();
+  const failureLookbackMinutes = parsed.data.failureLookbackMinutes || 60;
+  const stuckMinutes = parsed.data.stuckMinutes || 5;
+  const deployWindowMinutes = parsed.data.deployWindowMinutes || 15;
+  const repo = parsed.data.repo;
+
+  const mergedPrs = await recentMergedPrs(ctx, repo, nowMs, deployWindowMinutes);
+
+  const recentFailureRows = await query(
+    ctx,
+    `SELECT t.id, t.task, t.status, t.taskType, t.agentId, a.name as agentName,
+            t.scheduleId, t.parentTaskId, t.failureReason, t.createdAt, t.lastUpdatedAt
+     FROM agent_tasks t
+     LEFT JOIN agents a ON a.id = t.agentId
+     WHERE t.status = 'failed'
+       AND datetime(t.lastUpdatedAt) >= datetime(?, ?)
+     ORDER BY datetime(t.lastUpdatedAt) DESC
+     LIMIT 50`,
+    [now.toISOString(), `-${failureLookbackMinutes} minutes`],
+  );
+  const recentlyFailedTasks = recentFailureRows
+    .filter((row) => !row.unavailable)
+    .filter((row) => !BENIGN_FAILURE_RE.test(String(row.failureReason || "")))
+    .map(summarizeTask);
+
+  const stuckOfflineRows = await query(
+    ctx,
+    `SELECT t.id, t.task, t.status, t.taskType, t.agentId, a.name as agentName,
+            t.scheduleId, t.parentTaskId, t.failureReason, t.createdAt, t.lastUpdatedAt
+     FROM agent_tasks t
+     JOIN agents a ON a.id = t.agentId
+     WHERE t.status = 'in_progress'
+       AND a.status = 'offline'
+       AND datetime(t.lastUpdatedAt) <= datetime(?, ?)
+     ORDER BY datetime(t.lastUpdatedAt) ASC
+     LIMIT 50`,
+    [now.toISOString(), `-${stuckMinutes} minutes`],
+  );
+  const stuckInProgressOnOfflineAgents = stuckOfflineRows
+    .filter((row) => !row.unavailable)
+    .map(summarizeTask);
+
+  const orphanRows = await query(
+    ctx,
+    `SELECT t.id, t.task, t.status, t.taskType, t.agentId, a.name as agentName,
+            t.scheduleId, t.parentTaskId, t.failureReason, t.createdAt, t.lastUpdatedAt
+     FROM agent_tasks t
+     JOIN agents a ON a.id = t.agentId
+     WHERE t.status IN ('pending', 'offered')
+       AND a.status = 'offline'
+     ORDER BY datetime(t.lastUpdatedAt) ASC
+     LIMIT 50`,
+  );
+  const orphanedPendingOrOfferedOnOfflineWorkers = orphanRows
+    .filter((row) => !row.unavailable)
+    .map(summarizeTask);
+
+  const supersededRows = await query(
+    ctx,
+    `SELECT p.id, p.task, p.status, p.taskType, p.agentId, a.name as agentName,
+            p.scheduleId, p.parentTaskId, p.failureReason, p.createdAt, p.lastUpdatedAt
+     FROM agent_tasks p
+     LEFT JOIN agents a ON a.id = p.agentId
+     WHERE p.status = 'superseded'
+       AND datetime(p.lastUpdatedAt) >= datetime(?, ?)
+       AND NOT EXISTS (
+         SELECT 1
+         FROM agent_tasks c
+         WHERE c.parentTaskId = p.id
+           AND c.taskType = 'resume'
+           AND c.status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
+       )
+     ORDER BY datetime(p.lastUpdatedAt) DESC
+     LIMIT 50`,
+    [now.toISOString(), `-${failureLookbackMinutes} minutes`],
+  );
+  const supersededTasksMissingResumeChild = supersededRows
+    .filter((row) => !row.unavailable)
+    .map(summarizeTask);
+
+  return {
+    generatedAt: now.toISOString(),
+    windows: {
+      failureLookbackMinutes,
+      stuckMinutes,
+      deployWindowMinutes,
+    },
+    deployRestartDetection: {
+      source: repo ? "github:" + repo : null,
+      mergedPrsWithinWindow: Array.isArray(mergedPrs) ? mergedPrs : [],
+      skipped: Array.isArray(mergedPrs) ? null : mergedPrs.skipped || null,
+      error: Array.isArray(mergedPrs) ? null : mergedPrs.error,
+    },
+    recentlyFailedTasks,
+    stuckInProgressOnOfflineAgents,
+    orphanedPendingOrOfferedOnOfflineWorkers,
+    supersededTasksMissingResumeChild,
+    summary: {
+      mergedPrsWithinWindow: Array.isArray(mergedPrs) ? mergedPrs.length : 0,
+      recentlyFailedTasks: recentlyFailedTasks.length,
+      stuckInProgressOnOfflineAgents: stuckInProgressOnOfflineAgents.length,
+      orphanedPendingOrOfferedOnOfflineWorkers: orphanedPendingOrOfferedOnOfflineWorkers.length,
+      supersededTasksMissingResumeChild: supersededTasksMissingResumeChild.length,
+    },
+  };
+}

package/src/be/seed-scripts/catalog/catalog-report.ts

@@ -0,0 +1,457 @@
+export type CatalogReportFinding = {
+  id: string;
+  severity?: string;
+  summary: string;
+  action?: string;
+  samples?: unknown[];
+};
+
+export type CatalogReportSection = {
+  key: string;
+  label?: string;
+  goal: string;
+  findingCount?: number;
+  checks?: Record<string, unknown>;
+  findings?: CatalogReportFinding[];
+};
+
+export type CatalogReport = {
+  title: string;
+  slug: string;
+  description: string;
+  generatedAt: string;
+  lede: string;
+  metrics: Array<[string, unknown]>;
+  sections: CatalogReportSection[];
+  appendix: unknown;
+};
+
+function catalogReportAsText(value: unknown): string {
+  return typeof value === "string" ? value : value == null ? "" : JSON.stringify(value);
+}
+
+function catalogReportHtmlEscape(value: unknown): string {
+  return catalogReportAsText(value)
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
+function catalogReportHumanLabel(value: string): string {
+  return value
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+    .replace(/[-_.]+/g, " ")
+    .replace(/\b\w/g, (char) => char.toUpperCase());
+}
+
+function catalogReportFormatMetric(value: unknown): string {
+  if (typeof value === "number") return new Intl.NumberFormat("en-US").format(value);
+  return catalogReportAsText(value);
+}
+
+function catalogReportSeverityTone(value?: string): string {
+  if (value === "critical") return "danger";
+  if (value === "high") return "warn";
+  if (value === "medium") return "note";
+  return "low";
+}
+
+function catalogReportRenderSampleValue(value: unknown): string {
+  if (Array.isArray(value)) {
+    return value
+      .map((item) => (typeof item === "object" && item !== null ? JSON.stringify(item) : catalogReportAsText(item)))
+      .join(", ");
+  }
+  if (value && typeof value === "object") return JSON.stringify(value);
+  return catalogReportAsText(value);
+}
+
+function catalogReportRenderSamples(samples?: unknown[]): string {
+  if (!Array.isArray(samples) || samples.length === 0) return "";
+  const normalized = samples.map((sampleRow) =>
+    sampleRow && typeof sampleRow === "object" && !Array.isArray(sampleRow)
+      ? (sampleRow as Record<string, unknown>)
+      : { value: sampleRow },
+  );
+  const columns = Array.from(
+    new Set(normalized.flatMap((sampleRow) => Object.keys(sampleRow).slice(0, 6))),
+  ).slice(0, 6);
+  if (columns.length === 0) return "";
+  const rows = normalized
+    .map(
+      (sampleRow) =>
+        `<tr>${columns
+          .map((column) => `<td>${catalogReportHtmlEscape(catalogReportRenderSampleValue(sampleRow[column]))}</td>`)
+          .join("")}</tr>`,
+    )
+    .join("");
+  return `<div class="sample-table" aria-label="Sample rows">
+    <table>
+      <thead><tr>${columns.map((column) => `<th>${catalogReportHtmlEscape(catalogReportHumanLabel(column))}</th>`).join("")}</tr></thead>
+      <tbody>${rows}</tbody>
+    </table>
+  </div>`;
+}
+
+export function renderCatalogReportPage(report: CatalogReport): string {
+  const sections = report.sections
+    .map((section) => {
+      const findings = (section.findings || [])
+        .map(
+          (finding) => `<article class="finding ${catalogReportHtmlEscape(catalogReportSeverityTone(finding.severity))}">
+            <div class="finding-head">
+              <div>
+                <p class="finding-id">${catalogReportHtmlEscape(finding.id)}</p>
+                <h3>${catalogReportHtmlEscape(finding.summary)}</h3>
+              </div>
+              <span class="pill ${catalogReportHtmlEscape(catalogReportSeverityTone(finding.severity))}">${catalogReportHtmlEscape(
+                finding.severity || "low",
+              )}</span>
+            </div>
+            ${finding.action ? `<p class="action">${catalogReportHtmlEscape(finding.action)}</p>` : ""}
+            ${catalogReportRenderSamples(finding.samples)}
+          </article>`,
+        )
+        .join("");
+      const checks = Object.entries(section.checks || {})
+        .map(
+          ([label, value]) =>
+            `<div class="check"><span>${catalogReportHtmlEscape(catalogReportHumanLabel(label))}</span><strong>${catalogReportHtmlEscape(
+              catalogReportFormatMetric(value),
+            )}</strong></div>`,
+        )
+        .join("");
+      return `<section class="section">
+        <div class="section-grid">
+          <aside class="checks">
+            <p class="section-kicker">${catalogReportHtmlEscape(section.label || catalogReportHumanLabel(section.key))}</p>
+            <div class="check-list">${checks}</div>
+          </aside>
+          <div>
+            <div class="section-head">
+              <h2>${catalogReportHtmlEscape(section.goal)}</h2>
+              <span>${catalogReportHtmlEscape(catalogReportFormatMetric(section.findingCount ?? section.findings?.length ?? 0))} finding(s)</span>
+            </div>
+            <div class="findings">
+              ${findings || '<p class="empty">No actionable findings in this cluster.</p>'}
+            </div>
+          </div>
+        </div>
+      </section>`;
+    })
+    .join("\n");
+  return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="theme-color" content="#f5f2ea">
+  <title>${catalogReportHtmlEscape(report.title)}</title>
+  <style>
+    :root {
+      color-scheme: light;
+      --bg: #f5f2ea;
+      --panel: #ffffff;
+      --ink: #18181b;
+      --muted: #5f6368;
+      --line: #ded8cb;
+      --accent: #255c99;
+      --danger: #b42318;
+      --danger-bg: #fff1f0;
+      --warn: #b54708;
+      --warn-bg: #fff7ed;
+      --note: #175cd3;
+      --note-bg: #eff6ff;
+      --low: #067647;
+      --low-bg: #ecfdf3;
+      --radius: 8px;
+      --shadow: 0 1px 2px rgba(24, 24, 27, 0.06), 0 14px 36px rgba(24, 24, 27, 0.07);
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      background: var(--bg);
+      color: var(--ink);
+      font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+      font-size: 16px;
+      line-height: 1.55;
+    }
+    main {
+      width: min(1120px, calc(100% - 32px));
+      margin: 0 auto;
+      padding: 48px 0 72px;
+    }
+    header { margin-bottom: 28px; }
+    .eyebrow {
+      margin: 0 0 8px;
+      color: var(--muted);
+      font-size: 13px;
+      font-weight: 750;
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+    }
+    h1 {
+      margin: 0;
+      max-width: 860px;
+      font-size: clamp(2rem, 4vw, 3rem);
+      line-height: 1.05;
+      letter-spacing: 0;
+    }
+    .lede {
+      max-width: 780px;
+      margin: 16px 0 0;
+      color: var(--muted);
+      font-size: 18px;
+    }
+    .metrics {
+      display: grid;
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+      gap: 12px;
+      margin: 32px 0;
+    }
+    .metric, .section, details {
+      background: var(--panel);
+      border: 1px solid var(--line);
+      border-radius: var(--radius);
+      box-shadow: var(--shadow);
+    }
+    .metric { padding: 18px; }
+    .metric strong {
+      display: block;
+      font-size: 32px;
+      line-height: 1;
+      font-variant-numeric: tabular-nums;
+    }
+    .metric span {
+      display: block;
+      margin-top: 8px;
+      color: var(--muted);
+      font-size: 13px;
+      font-weight: 650;
+    }
+    .section {
+      margin-top: 18px;
+      padding: 24px;
+    }
+    .section-grid {
+      display: grid;
+      grid-template-columns: 260px minmax(0, 1fr);
+      gap: 28px;
+    }
+    .section-kicker {
+      margin: 0 0 12px;
+      color: var(--accent);
+      font-size: 13px;
+      font-weight: 800;
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+    }
+    .check-list {
+      display: grid;
+      gap: 8px;
+    }
+    .check {
+      display: flex;
+      align-items: baseline;
+      justify-content: space-between;
+      gap: 12px;
+      padding: 10px 0;
+      border-bottom: 1px solid var(--line);
+    }
+    .check span {
+      color: var(--muted);
+      font-size: 13px;
+    }
+    .check strong {
+      font-size: 18px;
+      font-variant-numeric: tabular-nums;
+    }
+    .section-head {
+      display: flex;
+      align-items: start;
+      justify-content: space-between;
+      gap: 16px;
+      margin-bottom: 16px;
+    }
+    .section-head h2 {
+      max-width: 680px;
+      margin: 0;
+      font-size: 24px;
+      line-height: 1.2;
+      letter-spacing: 0;
+    }
+    .section-head > span {
+      flex: 0 0 auto;
+      color: var(--muted);
+      font-size: 13px;
+      font-weight: 700;
+      white-space: nowrap;
+    }
+    .findings {
+      display: grid;
+      gap: 12px;
+    }
+    .finding {
+      border: 1px solid var(--line);
+      border-left: 4px solid var(--note);
+      border-radius: var(--radius);
+      padding: 16px;
+      background: #fffdf8;
+    }
+    .finding.danger { border-left-color: var(--danger); }
+    .finding.warn { border-left-color: var(--warn); }
+    .finding.low { border-left-color: var(--low); }
+    .finding-head {
+      display: flex;
+      align-items: start;
+      justify-content: space-between;
+      gap: 16px;
+    }
+    .finding-id {
+      margin: 0 0 4px;
+      color: var(--muted);
+      font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+      font-size: 12px;
+    }
+    h3 {
+      margin: 0;
+      font-size: 17px;
+      line-height: 1.3;
+      letter-spacing: 0;
+    }
+    .pill {
+      display: inline-flex;
+      align-items: center;
+      min-height: 26px;
+      padding: 4px 9px;
+      border-radius: 999px;
+      font-size: 12px;
+      font-weight: 800;
+      text-transform: uppercase;
+      white-space: nowrap;
+    }
+    .pill.danger { background: var(--danger-bg); color: var(--danger); }
+    .pill.warn { background: var(--warn-bg); color: var(--warn); }
+    .pill.note { background: var(--note-bg); color: var(--note); }
+    .pill.low { background: var(--low-bg); color: var(--low); }
+    .action {
+      margin: 10px 0 0;
+      color: var(--muted);
+    }
+    .sample-table {
+      margin-top: 14px;
+      overflow-x: auto;
+      border: 1px solid var(--line);
+      border-radius: var(--radius);
+      background: var(--panel);
+    }
+    table {
+      width: 100%;
+      min-width: 640px;
+      border-collapse: collapse;
+    }
+    th, td {
+      padding: 10px 12px;
+      border-bottom: 1px solid var(--line);
+      text-align: left;
+      vertical-align: top;
+    }
+    th {
+      color: var(--muted);
+      font-size: 12px;
+      font-weight: 800;
+      letter-spacing: 0.06em;
+      text-transform: uppercase;
+    }
+    td {
+      max-width: 360px;
+      color: #27272a;
+      font-size: 13px;
+      overflow-wrap: anywhere;
+    }
+    tr:last-child td { border-bottom: 0; }
+    .empty {
+      margin: 0;
+      color: var(--muted);
+    }
+    details {
+      margin-top: 24px;
+      padding: 18px;
+    }
+    summary {
+      cursor: pointer;
+      font-weight: 800;
+    }
+    pre {
+      margin: 16px 0 0;
+      max-height: 560px;
+      overflow: auto;
+      padding: 16px;
+      border-radius: var(--radius);
+      background: #111827;
+      color: #f9fafb;
+      font-size: 12px;
+      line-height: 1.45;
+    }
+    @media (max-width: 860px) {
+      main { width: min(100% - 24px, 1120px); padding-top: 32px; }
+      .metrics { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+      .section-grid { grid-template-columns: 1fr; gap: 18px; }
+      .section { padding: 18px; }
+      .section-head { display: block; }
+      .section-head > span { display: block; margin-top: 8px; }
+    }
+    @media (max-width: 520px) {
+      .metrics { grid-template-columns: 1fr; }
+      .lede { font-size: 16px; }
+      .finding-head { display: block; }
+      .pill { margin-top: 10px; }
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <header>
+      <p class="eyebrow">Generated ${catalogReportHtmlEscape(report.generatedAt)}</p>
+      <h1>${catalogReportHtmlEscape(report.title)}</h1>
+      <p class="lede">${catalogReportHtmlEscape(report.lede)}</p>
+    </header>
+    <section class="metrics" aria-label="Audit summary">
+      ${report.metrics
+        .map(
+          ([label, value]) =>
+            `<div class="metric"><strong>${catalogReportHtmlEscape(catalogReportFormatMetric(value))}</strong><span>${catalogReportHtmlEscape(
+              label,
+            )}</span></div>`,
+        )
+        .join("")}
+    </section>
+    ${sections}
+    <details>
+      <summary>Compressed JSON appendix</summary>
+      <pre>${catalogReportHtmlEscape(JSON.stringify(report.appendix, null, 2))}</pre>
+    </details>
+  </main>
+</body>
+</html>`;
+}
+
+export async function publishCatalogReportPage(report: CatalogReport, ctx: any): Promise<any> {
+  const response = await ctx.swarm.page_create({
+    title: report.title,
+    slug: report.slug,
+    description: report.description,
+    contentType: "text/html",
+    authMode: "authed",
+    body: renderCatalogReportPage(report),
+  });
+  const payload = response?.data ?? response;
+  if (payload?.success === false) return { error: payload.error || "page_create failed" };
+  return {
+    id: payload?.id ?? payload?.page?.id ?? null,
+    appUrl: payload?.appUrl ?? payload?.app_url ?? null,
+    apiUrl: payload?.apiUrl ?? payload?.api_url ?? null,
+    version: payload?.version ?? payload?.page?.version ?? null,
+  };
+}