@rubytech/create-maxy-code 0.1.45 → 0.1.49

package/payload/premium-plugins/real-agent/plugins/loop/mcp/src/tools/marketing-enquiry.ts

@@ -1,113 +1,27 @@
-import { loopGet, loopPost, loopPut, withTeamKey } from "../lib/loop-api.js";
+import { loopPost, withTeamKey } from "../lib/loop-api.js";
 
-type EnquiryAction = "seller-enquiry" | "autoresponder-get" | "autoresponder-answers" | "autoresponder-details" | "autoresponder-refer";
+// Loop API V2: POST /marketing/enquiries/seller
+// Submit a seller-side marketing enquiry. Auto-responder endpoints used to
+// live in this tool but were split into `loop-auto-responder` for intent
+// fidelity (Task 103).
 
-// ─── Loop API V2: Marketing Enquiry Endpoints ──────────────────
-// POST /marketing/enquiries/seller — submit seller enquiry
-// GET /marketing/enquiries/auto-responder/{id}/{key} — read enquiry
-// PUT .../auto-responder/{id}/answers/{key} — submit answers
-// PUT .../auto-responder/{id}/details/{key} — update details
-// PUT .../auto-responder/{id}/refer/{key} — refer enquiry
-// Note: auto-responder uses personCode + key (UUID), not personId
-// ────────────────────────────────────────────────────────────────
 interface LoopBooleanResponse {
   success?: boolean;
   [key: string]: unknown;
 }
 
-interface LoopAutoResponderDetails {
-  id?: number;
-  questions?: unknown[];
-  enquiryDetails?: unknown;
-  [key: string]: unknown;
-}
-
 export async function marketingEnquiry(params: {
   accountId: string;
   teamName: string;
-  action: EnquiryAction;
-  // For seller-enquiry
   sellerEnquiryData?: Record<string, unknown>;
-  // For autoresponder actions
-  autoResponderId?: number;
-  autoResponderKey?: string;
-  // For autoresponder-answers
-  answers?: unknown[];
-  // For autoresponder-details
-  details?: Record<string, unknown>;
 }): Promise<string> {
-  const { accountId, teamName, action } = params;
-
-  if (action === "seller-enquiry") {
-    await withTeamKey<LoopBooleanResponse>(
-      accountId, teamName, "marketing", "loop-marketing-enquiry",
-      async (apiKey) => {
-        return loopPost<LoopBooleanResponse>(
-          apiKey, "/marketing/enquiries/seller",
-          params.sellerEnquiryData ?? {}, "loop-marketing-enquiry", teamName
-        );
-      }
-    );
-    return `Seller enquiry submitted via team "${teamName}".`;
-  }
-
-  if (!params.autoResponderId || !params.autoResponderKey) {
-    throw new Error("autoResponderId and autoResponderKey are required for autoresponder actions.");
-  }
-  const id = params.autoResponderId;
-  const key = params.autoResponderKey;
-
-  if (action === "autoresponder-get") {
-    const result = await withTeamKey<LoopAutoResponderDetails>(
-      accountId, teamName, "marketing", "loop-marketing-enquiry",
-      async (apiKey) => {
-        return loopGet<LoopAutoResponderDetails>(
-          apiKey, `/marketing/enquiries/auto-responder/${id}/${key}`,
-          "loop-marketing-enquiry", teamName
-        );
-      }
-    );
-    return JSON.stringify(result, null, 2);
-  }
-
-  if (action === "autoresponder-answers") {
-    await withTeamKey<LoopBooleanResponse>(
-      accountId, teamName, "marketing", "loop-marketing-enquiry",
-      async (apiKey) => {
-        return loopPut<LoopBooleanResponse>(
-          apiKey, `/marketing/enquiries/auto-responder/${id}/answers/${key}`,
-          params.answers ?? [], "loop-marketing-enquiry", teamName
-        );
-      }
-    );
-    return `Auto-responder answers submitted for enquiry ${id} via team "${teamName}".`;
-  }
-
-  if (action === "autoresponder-details") {
-    await withTeamKey<LoopBooleanResponse>(
-      accountId, teamName, "marketing", "loop-marketing-enquiry",
-      async (apiKey) => {
-        return loopPut<LoopBooleanResponse>(
-          apiKey, `/marketing/enquiries/auto-responder/${id}/details/${key}`,
-          params.details ?? {}, "loop-marketing-enquiry", teamName
-        );
-      }
-    );
-    return `Auto-responder details updated for enquiry ${id} via team "${teamName}".`;
-  }
-
-  if (action === "autoresponder-refer") {
-    await withTeamKey<LoopBooleanResponse>(
-      accountId, teamName, "marketing", "loop-marketing-enquiry",
-      async (apiKey) => {
-        return loopPut<LoopBooleanResponse>(
-          apiKey, `/marketing/enquiries/auto-responder/${id}/refer/${key}`,
-          {}, "loop-marketing-enquiry", teamName
-        );
-      }
-    );
-    return `Enquiry ${id} referred via team "${teamName}".`;
-  }
-
-  throw new Error(`Unknown action: ${action}`);
+  const { accountId, teamName, sellerEnquiryData } = params;
+  await withTeamKey<LoopBooleanResponse>(
+    accountId, teamName, "marketing", "loop-marketing-enquiry",
+    async (apiKey) => loopPost<LoopBooleanResponse>(
+      apiKey, "/marketing/enquiries/seller",
+      sellerEnquiryData ?? {}, "loop-marketing-enquiry", teamName
+    )
+  );
+  return `Seller enquiry submitted via team "${teamName}".`;
 }

