@agent-native/dispatch 0.13.10 → 0.13.12

package/src/lib/automation-display.spec.ts

@@ -0,0 +1,95 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  automationIdentity,
+  automationNextRun,
+  automationStatus,
+  automationTarget,
+  sortAutomations,
+} from "./automation-display.js";
+import type { DispatchAutomationItem } from "./automations.js";
+
+function item(
+  overrides: Partial<DispatchAutomationItem> &
+    Pick<DispatchAutomationItem, "id" | "name" | "path" | "owner">,
+): DispatchAutomationItem {
+  return {
+    enabled: true,
+    ...overrides,
+  };
+}
+
+describe("automation-display", () => {
+  it("builds a stable owner:path identity", () => {
+    expect(
+      automationIdentity({ owner: "user@example.com", path: "jobs/digest.md" }),
+    ).toBe("user@example.com:jobs/digest.md");
+  });
+
+  it("prefers event names, then schedule descriptions", () => {
+    expect(
+      automationTarget(
+        item({
+          id: "1",
+          name: "Alert",
+          path: "jobs/alert.md",
+          owner: "user@example.com",
+          triggerType: "event",
+          event: "calendar.booking.created",
+        }),
+      ),
+    ).toBe("calendar.booking.created");
+
+    expect(
+      automationTarget(
+        item({
+          id: "2",
+          name: "Digest",
+          path: "jobs/digest.md",
+          owner: "user@example.com",
+          scheduleDescription: "Weekdays at 9am",
+          schedule: "0 9 * * 1-5",
+        }),
+      ),
+    ).toBe("Weekdays at 9am");
+  });
+
+  it("reports paused next-run and status for disabled automations", () => {
+    const paused = item({
+      id: "3",
+      name: "Paused",
+      path: "jobs/paused.md",
+      owner: "user@example.com",
+      enabled: false,
+      lastStatus: "success",
+    });
+    expect(automationNextRun(paused)).toBe("paused");
+    expect(automationStatus(paused)).toEqual({
+      label: "Paused",
+      tone: "muted",
+    });
+  });
+
+  it("sorts enabled errors ahead of healthy runs", () => {
+    const healthy = item({
+      id: "healthy",
+      name: "Healthy",
+      path: "jobs/healthy.md",
+      owner: "user@example.com",
+      lastStatus: "success",
+      lastRun: "2026-07-08T10:00:00.000Z",
+    });
+    const errored = item({
+      id: "error",
+      name: "Broken",
+      path: "jobs/broken.md",
+      owner: "user@example.com",
+      lastStatus: "error",
+      lastRun: "2026-07-08T09:00:00.000Z",
+    });
+    expect(sortAutomations([healthy, errored]).map((row) => row.id)).toEqual([
+      "error",
+      "healthy",
+    ]);
+  });
+});

package/src/lib/automation-display.ts

