@rubytech/create-realagent-code 0.1.118 → 0.1.120

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-backfill-from-logs.js

@@ -0,0 +1,156 @@
+// visitor-backfill-from-logs — one-shot importer.
+//
+// Parses [property-recommended] and [property-card-click] log lines from
+// the platform log and writes them into the visitor graph:
+//
+//   [property-recommended] sessionKey=<sk> listingSlug=<slug> ts=<iso>
+//     -> MERGE (Session {sessionKey})
+//        CREATE (Recommendation {sessionKey, listingSlug, recommendedAt})
+//        MERGE (Recommendation)-[:FOR_SESSION]->(Session)
+//
+//   [property-card-click] sessionKey=<sk> listingSlug=<slug> ts=<iso>
+//     -> MATCH/MERGE Session, CREATE Click {label:'card', listingSlug}
+//        MERGE Session-[:HAS_EVENT]->Click
+//
+// Parity check after backfill: graph counts vs log-scan counts for the
+// same window. parityCheck is 'ok' iff both deltas are zero, otherwise
+// 'mismatch' with the delta surfaced for diagnosis.
+//
+// Idempotency: re-running over the same log window does not duplicate
+// Recommendation nodes (MERGE on the exact sessionKey + slug + ts tuple).
+// Click nodes are immutable event records by design; if you re-run on a
+// window already processed you get duplicates. Operator runs once per
+// cutover.
+import { readFileSync } from "node:fs";
+import { getSession } from "../lib/neo4j.js";
+const REC_RE = /\[property-recommended\]\s+sessionKey=(\S+)\s+listingSlug=(\S+)\s+ts=(\S+)/;
+const CLICK_RE = /\[property-card-click\]\s+sessionKey=(\S+)\s+listingSlug=(\S+)\s+ts=(\S+)/;
+const ISO_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/;
+function parseLine(line) {
+    let m = REC_RE.exec(line);
+    if (m)
+        return { kind: "rec", sessionKey: m[1], listingSlug: m[2], ts: m[3] };
+    m = CLICK_RE.exec(line);
+    if (m)
+        return { kind: "click", sessionKey: m[1], listingSlug: m[2], ts: m[3] };
+    return null;
+}
+function inWindow(iso, sinceMs, untilMs) {
+    if (!ISO_RE.test(iso))
+        return false;
+    const t = Date.parse(iso);
+    if (Number.isNaN(t))
+        return false;
+    if (sinceMs !== null && t < sinceMs)
+        return false;
+    if (untilMs !== null && t >= untilMs)
+        return false;
+    return true;
+}
+export async function visitorBackfillFromLogs(p) {
+    const sinceMs = p.sinceIso ? Date.parse(p.sinceIso) : null;
+    const untilMs = p.untilIso ? Date.parse(p.untilIso) : null;
+    const batchSize = Math.max(10, Math.min(p.batchSize ?? 200, 2000));
+    let body;
+    try {
+        body = readFileSync(p.logPath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`[visitor-backfill] log read failed path=${p.logPath} err=${err.message}`);
+    }
+    const rec = [];
+    const click = [];
+    let unparseable = 0;
+    let windowStart = null;
+    let windowEnd = null;
+    for (const raw of body.split("\n")) {
+        if (!raw || (!raw.includes("[property-recommended]") && !raw.includes("[property-card-click]")))
+            continue;
+        const parsed = parseLine(raw);
+        if (!parsed) {
+            unparseable += 1;
+            continue;
+        }
+        if (!inWindow(parsed.ts, sinceMs, untilMs))
+            continue;
+        if (parsed.kind === "rec")
+            rec.push(parsed);
+        else
+            click.push(parsed);
+        if (windowStart === null || parsed.ts < windowStart)
+            windowStart = parsed.ts;
+        if (windowEnd === null || parsed.ts > windowEnd)
+            windowEnd = parsed.ts;
+    }
+    const session = getSession();
+    let recommendedWritten = 0;
+    let recommendedSkippedDuplicate = 0;
+    let clickedWritten = 0;
+    console.error(`[visitor-backfill] start accountId=${p.accountId} window=${windowStart}..${windowEnd} rec=${rec.length} click=${click.length}`);
+    try {
+        for (let i = 0; i < rec.length; i += batchSize) {
+            const slice = rec.slice(i, i + batchSize);
+            const result = await session.run(`UNWIND $rows AS row
+         MERGE (s:Session {accountId: $accountId, sessionId: row.sessionKey})
+           ON CREATE SET s.startedAt = datetime(row.ts), s.lastSeenAt = datetime(row.ts), s.backfilled = true
+           ON MATCH  SET s.lastSeenAt = CASE WHEN s.lastSeenAt > datetime(row.ts) THEN s.lastSeenAt ELSE datetime(row.ts) END
+         MERGE (r:Recommendation {accountId: $accountId, sessionKey: row.sessionKey, listingSlug: row.listingSlug, recommendedAt: datetime(row.ts)})
+           ON CREATE SET r.createdAt = datetime(), r.created = true
+           ON MATCH  SET r.created = false
+         MERGE (r)-[:FOR_SESSION]->(s)
+         RETURN sum(CASE WHEN r.created THEN 1 ELSE 0 END) AS written,
+                sum(CASE WHEN r.created THEN 0 ELSE 1 END) AS skipped`, { accountId: p.accountId, rows: slice });
+            const row = result.records[0];
+            recommendedWritten += Number(row?.get("written") ?? 0);
+            recommendedSkippedDuplicate += Number(row?.get("skipped") ?? 0);
+        }
+        for (let i = 0; i < click.length; i += batchSize) {
+            const slice = click.slice(i, i + batchSize);
+            const result = await session.run(`UNWIND $rows AS row
+         MERGE (s:Session {accountId: $accountId, sessionId: row.sessionKey})
+           ON CREATE SET s.startedAt = datetime(row.ts), s.lastSeenAt = datetime(row.ts), s.backfilled = true
+           ON MATCH  SET s.lastSeenAt = CASE WHEN s.lastSeenAt > datetime(row.ts) THEN s.lastSeenAt ELSE datetime(row.ts) END
+         CREATE (cl:Click {accountId: $accountId, label: 'card', href: '', listingSlug: row.listingSlug, pageViewId: '', occurredAt: datetime(row.ts), backfilled: true})
+         MERGE (s)-[:HAS_EVENT]->(cl)
+         RETURN count(cl) AS written`, { accountId: p.accountId, rows: slice });
+            const row = result.records[0];
+            clickedWritten += Number(row?.get("written") ?? 0);
+        }
+        const parityRes = await session.run(`MATCH (rec:Recommendation {accountId: $accountId})
+       WHERE rec.recommendedAt >= datetime($since) AND rec.recommendedAt < datetime($until)
+       WITH count(DISTINCT rec) AS recCount
+       OPTIONAL MATCH (cl:Click {accountId: $accountId, label: 'card'})
+       WHERE cl.occurredAt >= datetime($since) AND cl.occurredAt < datetime($until)
+         AND cl.backfilled = true
+       RETURN recCount, count(DISTINCT cl) AS clickCount`, {
+            accountId: p.accountId,
+            since: windowStart ?? new Date(0).toISOString(),
+            until: windowEnd ? new Date(Date.parse(windowEnd) + 1).toISOString() : new Date().toISOString(),
+        });
+        const head = parityRes.records[0];
+        const recGraph = Number(head?.get("recCount") ?? 0);
+        const clickGraph = Number(head?.get("clickCount") ?? 0);
+        const parityDelta = {
+            recommended: recGraph - rec.length,
+            clicked: clickGraph - click.length,
+        };
+        const parityCheck = parityDelta.recommended === 0 && parityDelta.clicked === 0 ? "ok" : "mismatch";
+        console.error(`[visitor-backfill] done parityCheck=${parityCheck} recParsed=${rec.length} recWritten=${recommendedWritten} clickParsed=${click.length} clickWritten=${clickedWritten} unparseable=${unparseable}`);
+        return {
+            windowStart,
+            windowEnd,
+            recommendedParsed: rec.length,
+            recommendedWritten,
+            recommendedSkippedDuplicate,
+            clickedParsed: click.length,
+            clickedWritten,
+            unparseable,
+            parityCheck,
+            parityDelta,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=visitor-backfill-from-logs.js.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-backfill-from-logs.js.map

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

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-engagement-score.d.ts

@@ -0,0 +1,21 @@
+export interface EngagementParams {
+    accountId: string;
+    sinceDays?: number;
+    limit?: number;
+}
+export interface EngagementRow {
+    personId: string;
+    personName: string | null;
+    email: string | null;
+    telephone: string | null;
+    visitCount: number;
+    lastSeenAt: string;
+    daysSinceLast: number;
+    avgScrollDepth: number;
+    totalDwellMs: number;
+    score: number;
+}
+export declare function visitorEngagementScore(p: EngagementParams): Promise<{
+    persons: EngagementRow[];
+}>;
+//# sourceMappingURL=visitor-engagement-score.d.ts.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-engagement-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-engagement-score.d.ts","sourceRoot":"","sources":["../../src/tools/visitor-engagement-score.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,sBAAsB,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAsDvG"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-engagement-score.js

@@ -0,0 +1,65 @@
+// visitor-engagement-score — engagement-ranked Person list.
+//
+// score = visit_count * recency_weight * depth_weight * dwell_weight
+//   visit_count    = number of :Session in the window
+//   recency_weight = exp(-daysSinceLast / 14)  (half-life 14d)
+//   depth_weight   = avg(maxScrollDepth / 100)
+//   dwell_weight   = log1p(totalDwellMs / 60000)  (per minute)
+//
+// Score is unitless; the nurture-list skill consumes it for ranking, not
+// absolute meaning. Returns top N most engaged Persons within sinceDays.
+import { getSession } from "../lib/neo4j.js";
+export async function visitorEngagementScore(p) {
+    const since = p.sinceDays ?? 30;
+    const limit = Math.max(1, Math.min(p.limit ?? 50, 200));
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (per:Person {accountId: $accountId})-[:VISITED]->(s:Session)
+       WHERE s.startedAt >= datetime() - duration({days: $since})
+       OPTIONAL MATCH (s)-[:HAS_EVENT]->(sm:ScrollMilestone)
+       OPTIONAL MATCH (s)-[:HAS_EVENT]->(pv:PageView)
+       WITH per, s,
+            coalesce(avg(sm.maxDepth), 0) AS avgDepth,
+            coalesce(sum(pv.dwellMs), 0) AS dwellMs
+       WITH per, count(s) AS visits, max(s.lastSeenAt) AS lastSeenAt,
+            avg(avgDepth) AS avgDepth, sum(dwellMs) AS totalDwellMs
+       WITH per, visits, lastSeenAt, avgDepth, totalDwellMs,
+            duration.between(lastSeenAt, datetime()).days AS daysSinceLast
+       WITH per, visits, lastSeenAt, avgDepth, totalDwellMs, daysSinceLast,
+            visits
+              * exp(-daysSinceLast / 14.0)
+              * (avgDepth / 100.0 + 0.1)
+              * log(1.0 + totalDwellMs / 60000.0)
+              AS score
+       RETURN elementId(per) AS personId,
+              per.name AS personName,
+              per.email AS email,
+              per.telephone AS telephone,
+              visits AS visitCount,
+              toString(lastSeenAt) AS lastSeenAt,
+              daysSinceLast,
+              avgDepth AS avgScrollDepth,
+              totalDwellMs,
+              score
+       ORDER BY score DESC
+       LIMIT $limit`, { accountId: p.accountId, since, limit });
+        return {
+            persons: result.records.map((r) => ({
+                personId: r.get("personId"),
+                personName: r.get("personName"),
+                email: r.get("email"),
+                telephone: r.get("telephone"),
+                visitCount: Number(r.get("visitCount") ?? 0),
+                lastSeenAt: r.get("lastSeenAt"),
+                daysSinceLast: Number(r.get("daysSinceLast") ?? 0),
+                avgScrollDepth: Number(r.get("avgScrollDepth") ?? 0),
+                totalDwellMs: Number(r.get("totalDwellMs") ?? 0),
+                score: Number(r.get("score") ?? 0),
+            })),
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=visitor-engagement-score.js.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-engagement-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-engagement-score.js","sourceRoot":"","sources":["../../src/tools/visitor-engagement-score.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,qEAAqE;AACrE,sDAAsD;AACtD,+DAA+D;AAC/D,+CAA+C;AAC/C,+DAA+D;AAC/D,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAqB7C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,CAAmB;IAC9D,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA4Bc,EACd,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CACzC,CAAC;QACF,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;gBAC3B,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC/B,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;gBACrB,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;gBAC7B,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAC5C,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC/B,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBAClD,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACpD,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBAChD,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aACnC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-event-ingest.d.ts

@@ -0,0 +1,26 @@
+export interface IngestParams {
+    accountId: string;
+    type: "pageview" | "click" | "scroll" | "dwell";
+    sessionId: string;
+    visitorId: string;
+    /** optional Person elementId — overrides identity resolution */
+    personId?: string | null;
+    url: string;
+    path?: string;
+    title?: string;
+    pageViewId?: string;
+    site?: string;
+    referrer?: string;
+    label?: string;
+    href?: string;
+    depth?: number;
+    dwellMs?: number;
+    occurredAt?: string;
+}
+export interface IngestResult {
+    ok: boolean;
+    type: string;
+    sessionId: string;
+}
+export declare function visitorEventIngest(p: IngestParams): Promise<IngestResult>;
+//# sourceMappingURL=visitor-event-ingest.d.ts.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-event-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-event-ingest.d.ts","sourceRoot":"","sources":["../../src/tools/visitor-event-ingest.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAqF/E"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-event-ingest.js

@@ -0,0 +1,78 @@
+// visitor-event-ingest — admin-side companion to POST /v/event for test
+// harness work and manual replay. Takes a single event payload identical
+// in shape to what the pixel sends, writes it into the graph against the
+// caller's accountId. Not exposed on the public agent surface.
+import { getSession } from "../lib/neo4j.js";
+export async function visitorEventIngest(p) {
+    const session = getSession();
+    const occurredAt = p.occurredAt ?? new Date().toISOString();
+    try {
+        if (p.type === "pageview") {
+            await session.run(`MERGE (s:Session {accountId: $accountId, sessionId: $sid})
+           ON CREATE SET s.startedAt = datetime($occurredAt), s.lastSeenAt = datetime($occurredAt)
+           ON MATCH  SET s.lastSeenAt = datetime($occurredAt)
+         MERGE (pg:Page {accountId: $accountId, url: $url})
+           ON CREATE SET pg.firstSeenAt = datetime($occurredAt), pg.title = $title
+         CREATE (pv:PageView {
+           accountId: $accountId, pageViewId: $pvId, occurredAt: datetime($occurredAt),
+           referrer: $referrer, path: $path
+         })
+         MERGE (s)-[:HAS_EVENT]->(pv)
+         MERGE (pv)-[:OF_PAGE]->(pg)`, {
+                accountId: p.accountId,
+                sid: p.sessionId,
+                url: p.url,
+                title: p.title ?? "",
+                pvId: p.pageViewId ?? `${p.sessionId}_${Date.parse(occurredAt)}`,
+                path: p.path ?? "",
+                referrer: p.referrer ?? "",
+                occurredAt,
+            });
+        }
+        else if (p.type === "click") {
+            await session.run(`MERGE (s:Session {accountId: $accountId, sessionId: $sid})
+           ON CREATE SET s.startedAt = datetime($occurredAt), s.lastSeenAt = datetime($occurredAt)
+           ON MATCH  SET s.lastSeenAt = datetime($occurredAt)
+         CREATE (cl:Click {accountId: $accountId, label: $label, href: $href, pageViewId: $pvId, occurredAt: datetime($occurredAt)})
+         MERGE (s)-[:HAS_EVENT]->(cl)`, {
+                accountId: p.accountId,
+                sid: p.sessionId,
+                label: (p.label ?? "unknown").slice(0, 64),
+                href: (p.href ?? "").slice(0, 2048),
+                pvId: p.pageViewId ?? "",
+                occurredAt,
+            });
+        }
+        else if (p.type === "scroll") {
+            await session.run(`MERGE (s:Session {accountId: $accountId, sessionId: $sid})
+         MERGE (sm:ScrollMilestone {accountId: $accountId, sessionId: $sid, pageViewId: $pvId})
+           ON CREATE SET sm.maxDepth = $depth, sm.firstAt = datetime($occurredAt), sm.lastAt = datetime($occurredAt)
+           ON MATCH  SET sm.maxDepth = CASE WHEN sm.maxDepth >= $depth THEN sm.maxDepth ELSE $depth END,
+                         sm.lastAt = datetime($occurredAt)
+         MERGE (s)-[:HAS_EVENT]->(sm)`, { accountId: p.accountId, sid: p.sessionId, pvId: p.pageViewId ?? "", depth: p.depth ?? 0, occurredAt });
+        }
+        else if (p.type === "dwell") {
+            await session.run(`MATCH (pv:PageView {accountId: $accountId, pageViewId: $pvId})
+         SET pv.dwellMs = coalesce(pv.dwellMs, 0) + $ms,
+             pv.dwellLastAt = datetime($occurredAt)`, { accountId: p.accountId, pvId: p.pageViewId ?? "", ms: p.dwellMs ?? 0, occurredAt });
+        }
+        if (p.personId) {
+            await session.run(`MATCH (per:Person {accountId: $accountId}) WHERE elementId(per) = $personId
+         MATCH (s:Session {accountId: $accountId, sessionId: $sid})
+         MERGE (per)-[:VISITED {accountId: $accountId}]->(s)`, { accountId: p.accountId, personId: p.personId, sid: p.sessionId });
+        }
+        else {
+            await session.run(`MERGE (av:AnonVisitor {accountId: $accountId, visitorId: $vid})
+           ON CREATE SET av.firstSeenAt = datetime($occurredAt), av.lastSeenAt = datetime($occurredAt)
+           ON MATCH  SET av.lastSeenAt = datetime($occurredAt)
+         WITH av
+         MATCH (s:Session {accountId: $accountId, sessionId: $sid})
+         MERGE (av)-[:VISITED {accountId: $accountId}]->(s)`, { accountId: p.accountId, vid: p.visitorId, sid: p.sessionId, occurredAt });
+        }
+        return { ok: true, type: p.type, sessionId: p.sessionId };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=visitor-event-ingest.js.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-event-ingest.js.map

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

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-page.d.ts

@@ -0,0 +1,19 @@
+export interface RecentByPageParams {
+    accountId: string;
+    /** Either listingSlug or url; one is required. */
+    listingSlug?: string;
+    url?: string;
+    sinceDays?: number;
+    limit?: number;
+}
+export interface VisitorSummary {
+    personId: string | null;
+    personName: string | null;
+    anonVisitorId: string | null;
+    pageviewCount: number;
+    lastSeenAt: string;
+}
+export declare function visitorRecentByPage(p: RecentByPageParams): Promise<{
+    visitors: VisitorSummary[];
+}>;
+//# sourceMappingURL=visitor-recent-by-page.d.ts.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-recent-by-page.d.ts","sourceRoot":"","sources":["../../src/tools/visitor-recent-by-page.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAsCxG"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-page.js

@@ -0,0 +1,41 @@
+// visitor-recent-by-page — who viewed a given page/listing recently.
+// Operator-side query: "who has shown interest in 12 Oak Street this week?"
+import { getSession } from "../lib/neo4j.js";
+export async function visitorRecentByPage(p) {
+    if (!p.listingSlug && !p.url) {
+        throw new Error("visitor-recent-by-page requires listingSlug or url");
+    }
+    const since = p.sinceDays ?? 7;
+    const limit = Math.max(1, Math.min(p.limit ?? 50, 200));
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (pv:PageView {accountId: $accountId})
+       WHERE pv.occurredAt >= datetime() - duration({days: $since})
+         AND ($url IS NULL OR EXISTS { MATCH (pv)-[:OF_PAGE]->(:Page {accountId: $accountId, url: $url}) })
+         AND ($slug IS NULL OR EXISTS { MATCH (pv)-[:OF_LISTING]->(:Listing {accountId: $accountId, slug: $slug, scope:'public'}) })
+       MATCH (s:Session)-[:HAS_EVENT]->(pv)
+       OPTIONAL MATCH (per:Person)-[:VISITED]->(s)
+       OPTIONAL MATCH (av:AnonVisitor)-[:VISITED]->(s)
+       WITH per, av, s, count(pv) AS pageviews
+       RETURN coalesce(elementId(per), null) AS personId,
+              coalesce(per.name, null) AS personName,
+              coalesce(av.visitorId, null) AS anonVisitorId,
+              sum(pageviews) AS totalPageviews,
+              toString(max(s.lastSeenAt)) AS lastSeenAt
+       ORDER BY lastSeenAt DESC
+       LIMIT $limit`, { accountId: p.accountId, url: p.url ?? null, slug: p.listingSlug ?? null, since, limit });
+        return {
+            visitors: result.records.map((r) => ({
+                personId: r.get("personId"),
+                personName: r.get("personName"),
+                anonVisitorId: r.get("anonVisitorId"),
+                pageviewCount: Number(r.get("totalPageviews") ?? 0),
+                lastSeenAt: r.get("lastSeenAt"),
+            })),
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=visitor-recent-by-page.js.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-recent-by-page.js","sourceRoot":"","sources":["../../src/tools/visitor-recent-by-page.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,4EAA4E;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAmB7C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,CAAqB;IAC7D,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;;;;;;;;;;;;oBAcc,EACd,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAC1F,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;gBAC3B,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC/B,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC;gBACrC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACnD,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;aAChC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-person.d.ts

@@ -0,0 +1,20 @@
+export interface RecentByPersonParams {
+    accountId: string;
+    personId: string;
+    sinceDays?: number;
+    limit?: number;
+}
+export interface SessionSummary {
+    sessionId: string;
+    startedAt: string;
+    lastSeenAt: string;
+    pageviewCount: number;
+    clickCount: number;
+    maxScrollDepth: number;
+    listingSlugs: string[];
+    dwellMs: number;
+}
+export declare function visitorRecentByPerson(p: RecentByPersonParams): Promise<{
+    sessions: SessionSummary[];
+}>;
+//# sourceMappingURL=visitor-recent-by-person.d.ts.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-person.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-recent-by-person.d.ts","sourceRoot":"","sources":["../../src/tools/visitor-recent-by-person.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAwC5G"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-person.js

@@ -0,0 +1,44 @@
+// visitor-recent-by-person — list recent :Session activity for a :Person.
+// Walks (Person)-[:VISITED]->(Session)-[:HAS_EVENT]->(*) and returns a
+// chronological summary the morning-round skill folds into its briefing.
+import { getSession } from "../lib/neo4j.js";
+export async function visitorRecentByPerson(p) {
+    const since = p.sinceDays ?? 30;
+    const limit = Math.max(1, Math.min(p.limit ?? 50, 200));
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (per:Person {accountId: $accountId}) WHERE elementId(per) = $personId
+       MATCH (per)-[:VISITED]->(s:Session)
+       WHERE s.startedAt >= datetime() - duration({days: $since})
+       OPTIONAL MATCH (s)-[:HAS_EVENT]->(pv:PageView)
+       OPTIONAL MATCH (s)-[:HAS_EVENT]->(cl:Click)
+       OPTIONAL MATCH (s)-[:HAS_EVENT]->(sm:ScrollMilestone)
+       OPTIONAL MATCH (pv)-[:OF_LISTING]->(l:Listing)
+       WITH s, count(DISTINCT pv) AS pageviews, count(DISTINCT cl) AS clicks,
+            coalesce(max(sm.maxDepth), 0) AS maxDepth,
+            collect(DISTINCT l.slug) AS slugs,
+            coalesce(sum(pv.dwellMs), 0) AS dwellMs
+       RETURN s.sessionId AS sessionId,
+              toString(s.startedAt) AS startedAt,
+              toString(s.lastSeenAt) AS lastSeenAt,
+              pageviews, clicks, maxDepth, slugs, dwellMs
+       ORDER BY s.lastSeenAt DESC
+       LIMIT $limit`, { accountId: p.accountId, personId: p.personId, since, limit });
+        return {
+            sessions: result.records.map((r) => ({
+                sessionId: r.get("sessionId"),
+                startedAt: r.get("startedAt"),
+                lastSeenAt: r.get("lastSeenAt"),
+                pageviewCount: Number(r.get("pageviews") ?? 0),
+                clickCount: Number(r.get("clicks") ?? 0),
+                maxScrollDepth: Number(r.get("maxDepth") ?? 0),
+                listingSlugs: (r.get("slugs") ?? []).filter((s) => typeof s === "string"),
+                dwellMs: Number(r.get("dwellMs") ?? 0),
+            })),
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=visitor-recent-by-person.js.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recent-by-person.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-recent-by-person.js","sourceRoot":"","sources":["../../src/tools/visitor-recent-by-person.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAoB7C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,CAAuB;IACjE,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;;;;;;;;;;;;;;oBAgBc,EACd,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAC/D,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;gBAC7B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;gBAC7B,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC/B,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC9C,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACxC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC9C,YAAY,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;gBAC/F,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aACvC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recommendation-ctr.d.ts

@@ -0,0 +1,22 @@
+export interface RecommendationCtrParams {
+    accountId: string;
+    /** Days back from now. Defaults to 7. */
+    sinceDays?: number;
+    /** Optional listingSlug filter. */
+    listingSlug?: string;
+}
+export interface CtrRow {
+    listingSlug: string;
+    recommended: number;
+    clicked: number;
+    ctr: number;
+}
+export interface CtrSummary {
+    windowDays: number;
+    totalRecommended: number;
+    totalClicked: number;
+    ctr: number;
+    perListing: CtrRow[];
+}
+export declare function visitorRecommendationCtr(p: RecommendationCtrParams): Promise<CtrSummary>;
+//# sourceMappingURL=visitor-recommendation-ctr.d.ts.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recommendation-ctr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-recommendation-ctr.d.ts","sourceRoot":"","sources":["../../src/tools/visitor-recommendation-ctr.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmC9F"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recommendation-ctr.js

@@ -0,0 +1,41 @@
+// visitor-recommendation-ctr — graph-backed CTR replacement for the
+// log-scan aggregation that ships with Task 336. Operates on Recommendation
+// nodes (materialised from [property-recommended] log lines via backfill)
+// joined to :Click events. Output schema matches the log-scan tool's so
+// the cutover (separate follow-up task) is a one-line swap.
+import { getSession } from "../lib/neo4j.js";
+export async function visitorRecommendationCtr(p) {
+    const since = p.sinceDays ?? 7;
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (rec:Recommendation {accountId: $accountId})
+       WHERE rec.recommendedAt >= datetime() - duration({days: $since})
+         AND ($slug IS NULL OR rec.listingSlug = $slug)
+       OPTIONAL MATCH (rec)-[:FOR_SESSION]->(s:Session)-[:HAS_EVENT]->(cl:Click {label: 'card'})
+       WITH rec.listingSlug AS slug,
+            count(DISTINCT rec) AS recommended,
+            count(DISTINCT cl) AS clicked
+       RETURN slug AS listingSlug, recommended, clicked,
+              CASE WHEN recommended > 0 THEN toFloat(clicked) / recommended ELSE 0.0 END AS ctr
+       ORDER BY recommended DESC`, { accountId: p.accountId, since, slug: p.listingSlug ?? null });
+        const perListing = result.records.map((r) => ({
+            listingSlug: r.get("listingSlug") ?? "",
+            recommended: Number(r.get("recommended") ?? 0),
+            clicked: Number(r.get("clicked") ?? 0),
+            ctr: Number(r.get("ctr") ?? 0),
+        }));
+        const totalRecommended = perListing.reduce((a, b) => a + b.recommended, 0);
+        const totalClicked = perListing.reduce((a, b) => a + b.clicked, 0);
+        return {
+            windowDays: since,
+            totalRecommended,
+            totalClicked,
+            ctr: totalRecommended > 0 ? totalClicked / totalRecommended : 0,
+            perListing,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=visitor-recommendation-ctr.js.map

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-recommendation-ctr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-recommendation-ctr.js","sourceRoot":"","sources":["../../src/tools/visitor-recommendation-ctr.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,4DAA4D;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAyB7C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,CAA0B;IACvE,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;;;;;;;iCAS2B,EAC3B,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI,EAAE,CAC/D,CAAC;QACF,MAAM,UAAU,GAAa,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE;YACvC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC/B,CAAC,CAAC,CAAC;QACJ,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC3E,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACnE,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,gBAAgB;YAChB,YAAY;YACZ,GAAG,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;YAC/D,UAAU;SACX,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/premium-plugins/real-agent/plugins/buyers/mcp/dist/tools/visitor-session-detail.d.ts

@@ -0,0 +1,32 @@
+export interface SessionDetailParams {
+    accountId: string;
+    sessionId: string;
+}
+export interface SessionEvent {
+    kind: "pageview" | "click" | "scroll";
+    occurredAt: string;
+    /** PageView only */
+    url?: string;
+    path?: string;
+    pageViewId?: string;
+    referrer?: string;
+    dwellMs?: number;
+    /** Click only */
+    label?: string;
+    href?: string;
+    /** Scroll only */
+    maxDepth?: number;
+    /** Optional listing link */
+    listingSlug?: string;
+}
+export interface SessionDetail {
+    sessionId: string;
+    startedAt: string | null;
+    lastSeenAt: string | null;
+    personId: string | null;
+    personName: string | null;
+    anonVisitorId: string | null;
+    events: SessionEvent[];
+}
+export declare function visitorSessionDetail(p: SessionDetailParams): Promise<SessionDetail>;
+//# sourceMappingURL=visitor-session-detail.d.ts.map