package/payload/premium-plugins/real-agent/plugins/loop/mcp/src/tools/property-intent.ts

@@ -0,0 +1,84 @@
+import { loopPost, withTeamKey } from "../lib/loop-api.js";
+
+type Department = "sales" | "lettings";
+
+// Loop API V2: distinct operator-intent endpoints (post-Task 103 split).
+//   POST /property/residential/{dept}/{id}/viewing      — request a viewing
+//   POST /property/residential/{dept}/{id}/call-back    — request a callback
+//   POST /property/residential/{dept}/{id}/information  — request more information
+// Each endpoint takes the same {name?, email?, phone?, message?} body but is
+// surfaced as a separate tool so operator intent is preserved on the agent's
+// tool-call surface (replaces the prior bundled loop-property-request).
+
+interface LoopBooleanResponse {
+  success?: boolean;
+  [key: string]: unknown;
+}
+
+async function submitIntent(
+  toolName: string,
+  action: "viewing" | "call-back" | "information",
+  params: {
+    accountId: string;
+    teamName: string;
+    propertyId: number;
+    department: Department;
+    name?: string;
+    email?: string;
+    phone?: string;
+    message?: string;
+  },
+  successLabel: string
+): Promise<string> {
+  const { accountId, teamName, propertyId, department, ...body } = params;
+  await withTeamKey<LoopBooleanResponse>(
+    accountId,
+    teamName,
+    "properties",
+    toolName,
+    async (apiKey) => {
+      const path = `/property/residential/${department}/${propertyId}/${action}`;
+      return loopPost<LoopBooleanResponse>(apiKey, path, body, toolName, teamName);
+    }
+  );
+  return `${successLabel} submitted for property ${propertyId} (${department}) via team "${teamName}".`;
+}
+
+export async function propertyViewing(params: {
+  accountId: string;
+  teamName: string;
+  propertyId: number;
+  department: Department;
+  name?: string;
+  email?: string;
+  phone?: string;
+  message?: string;
+}): Promise<string> {
+  return submitIntent("loop-property-viewing", "viewing", params, "Viewing request");
+}
+
+export async function propertyCallback(params: {
+  accountId: string;
+  teamName: string;
+  propertyId: number;
+  department: Department;
+  name?: string;
+  email?: string;
+  phone?: string;
+  message?: string;
+}): Promise<string> {
+  return submitIntent("loop-property-callback", "call-back", params, "Callback request");
+}
+
+export async function propertyInformation(params: {
+  accountId: string;
+  teamName: string;
+  propertyId: number;
+  department: Department;
+  name?: string;
+  email?: string;
+  phone?: string;
+  message?: string;
+}): Promise<string> {
+  return submitIntent("loop-property-information", "information", params, "Information request");
+}

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

@@ -39,11 +39,10 @@ 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 { accountId, channel, department = "both", teamName, limit } = params;
 
   const result = await aggregateAcrossTeams<LoopPropertyListing>(
     accountId,
@@ -60,12 +59,6 @@ export async function propertyListed(params: {
         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 }

package/payload/premium-plugins/real-agent/plugins/loop/mcp/src/tools/property-sold.ts

@@ -0,0 +1,67 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  loopGet,
+} from "../lib/loop-api.js";
+
+// Loop API V2: GET /property/residential/sold/{channel}
+// Distinct from /listed/{channel} — returns exchanged or completed properties
+// (Loop swagger summary: "USE THIS TO POWER WEBSITE SOLD GALLERIES").
+// Use case: canvassing letters built from recent sales in a target postcode.
+
+interface LoopPropertyListing {
+  listingId?: number;
+  propertyId?: number;
+  propertyRefId?: string;
+  channel?: string;
+  propertyAddress?: string;
+  displayAddress?: string;
+  status?: string;
+  propertyType?: string;
+  dateLaunched?: string;
+  price?: number;
+  bedrooms?: number;
+  bathrooms?: number;
+  receptionRooms?: number;
+  shortDescription?: string;
+  features?: string[];
+  images?: { url: string }[];
+  [key: string]: unknown;
+}
+
+type Channel = "rightmove" | "onTheMarket" | "zoopla" | "website";
+
+export async function propertySold(params: {
+  accountId: string;
+  channel: Channel;
+  teamName?: string;
+  limit?: number;
+}): Promise<string> {
+  const { accountId, channel, teamName, limit } = params;
+
+  const result = await aggregateAcrossTeams<LoopPropertyListing>(
+    accountId,
+    "properties",
+    "loop-property-sold",
+    async (apiKey, team) => {
+      const path = `/property/residential/sold/${channel}`;
+      const data = await loopGet<LoopPropertyListing[]>(apiKey, path, "loop-property-sold", team);
+      return Array.isArray(data) ? data : [];
+    },
+    { teamName, limitPerTeam: limit ?? 50, limitTotal: limit ?? 200 }
+  );
+
+  return formatAggregationResult(
+    result,
+    (p) => {
+      const addr = p.displayAddress ?? p.propertyAddress ?? "Unknown address";
+      const id = p.propertyId != null ? ` [ID: ${p.propertyId}]` : "";
+      const price = p.price ? ` — £${p.price.toLocaleString("en-GB")}` : "";
+      const beds = p.bedrooms ? ` ${p.bedrooms}bed` : "";
+      const propType = p.propertyType ? ` (${p.propertyType})` : "";
+      const status = p.status ? ` [${p.status}]` : "";
+      return `- ${addr}${id}${price}${beds}${propType}${status}`;
+    },
+    `${channel} sold`
+  );
+}