@@ -0,0 +1,70 @@
+import type { DispatchAutomationItem } from "./automations.js";
+
+export type AutomationStatusTone =
+  | "default"
+  | "success"
+  | "warning"
+  | "danger"
+  | "muted";
+
+export function automationIdentity(
+  item: Pick<DispatchAutomationItem, "owner" | "path">,
+): string {
+  return `${item.owner}:${item.path}`;
+}
+
+export function automationTarget(item: DispatchAutomationItem): string {
+  if (item.triggerType === "event" && item.event) return item.event;
+  if (item.scheduleDescription) return item.scheduleDescription;
+  if (item.schedule) return item.schedule;
+  return item.triggerType || "schedule";
+}
+
+export function relativeRunTime(value: string | null | undefined): string {
+  if (!value) return "never";
+  const timestamp = new Date(value).getTime();
+  if (!Number.isFinite(timestamp)) return "never";
+  const diff = timestamp - Date.now();
+  const abs = Math.abs(diff);
+  const suffix = diff >= 0 ? "from now" : "ago";
+  if (abs < 60_000) return diff >= 0 ? "soon" : "now";
+  if (abs < 3_600_000) return `${Math.floor(abs / 60_000)}m ${suffix}`;
+  if (abs < 86_400_000) return `${Math.floor(abs / 3_600_000)}h ${suffix}`;
+  return `${Math.floor(abs / 86_400_000)}d ${suffix}`;
+}
+
+export function automationLastRun(item: DispatchAutomationItem): string {
+  return item.lastRun ? relativeRunTime(item.lastRun) : "never";
+}
+
+export function automationNextRun(item: DispatchAutomationItem): string {
+  if (!item.enabled) return "paused";
+  if (item.triggerType === "event") return "on event";
+  return item.nextRun ? relativeRunTime(item.nextRun) : "not scheduled";
+}
+
+export function automationStatus(item: DispatchAutomationItem): {
+  label: string;
+  tone: AutomationStatusTone;
+} {
+  if (!item.enabled) return { label: "Paused", tone: "muted" };
+  if (item.lastStatus === "error") return { label: "Error", tone: "danger" };
+  if (item.lastStatus === "running")
+    return { label: "Running", tone: "warning" };
+  if (item.lastStatus === "skipped")
+    return { label: "Skipped", tone: "warning" };
+  if (item.lastStatus === "success")
+    return { label: "Healthy", tone: "success" };
+  return { label: "Ready", tone: "default" };
+}
+
+export function sortAutomations(
+  automations: DispatchAutomationItem[],
+): DispatchAutomationItem[] {
+  return [...automations].sort((a, b) => {
+    const aError = a.enabled && a.lastStatus === "error" ? 1 : 0;
+    const bError = b.enabled && b.lastStatus === "error" ? 1 : 0;
+    if (aError !== bError) return bError - aError;
+    return (b.lastRun || "").localeCompare(a.lastRun || "");
+  });
+}

package/src/lib/task-queue.spec.ts

@@ -0,0 +1,57 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  formatQueueAgeSeconds,
+  normalizeTaskQueueStats,
+  ZERO_TASK_QUEUE_STATS,
+} from "./task-queue";
+
+describe("normalizeTaskQueueStats", () => {
+  it("returns zeros for invalid payloads", () => {
+    expect(normalizeTaskQueueStats(null)).toEqual(ZERO_TASK_QUEUE_STATS);
+    expect(normalizeTaskQueueStats("bad")).toEqual(ZERO_TASK_QUEUE_STATS);
+  });
+
+  it("normalizes numeric fields and recent failures", () => {
+    expect(
+      normalizeTaskQueueStats({
+        pending: "2",
+        processing: 1,
+        completed_last_hour: 4,
+        failed_last_hour: "1",
+        oldest_pending_age_seconds: 90,
+        recent_failures: [
+          {
+            id: "f1",
+            platform: "slack",
+            error: "rate limited",
+            attempts: "3",
+          },
+        ],
+      }),
+    ).toEqual({
+      pending: 2,
+      processing: 1,
+      completed_last_hour: 4,
+      failed_last_hour: 1,
+      oldest_pending_age_seconds: 90,
+      recent_failures: [
+        {
+          id: "f1",
+          platform: "slack",
+          error: "rate limited",
+          attempts: 3,
+        },
+      ],
+    });
+  });
+});
+
+describe("formatQueueAgeSeconds", () => {
+  it("formats common ages", () => {
+    expect(formatQueueAgeSeconds(0)).toBe("none");
+    expect(formatQueueAgeSeconds(12)).toBe("12s");
+    expect(formatQueueAgeSeconds(120)).toBe("2m");
+    expect(formatQueueAgeSeconds(7200)).toBe("2.0h");
+  });
+});

package/src/lib/task-queue.ts

