@rubytech/create-maxy 1.0.498 → 1.0.500

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/people-search.ts

@@ -0,0 +1,93 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+interface LoopPersonSummary {
+  id?: number;
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  phone?: string;
+  type?: string;
+  [key: string]: unknown;
+}
+
+type PeopleRole = "buyers" | "sellers" | "renters" | "landlords";
+
+export async function peopleSearch(params: {
+  accountId: string;
+  role?: PeopleRole;
+  searchTerm?: string;
+  // Role-specific filters (buyers)
+  maxPrice?: number;
+  minBeds?: number;
+  searchAreas?: string;
+  propertyTypes?: string;
+  // Role-specific filters (sellers/landlords)
+  startDate?: string;
+  endDate?: string;
+  minPrice?: number;
+  // Role-specific filters (renters)
+  maxRent?: number;
+  teamName?: string;
+  limit?: number;
+}): Promise<string> {
+  const {
+    accountId, role, searchTerm,
+    maxPrice, minBeds, searchAreas, propertyTypes,
+    startDate, endDate, minPrice, maxRent,
+    teamName, limit,
+  } = params;
+
+  const result = await aggregateAcrossTeams<LoopPersonSummary>(
+    accountId,
+    "people",
+    "loop-people-search",
+    async (apiKey, team) => {
+      const qp: string[] = [];
+      if (searchTerm) qp.push(`SearchTerm=${encodeURIComponent(searchTerm)}`);
+
+      if (role === "buyers") {
+        if (maxPrice != null) qp.push(`MaxPrice=${maxPrice}`);
+        if (minBeds != null) qp.push(`MinBeds=${minBeds}`);
+        if (searchAreas) qp.push(`SearchAreas=${encodeURIComponent(searchAreas)}`);
+        if (propertyTypes) qp.push(`PropertyTypes=${encodeURIComponent(propertyTypes)}`);
+      } else if (role === "sellers" || role === "landlords") {
+        if (startDate) qp.push(`StartDate=${encodeURIComponent(startDate)}`);
+        if (endDate) qp.push(`EndDate=${encodeURIComponent(endDate)}`);
+        if (minPrice != null) qp.push(`MinPrice=${minPrice}`);
+        if (maxPrice != null) qp.push(`MaxPrice=${maxPrice}`);
+      } else if (role === "renters") {
+        if (maxRent != null) qp.push(`MaxRent=${maxRent}`);
+        if (minBeds != null) qp.push(`MinBeds=${minBeds}`);
+        if (searchAreas) qp.push(`SearchAreas=${encodeURIComponent(searchAreas)}`);
+        if (propertyTypes) qp.push(`PropertyTypes=${encodeURIComponent(propertyTypes)}`);
+      } else {
+        // Generic /people endpoint
+        if (startDate) qp.push(`StartDate=${encodeURIComponent(startDate)}`);
+        if (endDate) qp.push(`EndDate=${encodeURIComponent(endDate)}`);
+      }
+
+      const query = qp.length > 0 ? `?${qp.join("&")}` : "";
+      const basePath = role ? `/people/${role}` : "/people";
+      const path = `${basePath}${query}`;
+      const data = await loopGet<LoopPersonSummary[]>(apiKey, path, "loop-people-search", team);
+      return Array.isArray(data) ? data : [];
+    },
+    { teamName, limitPerTeam: limit ?? 50, limitTotal: limit ?? 200 }
+  );
+
+  const entityName = role ?? "people";
+  return formatAggregationResult(
+    result,
+    (p) => {
+      const name = [p.firstName, p.lastName].filter(Boolean).join(" ") || "Unknown";
+      const contact = p.email ?? p.phone ?? "";
+      const type = p.type ? ` (${p.type})` : "";
+      return `- ${name}${contact ? ` <${contact}>` : ""}${type}`;
+    },
+    entityName
+  );
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/property-detail.ts

@@ -0,0 +1,70 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+interface LoopPropertyDetail {
+  id?: number;
+  address?: string;
+  price?: number;
+  status?: string;
+  type?: string;
+  bedrooms?: number;
+  bathrooms?: number;
+  description?: string;
+  receptions?: number;
+  tenure?: string;
+  councilTax?: string;
+  epcRating?: string;
+  floorArea?: number;
+  [key: string]: unknown;
+}
+
+type Department = "sales" | "lettings";
+
+export async function propertyDetail(params: {
+  accountId: string;
+  propertyId: number;
+  department: Department;
+  previewHash?: number;
+  teamName?: string;
+}): Promise<string> {
+  const { accountId, propertyId, department, previewHash, teamName } = params;
+
+  const result = await aggregateAcrossTeams<LoopPropertyDetail>(
+    accountId,
+    "properties",
+    "loop-property-detail",
+    async (apiKey, team) => {
+      const path = previewHash
+        ? `/property/residential/${department}/${propertyId}/preview/${previewHash}`
+        : `/property/residential/${department}/${propertyId}`;
+      const data = await loopGet<LoopPropertyDetail>(apiKey, path, "loop-property-detail", team);
+      if (data && typeof data === "object" && !Array.isArray(data)) {
+        return [data];
+      }
+      return [];
+    },
+    { teamName }
+  );
+
+  return formatAggregationResult(
+    result,
+    (p) => {
+      const lines = [`**${p.address ?? "Unknown address"}**`];
+      if (p.price) lines.push(`Price: £${p.price.toLocaleString("en-GB")}`);
+      if (p.status) lines.push(`Status: ${p.status}`);
+      if (p.type) lines.push(`Type: ${p.type}`);
+      if (p.bedrooms) lines.push(`Bedrooms: ${p.bedrooms}`);
+      if (p.bathrooms) lines.push(`Bathrooms: ${p.bathrooms}`);
+      if (p.receptions) lines.push(`Receptions: ${p.receptions}`);
+      if (p.tenure) lines.push(`Tenure: ${p.tenure}`);
+      if (p.councilTax) lines.push(`Council Tax: ${p.councilTax}`);
+      if (p.epcRating) lines.push(`EPC: ${p.epcRating}`);
+      if (p.description) lines.push(`\n${p.description}`);
+      return lines.join("\n");
+    },
+    "property details"
+  );
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/property-listed.ts

@@ -0,0 +1,67 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+interface LoopPropertyListing {
+  id?: number;
+  address?: string;
+  price?: number;
+  status?: string;
+  type?: string;
+  bedrooms?: number;
+  listingUrl?: string;
+  [key: string]: unknown;
+}
+
+type Department = "sales" | "lettings" | "both";
+type Channel = "rightmove" | "onTheMarket" | "zoopla" | "website";
+
+export async function propertyListed(params: {
+  accountId: string;
+  channel: Channel;
+  department?: Department;
+  includeSold?: boolean;
+  teamName?: string;
+  limit?: number;
+}): Promise<string> {
+  const { accountId, channel, department = "both", includeSold = false, teamName, limit } = params;
+
+  const result = await aggregateAcrossTeams<LoopPropertyListing>(
+    accountId,
+    "properties",
+    "loop-property-listed",
+    async (apiKey, team) => {
+      const all: LoopPropertyListing[] = [];
+      const depts: string[] =
+        department === "both" ? ["sales", "lettings"] : [department];
+
+      for (const dept of depts) {
+        const path = `/property/residential/${dept}/listed/${channel}`;
+        const data = await loopGet<LoopPropertyListing[]>(apiKey, path, "loop-property-listed", team);
+        if (Array.isArray(data)) all.push(...data);
+      }
+
+      if (includeSold) {
+        const soldPath = `/property/residential/sold/${channel}`;
+        const soldData = await loopGet<LoopPropertyListing[]>(apiKey, soldPath, "loop-property-listed", team);
+        if (Array.isArray(soldData)) all.push(...soldData);
+      }
+
+      return all;
+    },
+    { teamName, limitPerTeam: limit ?? 50, limitTotal: limit ?? 200 }
+  );
+
+  return formatAggregationResult(
+    result,
+    (p) => {
+      const price = p.price ? ` — £${p.price.toLocaleString("en-GB")}` : "";
+      const beds = p.bedrooms ? ` ${p.bedrooms}bed` : "";
+      const status = p.status ? ` [${p.status}]` : "";
+      return `- ${p.address ?? "Unknown address"}${price}${beds}${status}`;
+    },
+    `${channel} listings`
+  );
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/property-request.ts

@@ -0,0 +1,37 @@
+import { loopPost, withTeamKey } from "../lib/loop-api.js";
+
+type Department = "sales" | "lettings";
+type RequestAction = "viewing" | "call-back" | "information";
+
+interface LoopBooleanResponse {
+  success?: boolean;
+  [key: string]: unknown;
+}
+
+export async function propertyRequest(params: {
+  accountId: string;
+  teamName: string;
+  propertyId: number;
+  department: Department;
+  action: RequestAction;
+  name?: string;
+  email?: string;
+  phone?: string;
+  message?: string;
+}): Promise<string> {
+  const { accountId, teamName, propertyId, department, action, ...body } = params;
+
+  const result = await withTeamKey<LoopBooleanResponse>(
+    accountId,
+    teamName,
+    "properties",
+    "loop-property-request",
+    async (apiKey) => {
+      const path = `/property/residential/${department}/${propertyId}/${action}`;
+      return loopPost<LoopBooleanResponse>(apiKey, path, body, "loop-property-request", teamName);
+    }
+  );
+
+  const actionLabel = action === "call-back" ? "callback" : action;
+  return `${actionLabel} request submitted for property ${propertyId} (${department}) via team "${teamName}".`;
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/property-search.ts

@@ -0,0 +1,80 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+interface LoopPropertySummary {
+  id?: number;
+  address?: string;
+  price?: number;
+  status?: string;
+  type?: string;
+  bedrooms?: number;
+  bathrooms?: number;
+  description?: string;
+  [key: string]: unknown;
+}
+
+type Department = "sales" | "lettings" | "both";
+
+export async function propertySearch(params: {
+  accountId: string;
+  department?: Department;
+  searchTerm?: string;
+  minPrice?: number;
+  maxPrice?: number;
+  minBedrooms?: number;
+  maxBedrooms?: number;
+  propertyStatuses?: string;
+  propertyTypes?: string;
+  teamName?: string;
+  limit?: number;
+}): Promise<string> {
+  const {
+    accountId, department = "both", searchTerm, minPrice, maxPrice,
+    minBedrooms, maxBedrooms, propertyStatuses, propertyTypes,
+    teamName, limit,
+  } = params;
+
+  const result = await aggregateAcrossTeams<LoopPropertySummary>(
+    accountId,
+    "properties",
+    "loop-property-search",
+    async (apiKey, team) => {
+      const depts: string[] =
+        department === "both" ? ["sales", "lettings"] : [department];
+      const all: LoopPropertySummary[] = [];
+
+      for (const dept of depts) {
+        const qp: string[] = [];
+        if (searchTerm) qp.push(`SearchTerm=${encodeURIComponent(searchTerm)}`);
+        if (minPrice != null) qp.push(`MinPrice=${minPrice}`);
+        if (maxPrice != null) qp.push(`MaxPrice=${maxPrice}`);
+        if (minBedrooms != null) qp.push(`MinBedrooms=${minBedrooms}`);
+        if (maxBedrooms != null) qp.push(`MaxBedrooms=${maxBedrooms}`);
+        if (propertyStatuses) qp.push(`PropertyStatuses=${encodeURIComponent(propertyStatuses)}`);
+        if (propertyTypes) qp.push(`PropertyTypes=${encodeURIComponent(propertyTypes)}`);
+
+        const query = qp.length > 0 ? `?${qp.join("&")}` : "";
+        const path = `/property/residential/${dept}${query}`;
+        const data = await loopGet<LoopPropertySummary[]>(apiKey, path, "loop-property-search", team);
+        if (Array.isArray(data)) all.push(...data);
+      }
+      return all;
+    },
+    { teamName, limitPerTeam: limit ?? 50, limitTotal: limit ?? 200 }
+  );
+
+  return formatAggregationResult(
+    result,
+    (p) => {
+      const price = p.price ? ` — £${p.price.toLocaleString("en-GB")}` : "";
+      const beds = p.bedrooms ? ` ${p.bedrooms}bed` : "";
+      const status = p.status ? ` [${p.status}]` : "";
+      const propType = p.type ? ` (${p.type})` : "";
+      return `- ${p.address ?? "Unknown address"}${price}${beds}${propType}${status}`;
+    },
+    "properties"
+  );
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/supplier.ts

@@ -0,0 +1,120 @@
+import { loopGet, loopPost, loopPut, withTeamKey } from "../lib/loop-api.js";
+
+type SupplierAction =
+  | "maintenance-jobs"
+  | "maintenance-complete"
+  | "maintenance-quotes"
+  | "maintenance-submit-quote"
+  | "board-jobs"
+  | "board-complete";
+
+interface LoopSupplierResult {
+  [key: string]: unknown;
+}
+
+interface LoopBooleanResponse {
+  success?: boolean;
+  [key: string]: unknown;
+}
+
+export async function supplier(params: {
+  accountId: string;
+  teamName: string;
+  action: SupplierAction;
+  code: string;
+  jobId?: number;
+  // For maintenance-submit-quote
+  quoteId?: number;
+  quoteData?: Record<string, unknown>;
+  // For board-complete
+  completionData?: Record<string, unknown>;
+}): Promise<string> {
+  const { accountId, teamName, action, code } = params;
+
+  // jobId is required for all actions except maintenance-submit-quote
+  const jobId = params.jobId;
+  if (action !== "maintenance-submit-quote" && jobId == null) {
+    throw new Error(`jobId is required for action "${action}".`);
+  }
+
+  if (action === "maintenance-jobs") {
+    const result = await withTeamKey<LoopSupplierResult>(
+      accountId, teamName, "supplier", "loop-supplier",
+      async (apiKey) => {
+        return loopGet<LoopSupplierResult>(
+          apiKey, `/supplier/maintenance/${encodeURIComponent(code)}/${jobId}/job-list`,
+          "loop-supplier", teamName
+        );
+      }
+    );
+    return JSON.stringify(result, null, 2);
+  }
+
+  if (action === "maintenance-complete") {
+    await withTeamKey<LoopBooleanResponse>(
+      accountId, teamName, "supplier", "loop-supplier",
+      async (apiKey) => {
+        return loopPost<LoopBooleanResponse>(
+          apiKey, `/supplier/maintenance/${encodeURIComponent(code)}/${jobId}/complete`,
+          {}, "loop-supplier", teamName
+        );
+      }
+    );
+    return `Maintenance job ${jobId} marked complete via team "${teamName}".`;
+  }
+
+  if (action === "maintenance-quotes") {
+    const result = await withTeamKey<LoopSupplierResult>(
+      accountId, teamName, "supplier", "loop-supplier",
+      async (apiKey) => {
+        return loopGet<LoopSupplierResult>(
+          apiKey, `/supplier/maintenance/${encodeURIComponent(code)}/${jobId}/quote-list`,
+          "loop-supplier", teamName
+        );
+      }
+    );
+    return JSON.stringify(result, null, 2);
+  }
+
+  if (action === "maintenance-submit-quote") {
+    if (!params.quoteId) throw new Error("quoteId is required for maintenance-submit-quote.");
+    await withTeamKey<LoopBooleanResponse>(
+      accountId, teamName, "supplier", "loop-supplier",
+      async (apiKey) => {
+        return loopPut<LoopBooleanResponse>(
+          apiKey, `/supplier/maintenance/${encodeURIComponent(code)}/${params.quoteId}/quote-for-job`,
+          params.quoteData ?? {}, "loop-supplier", teamName
+        );
+      }
+    );
+    return `Quote ${params.quoteId} submitted via team "${teamName}".`;
+  }
+
+  if (action === "board-jobs") {
+    const result = await withTeamKey<LoopSupplierResult>(
+      accountId, teamName, "supplier", "loop-supplier",
+      async (apiKey) => {
+        return loopGet<LoopSupplierResult>(
+          apiKey, `/supplier/board-contractor/${encodeURIComponent(code)}/${jobId}/job-list`,
+          "loop-supplier", teamName
+        );
+      }
+    );
+    return JSON.stringify(result, null, 2);
+  }
+
+  if (action === "board-complete") {
+    await withTeamKey<LoopBooleanResponse>(
+      accountId, teamName, "supplier", "loop-supplier",
+      async (apiKey) => {
+        return loopPost<LoopBooleanResponse>(
+          apiKey, `/supplier/board-contractor/${encodeURIComponent(code)}/${jobId}/complete`,
+          params.completionData ?? {}, "loop-supplier", teamName
+        );
+      }
+    );
+    return `Board contractor job ${jobId} marked complete via team "${teamName}".`;
+  }
+
+  throw new Error(`Unknown supplier action: ${action}`);
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/team-availability.ts

@@ -0,0 +1,42 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+interface LoopTimeRange {
+  start?: string;
+  end?: string;
+  [key: string]: unknown;
+}
+
+export async function teamAvailability(params: {
+  accountId: string;
+  agentId: string;
+  searchDate: string;
+  teamName?: string;
+}): Promise<string> {
+  const { accountId, agentId, searchDate, teamName } = params;
+
+  const result = await aggregateAcrossTeams<LoopTimeRange>(
+    accountId,
+    "team",
+    "loop-team-availability",
+    async (apiKey, team) => {
+      const path = `/team/${encodeURIComponent(agentId)}/availability/${encodeURIComponent(searchDate)}`;
+      const data = await loopGet<LoopTimeRange[]>(apiKey, path, "loop-team-availability", team);
+      return Array.isArray(data) ? data : [];
+    },
+    { teamName }
+  );
+
+  return formatAggregationResult(
+    result,
+    (slot) => {
+      const start = slot.start ?? "?";
+      const end = slot.end ?? "?";
+      return `- ${start} — ${end}`;
+    },
+    `availability slots for ${searchDate}`
+  );
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/viewing-create.ts

@@ -0,0 +1,36 @@
+import { loopPost, withTeamKey } from "../lib/loop-api.js";
+
+type Department = "sales" | "lettings";
+
+interface LoopNumberResponse {
+  result?: number;
+  [key: string]: unknown;
+}
+
+export async function viewingCreate(params: {
+  accountId: string;
+  teamName: string;
+  department: Department;
+  propertyId: number;
+  date: string;
+  time: string;
+  attendeeName: string;
+  attendeeEmail?: string;
+  attendeePhone?: string;
+}): Promise<string> {
+  const { accountId, teamName, department, ...body } = params;
+
+  const result = await withTeamKey<LoopNumberResponse>(
+    accountId,
+    teamName,
+    "viewings",
+    "loop-viewing-create",
+    async (apiKey) => {
+      const path = `/residential/${department}/viewings`;
+      return loopPost<LoopNumberResponse>(apiKey, path, body, "loop-viewing-create", teamName);
+    }
+  );
+
+  const viewingId = result.result ?? "unknown";
+  return `Viewing created (ID: ${viewingId}) for property ${params.propertyId} on ${params.date} at ${params.time} via team "${teamName}".`;
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/viewing-detail.ts

@@ -0,0 +1,70 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+interface LoopViewingDetail {
+  id?: number;
+  propertyAddress?: string;
+  date?: string;
+  time?: string;
+  status?: string;
+  type?: string;
+  attendeeName?: string;
+  attendeeEmail?: string;
+  attendeePhone?: string;
+  notes?: string;
+  buyerFeedback?: string;
+  sellerFeedback?: string;
+  renterFeedback?: string;
+  landlordFeedback?: string;
+  [key: string]: unknown;
+}
+
+type Department = "sales" | "lettings";
+
+export async function viewingDetail(params: {
+  accountId: string;
+  viewingId: number;
+  department: Department;
+  teamName?: string;
+}): Promise<string> {
+  const { accountId, viewingId, department, teamName } = params;
+
+  const result = await aggregateAcrossTeams<LoopViewingDetail>(
+    accountId,
+    "viewings",
+    "loop-viewing-detail",
+    async (apiKey, team) => {
+      const path = `/residential/${department}/viewings/${viewingId}`;
+      const data = await loopGet<LoopViewingDetail>(apiKey, path, "loop-viewing-detail", team);
+      if (data && typeof data === "object" && !Array.isArray(data)) {
+        return [data];
+      }
+      return [];
+    },
+    { teamName }
+  );
+
+  return formatAggregationResult(
+    result,
+    (v) => {
+      const lines = [`**${v.propertyAddress ?? "Unknown property"}**`];
+      const when = [v.date, v.time].filter(Boolean).join(" ");
+      if (when) lines.push(`Date/Time: ${when}`);
+      if (v.status) lines.push(`Status: ${v.status}`);
+      if (v.type) lines.push(`Type: ${v.type}`);
+      if (v.attendeeName) lines.push(`Attendee: ${v.attendeeName}`);
+      if (v.attendeeEmail) lines.push(`Email: ${v.attendeeEmail}`);
+      if (v.attendeePhone) lines.push(`Phone: ${v.attendeePhone}`);
+      if (v.notes) lines.push(`Notes: ${v.notes}`);
+      if (v.buyerFeedback) lines.push(`Buyer Feedback: ${v.buyerFeedback}`);
+      if (v.sellerFeedback) lines.push(`Seller Feedback: ${v.sellerFeedback}`);
+      if (v.renterFeedback) lines.push(`Renter Feedback: ${v.renterFeedback}`);
+      if (v.landlordFeedback) lines.push(`Landlord Feedback: ${v.landlordFeedback}`);
+      return lines.join("\n");
+    },
+    "viewing details"
+  );
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/viewing-search.ts

@@ -0,0 +1,74 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+interface LoopViewingSummary {
+  id?: number;
+  propertyAddress?: string;
+  date?: string;
+  time?: string;
+  status?: string;
+  type?: string;
+  attendeeName?: string;
+  [key: string]: unknown;
+}
+
+type Department = "sales" | "lettings" | "both";
+
+export async function viewingSearch(params: {
+  accountId: string;
+  department?: Department;
+  searchTerm?: string;
+  appointmentStartDate?: string;
+  appointmentEndDate?: string;
+  status?: string;
+  teamName?: string;
+  limit?: number;
+}): Promise<string> {
+  const {
+    accountId, department = "both", searchTerm,
+    appointmentStartDate, appointmentEndDate, status,
+    teamName, limit,
+  } = params;
+
+  const result = await aggregateAcrossTeams<LoopViewingSummary>(
+    accountId,
+    "viewings",
+    "loop-viewing-search",
+    async (apiKey, team) => {
+      const depts: string[] =
+        department === "both" ? ["sales", "lettings"] : [department];
+      const all: LoopViewingSummary[] = [];
+
+      for (const dept of depts) {
+        const qp: string[] = [];
+        if (searchTerm) qp.push(`SearchTerm=${encodeURIComponent(searchTerm)}`);
+        if (appointmentStartDate) qp.push(`AppointmentStartDate=${encodeURIComponent(appointmentStartDate)}`);
+        if (appointmentEndDate) qp.push(`AppointmentEndDate=${encodeURIComponent(appointmentEndDate)}`);
+        if (status) qp.push(`Status=${encodeURIComponent(status)}`);
+
+        const query = qp.length > 0 ? `?${qp.join("&")}` : "";
+        const path = `/residential/${dept}/viewings${query}`;
+        const data = await loopGet<LoopViewingSummary[]>(apiKey, path, "loop-viewing-search", team);
+        if (Array.isArray(data)) all.push(...data);
+      }
+      return all;
+    },
+    { teamName, limitPerTeam: limit ?? 50, limitTotal: limit ?? 200 }
+  );
+
+  return formatAggregationResult(
+    result,
+    (v) => {
+      const addr = v.propertyAddress ?? "Unknown property";
+      const when = [v.date, v.time].filter(Boolean).join(" ");
+      const viewStatus = v.status ? ` [${v.status}]` : "";
+      const attendee = v.attendeeName ? ` — ${v.attendeeName}` : "";
+      const viewType = v.type ? ` (${v.type})` : "";
+      return `- ${addr} — ${when || "No date"}${viewType}${attendee}${viewStatus}`;
+    },
+    "viewings"
+  );
+}