@rubytech/create-realagent-code 0.1.24 → 0.1.27

package/payload/platform/plugins/loop/mcp/src/tools/property-request.ts

@@ -0,0 +1,42 @@
+import { loopPost, withTeamKey } from "../lib/loop-api.js";
+
+type Department = "sales" | "lettings";
+type RequestAction = "viewing" | "call-back" | "information";
+
+// ─── Loop API V2: POST /property/residential/{dept}/{id}/{action}
+// Actions: viewing, call-back, information
+// Request body: { name?, email?, phone?, message? }
+// Response: boolean success
+// ────────────────────────────────────────────────────────────────
+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/platform/plugins/loop/mcp/src/tools/property-search.ts

@@ -0,0 +1,92 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+// ─── Loop API V2: /property/residential/{dept} ─────────────────
+// Fields: id, refId, propertyAddress, status, propertyType,
+//   dateCreated, price, bedrooms, offerCount, viewingCount,
+//   publishedToPortals, publishedToWebsite, publishedToMatching
+// ────────────────────────────────────────────────────────────────
+interface LoopPropertySummary {
+  id: number;
+  refId?: string;
+  propertyAddress?: string;
+  status?: string;
+  propertyType?: string;
+  dateCreated?: string;
+  price?: number;
+  bedrooms?: number;
+  offerCount?: number;
+  viewingCount?: number;
+  publishedToPortals?: boolean;
+  publishedToWebsite?: boolean;
+  publishedToMatching?: boolean;
+  [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 id = p.id != null ? ` [ID: ${p.id}]` : "";
+      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.propertyType ? ` (${p.propertyType})` : "";
+      const offers = p.offerCount ? ` ${p.offerCount} offer${p.offerCount !== 1 ? "s" : ""}` : "";
+      return `- ${p.propertyAddress ?? "Unknown address"}${id}${price}${beds}${propType}${status}${offers}`;
+    },
+    "properties"
+  );
+}

package/payload/platform/plugins/loop/mcp/src/tools/supplier.ts

@@ -0,0 +1,129 @@
+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";
+
+// ─── Loop API V2: Supplier Endpoints ───────────────────────────
+// /supplier/maintenance/{code}/{jobId}/job-list — GET job list
+// /supplier/maintenance/{code}/{jobId}/complete — POST complete
+// /supplier/maintenance/{code}/{jobId}/quote-list — GET quotes
+// /supplier/maintenance/{code}/{quoteId}/quote-for-job — PUT quote
+// /supplier/board-contractor/{code}/{jobId}/job-list — GET jobs
+// /supplier/board-contractor/{code}/{jobId}/complete — POST complete
+// Uses quoteCode/code (string) and jobId (int64)
+// ────────────────────────────────────────────────────────────────
+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/platform/plugins/loop/mcp/src/tools/team-availability.ts

@@ -0,0 +1,52 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+// ─── Loop API V2: /team/{agentId}/availability/{searchDate} ────
+// Returns array of: { agentId, start, end }
+// Times are ISO datetime strings (e.g. "2026-04-10T06:00:00")
+// ────────────────────────────────────────────────────────────────
+interface LoopTimeRange {
+  agentId?: string;
+  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 ? formatTime(slot.start) : "?";
+      const end = slot.end ? formatTime(slot.end) : "?";
+      return `- ${start} — ${end}`;
+    },
+    `availability slots for ${searchDate}`
+  );
+}
+
+function formatTime(iso: string): string {
+  const timePart = iso.split("T")[1];
+  return timePart ? timePart.slice(0, 5) : iso;
+}

package/payload/platform/plugins/loop/mcp/src/tools/team-info.ts