@@ -0,0 +1,72 @@
+import { agentNativePath } from "@agent-native/core/client";
+
+export interface TaskQueueFailure {
+  id: string;
+  platform: string;
+  error: string;
+  attempts: number;
+}
+
+export interface TaskQueueStats {
+  pending: number;
+  processing: number;
+  completed_last_hour: number;
+  failed_last_hour: number;
+  oldest_pending_age_seconds: number;
+  recent_failures: TaskQueueFailure[];
+}
+
+export const ZERO_TASK_QUEUE_STATS: TaskQueueStats = {
+  pending: 0,
+  processing: 0,
+  completed_last_hour: 0,
+  failed_last_hour: 0,
+  oldest_pending_age_seconds: 0,
+  recent_failures: [],
+};
+
+function asNumber(value: unknown): number {
+  const n = Number(value ?? 0);
+  return Number.isFinite(n) ? n : 0;
+}
+
+export function normalizeTaskQueueStats(value: unknown): TaskQueueStats {
+  if (!value || typeof value !== "object") return ZERO_TASK_QUEUE_STATS;
+  const stats = value as Record<string, unknown>;
+  return {
+    pending: asNumber(stats.pending),
+    processing: asNumber(stats.processing),
+    completed_last_hour: asNumber(stats.completed_last_hour),
+    failed_last_hour: asNumber(stats.failed_last_hour),
+    oldest_pending_age_seconds: asNumber(stats.oldest_pending_age_seconds),
+    recent_failures: Array.isArray(stats.recent_failures)
+      ? stats.recent_failures.map((failure, index) => {
+          const row =
+            failure && typeof failure === "object"
+              ? (failure as Record<string, unknown>)
+              : {};
+          return {
+            id: String(row.id ?? `failure-${index}`),
+            platform: String(row.platform ?? ""),
+            error: String(row.error ?? ""),
+            attempts: asNumber(row.attempts),
+          };
+        })
+      : [],
+  };
+}
+
+export async function getDispatchTaskQueueStats(): Promise<TaskQueueStats> {
+  const response = await fetch(
+    agentNativePath("/_agent-native/integrations/task-queue/status"),
+  );
+  if (!response.ok) return ZERO_TASK_QUEUE_STATS;
+  return normalizeTaskQueueStats(await response.json().catch(() => null));
+}
+
+export function formatQueueAgeSeconds(seconds: number): string {
+  if (!Number.isFinite(seconds) || seconds <= 0) return "none";
+  if (seconds < 60) return `${Math.round(seconds)}s`;
+  if (seconds < 3600) return `${Math.round(seconds / 60)}m`;
+  return `${(seconds / 3600).toFixed(1)}h`;
+}

package/src/routes/index.ts

