@burdenoff/mcp-libs 2026.626.1 → 2026.627.2

package/dist/modules/housingvista/index.cjs

@@ -0,0 +1,1092 @@
+'use strict';
+
+var zod = require('zod');
+require('graphql-request');
+require('cross-fetch');
+require('@modelcontextprotocol/sdk/server/mcp.js');
+require('@modelcontextprotocol/sdk/types.js');
+
+// src/modules/housingvista/tools/properties.ts
+
+// src/core/errors.ts
+var McpInternalError = class extends Error {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "McpInternalError";
+    this.cause = cause;
+  }
+};
+
+// src/core/result.ts
+function jsonResult(data, structured) {
+  const result = {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  };
+  return result;
+}
+function errorResult(message, hint) {
+  const text = hint ? `${message}
+
+Hint: ${hint}` : message;
+  return { content: [{ type: "text", text }], isError: true };
+}
+
+// src/core/tool-name.ts
+var MAX_TOOL_NAME_LENGTH = 63;
+function assertSafeName(name, kind) {
+  if (name.length > MAX_TOOL_NAME_LENGTH) {
+    throw new McpInternalError(
+      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`
+    );
+  }
+  return name;
+}
+function mcpToolName(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpToolName: productName is required");
+  }
+  const name = [productName, ...parts].filter(Boolean).join("_");
+  return assertSafeName(name);
+}
+function mcpResourceUri(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpResourceUri: productName is required");
+  }
+  return `${productName}://${parts.filter(Boolean).join("/")}`;
+}
+function mcpPromptName(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpPromptName: productName is required");
+  }
+  return [productName, ...parts].filter(Boolean).join("-");
+}
+
+// src/modules/housingvista/operations.ts
+var PROPERTY_FIELDS = `
+  id title description category type status price totalArea bedrooms bathrooms
+  city state imageUrl context workspaceId createdAt updatedAt
+`;
+var PROPERTY_REF_FIELDS = `id title city state price status type`;
+var INVESTMENT_FIELDS = `
+  id title investmentType totalValue riskLevel status investors returns
+  propertyId workspaceId createdAt updatedAt
+  property { ${PROPERTY_REF_FIELDS} }
+`;
+var TRANSACTION_FIELDS = `
+  id title type status amount currency parties milestones escrow documents
+  propertyId workspaceId createdAt updatedAt
+  property { ${PROPERTY_REF_FIELDS} }
+`;
+var RENTAL_UNIT_FIELDS = `
+  id unitNumber propertyId propertyTitle tenantName tenantEmail tenantPhone
+  monthlyRent securityDeposit leaseStart leaseEnd status paymentStatus lastPaymentAt
+`;
+var AMC_CONTRACT_FIELDS = `
+  id packageName providerName propertyTitle status monthlyCost startDate endDate
+  nextServiceDate servicesIncluded
+`;
+var ASSET_FIELDS = `
+  id title type category status location currentValue purchasePrice
+  appreciationPercent rentalYield imageUrl
+`;
+var MARKETPLACE_SERVICE_FIELDS = `
+  id name category description providerName rating reviewCount priceRange
+  responseTime availableAreas featured verified imageUrl
+`;
+var LEGAL_SERVICE_FIELDS = `
+  id title category description providerName providerRating status consultationFee
+  priceRange estimatedDuration documentsRequired features
+`;
+var AREA_INSIGHT_FIELDS = `
+  id areaName city avgPropertyPrice avgRentalYield appreciationRate population
+  safetyScore connectivityScore amenitiesScore greenCoverPercent schoolsNearby
+  hospitalsNearby upcomingProjects
+`;
+var MARKET_TREND_FIELDS = `
+  id monthLabel avgPrice avgRent priceChangePercent demandIndex supplyIndex
+`;
+var HOME_LOAN_OFFER_FIELDS = `
+  id bankName interestRate maxAmount maxTenure processingFee prepaymentCharges
+  emiPerLakh rating specialOffer features
+`;
+var VERIFICATION_ITEM_FIELDS = `
+  id entityType entityLabel status priority notes submittedAt
+`;
+var DASHBOARD_STATS_FIELDS = `
+  totalProperties totalValue totalPortfolioValue totalInvestments investmentReturns
+  monthlyRevenue occupancyRate totalTenants activeTransactions pendingVerifications
+  maintenanceRequests upcomingViewings unreadMessages
+`;
+var GET_PROPERTY = `
+  query HousingVistaProperty($id: ID!) {
+    housingvistaProperty(id: $id) {
+      ${PROPERTY_FIELDS}
+    }
+  }
+`;
+var LIST_PROPERTIES = `
+  query HousingVistaProperties(
+    $filter: HousingVistaPropertyFilterInput
+    $pagination: HousingVistaPaginationInput
+  ) {
+    housingvistaProperties(filter: $filter, pagination: $pagination) {
+      ${PROPERTY_FIELDS}
+    }
+  }
+`;
+var CREATE_PROPERTY = `
+  mutation HousingVistaCreateProperty($input: CreatePropertyInput!) {
+    createHousingvistaProperty(input: $input) {
+      ${PROPERTY_FIELDS}
+    }
+  }
+`;
+var UPDATE_PROPERTY = `
+  mutation HousingVistaUpdateProperty($id: ID!, $input: UpdatePropertyInput!) {
+    updateHousingvistaProperty(id: $id, input: $input) {
+      ${PROPERTY_FIELDS}
+    }
+  }
+`;
+var DELETE_PROPERTY = `
+  mutation HousingVistaDeleteProperty($id: ID!) {
+    deleteHousingvistaProperty(id: $id)
+  }
+`;
+var GET_INVESTMENT = `
+  query HousingVistaInvestment($id: ID!) {
+    housingvistaInvestment(id: $id) {
+      ${INVESTMENT_FIELDS}
+    }
+  }
+`;
+var LIST_INVESTMENTS = `
+  query HousingVistaInvestments($pagination: HousingVistaPaginationInput) {
+    housingvistaInvestments(pagination: $pagination) {
+      ${INVESTMENT_FIELDS}
+    }
+  }
+`;
+var GET_TRANSACTION = `
+  query HousingVistaTransaction($id: ID!) {
+    housingvistaTransaction(id: $id) {
+      ${TRANSACTION_FIELDS}
+    }
+  }
+`;
+var LIST_TRANSACTIONS = `
+  query HousingVistaTransactions($pagination: HousingVistaPaginationInput) {
+    housingvistaTransactions(pagination: $pagination) {
+      ${TRANSACTION_FIELDS}
+    }
+  }
+`;
+var LIST_RENTAL_UNITS = `
+  query HousingVistaRentalUnits($pagination: HousingVistaPaginationInput) {
+    housingvistaRentalUnits(pagination: $pagination) {
+      ${RENTAL_UNIT_FIELDS}
+    }
+  }
+`;
+var LIST_AMC_CONTRACTS = `
+  query HousingVistaAmcContracts($pagination: HousingVistaPaginationInput) {
+    housingvistaAmcContracts(pagination: $pagination) {
+      ${AMC_CONTRACT_FIELDS}
+    }
+  }
+`;
+var LIST_ASSETS = `
+  query HousingVistaAssets($pagination: HousingVistaPaginationInput) {
+    housingvistaAssets(pagination: $pagination) {
+      ${ASSET_FIELDS}
+    }
+  }
+`;
+var LIST_MARKETPLACE_SERVICES = `
+  query HousingVistaMarketplaceServices($pagination: HousingVistaPaginationInput) {
+    housingvistaMarketplaceServices(pagination: $pagination) {
+      ${MARKETPLACE_SERVICE_FIELDS}
+    }
+  }
+`;
+var LIST_LEGAL_SERVICES = `
+  query HousingVistaLegalServices($pagination: HousingVistaPaginationInput) {
+    housingvistaLegalServices(pagination: $pagination) {
+      ${LEGAL_SERVICE_FIELDS}
+    }
+  }
+`;
+var LIST_AREA_INSIGHTS = `
+  query HousingVistaAreaInsights($pagination: HousingVistaPaginationInput) {
+    housingvistaAreaInsights(pagination: $pagination) {
+      ${AREA_INSIGHT_FIELDS}
+    }
+  }
+`;
+var LIST_MARKET_TRENDS = `
+  query HousingVistaMarketTrends($pagination: HousingVistaPaginationInput) {
+    housingvistaMarketTrends(pagination: $pagination) {
+      ${MARKET_TREND_FIELDS}
+    }
+  }
+`;
+var LIST_HOME_LOAN_OFFERS = `
+  query HousingVistaHomeLoanOffers($pagination: HousingVistaPaginationInput) {
+    housingvistaHomeLoanOffers(pagination: $pagination) {
+      ${HOME_LOAN_OFFER_FIELDS}
+    }
+  }
+`;
+var LIST_VERIFICATION_ITEMS = `
+  query HousingVistaVerificationItems($pagination: HousingVistaPaginationInput) {
+    housingvistaVerificationItems(pagination: $pagination) {
+      ${VERIFICATION_ITEM_FIELDS}
+    }
+  }
+`;
+var DASHBOARD_STATS = `
+  query HousingVistaDashboardStats {
+    housingvistaDashboardStats {
+      ${DASHBOARD_STATS_FIELDS}
+    }
+  }
+`;
+var PropertyStatusEnum = zod.z.enum(["for_rent", "for_sale", "off_market", "rented", "sold", "under_contract"]).describe("Listing/market status of a property");
+var PropertyTypeEnum = zod.z.enum(["agricultural", "commercial", "industrial", "mixed_use", "residential"]).describe("Physical use-class of a property");
+var JsonObject = zod.z.record(zod.z.string(), zod.z.unknown());
+
+// src/modules/housingvista/tools/properties.ts
+function registerPropertyTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "properties_get")),
+    {
+      title: "Get Property",
+      description: "Fetch a single HousingVista property listing by ID.",
+      inputSchema: { id: zod.z.string().describe("Property ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_PROPERTY, { id });
+        if (!data.housingvistaProperty) return errorResult(`Property ${id} not found`);
+        return jsonResult(data.housingvistaProperty);
+      } catch (error) {
+        ctx.logger.error("housingvista properties_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get property: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "properties_list")),
+    {
+      title: "List Properties",
+      description: "List property listings in the bound workspace with optional city/status/type/text filters and pagination.",
+      inputSchema: {
+        city: zod.z.string().optional().describe("Filter by city"),
+        status: PropertyStatusEnum.optional().describe("Filter by listing status"),
+        type: PropertyTypeEnum.optional().describe("Filter by property use-class"),
+        search: zod.z.string().optional().describe("Free-text search across title/description"),
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ city, status, type, search, limit, offset }) => {
+      try {
+        const filter = {};
+        if (city !== void 0) filter.city = city;
+        if (status !== void 0) filter.status = status;
+        if (type !== void 0) filter.type = type;
+        if (search !== void 0) filter.search = search;
+        const data = await ctx.gql.workspace.request(LIST_PROPERTIES, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaProperties);
+      } catch (error) {
+        ctx.logger.error("housingvista properties_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list properties: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "properties_create")),
+    {
+      title: "Create Property",
+      description: 'Create a new property listing. `type` and `status` are required enums; `category` is a free-form label (e.g. "Apartment", "Villa", "Plot").',
+      inputSchema: {
+        title: zod.z.string().min(1).describe("Listing title"),
+        category: zod.z.string().min(1).describe('Free-form category label, e.g. "Apartment", "Villa"'),
+        type: PropertyTypeEnum.describe("Property use-class"),
+        status: PropertyStatusEnum.describe("Initial listing status"),
+        price: zod.z.number().describe("Asking / listed price"),
+        totalArea: zod.z.number().describe("Total area (e.g. sq ft)"),
+        bedrooms: zod.z.number().int().describe("Number of bedrooms"),
+        bathrooms: zod.z.number().int().describe("Number of bathrooms"),
+        city: zod.z.string().min(1).describe("City"),
+        state: zod.z.string().min(1).describe("State"),
+        description: zod.z.string().optional().describe("Listing description"),
+        imageUrl: zod.z.string().optional().describe("Primary image URL"),
+        context: JsonObject.optional().describe(
+          "Arbitrary context JSON (amenities, metadata, etc.)"
+        )
+      }
+    },
+    async ({
+      title,
+      category,
+      type,
+      status,
+      price,
+      totalArea,
+      bedrooms,
+      bathrooms,
+      city,
+      state,
+      description,
+      imageUrl,
+      context
+    }) => {
+      try {
+        const input = {
+          title,
+          category,
+          type,
+          status,
+          price,
+          totalArea,
+          bedrooms,
+          bathrooms,
+          city,
+          state
+        };
+        if (description !== void 0) input.description = description;
+        if (imageUrl !== void 0) input.imageUrl = imageUrl;
+        if (context !== void 0) input.context = context;
+        const data = await ctx.gql.workspace.request(CREATE_PROPERTY, { input });
+        return jsonResult(data.createHousingvistaProperty);
+      } catch (error) {
+        ctx.logger.error("housingvista properties_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create property: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "properties_update")),
+    {
+      title: "Update Property",
+      description: "Update a property listing. At least one mutable field must be provided. Use `status` to move a listing through its market lifecycle.",
+      inputSchema: {
+        id: zod.z.string().describe("Property ID"),
+        title: zod.z.string().optional().describe("Updated title"),
+        category: zod.z.string().optional().describe("Updated category label"),
+        type: PropertyTypeEnum.optional().describe("Updated use-class"),
+        status: PropertyStatusEnum.optional().describe("Updated listing status"),
+        price: zod.z.number().optional().describe("Updated price"),
+        totalArea: zod.z.number().optional().describe("Updated total area"),
+        bedrooms: zod.z.number().int().optional().describe("Updated bedroom count"),
+        bathrooms: zod.z.number().int().optional().describe("Updated bathroom count"),
+        city: zod.z.string().optional().describe("Updated city"),
+        state: zod.z.string().optional().describe("Updated state"),
+        description: zod.z.string().optional().describe("Updated description"),
+        imageUrl: zod.z.string().optional().describe("Updated primary image URL"),
+        context: JsonObject.optional().describe("Updated context JSON")
+      }
+    },
+    async ({
+      id,
+      title,
+      category,
+      type,
+      status,
+      price,
+      totalArea,
+      bedrooms,
+      bathrooms,
+      city,
+      state,
+      description,
+      imageUrl,
+      context
+    }) => {
+      try {
+        const input = {};
+        if (title !== void 0) input.title = title;
+        if (category !== void 0) input.category = category;
+        if (type !== void 0) input.type = type;
+        if (status !== void 0) input.status = status;
+        if (price !== void 0) input.price = price;
+        if (totalArea !== void 0) input.totalArea = totalArea;
+        if (bedrooms !== void 0) input.bedrooms = bedrooms;
+        if (bathrooms !== void 0) input.bathrooms = bathrooms;
+        if (city !== void 0) input.city = city;
+        if (state !== void 0) input.state = state;
+        if (description !== void 0) input.description = description;
+        if (imageUrl !== void 0) input.imageUrl = imageUrl;
+        if (context !== void 0) input.context = context;
+        if (Object.keys(input).length === 0) {
+          return errorResult(
+            "No updates specified \u2014 provide at least one mutable property field (title/category/type/status/price/totalArea/bedrooms/bathrooms/city/state/description/imageUrl/context)"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_PROPERTY, { id, input });
+        return jsonResult(data.updateHousingvistaProperty);
+      } catch (error) {
+        ctx.logger.error("housingvista properties_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update property: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "properties_delete")),
+    {
+      title: "Delete Property",
+      description: "Delete a property listing by ID. Returns true on success.",
+      inputSchema: { id: zod.z.string().describe("Property ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(DELETE_PROPERTY, { id });
+        return jsonResult({ deleted: data.deleteHousingvistaProperty, id });
+      } catch (error) {
+        ctx.logger.error("housingvista properties_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete property: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerInvestmentTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "investments_get")),
+    {
+      title: "Get Investment",
+      description: "Fetch a single HousingVista property investment by ID, including its property, investors, and returns.",
+      inputSchema: { id: zod.z.string().describe("Investment ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_INVESTMENT, { id });
+        if (!data.housingvistaInvestment) return errorResult(`Investment ${id} not found`);
+        return jsonResult(data.housingvistaInvestment);
+      } catch (error) {
+        ctx.logger.error("housingvista investments_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get investment: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "investments_list")),
+    {
+      title: "List Investments",
+      description: "List property-investment vehicles in the bound workspace with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_INVESTMENTS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaInvestments);
+      } catch (error) {
+        ctx.logger.error("housingvista investments_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list investments: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerTransactionTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "transactions_get")),
+    {
+      title: "Get Transaction",
+      description: "Fetch a single HousingVista property transaction by ID, including its property, parties, milestones, escrow, and documents.",
+      inputSchema: { id: zod.z.string().describe("Transaction ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_TRANSACTION, { id });
+        if (!data.housingvistaTransaction) return errorResult(`Transaction ${id} not found`);
+        return jsonResult(data.housingvistaTransaction);
+      } catch (error) {
+        ctx.logger.error("housingvista transactions_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get transaction: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "transactions_list")),
+    {
+      title: "List Transactions",
+      description: "List property transactions (deal pipeline) in the bound workspace with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_TRANSACTIONS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaTransactions);
+      } catch (error) {
+        ctx.logger.error("housingvista transactions_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list transactions: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerLeasingTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "rentals_list")),
+    {
+      title: "List Rental Units",
+      description: "List rental units (tenancies) in the bound workspace \u2014 tenant, lease window, monthly rent, and payment status \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_RENTAL_UNITS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaRentalUnits);
+      } catch (error) {
+        ctx.logger.error("housingvista rentals_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list rental units: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "amc_list")),
+    {
+      title: "List AMC Contracts",
+      description: "List annual maintenance contracts (AMC) in the bound workspace \u2014 package, provider, cost, and next service date \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_AMC_CONTRACTS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaAmcContracts);
+      } catch (error) {
+        ctx.logger.error("housingvista amc_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list AMC contracts: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerAssetTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "assets_list")),
+    {
+      title: "List Assets",
+      description: "List owned real-estate assets in the bound workspace \u2014 current value, purchase price, appreciation, and rental yield \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_ASSETS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaAssets);
+      } catch (error) {
+        ctx.logger.error("housingvista assets_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list assets: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerMarketplaceTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "marketplace_services_list")),
+    {
+      title: "List Marketplace Services",
+      description: "List vendor marketplace services in the bound workspace \u2014 provider, rating, price range, coverage areas, and verification flag \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_MARKETPLACE_SERVICES, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaMarketplaceServices);
+      } catch (error) {
+        ctx.logger.error("housingvista marketplace_services_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list marketplace services: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "legal_services_list")),
+    {
+      title: "List Legal Services",
+      description: "List legal/conveyancing services in the bound workspace \u2014 provider, rating, consultation fee, required documents, and estimated duration \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_LEGAL_SERVICES, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaLegalServices);
+      } catch (error) {
+        ctx.logger.error("housingvista legal_services_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list legal services: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerMarketTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "market_area_insights")),
+    {
+      title: "List Area Insights",
+      description: "List per-area market insights in the bound workspace \u2014 average price, rental yield, appreciation rate, and liveability scores \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_AREA_INSIGHTS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaAreaInsights);
+      } catch (error) {
+        ctx.logger.error("housingvista market_area_insights failed", { error: String(error) });
+        return errorResult(
+          `Failed to list area insights: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "market_trends")),
+    {
+      title: "List Market Trends",
+      description: "List time-series market trends in the bound workspace \u2014 average price/rent, price change percent, and demand/supply indices by month \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_MARKET_TRENDS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaMarketTrends);
+      } catch (error) {
+        ctx.logger.error("housingvista market_trends failed", { error: String(error) });
+        return errorResult(
+          `Failed to list market trends: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "market_home_loans")),
+    {
+      title: "List Home Loan Offers",
+      description: "List home-loan offers in the bound workspace \u2014 bank, interest rate, max amount/tenure, processing fee, and EMI per lakh \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_HOME_LOAN_OFFERS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaHomeLoanOffers);
+      } catch (error) {
+        ctx.logger.error("housingvista market_home_loans failed", { error: String(error) });
+        return errorResult(
+          `Failed to list home loan offers: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerVerificationTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "verification_list")),
+    {
+      title: "List Verification Items",
+      description: "List items in the verification/moderation queue for the bound workspace \u2014 entity type/label, status, and priority \u2014 with pagination.",
+      inputSchema: {
+        limit: zod.z.number().int().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_VERIFICATION_ITEMS, {
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.housingvistaVerificationItems);
+      } catch (error) {
+        ctx.logger.error("housingvista verification_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list verification items: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/housingvista/tools/analytics.ts
+function registerAnalyticsTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "analytics_dashboard")),
+    {
+      title: "HousingVista Dashboard Stats",
+      description: "Headline portfolio KPIs: total properties/value/portfolio-value, investments + returns, monthly revenue, occupancy rate, tenants, active transactions, pending verifications, maintenance requests, upcoming viewings, and unread messages.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(DASHBOARD_STATS, {});
+        return jsonResult(data.housingvistaDashboardStats);
+      } catch (error) {
+        ctx.logger.error("housingvista analytics_dashboard failed", { error: String(error) });
+        return errorResult(
+          `Failed to get dashboard stats: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/housingvista/resources.ts
+function registerHousingVistaResources(server, ctx, track) {
+  const schemaUri = track(mcpResourceUri(ctx.productName, "schema"));
+  const dashboardUri = track(mcpResourceUri(ctx.productName, "dashboard"));
+  const propertiesUri = track(mcpResourceUri(ctx.productName, "properties"));
+  const marketUri = track(mcpResourceUri(ctx.productName, "market"));
+  server.registerResource(
+    "housingvista-schema",
+    schemaUri,
+    {
+      title: "HousingVista Domain Schema",
+      description: "Overview of the HousingVista real-estate domain \u2014 entities, enums, and the per-entity tool surface.",
+      mimeType: "text/plain"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${schemaUri} requested`);
+      const schema = `# HousingVista Domain (Overview)
+
+End-to-end real-estate platform: listings, transactions, investments, rentals,
+maintenance contracts, a services marketplace, market intelligence, and a
+verification queue.
+
+## Entities
+- Property \u2014 a property listing (the core entity; full CRUD)
+- Investment \u2014 a property-investment vehicle (embeds property, investors, returns)
+- HousingVistaTransaction \u2014 a property deal (parties, milestones, escrow, documents)
+- RentalUnit \u2014 a rental tenancy (tenant, lease window, rent, payment status)
+- AmcContract \u2014 an annual maintenance contract (package, provider, service date)
+- HousingVistaAsset \u2014 an owned real-estate asset (value, appreciation, yield)
+- MarketplaceService \u2014 a vendor marketplace service
+- LegalService \u2014 a legal/conveyancing service
+- AreaInsight \u2014 per-area market intelligence (price, yield, liveability scores)
+- MarketTrend \u2014 time-series market trends (price/rent, demand/supply indices)
+- HomeLoanOffer \u2014 a bank home-loan offer
+- VerificationItem \u2014 an item in the verification/moderation queue
+
+## Enums
+- PropertyStatus: for_rent, for_sale, off_market, rented, sold, under_contract
+- PropertyType: agricultural, commercial, industrial, mixed_use, residential
+
+## Tool groups
+properties (CRUD), investments, transactions, leasing (rentals + amc), assets,
+marketplace (marketplace + legal services), market (area insights + trends +
+home loans), verification, analytics. All run against the WORKSPACE gateway
+(workspace-scoped).
+`;
+      return {
+        contents: [{ uri: schemaUri, text: schema, mimeType: "text/plain" }]
+      };
+    }
+  );
+  server.registerResource(
+    "housingvista-dashboard",
+    dashboardUri,
+    {
+      title: "HousingVista Dashboard Stats",
+      description: "Live headline portfolio KPIs (properties, value, investments, occupancy, tenants, transactions).",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${dashboardUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          DASHBOARD_STATS,
+          {}
+        );
+        return {
+          contents: [
+            {
+              uri: dashboardUri,
+              text: JSON.stringify(data.housingvistaDashboardStats, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: dashboardUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "housingvista-properties",
+    propertiesUri,
+    {
+      title: "HousingVista Property Listings",
+      description: "The first 50 property listings in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${propertiesUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          LIST_PROPERTIES,
+          { pagination: { limit: 50, offset: 0 } }
+        );
+        return {
+          contents: [
+            {
+              uri: propertiesUri,
+              text: JSON.stringify(data.housingvistaProperties, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: propertiesUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "housingvista-market",
+    marketUri,
+    {
+      title: "HousingVista Market Trends",
+      description: "Time-series market trends (price/rent, demand/supply indices) for the workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${marketUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          LIST_MARKET_TRENDS,
+          { pagination: { limit: 50, offset: 0 } }
+        );
+        return {
+          contents: [
+            {
+              uri: marketUri,
+              text: JSON.stringify(data.housingvistaMarketTrends, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: marketUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+function registerHousingVistaPrompts(server, ctx, track) {
+  const p = ctx.productName;
+  const listingName = track(mcpPromptName(p, "property-listing"));
+  const portfolioName = track(mcpPromptName(p, "portfolio-review"));
+  server.registerPrompt(
+    listingName,
+    {
+      title: "Property Listing",
+      description: "Guide for listing a new HousingVista property end to end: create the listing, enrich it, cross-check the local market, and move it to market.",
+      argsSchema: {
+        city: zod.z.string().optional().describe("Target city"),
+        type: zod.z.string().optional().describe("Property type (use-class)")
+      }
+    },
+    ({ city, type }) => {
+      ctx.logger.debug(`Prompt ${listingName} called`, { city, type });
+      const cityNote = city ? `Target city is "${city}".` : "Ask the user for the city.";
+      const typeNote = type ? `Use property type ${type}.` : "Help the user pick a PropertyType (residential/commercial/industrial/agricultural/mixed_use).";
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Help me list a new HousingVista property.
+
+1. **Market Check**: Use ${p}_market_area_insights and ${p}_market_trends to ground pricing for the area. ${cityNote}
+2. **Create Listing**: Use ${p}_properties_create. ${typeNote} Provide title, category, price, totalArea, bedrooms, bathrooms, city, and state. Set status=for_sale or for_rent.
+3. **Review**: Use ${p}_properties_get to confirm the created listing, then ${p}_properties_update to refine description/imageUrl/context if needed.
+4. **Finance Options**: Use ${p}_market_home_loans to surface relevant home-loan offers for prospective buyers.
+5. **Verify Catalog**: Use ${p}_properties_list filtered by city/type/status to confirm the listing appears.
+
+Show results at each step and confirm before publishing.`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.registerPrompt(
+    portfolioName,
+    {
+      title: "Portfolio Review",
+      description: "Review workflow for a real-estate portfolio: headline KPIs, owned assets, active transactions, investments, rental income, maintenance contracts, and the verification queue.",
+      argsSchema: {}
+    },
+    () => {
+      ctx.logger.debug(`Prompt ${portfolioName} called`);
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Run a HousingVista portfolio review.
+
+1. **KPIs**: Use ${p}_analytics_dashboard for headline portfolio numbers (value, occupancy, returns).
+2. **Assets**: Use ${p}_assets_list to review owned assets \u2014 current value, appreciation, and rental yield.
+3. **Deal Pipeline**: Use ${p}_transactions_list to check active transactions and their milestones/escrow status.
+4. **Investments**: Use ${p}_investments_list to review investment vehicles and their returns.
+5. **Rental Income**: Use ${p}_rentals_list to check tenancies and payment status; flag overdue rents.
+6. **Maintenance**: Use ${p}_amc_list to review AMC contracts and upcoming service dates.
+7. **Verification**: Use ${p}_verification_list to clear the moderation/verification queue, prioritising high-priority items.
+
+Summarize what needs attention after each step.`
+            }
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/modules/housingvista/index.ts
+var housingvistaModule = {
+  id: "housingvista",
+  version: "0.0.1",
+  displayName: "HousingVista",
+  dependsOn: ["auth"],
+  capabilities: { tools: {}, resources: {}, prompts: {} },
+  register(server, ctx) {
+    const tools = [];
+    const resources = [];
+    const prompts = [];
+    const trackTool = (n) => {
+      tools.push(n);
+      return n;
+    };
+    const trackResource = (uri) => {
+      resources.push(uri);
+      return uri;
+    };
+    const trackPrompt = (n) => {
+      prompts.push(n);
+      return n;
+    };
+    registerPropertyTools(server, ctx, trackTool);
+    registerInvestmentTools(server, ctx, trackTool);
+    registerTransactionTools(server, ctx, trackTool);
+    registerLeasingTools(server, ctx, trackTool);
+    registerAssetTools(server, ctx, trackTool);
+    registerMarketplaceTools(server, ctx, trackTool);
+    registerMarketTools(server, ctx, trackTool);
+    registerVerificationTools(server, ctx, trackTool);
+    registerAnalyticsTools(server, ctx, trackTool);
+    registerHousingVistaResources(server, ctx, trackResource);
+    registerHousingVistaPrompts(server, ctx, trackPrompt);
+    return { tools, resources, prompts };
+  }
+};
+var housingvista_default = housingvistaModule;
+
+module.exports = housingvista_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map