@rubytech/create-maxy-code 0.1.49 → 0.1.57

package/payload/premium-plugins/real-agent/plugins/brochures/skills/property-socials/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: property-socials
+description: Use when generating Open Graph / social-share images for a property page built by the real-estate brochure pipeline (estate-agents/<agent>/properties/<slug>/output/web/page.html). Produces landscape, square, and portrait JPGs that match the brochure's brand palette and typography, pulling copy from property.json and hero images already curated for that property. Triggers include "og images for <property>", "social collateral for <listing>", "Instagram tiles for that brochure", or any request to create share-card imagery for a published realagent.chat property page.
+---
+
+# Property OG / Social Images
+
+The brochure pipeline already produces a styled property page at
+`estate-agents/<agent>/properties/<slug>/output/web/page.html` with curated hero
+images under `images/`, branding tokens in `:root` of the page CSS, and
+structured metadata in the property's `property.json`. This skill renders
+share-ready images by overlaying brand-consistent typography on those hero
+shots — it does not re-design anything.
+
+## Inputs the skill consumes (never invents)
+
+- **Palette and fonts** — read from `:root` in `output/web/page.html`. Use the
+  exact `--paper / --ink / --gold` tokens and Google Font imports already on
+  that page. Do not pick new colours.
+- **Copy** — `property.json` is canonical for address, price, qualifier,
+  bedrooms/baths/receptions, agent name + phone. The page's
+  `<meta name="description">` is the sub-headline. The brochure folder's
+  display name (e.g. *Sparrows Farm*) is the headline.
+- **Hero images** — `images/<slug>-hero-1-main.webp`, `hero-2-kitchen.webp`,
+  `hero-3-garden.webp` are the curated set. Use them by name; do not pick
+  numbered shots from the raw set unless the curated heroes are missing.
+
+## Output contract
+
+Two deliverables every time: image files and the captions that go with them.
+
+**Image files** are written next to `page.html` so they share the same public
+URL prefix:
+
+| File | Dimensions | Use |
+|------|------------|-----|
+| `og-landscape-<hero>.jpg` | 1200×628  | Twitter / LinkedIn / Facebook / OG |
+| `og-square-<hero>.jpg`    | 1200×1200 | Instagram feed |
+| `og-portrait-<hero>.jpg`  | 1080×1350 | Instagram portrait, mobile |
+
+`<hero>` is `main`, `kitchen`, or `garden`. At minimum produce
+`og-landscape-main.jpg`; offer the full five-variant set (landscape + square +
+three portraits) when the user wants social collateral, not just a meta image.
+
+**Captions** are written into `output/web/social-posts.md`, one section per
+image, ready to paste. Every caption is generated through the `plainly` skill's
+register: no em-dashes, no inflation vocabulary (*discover*, *unlock*,
+*nestled*, *stunning*, *boasts*, *bespoke* where it isn't literally bespoke),
+no antithetical "it's not X, it's Y", no rhetorical openers (*Imagine…*,
+*Picture this…*). Read each draft aloud; if it sounds like an estate-agent
+blurb-bot rather than a person, rewrite it.
+
+Per-platform shape (these are caps, not minimums):
+
+- **Landscape post (Twitter / X)**: under 280 characters. One sentence of
+  scene, one of specs, one of agent + phone. Link as last token.
+- **Landscape post (LinkedIn / Facebook)**: three short paragraphs. Opening
+  line that names the property and locality. A middle paragraph of concrete
+  features taken from `property.json`'s `key_features`. A closing paragraph
+  with price, agent name, phone, listing URL.
+- **Square (Instagram feed)**: property name + locality on line one, two or
+  three lines of concrete features, price, agent + phone, "link in bio", four
+  to six hashtags drawn from locality + property type + agency.
+- **Portrait (Instagram portrait / Reels cover)**: lead with what is visible
+  in *that specific hero* (exterior, kitchen, or garden), not the generic
+  property summary. Three lines maximum. Price + agent line at the bottom.
+
+Copy sources, in order: `property.json` for facts (address, price, beds, baths,
+acreage, key features); the page's `<meta name="description">` for tone of the
+hero sub-line; the brochure folder display name for the headline. Do not invent
+features that are not in those sources.
+
+## How rendering works
+
+A single `og.html` template lives at `output/web/og.html` alongside `page.html`
+so it can use relative `images/` paths. It accepts `?format=landscape|square|
+portrait` and `?hero=main|kitchen|garden`, applies the matching CSS class with
+explicit min/max width and height (no relative units), and sets the background
+hero image from the param. Playwright screenshots the URL at exactly the
+container's pixel size.
+
+Critical layout rules:
+
+- The stage div fixes its own width and height with `width / minWidth / maxWidth`
+  (and the height triple). Without max constraints the viewport bleeds.
+- Hero fills the stage with `background-size: cover; background-position: center`
+  so the same template works across all three aspect ratios.
+- A vertical gradient scrim (transparent → ink 0.85) sits between hero and copy.
+  On bright daytime shots the scrim's bottom stop must reach ≥ 0.85 or the
+  eyebrow/sub copy loses contrast.
+- Copy block sits in the bottom-left: eyebrow (locality, gold), headline
+  (display serif), sub (italic body serif), thin rule, specs row, footer line
+  with `realagent.chat / <agent>` left and `<agent name> · <phone>` right.
+
+## Generation flow
+
+1. Confirm `output/web/og.html` is in sync with the page's `:root` palette and
+   `property.json` copy. If the property page has been re-themed since the last
+   render, update the template before screenshotting.
+2. Start a static server in `output/web/` on any free port:
+   `python3 -m http.server <port> &`. Hold the PID so it can be killed at the
+   end. Relative `images/` paths require a real HTTP origin; `file://` won't
+   render webfonts either.
+3. On a fresh machine, `npx -y playwright install chromium` once. The first
+   `playwright screenshot` invocation otherwise fails with "Executable doesn't
+   exist".
+4. Screenshot each variant. Pass `--wait-for-timeout=2500` so Google Fonts
+   land before capture. Always quote URLs that contain `&`.
+5. Stop the server. Verify each JPG with `Read` so the user sees the rendered
+   collateral inline — file sizes alone aren't proof of a good render.
+
+## Failure modes seen on first use
+
+- **Filename mangling.** A bash loop using `for v in "landscape main" …; set --
+  $v` collapses to filenames like `og-landscape main-.jpg` (space, then dash).
+  Use an explicit per-variant call or an array; never rely on positional
+  splitting for two-word tuples.
+- **6 KB screenshots.** A screenshot under ~20 KB is a blank page. Common
+  causes: server not running, wrong port, Chromium not installed, or `og.html`
+  threw a JS error. Open the URL in a browser to confirm before re-running.
+- **Eyebrow on a light surface.** The garden / pool hero washes the eyebrow
+  out. Either deepen the scrim's bottom stop or move the eyebrow above the
+  hero crop on that variant. Don't ship a low-contrast tile.
+- **Treating this as a Next.js task.** The brochure site is static HTML. The
+  upstream `og-images` skill assumes `app/og/page.tsx`; ignore that scaffold
+  and render against the static page directly.
+- **Captions that sound like AI marketing.** "Discover this stunning home
+  nestled in the heart of Essex" is the failure mode. Strip *discover*,
+  *unlock*, *nestled*, *stunning*, *boasts*, *exquisite*, *charming*, every
+  em-dash, every exclamation mark used to fake enthusiasm. The aloud test from
+  the `plainly` skill applies: read the caption out; if you would not say it
+  in conversation to a buyer, rewrite it.
+
+## Out of scope
+
+- The brochure page itself (owned by `real-estate-brochure:property-brochure`).
+- Property metadata extraction (owned by
+  `real-estate-brochure:property-extract`).
+- Wiring `<meta property="og:image">` into `page.html`. Surface the snippet for
+  the operator; the page is regenerated by a separate skill and edits there
+  belong in that pipeline, not this one.

package/payload/premium-plugins/real-agent/plugins/loop/PLUGIN.md

@@ -174,6 +174,30 @@ Loop covers five value pillars with API surface. Each pillar has both read and w
 - `loop-customer-preferences` (action=write)
 - `loop-supplier` (action=maintenance-complete, board-complete, maintenance-submit-quote)
 
+## Time presentation
+
+**Every datetime field in a Loop response is UTC, returned without a timezone marker.** The Loop V2 API stores and returns instants as bare `YYYY-MM-DDTHH:MM:SS` strings whose true zone is UTC. Presenting them verbatim is silent misrepresentation: a viewing whose `dateOfAppointment` is `12:00:00` is `12:00Z`, which is `13:00 BST` between late March and late October in the UK. Off-by-one-hour viewing times have already misled an operator (Task 126).
+
+**Convert before any datetime appears in agent output.** The operator's zone comes from the `Person.timezone` property on the operator's `Person` node; Real Agent UK accounts default to `Europe/London` when that property is absent. The conversion is non-negotiable — there is no case where a Loop datetime is presented to the operator in its raw UTC form. State the converted local time, and where ambiguous (cross-DST scheduling, calendar invites), name the zone explicitly (`13:00 BST`, `09:30 GMT`).
+
+The tools whose responses carry one or more datetime fields — and therefore require this conversion before any field value reaches the operator — are exhaustive:
+
+- `loop-viewing-search` — `dateOfAppointment`, `dateOfAppointmentEnd`
+- `loop-viewing-detail` — `dateCreated`, `dateOfAppointment`, `dateOfAppointmentEnd`, `dateBuyerFeedbackGiven`, `dateSellerFeedbackGiven`, `dateDone`
+- `loop-feedback-get` — `viewingDateOfAppointment`
+- `loop-people-search` — renters list: `dateRequired`
+- `loop-people-detail` — `dateCreated`; nested `viewings[].dateOfAppointment(+End)`, `offers[].dateReceived`, `applications[].dateReceived`, `applications[].proposedStartDate`, `property.dateCreated` (sellers/landlords), `dateRequired` (renters)
+- `loop-property-search` — `dateCreated`
+- `loop-property-detail` — `dateCreated`, `dateInstructed`, `dateUnderOffer`, `dateLaunched`, `dateExchanged`, `dateCompleted`, `dateWithdrawn`, `dateFirstAvailable`, `leaseExpiryDate`
+- `loop-property-listed` — `dateLaunched`, `dateFirstAvailable`, `leaseExpiryDate`
+- `loop-property-sold` — `dateLaunched`, `leaseExpiryDate`, `images[].dateUpdated`
+- `loop-marketing-match` — `dateCreated`, `dateInstructed`, `dateUnderOffer`, `dateLaunched`, `dateExchanged`, `dateCompleted`, `dateWithdrawn`, `dateFirstAvailable`, `viewings[].dateOfAppointment(+End)`, `applications[].dateReceived`, `applications[].proposedStartDate`, `marketListings[].dateListed`, `images[].dateUpdated`
+- `loop-auto-responder` — `enquiry.dateMoving`
+- `loop-team-availability` — `start`, `end`
+- `loop-supplier` — `dateCreated`, `dateDone`, `dateReported`, `dateQuoteBy`, `dateCompleted`, `dateApproved`
+
+Tools not listed (`loop-key-*`, `loop-team-info`, `loop-customer-preferences`, `loop-marketing-enquiry`, `loop-marketing-match-batch`, `loop-marketing-match-request`, `loop-viewing-create`, `loop-viewing-update`, `loop-feedback-submit`, `loop-property-viewing`, `loop-property-callback`, `loop-property-information`) either have no datetime in response or are write-only acknowledgements. The enumeration is grounded in the vendored swagger snapshot at `mcp/src/__tests__/loop-swagger.snapshot.json`; the pinning test at `mcp/src/__tests__/plugin-md-time-doctrine.test.ts` blocks silent drift.
+
 ### Team-key prerequisite
 
 Every Loop tool routes through one or more team keys. If `loop-key-list` returns nothing for the account, surface the registration prompt before attempting any other Loop call — every downstream tool will fail otherwise. If a call returns `Team "X" does not have <group> permission`, the key was scoped to fewer than 8 endpoint groups; re-register with the full permissions array (`["properties","people","viewings","feedback","team","marketing","customer","supplier"]`).

package/payload/premium-plugins/real-agent/plugins/loop/mcp/src/__tests__/plugin-md-time-doctrine.test.ts

@@ -0,0 +1,132 @@
+/**
+ * Anti-regression: PLUGIN.md must carry the "Time presentation" doctrine
+ * paragraph and enumerate every Loop tool whose response contains a
+ * datetime field. The doctrine is the agent's only signal that Loop
+ * returns bare UTC strings without a zone marker — silent drop of this
+ * section recurs the off-by-one-hour viewing-time failure (Task 126).
+ *
+ * The expected tool list is derived live from the vendored swagger
+ * snapshot, so if Loop adds a new datetime-bearing endpoint and we miss
+ * mapping it in PLUGIN.md, the test fails and names the orphan.
+ */
+
+import { describe, expect, it } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_MD = resolve(__dirname, '../../../PLUGIN.md');
+const SWAGGER_PATH = resolve(__dirname, 'loop-swagger.snapshot.json');
+
+interface SwaggerDoc {
+  paths: Record<string, Record<string, { responses?: Record<string, { content?: Record<string, { schema?: unknown }> }> }>>;
+  components?: { schemas?: Record<string, unknown> };
+}
+
+const swagger = JSON.parse(readFileSync(SWAGGER_PATH, 'utf-8')) as SwaggerDoc;
+const plugin = readFileSync(PLUGIN_MD, 'utf-8');
+
+// Swagger path → tool name. Every response-bearing GET path that surfaces
+// a datetime field must map to exactly one tool here. Add a row when Loop
+// publishes a new datetime endpoint that we expose.
+const PATH_TO_TOOL: Record<string, string> = {
+  '/residential/sales/viewings': 'loop-viewing-search',
+  '/residential/lettings/viewings': 'loop-viewing-search',
+  '/residential/sales/viewings/{id}': 'loop-viewing-detail',
+  '/residential/lettings/viewings/{id}': 'loop-viewing-detail',
+  '/feedback/residential/sales/viewings/{id}': 'loop-feedback-get',
+  '/feedback/residential/lettings/viewings/{id}': 'loop-feedback-get',
+  '/people/renters': 'loop-people-search',
+  '/people/{id}': 'loop-people-detail',
+  '/people/buyers/{id}': 'loop-people-detail',
+  '/people/sellers/{id}': 'loop-people-detail',
+  '/people/landlords/{id}': 'loop-people-detail',
+  '/people/renters/{id}': 'loop-people-detail',
+  '/property/residential/sales/{id}': 'loop-property-detail',
+  '/property/residential/lettings/{id}': 'loop-property-detail',
+  '/property/residential/sales': 'loop-property-search',
+  '/property/residential/lettings': 'loop-property-search',
+  '/property/residential/sales/listed/{channel}': 'loop-property-listed',
+  '/property/residential/lettings/listed/{channel}': 'loop-property-listed',
+  '/property/residential/sales/{id}/preview/{previewHash}': 'loop-property-detail',
+  '/property/residential/lettings/{id}/preview/{previewHash}': 'loop-property-detail',
+  '/property/residential/sold/{channel}': 'loop-property-sold',
+  '/marketing/matching/{id}': 'loop-marketing-match',
+  '/marketing/rentals/matching/{id}': 'loop-marketing-match',
+  '/marketing/enquiries/auto-responder/{id}/{key}': 'loop-auto-responder',
+  '/team/{agentId}/availability/{searchDate}': 'loop-team-availability',
+  '/supplier/board-contractor/{code}/{jobid}/job-list': 'loop-supplier',
+  '/supplier/maintenance/{quoteCode}/{jobid}/job-list': 'loop-supplier',
+  '/supplier/maintenance/{quoteCode}/{jobId}/quote-list': 'loop-supplier',
+};
+
+function resolveRef(ref: string): unknown {
+  const parts = ref.replace('#/', '').split('/');
+  let cur: unknown = swagger;
+  for (const p of parts) cur = cur && typeof cur === 'object' ? (cur as Record<string, unknown>)[p] : null;
+  return cur;
+}
+
+function hasDateField(node: unknown, depth = 0, visited = new WeakSet<object>()): boolean {
+  if (!node || typeof node !== 'object' || depth > 12) return false;
+  if (visited.has(node as object)) return false;
+  visited.add(node as object);
+  const n = node as Record<string, unknown>;
+  if (typeof n.$ref === 'string') return hasDateField(resolveRef(n.$ref), depth + 1, visited);
+  if (n.format === 'date-time' || n.format === 'date') return true;
+  if (n.properties && typeof n.properties === 'object') {
+    for (const v of Object.values(n.properties as Record<string, unknown>)) {
+      if (hasDateField(v, depth + 1, visited)) return true;
+    }
+  }
+  if (n.items && hasDateField(n.items, depth + 1, visited)) return true;
+  if (Array.isArray(n.allOf)) {
+    for (const v of n.allOf) if (hasDateField(v, depth + 1, visited)) return true;
+  }
+  return false;
+}
+
+function toolsRequiringDoctrine(): Set<string> {
+  const tools = new Set<string>();
+  for (const [path, methods] of Object.entries(swagger.paths)) {
+    const op = methods.get;
+    if (!op || !op.responses) continue;
+    const anyDate = Object.values(op.responses).some(r =>
+      Object.values(r.content || {}).some(sw => hasDateField(sw.schema)),
+    );
+    if (!anyDate) continue;
+    const tool = PATH_TO_TOOL[path];
+    if (tool) tools.add(tool);
+    else throw new Error(`Swagger GET ${path} returns a datetime but has no PATH_TO_TOOL mapping — add it and list the tool in PLUGIN.md "Time presentation".`);
+  }
+  return tools;
+}
+
+describe('PLUGIN.md time-presentation doctrine', () => {
+  it('contains the Time presentation section', () => {
+    expect(plugin).toMatch(/^## Time presentation$/m);
+  });
+
+  it('names UTC, Person.timezone, and the Europe/London default', () => {
+    expect(plugin).toMatch(/UTC/);
+    expect(plugin).toMatch(/Person\.timezone/);
+    expect(plugin).toMatch(/Europe\/London/);
+  });
+
+  it('forbids raw UTC presentation', () => {
+    // Must state conversion is required before any datetime appears in output.
+    expect(plugin).toMatch(/Convert before any datetime appears in agent output/);
+  });
+
+  it('enumerates every tool whose Loop response carries a datetime field', () => {
+    const required = toolsRequiringDoctrine();
+    const missing: string[] = [];
+    for (const tool of required) {
+      // Each tool must appear in the doctrine section as a bullet item.
+      const re = new RegExp(`^- \`${tool.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&')}\``, 'm');
+      if (!re.test(plugin)) missing.push(tool);
+    }
+    expect(missing, `PLUGIN.md "Time presentation" must list: ${missing.join(', ')}`).toEqual([]);
+  });
+});

package/payload/premium-plugins/real-agent/plugins/property-data/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "real-agent-property-data",
+  "description": "PropertyData UK market analytics — postcode-keyed valuation, asking prices, sold prices, demand, yields, growth, national HPI. One encrypted API key per account.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  },
+  "mcpServers": {
+    "real-agent-property-data": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/mcp/dist/index.js"
+      ]
+    }
+  }
+}