@@ -47,6 +47,7 @@ export const dispatchRoutes: RouteConfig = [
   route("identities", "./pages/identities.js"),
   route("approval", "./pages/approval.js"),
   route("approvals", "./pages/approvals.js"),
+  route("automations", "./pages/automations.js"),
   route("audit", "./pages/audit.js"),
   route("settings", "./pages/settings.js"),
   route("dreams", "./pages/dreams.js"),

package/src/routes/pages/_index.tsx

@@ -1,7 +1,7 @@
 import { appPath } from "@agent-native/core/client";
 import { redirect, type LoaderFunctionArgs } from "react-router";
 
-import { Spinner } from "@/components/ui/spinner";
+import { Spinner } from "../../components/ui/spinner";
 
 const SEO_TITLE =
   "Agent-Native Dispatch - Open Source workspace control plane for AI agents";

package/src/routes/pages/agents.tsx

@@ -8,11 +8,14 @@ import { IconCheck, IconCopy, IconPlugConnected } from "@tabler/icons-react";
 import { useMemo, useState } from "react";
 import { toast } from "sonner";
 
-import { AgentsPanel, type ConnectedAgent } from "@/components/agents-panel";
-import { DispatchShell } from "@/components/dispatch-shell";
-import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import { Switch } from "@/components/ui/switch";
+import {
+  AgentsPanel,
+  type ConnectedAgent,
+} from "../../components/agents-panel";
+import { DispatchShell } from "../../components/dispatch-shell";
+import { Button } from "../../components/ui/button";
+import { Input } from "../../components/ui/input";
+import { Switch } from "../../components/ui/switch";
 
 export function meta() {
   return [{ title: "Agents — Dispatch" }];

package/src/routes/pages/approval.tsx

@@ -19,10 +19,10 @@ import { toast } from "sonner";
 import {
   ApprovalValueBlock,
   parseApprovalValue,
-} from "@/components/approval-value-block";
-import { Badge } from "@/components/ui/badge";
-import { Button } from "@/components/ui/button";
-import { Skeleton } from "@/components/ui/skeleton";
+} from "../../components/approval-value-block";
+import { Badge } from "../../components/ui/badge";
+import { Button } from "../../components/ui/button";
+import { Skeleton } from "../../components/ui/skeleton";
 
 export function meta() {
   return [{ title: "Approval — Dispatch" }];

package/src/routes/pages/approvals.tsx

@@ -3,10 +3,10 @@ import { useOrg } from "@agent-native/core/client/org";
 import { useMemo, useState } from "react";
 import { toast } from "sonner";
 
-import { DispatchShell } from "@/components/dispatch-shell";
-import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import { Switch } from "@/components/ui/switch";
+import { DispatchShell } from "../../components/dispatch-shell";
+import { Button } from "../../components/ui/button";
+import { Input } from "../../components/ui/input";
+import { Switch } from "../../components/ui/switch";
 
 export function meta() {
   return [{ title: "Approvals — Dispatch" }];

package/src/routes/pages/apps.$appId.tsx

@@ -7,14 +7,14 @@ import {
 import { useEffect, useMemo } from "react";
 import { Link, useParams } from "react-router";
 
-import { DispatchShell } from "@/components/dispatch-shell";
-import { Badge } from "@/components/ui/badge";
-import { Button } from "@/components/ui/button";
-import { Skeleton } from "@/components/ui/skeleton";
+import { DispatchShell } from "../../components/dispatch-shell";
+import { Badge } from "../../components/ui/badge";
+import { Button } from "../../components/ui/button";
+import { Skeleton } from "../../components/ui/skeleton";
 import {
   workspaceAppHref,
   type WorkspaceAppSummary,
-} from "@/lib/workspace-apps";
+} from "../../lib/workspace-apps";
 
 export function meta() {
   return [{ title: "Workspace app - Dispatch" }];

package/src/routes/pages/apps.tsx

@@ -25,18 +25,18 @@ import {
 import { useState } from "react";
 import { toast } from "sonner";
 
-import { CreateAppPopover } from "@/components/create-app-popover";
-import { DispatchShell } from "@/components/dispatch-shell";
-import { Button } from "@/components/ui/button";
+import { CreateAppPopover } from "../../components/create-app-popover";
+import { DispatchShell } from "../../components/dispatch-shell";
+import { Button } from "../../components/ui/button";
 import {
   Collapsible,
   CollapsibleContent,
   CollapsibleTrigger,
-} from "@/components/ui/collapsible";
-import { Skeleton } from "@/components/ui/skeleton";
-import { WorkspaceAppCard } from "@/components/workspace-app-card";
-import { cn } from "@/lib/utils";
-import type { WorkspaceAppSummary } from "@/lib/workspace-apps";
+} from "../../components/ui/collapsible";
+import { Skeleton } from "../../components/ui/skeleton";
+import { WorkspaceAppCard } from "../../components/workspace-app-card";
+import { cn } from "../../lib/utils";
+import type { WorkspaceAppSummary } from "../../lib/workspace-apps";
 
 export function meta() {
   return [{ title: "Apps — Dispatch" }];

package/src/routes/pages/audit.tsx

@@ -1,6 +1,6 @@
 import { useActionQuery } from "@agent-native/core/client";
 
-import { DispatchShell } from "@/components/dispatch-shell";
+import { DispatchShell } from "../../components/dispatch-shell";
 
 export function meta() {
   return [{ title: "Audit — Dispatch" }];