@@ -0,0 +1,95 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+// ─── Loop API V2: /team ────────────────────────────────────────
+// Fields: apiKey (redacted), clientName, teamName,
+//   address1, address2, address3, email, phoneNumber, websiteUrl,
+//   primaryDarkColour, primaryLightColour, secondaryDarkColour,
+//   secondaryLightColour, legalName, websiteContactUrl,
+//   websitePropertiesUrl, dateCreated,
+//   members[] (each: id, firstName, lastName, email, mobilePhone,
+//     jobTitle, signatureImageUrl, avatarImage, avatarMedium,
+//     avatarThumbnail, biography, customUrl, twitterUrl)
+// ────────────────────────────────────────────────────────────────
+interface LoopTeam {
+  clientName?: string;
+  teamName?: string;
+  address1?: string;
+  address2?: string;
+  address3?: string;
+  email?: string;
+  phoneNumber?: string;
+  websiteUrl?: string;
+  legalName?: string;
+  dateCreated?: string;
+  members?: LoopTeamMember[];
+  [key: string]: unknown;
+}
+
+interface LoopTeamMember {
+  id: string;
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  mobilePhone?: string;
+  jobTitle?: string;
+  biography?: string;
+  [key: string]: unknown;
+}
+
+export async function teamInfo(params: {
+  accountId: string;
+  teamName?: string;
+}): Promise<string> {
+  const { accountId, teamName } = params;
+
+  const result = await aggregateAcrossTeams<LoopTeam>(
+    accountId,
+    "team",
+    "loop-team-info",
+    async (apiKey, team) => {
+      const data = await loopGet<LoopTeam>(
+        apiKey,
+        "/team",
+        "loop-team-info",
+        team
+      );
+      // /team returns a single object, not an array
+      if (data && typeof data === "object" && !Array.isArray(data)) {
+        return [data];
+      }
+      return Array.isArray(data) ? data : [];
+    },
+    { teamName }
+  );
+
+  return formatAggregationResult(
+    result,
+    (t) => {
+      const name = t.teamName ?? t.clientName ?? "Unknown";
+      const client = t.clientName && t.clientName !== t.teamName ? ` (${t.clientName})` : "";
+      const addr = t.address1 ? ` — ${t.address1}` : "";
+      const phone = t.phoneNumber ? ` | ${t.phoneNumber}` : "";
+      const email = t.email ? ` | ${t.email}` : "";
+      const web = t.websiteUrl ? ` | ${t.websiteUrl}` : "";
+
+      const lines = [`- **${name}**${client}${addr}${phone}${email}${web}`];
+
+      if (t.members?.length) {
+        lines.push(`  Team members (${t.members.length}):`);
+        for (const m of t.members) {
+          const mName = [m.firstName, m.lastName].filter(Boolean).join(" ");
+          const title = m.jobTitle ? ` (${m.jobTitle})` : "";
+          const mEmail = m.email ? ` — ${m.email}` : "";
+          lines.push(`    - ${mName} [ID: ${m.id}]${title}${mEmail}`);
+        }
+      }
+
+      return lines.join("\n");
+    },
+    "teams"
+  );
+}

package/payload/platform/plugins/loop/mcp/src/tools/viewing-create.ts

@@ -0,0 +1,41 @@
+import { loopPost, withTeamKey } from "../lib/loop-api.js";
+
+type Department = "sales" | "lettings";
+
+// ─── Loop API V2: POST /residential/{dept}/viewings ────────────
+// Request body: { propertyId, date, time, attendeeName,
+//   attendeeEmail?, attendeePhone? }
+// Response: number (the created viewing ID) in data field
+// ────────────────────────────────────────────────────────────────
+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/platform/plugins/loop/mcp/src/tools/viewing-detail.ts