package/payload/premium-plugins/real-agent/plugins/property-data/PLUGIN.md

@@ -0,0 +1,100 @@
+---
+name: real-agent-property-data
+description: "PropertyData UK market analytics — postcode-keyed valuation, asking prices, sold prices, demand, yields, growth, national HPI. One encrypted API key per account."
+tools:
+  - name: property-data-key-register
+    publicAllowlist: false
+  - name: property-data-key-deregister
+    publicAllowlist: false
+  - name: property-data-key-list
+    publicAllowlist: false
+  - name: property-data-valuation-sale
+    publicAllowlist: false
+  - name: property-data-valuation-rent
+    publicAllowlist: false
+  - name: property-data-prices
+    publicAllowlist: false
+  - name: property-data-prices-rent
+    publicAllowlist: false
+  - name: property-data-sold-prices
+    publicAllowlist: false
+  - name: property-data-demand
+    publicAllowlist: false
+  - name: property-data-yields
+    publicAllowlist: false
+  - name: property-data-growth
+    publicAllowlist: false
+  - name: property-data-national-hpi
+    publicAllowlist: false
+skills:
+  - skills/property-data/SKILL.md
+always: false
+metadata: {"platform":{"optional":true,"embed":["admin"]}}
+mcp:
+  command: node
+  args:
+    - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
+    - ${PREMIUM_PLUGINS_ROOT}/real-agent/plugins/property-data/mcp/dist/index.js
+  env:
+    MCP_SPAWN_TEE_NAME: property-data
+    LOG_DIR: ${LOG_DIR}
+    PLATFORM_ROOT: ${PLATFORM_ROOT}
+    ACCOUNT_ID: ${ACCOUNT_ID}
+    SESSION_ID: ${SESSION_ID}
+---
+
+# Real Agent — PropertyData
+
+Local stdio MCP that proxies the PropertyData UK market-analytics HTTP API (propertydata.co.uk). Postcode-keyed analytics powering valuer + negotiator workflows: comparable evidence, asking-price baselines, sold-price history, demand index, rental yield, growth signals, and the national house-price index.
+
+## Capabilities
+
+- **Key management** — register, deregister, and list a single PropertyData API key per account. AES-256-GCM encrypted at rest in Neo4j under the `PropertyDataKey` label.
+- **Valuation** — point-estimate sale and rent valuations from postcode + property attributes (`valuation-sale`, `valuation-rent`).
+- **Asking-price baselines** — live mean / median / 80th-percentile asking prices for sale and rent in a postcode (`prices`, `prices-rent`).
+- **Sold-price history** — Land Registry sold transactions filtered by postcode, property type, and age (`sold-prices`).
+- **Demand index** — number of properties currently for sale vs. average days to sell-STC for a postcode (`demand`).
+- **Rental yield** — gross yield estimates by postcode and bedroom count (`yields`).
+- **Growth signals** — short and long-term price growth by postcode (`growth`).
+- **National house-price index** — UK-wide HPI series (`national-hpi`).
+
+## Security
+
+The PropertyData API key is encrypted at rest with AES-256-GCM. Encryption key lives at `~/<configDir>/.property-data-encryption-key` with mode `0600`. Never include the key value in responses; identify the key by registration timestamp only. If the operator asks for the key value, explain that keys are encrypted and cannot be retrieved — they must be re-registered from the PropertyData dashboard.
+
+## When to use these tools
+
+### Pillar 1 — Comparable evidence for valuation
+
+**Triggers** — operator says "comps for", "sold prices around", "what's gone for", "comparable evidence":
+- `property-data-sold-prices` — Land Registry sold prices for the postcode
+
+### Pillar 2 — Asking-price baselines and point valuations
+
+**Triggers** — operator says "what's it worth", "asking prices in", "point estimate", "ballpark":
+- `property-data-valuation-sale` — point sale estimate for postcode + attributes
+- `property-data-valuation-rent` — point rent estimate
+- `property-data-prices` — distribution of asking prices for sale
+- `property-data-prices-rent` — distribution of asking prices for rent
+
+### Pillar 3 — Demand + yield + growth (negotiation signals)
+
+**Triggers** — operator says "demand in", "yield on", "growth", "is the market moving":
+- `property-data-demand` — supply count + average days to sell-STC
+- `property-data-yields` — gross rental yield by bedroom count
+- `property-data-growth` — short and long-term price growth
+- `property-data-national-hpi` — national HPI context
+
+### Key prerequisite
+
+Every PropertyData tool requires a registered key. If `property-data-key-list` returns nothing for the account, surface the registration prompt before attempting any other call — every downstream tool will return `status=key-missing` otherwise.
+
+## Tool error envelope
+
+Every tool returns either the PropertyData `data` payload as JSON text or an `isError: true` envelope with deterministic text shape:
+
+- `Error: key-not-registered. Register a PropertyData API key with property-data-key-register before calling this tool.`
+- `Error: http-<status> from PropertyData. <message>`
+- `Error: bad-response from PropertyData (non-JSON, length=<n>).`
+
+Operators see the reason directly; downstream skills branch on the prefix.

