@rubytech/create-realagent-code 0.1.116 → 0.1.118

package/payload/platform/plugins/aeo/mcp/dist/index.js

@@ -0,0 +1,171 @@
+import { initStderrTee } from "../../../../lib/mcp-stderr-tee/dist/index.js";
+initStderrTee("aeo");
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { eagerTool } from "../../../../lib/mcp-eager/dist/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { emitJsonLd } from "./tools/aeo-emit-jsonld.js";
+import { writeLlmsTxt } from "./tools/aeo-write-llms-txt.js";
+import { auditPage } from "./tools/aeo-audit-page.js";
+import { closeDriver } from "./lib/neo4j.js";
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const server = new McpServer({
+    name: "maxy-aeo",
+    version: "0.1.0",
+});
+// Plugin-system boot tolerance — see Task 202. Module-init must never
+// throw; plugin-system spawn enumerates tools/list before ACCOUNT_ID
+// is set. Per-call refusal preserves account isolation.
+const accountId = process.env.ACCOUNT_ID ?? null;
+process.stderr.write(`[aeo] boot accountId=${accountId ?? "null"}\n`);
+function refuseNoAccount(toolName) {
+    process.stderr.write(`[aeo] tool=${toolName} refuse reason=no-account-context\n`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${toolName} cannot execute: this MCP instance was launched without ACCOUNT_ID (plugin-system metadata-only mode). Per-account AEO operations require ACCOUNT_ID at spawn.`,
+            },
+        ],
+        isError: true,
+    };
+}
+const agentSlug = process.env.AGENT_SLUG || undefined;
+const sessionId = process.env.SESSION_ID || undefined;
+// ---------------------------------------------------------------------------
+// aeo-emit-jsonld
+// ---------------------------------------------------------------------------
+eagerTool(server, "aeo-emit-jsonld", "Emit a schema.org JSON-LD block for a typed graph entity. Pass entityId for a Neo4j-sourced render, or label + properties for an inline render. Returns the parsed JSON-LD object and a ready-to-inline <script> block string.", {
+    entityId: z
+        .string()
+        .optional()
+        .describe("Neo4j elementId of a typed node (Organization, Person, Service, …)"),
+    label: z
+        .string()
+        .optional()
+        .describe("Source label when rendering inline (no entityId)"),
+    properties: z
+        .record(z.unknown())
+        .optional()
+        .describe("Property bag for inline render"),
+}, async (args) => {
+    if (!accountId)
+        return refuseNoAccount("aeo-emit-jsonld");
+    try {
+        const result = await emitJsonLd({ accountId, ...args });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[aeo-emit-jsonld] error: ${message}\n`);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// aeo-write-llms-txt
+// ---------------------------------------------------------------------------
+eagerTool(server, "aeo-write-llms-txt", "Generate /llms.txt and /llms-full.txt for the account's published KnowledgeDocument pages. Index lists every page with title, url, summary. Full file concatenates each page's body, demoting any in-body H1s to H2 to keep one heading hierarchy.", {
+    siteName: z.string().describe("Display name of the site (top H1 of llms.txt)"),
+    siteDescription: z
+        .string()
+        .optional()
+        .describe("One-line site description (emitted as a blockquote)"),
+}, async (args) => {
+    if (!accountId)
+        return refuseNoAccount("aeo-write-llms-txt");
+    try {
+        const result = await writeLlmsTxt({ accountId, ...args });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        pageCount: result.pageCount,
+                        skippedNoUrl: result.skippedNoUrl,
+                        sizeBytes: result.sizeBytes,
+                        llmsTxt: result.llmsTxt,
+                        llmsFullTxt: result.llmsFullTxt,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[aeo-llms-txt] error: ${message}\n`);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// aeo-audit-page
+// ---------------------------------------------------------------------------
+eagerTool(server, "aeo-audit-page", "Run the eight-heuristic AEO audit against a URL or inline HTML. Returns a 0–100 score, per-heuristic pass/warn/fail, and one rewrite suggestion per fail. Pass persist=true with targetKnowledgeDocumentId to record an :AEOAudit node linked from the document.", {
+    url: z.string().url().optional().describe("Page URL to fetch and audit"),
+    html: z.string().optional().describe("Raw HTML to audit (alternative to url)"),
+    persist: z
+        .boolean()
+        .optional()
+        .describe("If true, write an :AEOAudit node and HAS_AEO_AUDIT edge"),
+    targetKnowledgeDocumentId: z
+        .string()
+        .optional()
+        .describe("Neo4j elementId of the KnowledgeDocument to link the audit to"),
+}, async (args) => {
+    if (!accountId)
+        return refuseNoAccount("aeo-audit-page");
+    try {
+        const result = await auditPage({
+            accountId,
+            agentSlug,
+            sessionId,
+            ...args,
+        });
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[aeo-audit] error: ${message}\n`);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// Boot
+// ---------------------------------------------------------------------------
+async function shutdown() {
+    try {
+        await closeDriver();
+    }
+    catch {
+        // already-closed driver during shutdown is benign
+    }
+}
+process.on("SIGTERM", () => {
+    void shutdown().finally(() => process.exit(0));
+});
+process.on("SIGINT", () => {
+    void shutdown().finally(() => process.exit(0));
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write("[aeo] ready\n");
+//# sourceMappingURL=index.js.map

package/payload/platform/plugins/aeo/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/platform/plugins/aeo/mcp/dist/lib/audit-heuristics.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Page-level AEO (Answer Engine Optimisation) heuristics. Eight checks
+ * run against raw HTML; each returns a status and, when the check fails,
+ * one concrete rewrite suggestion the operator can apply.
+ *
+ * The HTML parser is a deliberate single-pass regex scanner: AEO audits
+ * run on pages the platform itself renders, so we know they are
+ * server-side-generated, well-formed enough for regex inspection, and
+ * not gated on script-injected content. Bringing in a full DOM parser
+ * (jsdom, cheerio) would dwarf the rest of the plugin and pull in
+ * Node-version-coupled native deps. If we later need to audit
+ * third-party arbitrary HTML, swap the parser then.
+ */
+export type HeuristicStatus = "pass" | "warn" | "fail";
+export interface HeuristicResult {
+    name: HeuristicName;
+    status: HeuristicStatus;
+    detail: string;
+    suggestion?: string;
+}
+export type HeuristicName = "h1-present" | "jsonld-present" | "structured-answer" | "faq-section" | "meta-description" | "canonical-url" | "og-tags" | "heading-hierarchy";
+export interface AuditResult {
+    score: number;
+    heuristics: HeuristicResult[];
+}
+export declare function auditHtml(html: string): AuditResult;
+//# sourceMappingURL=audit-heuristics.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/lib/audit-heuristics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-heuristics.d.ts","sourceRoot":"","sources":["../../src/lib/audit-heuristics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,gBAAgB,GAChB,mBAAmB,GACnB,aAAa,GACb,kBAAkB,GAClB,eAAe,GACf,SAAS,GACT,mBAAmB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAoRD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAOnD"}

package/payload/platform/plugins/aeo/mcp/dist/lib/audit-heuristics.js

@@ -0,0 +1,274 @@
+/**
+ * Page-level AEO (Answer Engine Optimisation) heuristics. Eight checks
+ * run against raw HTML; each returns a status and, when the check fails,
+ * one concrete rewrite suggestion the operator can apply.
+ *
+ * The HTML parser is a deliberate single-pass regex scanner: AEO audits
+ * run on pages the platform itself renders, so we know they are
+ * server-side-generated, well-formed enough for regex inspection, and
+ * not gated on script-injected content. Bringing in a full DOM parser
+ * (jsdom, cheerio) would dwarf the rest of the plugin and pull in
+ * Node-version-coupled native deps. If we later need to audit
+ * third-party arbitrary HTML, swap the parser then.
+ */
+const H1_RX = /<h1\b[^>]*>([\s\S]*?)<\/h1>/gi;
+const JSONLD_RX = /<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
+const META_DESC_RX = /<meta\b[^>]*name=["']description["'][^>]*content=["']([^"']*)["']/i;
+const META_DESC_RX_REV = /<meta\b[^>]*content=["']([^"']*)["'][^>]*name=["']description["']/i;
+const CANONICAL_RX = /<link\b[^>]*rel=["']canonical["'][^>]*href=["']([^"']*)["']/i;
+const OG_TITLE_RX = /<meta\b[^>]*property=["']og:title["']/i;
+const OG_DESC_RX = /<meta\b[^>]*property=["']og:description["']/i;
+const HEADING_RX = /<(h[1-6])\b[^>]*>([\s\S]*?)<\/\1>/gi;
+const TAG_STRIP = /<[^>]+>/g;
+function stripTags(html) {
+    return html.replace(TAG_STRIP, "").replace(/\s+/g, " ").trim();
+}
+function readMetaDescription(html) {
+    const m = html.match(META_DESC_RX) ?? html.match(META_DESC_RX_REV);
+    return m ? m[1] : null;
+}
+function checkH1(html) {
+    const matches = [...html.matchAll(H1_RX)];
+    if (matches.length === 0) {
+        return {
+            name: "h1-present",
+            status: "fail",
+            detail: "no <h1> found",
+            suggestion: "Add one <h1> at the top of the page naming the entity or question this page answers.",
+        };
+    }
+    if (matches.length > 1) {
+        return {
+            name: "h1-present",
+            status: "warn",
+            detail: `${matches.length} <h1> elements (expected 1)`,
+        };
+    }
+    return {
+        name: "h1-present",
+        status: "pass",
+        detail: `1 <h1>: "${stripTags(matches[0][1]).slice(0, 80)}"`,
+    };
+}
+function checkJsonLd(html) {
+    const matches = [...html.matchAll(JSONLD_RX)];
+    if (matches.length === 0) {
+        return {
+            name: "jsonld-present",
+            status: "fail",
+            detail: "no JSON-LD <script> block",
+            suggestion: "Emit a schema.org JSON-LD block via aeo-emit-jsonld and inline it in <head>.",
+        };
+    }
+    let valid = 0;
+    for (const m of matches) {
+        try {
+            JSON.parse(m[1]);
+            valid += 1;
+        }
+        catch {
+            // counted below
+        }
+    }
+    if (valid === 0) {
+        return {
+            name: "jsonld-present",
+            status: "fail",
+            detail: `${matches.length} JSON-LD block(s) but none parse`,
+            suggestion: "Fix the JSON-LD payload — JSON.parse failed on every block.",
+        };
+    }
+    if (valid < matches.length) {
+        return {
+            name: "jsonld-present",
+            status: "warn",
+            detail: `${valid}/${matches.length} JSON-LD blocks parse`,
+        };
+    }
+    return {
+        name: "jsonld-present",
+        status: "pass",
+        detail: `${valid} JSON-LD block(s)`,
+    };
+}
+function checkStructuredAnswer(html) {
+    const h1Matches = [...html.matchAll(H1_RX)];
+    if (h1Matches.length === 0) {
+        return {
+            name: "structured-answer",
+            status: "fail",
+            detail: "no <h1> — cannot locate structured answer position",
+            suggestion: "Add an <h1> followed by a single ≤280-character paragraph that answers the page question directly.",
+        };
+    }
+    const h1 = h1Matches[0];
+    const after = html.slice((h1.index ?? 0) + h1[0].length);
+    const pMatch = after.match(/<p\b[^>]*>([\s\S]*?)<\/p>/i);
+    if (!pMatch) {
+        return {
+            name: "structured-answer",
+            status: "fail",
+            detail: "no <p> after <h1>",
+            suggestion: "Add one ≤280-character <p> immediately after the <h1> that states the answer in one sentence.",
+        };
+    }
+    const text = stripTags(pMatch[1]);
+    if (text.length === 0) {
+        return {
+            name: "structured-answer",
+            status: "fail",
+            detail: "first <p> after <h1> is empty",
+            suggestion: "Fill the first <p> after <h1> with a ≤280-character direct answer.",
+        };
+    }
+    if (text.length > 280) {
+        return {
+            name: "structured-answer",
+            status: "warn",
+            detail: `first <p> after <h1> is ${text.length} chars (target ≤280)`,
+        };
+    }
+    return {
+        name: "structured-answer",
+        status: "pass",
+        detail: `first <p> after <h1> is ${text.length} chars`,
+    };
+}
+function checkFaqSection(html) {
+    const lower = html.toLowerCase();
+    const hasFaqJsonLd = /["']@type["']\s*:\s*["']faqpage["']/i.test(html);
+    const hasFaqText = /\bfrequently asked questions\b/i.test(lower) ||
+        /\bfaqs?\b/i.test(lower);
+    if (hasFaqJsonLd) {
+        return {
+            name: "faq-section",
+            status: "pass",
+            detail: "FAQPage JSON-LD present",
+        };
+    }
+    if (hasFaqText) {
+        return {
+            name: "faq-section",
+            status: "warn",
+            detail: "FAQ text but no FAQPage JSON-LD",
+        };
+    }
+    return {
+        name: "faq-section",
+        status: "fail",
+        detail: "no FAQ section",
+        suggestion: "Add a FAQ section with FAQPage JSON-LD listing the 3–5 questions customers most often ask.",
+    };
+}
+function checkMetaDescription(html) {
+    const desc = readMetaDescription(html);
+    if (!desc) {
+        return {
+            name: "meta-description",
+            status: "fail",
+            detail: "no <meta name=\"description\">",
+            suggestion: "Add <meta name=\"description\"> with an 80–160 character summary of the page's answer.",
+        };
+    }
+    const len = desc.trim().length;
+    if (len < 80 || len > 160) {
+        return {
+            name: "meta-description",
+            status: "warn",
+            detail: `description is ${len} chars (target 80–160)`,
+        };
+    }
+    return {
+        name: "meta-description",
+        status: "pass",
+        detail: `description is ${len} chars`,
+    };
+}
+function checkCanonical(html) {
+    const m = html.match(CANONICAL_RX);
+    if (!m) {
+        return {
+            name: "canonical-url",
+            status: "fail",
+            detail: "no <link rel=\"canonical\">",
+            suggestion: "Add <link rel=\"canonical\" href=\"<page-url>\"> in <head>.",
+        };
+    }
+    return {
+        name: "canonical-url",
+        status: "pass",
+        detail: `canonical=${m[1]}`,
+    };
+}
+function checkOgTags(html) {
+    const hasTitle = OG_TITLE_RX.test(html);
+    const hasDesc = OG_DESC_RX.test(html);
+    if (hasTitle && hasDesc) {
+        return {
+            name: "og-tags",
+            status: "pass",
+            detail: "og:title + og:description present",
+        };
+    }
+    const missing = [];
+    if (!hasTitle)
+        missing.push("og:title");
+    if (!hasDesc)
+        missing.push("og:description");
+    return {
+        name: "og-tags",
+        status: "fail",
+        detail: `missing: ${missing.join(", ")}`,
+        suggestion: `Add <meta property="${missing.join('"> and <meta property="')}"> in <head>.`,
+    };
+}
+function checkHeadingHierarchy(html) {
+    const levels = [];
+    for (const m of html.matchAll(HEADING_RX)) {
+        levels.push(parseInt(m[1].slice(1), 10));
+    }
+    if (levels.length === 0) {
+        return {
+            name: "heading-hierarchy",
+            status: "fail",
+            detail: "no headings on the page",
+            suggestion: "Add a semantic heading structure starting with <h1> and stepping down by one level.",
+        };
+    }
+    for (let i = 1; i < levels.length; i += 1) {
+        const prev = levels[i - 1];
+        const cur = levels[i];
+        if (cur > prev + 1) {
+            return {
+                name: "heading-hierarchy",
+                status: "fail",
+                detail: `heading skip: h${prev} → h${cur}`,
+                suggestion: `Replace the h${cur} after the h${prev} with an h${prev + 1} (or insert an intermediate heading).`,
+            };
+        }
+    }
+    return {
+        name: "heading-hierarchy",
+        status: "pass",
+        detail: `${levels.length} headings, no skips`,
+    };
+}
+const ALL_CHECKS = [
+    checkH1,
+    checkJsonLd,
+    checkStructuredAnswer,
+    checkFaqSection,
+    checkMetaDescription,
+    checkCanonical,
+    checkOgTags,
+    checkHeadingHierarchy,
+];
+export function auditHtml(html) {
+    const heuristics = ALL_CHECKS.map((fn) => fn(html));
+    const passes = heuristics.filter((r) => r.status === "pass").length;
+    const warns = heuristics.filter((r) => r.status === "warn").length;
+    const total = heuristics.length;
+    const score = Math.round((100 * (passes + 0.5 * warns)) / total);
+    return { score, heuristics };
+}
+//# sourceMappingURL=audit-heuristics.js.map

package/payload/platform/plugins/aeo/mcp/dist/lib/audit-heuristics.js.map

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

package/payload/platform/plugins/aeo/mcp/dist/lib/neo4j.d.ts

@@ -0,0 +1,5 @@
+import { Driver, Session } from "neo4j-driver";
+export declare function getDriver(): Driver;
+export declare function getSession(): Session;
+export declare function closeDriver(): Promise<void>;
+//# sourceMappingURL=neo4j.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/lib/neo4j.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.d.ts","sourceRoot":"","sources":["../../src/lib/neo4j.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAqBtD,wBAAgB,SAAS,IAAI,MAAM,CAclC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjD"}

package/payload/platform/plugins/aeo/mcp/dist/lib/neo4j.js

@@ -0,0 +1,38 @@
+import neo4j from "neo4j-driver";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+let driver = null;
+function readPassword() {
+    if (process.env.NEO4J_PASSWORD)
+        return process.env.NEO4J_PASSWORD;
+    const passwordFile = resolve(process.env.PLATFORM_ROOT ?? resolve(import.meta.dirname, "../../../.."), "config/.neo4j-password");
+    try {
+        return readFileSync(passwordFile, "utf-8").trim();
+    }
+    catch {
+        throw new Error(`Neo4j password not found. Expected at ${passwordFile} or in NEO4J_PASSWORD env var.`);
+    }
+}
+export function getDriver() {
+    if (!driver) {
+        const uri = process.env.NEO4J_URI;
+        if (!uri) {
+            throw new Error("[aeo] NEO4J_URI unset — refusing to default to bolt://localhost:7687");
+        }
+        const user = process.env.NEO4J_USER ?? "neo4j";
+        const password = readPassword();
+        console.error(`[aeo] resolved neo4j_uri=${uri}`);
+        driver = neo4j.driver(uri, neo4j.auth.basic(user, password));
+    }
+    return driver;
+}
+export function getSession() {
+    return getDriver().session();
+}
+export async function closeDriver() {
+    if (driver) {
+        await driver.close();
+        driver = null;
+    }
+}
+//# sourceMappingURL=neo4j.js.map

package/payload/platform/plugins/aeo/mcp/dist/lib/neo4j.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.js","sourceRoot":"","sources":["../../src/lib/neo4j.ts"],"names":[],"mappings":"AAAA,OAAO,KAA0B,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClE,MAAM,YAAY,GAAG,OAAO,CAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACxE,wBAAwB,CACzB,CAAC;IACF,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yCAAyC,YAAY,gCAAgC,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACjD,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/aeo/mcp/dist/lib/schema-mapping.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Maps Neo4j node labels to schema.org types and builds JSON-LD payloads
+ * suitable for inline `<script type="application/ld+json">` blocks on
+ * rendered pages.
+ *
+ * Coverage matches Task 354 spec §1 — the seven page types that the
+ * platform's typed nodes cover natively. Labels outside this set fall
+ * through to a generic `schema:Thing` projection; callers should treat
+ * a generic result as a doc gap, not a success.
+ *
+ * The mapper is deliberately strict: every emitted JSON-LD object names
+ * `@context` and `@type` and carries `@id` when an `elementId` is
+ * available. Missing required properties for the chosen type produce a
+ * `MissingPropertyError`; callers surface this rather than emitting an
+ * invalid block.
+ */
+export type JsonLdValue = string | number | boolean | null | JsonLdObject | JsonLdValue[];
+export interface JsonLdObject {
+    "@context"?: string;
+    "@type": string;
+    "@id"?: string;
+    [property: string]: JsonLdValue | undefined;
+}
+export type SupportedPageType = "Organization" | "LocalBusiness" | "Person" | "Service" | "Product" | "Article" | "FAQPage" | "RealEstateListing" | "Event";
+/** Inputs accepted by the mapper. */
+export interface EntityInput {
+    /** Source Neo4j label (or one of `SupportedPageType` directly). */
+    label: string;
+    /** Optional Neo4j elementId — emitted as `@id` when present. */
+    elementId?: string;
+    /** Flat property bag from the node. */
+    properties: Record<string, unknown>;
+}
+export declare class MissingPropertyError extends Error {
+    readonly schemaType: SupportedPageType | "Thing";
+    readonly missing: string[];
+    constructor(schemaType: SupportedPageType | "Thing", missing: string[]);
+}
+export declare function resolveSchemaType(label: string): SupportedPageType | "Thing";
+/**
+ * Build a JSON-LD object from a typed entity. Throws
+ * `MissingPropertyError` when the resolved schema.org type's required
+ * properties are not satisfied.
+ */
+export declare function buildJsonLd(input: EntityInput): JsonLdObject;
+/** Render a JSON-LD object as a `<script>` block string. */
+export declare function renderJsonLdScript(obj: JsonLdObject): string;
+//# sourceMappingURL=schema-mapping.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/lib/schema-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-mapping.d.ts","sourceRoot":"","sources":["../../src/lib/schema-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,YAAY,GACZ,WAAW,EAAE,CAAC;AAElB,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,eAAe,GACf,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,mBAAmB,GACnB,OAAO,CAAC;AAEZ,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,UAAU,EAAE,iBAAiB,GAAG,OAAO;aACvC,OAAO,EAAE,MAAM,EAAE;gBADjB,UAAU,EAAE,iBAAiB,GAAG,OAAO,EACvC,OAAO,EAAE,MAAM,EAAE;CAOpC;AA4BD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GACZ,iBAAiB,GAAG,OAAO,CAE7B;AAyLD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CA0B5D;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE5D"}