@@ -0,0 +1,171 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+// ─── Loop API V2: /residential/{dept}/viewings/{id} ────────────
+// Fields: id, dateCreated, dateOfAppointment, dateOfAppointmentEnd,
+//   dateBuyerFeedbackGiven, dateSellerFeedbackGiven, dateDone,
+//   status, type, comment, buyerFeedback, sellerFeedback,
+//   buyerConfirmed, sellerConfirmed, agentConfirmed,
+//   property (nested PropertySummary), buyer (nested BuyerSummary),
+//   seller (nested SellerSummary),
+//   attendingAgent (nested TeamMember), creatingAgent (nested TeamMember),
+//   teamId
+// ────────────────────────────────────────────────────────────────
+interface LoopViewingDetail {
+  id: number;
+  dateCreated?: string;
+  dateOfAppointment?: string;
+  dateOfAppointmentEnd?: string;
+  dateBuyerFeedbackGiven?: string | null;
+  dateSellerFeedbackGiven?: string | null;
+  dateDone?: string | null;
+  status?: string;
+  type?: string;
+  comment?: string | null;
+  buyerFeedback?: string | null;
+  sellerFeedback?: string | null;
+  buyerConfirmed?: boolean;
+  sellerConfirmed?: boolean;
+  agentConfirmed?: boolean;
+  property?: {
+    id: number;
+    propertyAddress?: string;
+    status?: string;
+    propertyType?: string;
+    price?: number;
+    bedrooms?: number;
+    [key: string]: unknown;
+  };
+  buyer?: {
+    id: number;
+    buyerGroupName?: string;
+    maxPrice?: number | null;
+    position?: string;
+    viewingCount?: number;
+    offerCount?: number;
+    [key: string]: unknown;
+  };
+  seller?: {
+    id: number;
+    sellerGroupName?: string;
+    propertyAddress?: string;
+    price?: number;
+    [key: string]: unknown;
+  };
+  attendingAgent?: {
+    id: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    mobilePhone?: string;
+    jobTitle?: string;
+    [key: string]: unknown;
+  };
+  creatingAgent?: {
+    id: string;
+    firstName?: string;
+    lastName?: string;
+    [key: string]: unknown;
+  };
+  teamId?: 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 propAddr = v.property?.propertyAddress ?? "Unknown property";
+      const lines = [`**${propAddr}** [Viewing ID: ${v.id}]`];
+
+      // Appointment time
+      if (v.dateOfAppointment) {
+        const start = formatDateTime(v.dateOfAppointment);
+        const end = v.dateOfAppointmentEnd ? formatDateTime(v.dateOfAppointmentEnd) : "";
+        lines.push(`Date/Time: ${start}${end ? ` — ${end}` : ""}`);
+      }
+      if (v.status) lines.push(`Status: ${v.status}`);
+      if (v.type) lines.push(`Type: ${v.type}`);
+
+      // Confirmation status
+      const confirmParts: string[] = [];
+      if (v.buyerConfirmed != null) confirmParts.push(`Buyer: ${v.buyerConfirmed ? "yes" : "no"}`);
+      if (v.sellerConfirmed != null) confirmParts.push(`Seller: ${v.sellerConfirmed ? "yes" : "no"}`);
+      if (v.agentConfirmed != null) confirmParts.push(`Agent: ${v.agentConfirmed ? "yes" : "no"}`);
+      if (confirmParts.length) lines.push(`Confirmed — ${confirmParts.join(", ")}`);
+
+      // Property details
+      if (v.property) {
+        const prop = v.property;
+        if (prop.price != null) lines.push(`Property price: £${prop.price.toLocaleString("en-GB")}`);
+        if (prop.propertyType) lines.push(`Property type: ${prop.propertyType}`);
+        if (prop.bedrooms != null) lines.push(`Bedrooms: ${prop.bedrooms}`);
+        if (prop.id) lines.push(`Property ID: ${prop.id}`);
+      }
+
+      // Buyer
+      if (v.buyer) {
+        const b = v.buyer;
+        lines.push(`\n**Buyer:** ${b.buyerGroupName ?? "Unknown"} [ID: ${b.id}]`);
+        if (b.maxPrice != null) lines.push(`  Max price: £${b.maxPrice.toLocaleString("en-GB")}`);
+        if (b.position && b.position !== "none") lines.push(`  Position: ${b.position}`);
+      }
+
+      // Seller
+      if (v.seller) {
+        const s = v.seller;
+        lines.push(`\n**Seller:** ${s.sellerGroupName ?? "Unknown"} [ID: ${s.id}]`);
+      }
+
+      // Attending agent
+      if (v.attendingAgent) {
+        const a = v.attendingAgent;
+        const agentName = [a.firstName, a.lastName].filter(Boolean).join(" ");
+        const title = a.jobTitle ? ` (${a.jobTitle})` : "";
+        const contact = a.email ?? a.mobilePhone ?? "";
+        lines.push(`\n**Attending agent:** ${agentName}${title}${contact ? ` — ${contact}` : ""}`);
+      }
+
+      // Feedback
+      if (v.buyerFeedback) lines.push(`\nBuyer feedback: ${v.buyerFeedback}`);
+      if (v.sellerFeedback) lines.push(`Seller feedback: ${v.sellerFeedback}`);
+      if (v.comment) lines.push(`Notes: ${v.comment}`);
+
+      return lines.join("\n");
+    },
+    "viewing details"
+  );
+}
+
+function formatDateTime(iso: string): string {
+  const [datePart, timePart] = iso.split("T");
+  if (!timePart) return datePart;
+  return `${datePart} ${timePart.slice(0, 5)}`;
+}