feat(agents): show last used timestamp on agent card and settings

Author: rafavalls

apps/mesh/src/storage/virtual.ts

@@ -183,9 +183,12 @@ export class VirtualMCPStorage implements VirtualMCPStoragePort {
       .where("dependency_mode", "=", "direct")
       .execute();
 
+    const lastUsedMap = await this.fetchLastUsed([id]);
+
     return this.deserializeVirtualMCPEntity(
       row as unknown as RawConnectionRow,
       aggregationRows as RawAggregationRow[],
+      lastUsedMap.get(id),
     );
   }
 
@@ -227,10 +230,13 @@ export class VirtualMCPStorage implements VirtualMCPStoragePort {
       aggregationsByParent.set(agg.parent_connection_id, existing);
     }
 
+    const lastUsedMap = await this.fetchLastUsed(virtualMcpIds);
+
     return rows.map((row) =>
       this.deserializeVirtualMCPEntity(
         row as unknown as RawConnectionRow,
         aggregationsByParent.get(row.id) ?? [],
+        lastUsedMap.get(row.id),
       ),
     );
   }
@@ -483,12 +489,47 @@ export class VirtualMCPStorage implements VirtualMCPStoragePort {
     }
   }
 
+  /**
+   * Returns the most recent thread per agent (by created_at) with the user who started it.
+   */
+  private async fetchLastUsed(
+    ids: string[],
+  ): Promise<Map<string, { last_used_at: string; last_used_by: string }>> {
+    if (ids.length === 0) return new Map();
+
+    const rows = await this.db
+      .selectFrom("threads")
+      .distinctOn("virtual_mcp_id")
+      .select(["virtual_mcp_id", "created_by", "created_at"])
+      .where("virtual_mcp_id", "in", ids)
+      .orderBy("virtual_mcp_id")
+      .orderBy("created_at", "desc")
+      .execute();
+
+    const result = new Map<
+      string,
+      { last_used_at: string; last_used_by: string }
+    >();
+    for (const row of rows) {
+      const at =
+        row.created_at instanceof Date
+          ? row.created_at.toISOString()
+          : String(row.created_at);
+      result.set(row.virtual_mcp_id, {
+        last_used_at: at,
+        last_used_by: row.created_by,
+      });
+    }
+    return result;
+  }
+
   /**
    * Deserialize connection row with aggregations to VirtualMCPEntity
    */
   private deserializeVirtualMCPEntity(
     row: RawConnectionRow,
     aggregationRows: RawAggregationRow[],
+    lastUsed?: { last_used_at: string; last_used_by: string },
   ): VirtualMCPEntity {
     // Convert Date to ISO string if needed
     const createdAt =
@@ -518,6 +559,8 @@ export class VirtualMCPStorage implements VirtualMCPStoragePort {
       updated_at: updatedAt,
       created_by: row.created_by,
       updated_by: row.updated_by ?? undefined,
+      last_used_at: lastUsed?.last_used_at,
+      last_used_by: lastUsed?.last_used_by,
       metadata: {
         ...metadata,
         instructions: metadata?.instructions ?? null,

apps/mesh/src/web/components/project-card.tsx

@@ -91,9 +91,9 @@ export function ProjectCard({ project, onDeleteClick }: ProjectCardProps) {
         <div className="border-t border-border mt-auto">
           <div className="h-10 flex items-center px-4.5">
             <p className="text-xs text-muted-foreground">
-              {formatDistanceToNow(new Date(project.updated_at), {
-                addSuffix: true,
-              })}
+              {project.last_used_at
+                ? `Last used ${formatDistanceToNow(new Date(project.last_used_at), { addSuffix: true })}`
+                : `Updated ${formatDistanceToNow(new Date(project.updated_at), { addSuffix: true })}`}
             </p>
           </div>
         </div>

apps/mesh/src/web/views/virtual-mcp/index.tsx

@@ -1,3 +1,4 @@
+import { formatDistanceToNow } from "date-fns";
 import { generatePrefixedId } from "@/shared/utils/generate-id";
 import type { VirtualMCPEntity } from "@/tools/virtual/schema";
 import { getUIResourceUri } from "@/mcp-apps/types.ts";
@@ -1548,20 +1549,27 @@ Define step-by-step how the agent should handle requests.
             </div>
 
             {/* Creator metadata */}
-            <div className="flex items-center gap-2 -mt-6 text-muted-foreground">
+            <div className="flex items-center gap-2 -mt-6 text-sm text-muted-foreground">
               <User
                 id={virtualMcp.created_by}
                 size="2xs"
                 className="text-sm text-muted-foreground"
               />
-              <span className="text-muted-foreground/50 text-sm">·</span>
-              <span className="text-sm">
+              <span className="text-muted-foreground/50">·</span>
+              <span>
+                Created{" "}
                 {new Date(virtualMcp.created_at).toLocaleDateString("en-US", {
                   month: "short",
                   day: "numeric",
                   year: "numeric",
                 })}
               </span>
+              <span className="text-muted-foreground/50">·</span>
+              <span>
+                {virtualMcp.last_used_at
+                  ? `Last used ${formatDistanceToNow(new Date(virtualMcp.last_used_at), { addSuffix: true })}`
+                  : "Never used"}
+              </span>
             </div>
 
             {/* Connections section */}

packages/mesh-sdk/src/types/virtual-mcp.ts

@@ -196,6 +196,14 @@ export const VirtualMCPEntitySchema = z.object({
     .string()
     .optional()
     .describe("User ID who last updated this item"),
+  last_used_at: z
+    .string()
+    .optional()
+    .describe("Timestamp of most recent thread creation for this agent"),
+  last_used_by: z
+    .string()
+    .optional()
+    .describe("User ID who most recently used this agent"),
 
   // Entity-specific fields
   organization_id: z.string().describe("Organization ID this item belongs to"),