package/payload/premium-plugins/real-agent/plugins/property-data/mcp/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/payload/premium-plugins/real-agent/plugins/property-data/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/payload/premium-plugins/real-agent/plugins/property-data/mcp/dist/index.js

@@ -0,0 +1,153 @@
+import { initStderrTee } from "../../../../lib/mcp-stderr-tee/dist/index.js";
+initStderrTee("property-data");
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { keyRegister } from "./tools/key-register.js";
+import { keyDeregister } from "./tools/key-deregister.js";
+import { keyList } from "./tools/key-list.js";
+import { valuationSale, valuationRent, prices, pricesRent, soldPrices, demand, yields, growth, nationalHpi, } from "./tools/endpoints.js";
+import { closeDriver } from "./lib/neo4j.js";
+import { KeyNotRegisteredError, PropertyDataError, BadResponseError, } from "./lib/propertydata-api.js";
+const accountId = process.env.ACCOUNT_ID;
+if (!accountId) {
+    throw new Error("ACCOUNT_ID environment variable is required");
+}
+const server = new McpServer({
+    name: "maxy-property-data",
+    version: "0.1.0",
+});
+console.error(`[property-data] server started, account=${accountId}`);
+function errorEnvelope(err) {
+    let text;
+    if (err instanceof KeyNotRegisteredError) {
+        text =
+            "Error: key-not-registered. Register a PropertyData API key with property-data-key-register before calling this tool.";
+    }
+    else if (err instanceof PropertyDataError) {
+        text = `Error: http-${err.status} from PropertyData. ${err.upstreamMessage}`;
+    }
+    else if (err instanceof BadResponseError) {
+        text = `Error: bad-response from PropertyData (non-JSON, length=${err.length}).`;
+    }
+    else {
+        text = `Error: ${err instanceof Error ? err.message : String(err)}`;
+    }
+    return { content: [{ type: "text", text }], isError: true };
+}
+function endpointHandler(fn) {
+    return async (params) => {
+        try {
+            const text = await fn({ ...params, accountId: accountId });
+            return { content: [{ type: "text", text }] };
+        }
+        catch (err) {
+            return errorEnvelope(err);
+        }
+    };
+}
+// ─────────────────────────────────────────────────────────────────
+// Key Management
+// ─────────────────────────────────────────────────────────────────
+server.tool("property-data-key-register", "Register the account's PropertyData API key. Validates the key against PropertyData's /national-hpi endpoint, encrypts it with AES-256-GCM, and stores it in Neo4j. One key per account; re-registering overwrites the existing key.", {
+    apiKey: z.string().min(8).describe("PropertyData API key from propertydata.co.uk dashboard"),
+}, async ({ apiKey }) => {
+    try {
+        await keyRegister({ apiKey, accountId: accountId });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "PropertyData API key registered successfully.",
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return errorEnvelope(err);
+    }
+});
+server.tool("property-data-key-deregister", "Remove the account's PropertyData API key. The encrypted key is permanently deleted from Neo4j.", {}, async () => {
+    try {
+        await keyDeregister({ accountId: accountId });
+        return {
+            content: [{ type: "text", text: "PropertyData API key deregistered." }],
+        };
+    }
+    catch (err) {
+        return errorEnvelope(err);
+    }
+});
+server.tool("property-data-key-list", "Show whether a PropertyData API key is registered for this account. Never reveals the key value.", {}, async () => {
+    try {
+        const text = await keyList({ accountId: accountId });
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        return errorEnvelope(err);
+    }
+});
+// ─────────────────────────────────────────────────────────────────
+// Valuation endpoints
+// ─────────────────────────────────────────────────────────────────
+const valuationSchema = {
+    postcode: z.string().min(2).describe("UK postcode (outcode or full)"),
+    type: z
+        .enum(["detached", "semi-detached", "terraced", "flat"])
+        .describe("Property type"),
+    bedrooms: z.number().int().min(0).describe("Bedroom count"),
+    bathrooms: z.number().int().min(0).optional().describe("Bathroom count"),
+    internal_area: z.number().optional().describe("Internal area (sq ft)"),
+    construction_date: z.string().optional().describe("Construction date band (e.g. 'pre1900', '1900-1929')"),
+    finish_quality: z
+        .enum(["luxury", "above_average", "average", "below_average", "needs_modernisation"])
+        .optional()
+        .describe("Finish quality"),
+};
+server.tool("property-data-valuation-sale", "Point sale-price estimate for a property given postcode + attributes. Returns point estimate plus comparables.", valuationSchema, endpointHandler(valuationSale));
+server.tool("property-data-valuation-rent", "Point rent estimate (PCM) for a property given postcode + attributes. Returns point estimate plus comparables.", valuationSchema, endpointHandler(valuationRent));
+// ─────────────────────────────────────────────────────────────────
+// Asking-price distributions
+// ─────────────────────────────────────────────────────────────────
+const pricesSchema = {
+    postcode: z.string().min(2).describe("UK postcode (outcode or full)"),
+    type: z
+        .enum(["detached", "semi-detached", "terraced", "flat"])
+        .optional()
+        .describe("Filter by property type"),
+    bedrooms: z.number().int().min(0).optional().describe("Filter by bedroom count"),
+};
+server.tool("property-data-prices", "Asking-price distribution for sale listings in a postcode — mean, median, 80th percentile.", pricesSchema, endpointHandler(prices));
+server.tool("property-data-prices-rent", "Asking-price distribution for rental listings in a postcode — mean, median, 80th percentile (PCM).", pricesSchema, endpointHandler(pricesRent));
+// ─────────────────────────────────────────────────────────────────
+// Sold prices (Land Registry)
+// ─────────────────────────────────────────────────────────────────
+server.tool("property-data-sold-prices", "Land Registry sold transactions for a postcode, optionally filtered by age, type, and bedrooms.", {
+    postcode: z.string().min(2).describe("UK postcode (outcode or full)"),
+    max_age: z.number().int().min(1).optional().describe("Max transaction age in months"),
+    type: z
+        .enum(["detached", "semi-detached", "terraced", "flat"])
+        .optional()
+        .describe("Filter by property type"),
+    bedrooms: z.number().int().min(0).optional().describe("Filter by bedroom count"),
+}, endpointHandler(soldPrices));
+// ─────────────────────────────────────────────────────────────────
+// Demand / yields / growth / national HPI
+// ─────────────────────────────────────────────────────────────────
+server.tool("property-data-demand", "Demand signals for a postcode — count of properties for sale and average days to sell-STC.", { postcode: z.string().min(2).describe("UK postcode (outcode or full)") }, endpointHandler(demand));
+server.tool("property-data-yields", "Gross rental yield for a postcode and bedroom count.", {
+    postcode: z.string().min(2).describe("UK postcode (outcode or full)"),
+    bedrooms: z.number().int().min(0).describe("Bedroom count"),
+}, endpointHandler(yields));
+server.tool("property-data-growth", "Short-term and long-term price growth signals for a postcode.", { postcode: z.string().min(2).describe("UK postcode (outcode or full)") }, endpointHandler(growth));
+server.tool("property-data-national-hpi", "UK national house-price index series. No postcode required.", {}, endpointHandler(nationalHpi));
+// ─────────────────────────────────────────────────────────────────
+// Lifecycle
+// ─────────────────────────────────────────────────────────────────
+process.on("SIGINT", async () => {
+    await closeDriver();
+    process.exit(0);
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/payload/premium-plugins/real-agent/plugins/property-data/mcp/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/payload/premium-plugins/real-agent/plugins/property-data/mcp/dist/lib/crypto.d.ts

@@ -0,0 +1,3 @@
+export declare function encrypt(plaintext: string): string;
+export declare function decrypt(encryptedValue: string): string;
+//# sourceMappingURL=crypto.d.ts.map

package/payload/premium-plugins/real-agent/plugins/property-data/mcp/dist/lib/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/lib/crypto.ts"],"names":[],"mappings":"AAgDA,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,wBAAgB,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAoBtD"}