propstack-mcp-server 1.0.0

package/dist/tools/deals.js

@@ -0,0 +1,230 @@
+import { z } from "zod";
+import { textResult, errorResult, fmt, fmtPrice, stripUndefined } from "./helpers.js";
+// ── Response formatting ──────────────────────────────────────────────
+const FEELING_LABELS = ["none", "cold", "warm", "hot"];
+function formatDeal(d) {
+    const clientName = d.client
+        ? (fmt(d.client.name) !== "none" ? fmt(d.client.name) : [fmt(d.client.first_name, ""), fmt(d.client.last_name, "")].filter(Boolean).join(" ") || "Unnamed")
+        : `Contact #${d.client_id ?? "?"}`;
+    const propertyTitle = d.property
+        ? fmt(d.property.title, "Untitled")
+        : `Property #${d.property_id ?? "?"}`;
+    const lines = [
+        `**Deal #${d.id}**: ${clientName} → ${propertyTitle}`,
+        `Stage: ${fmt(d.deal_stage_id)} | Pipeline: ${fmt(d.deal_pipeline_id)}`,
+        `Category: ${fmt(d.category)}`,
+        d.sold_price ? `Price: ${fmtPrice(d.sold_price)}` : null,
+        d.feeling !== null && d.feeling !== undefined
+            ? `Feeling: ${FEELING_LABELS[d.feeling] ?? d.feeling}`
+            : null,
+        `Broker: ${fmt(d.broker_id, "unassigned")}`,
+        d.note ? `Note: ${d.note}` : null,
+        d.date ? `Date: ${d.date}` : null,
+        d.reservation_reason_id ? `Cancellation reason ID: ${d.reservation_reason_id}` : null,
+        `Created: ${fmt(d.created_at)}`,
+    ];
+    // Show expanded contact details
+    if (d.client) {
+        lines.push(`Contact: ${clientName} (ID: ${d.client.id}, Email: ${fmt(d.client.email)}, Phone: ${fmt(d.client.phone ?? d.client.home_cell)})`);
+    }
+    // Show expanded property details
+    if (d.property) {
+        const addr = [fmt(d.property.street, ""), fmt(d.property.house_number, "")].filter(Boolean).join(" ");
+        const city = [fmt(d.property.zip_code, ""), fmt(d.property.city, "")].filter(Boolean).join(" ");
+        const fullAddr = [addr, city].filter(Boolean).join(", ");
+        lines.push(`Property: ${propertyTitle} (ID: ${d.property.id}, ${fullAddr || "no address"}, ${fmtPrice(d.property.price)})`);
+    }
+    return lines.filter(Boolean).join("\n");
+}
+function formatDealRow(d) {
+    const clientName = d.client
+        ? (fmt(d.client.name) !== "none" ? fmt(d.client.name) : [fmt(d.client.first_name, ""), fmt(d.client.last_name, "")].filter(Boolean).join(" ") || "Unnamed")
+        : String(d.client_id ?? "?");
+    const propertyTitle = d.property
+        ? fmt(d.property.title, "—")
+        : String(d.property_id ?? "?");
+    return `| ${d.id} | ${clientName} | ${propertyTitle} | ${fmt(d.deal_stage_id)} | ${fmt(d.category)} | ${fmt(d.feeling !== null && d.feeling !== undefined ? (FEELING_LABELS[d.feeling] ?? d.feeling) : null)} | ${fmt(d.created_at)} |`;
+}
+// ── Tool registration ────────────────────────────────────────────────
+export function registerDealTools(server, client) {
+    // ── search_deals ────────────────────────────────────────────────
+    server.tool("search_deals", `Search and filter deals (contact↔property relationships) in Propstack.
+
+Use this tool to:
+- Show all deals in a specific pipeline stage
+- Find deals for a contact or property
+- Track deal pipeline progress for a project
+- Find lost deals and cancellation reasons
+- Filter by broker, team, feeling (cold/warm/hot)
+
+A "deal" represents an interested contact linked to a property at a
+specific stage in a sales/rental pipeline (e.g. Anfrage → Besichtigung
+→ Reserviert → Notartermin → Verkauft).
+
+Use include="client,property" to get expanded contact and property
+details in one request.
+
+Common queries:
+- All active deals: category="qualified"
+- Lost deals this month: category="lost" + created_at_from
+- Deals for a property: property_id=123
+- Pipeline view: deal_pipeline_id + sort_by=deal_stage_id`, {
+        client_id: z.number().optional()
+            .describe("Filter by contact ID"),
+        property_id: z.number().optional()
+            .describe("Filter by property ID"),
+        project_id: z.number().optional()
+            .describe("Filter by project ID"),
+        broker_id: z.number().optional()
+            .describe("Filter by assigned broker ID"),
+        deal_stage_ids: z.array(z.number()).optional()
+            .describe("Filter by deal stage IDs (pipeline steps)"),
+        deal_pipeline_id: z.number().optional()
+            .describe("Filter by deal pipeline ID"),
+        category: z.enum(["qualified", "unqualified", "lost"]).optional()
+            .describe("Deal category: qualified (active), unqualified (not yet), lost (cancelled/rejected)"),
+        reservation_reason_ids: z.array(z.number()).optional()
+            .describe("Filter by cancellation/reservation reason IDs"),
+        client_source_id: z.number().optional()
+            .describe("Filter by lead source ID"),
+        team_id: z.number().optional()
+            .describe("Filter by team ID"),
+        property_broker_ids: z.array(z.number()).optional()
+            .describe("Filter by property's assigned broker IDs"),
+        client_broker_ids: z.array(z.number()).optional()
+            .describe("Filter by contact's assigned broker IDs"),
+        feeling_from: z.number().optional()
+            .describe("Minimum feeling score (0=none, 1=cold, 2=warm, 3=hot)"),
+        feeling_to: z.number().optional()
+            .describe("Maximum feeling score"),
+        created_at_from: z.string().optional()
+            .describe("Filter deals created after this date (ISO 8601)"),
+        created_at_to: z.string().optional()
+            .describe("Filter deals created before this date (ISO 8601)"),
+        start_date_from: z.string().optional()
+            .describe("Filter by deal start date from (ISO 8601)"),
+        start_date_to: z.string().optional()
+            .describe("Filter by deal start date to (ISO 8601)"),
+        show_archived_clients: z.boolean().optional()
+            .describe("Include deals with archived contacts"),
+        hide_archived_properties: z.boolean().optional()
+            .describe("Exclude deals with archived properties"),
+        include: z.string().optional()
+            .describe("Comma-separated related data to expand: 'client', 'property', or 'client,property'"),
+        sort_by: z.string().optional()
+            .describe("Field to sort results by"),
+        order: z.enum(["asc", "desc"]).optional()
+            .describe("Sort order (default: desc)"),
+        page: z.number().optional()
+            .describe("Page number (default: 1)"),
+        per_page: z.number().optional()
+            .describe("Results per page (default: 25)"),
+    }, async (args) => {
+        try {
+            const res = await client.get("/client_properties", { params: args });
+            if (!res.data || res.data.length === 0) {
+                return textResult("No deals found matching your criteria.");
+            }
+            const header = res.meta?.total_count !== undefined
+                ? `Found ${res.meta.total_count} deals (showing ${res.data.length}):\n\n`
+                : `Found ${res.data.length} deals:\n\n`;
+            const table = [
+                "| ID | Contact | Property | Stage | Category | Feeling | Created |",
+                "|---|---|---|---|---|---|---|",
+                ...res.data.map(formatDealRow),
+            ].join("\n");
+            return textResult(header + table);
+        }
+        catch (err) {
+            return errorResult("Deal", err);
+        }
+    });
+    // ── create_deal ─────────────────────────────────────────────────
+    server.tool("create_deal", `Create a deal linking an interested contact to a property in Propstack.
+
+A deal represents a contact's interest in a property and tracks it
+through pipeline stages (e.g. Anfrage → Besichtigung → Reserviert →
+Notartermin → Verkauft).
+
+Use this tool after:
+- A viewing to formalize interest
+- A contact inquiry about a property
+- Moving a lead into the sales pipeline
+
+Requires client_id, property_id, and deal_stage_id. Use list_pipelines or
+get_pipeline to find valid pipeline and stage IDs.`, {
+        client_id: z.number()
+            .describe("Contact ID (required)"),
+        property_id: z.number()
+            .describe("Property ID (required)"),
+        deal_stage_id: z.number()
+            .describe("Pipeline stage ID (required — use list_pipelines or get_pipeline to look up)"),
+        broker_id: z.number().optional()
+            .describe("Assigned broker ID"),
+        deal_pipeline_id: z.number().optional()
+            .describe("Pipeline ID (if multiple pipelines exist)"),
+        sold_price: z.number().optional()
+            .describe("Expected or agreed price"),
+        note: z.string().optional()
+            .describe("Free-text note about this deal"),
+        date: z.string().optional()
+            .describe("Deal date (ISO 8601)"),
+        feeling: z.number().optional()
+            .describe("Feeling score: 0=none, 1=cold, 2=warm, 3=hot"),
+    }, async (args) => {
+        try {
+            const deal = await client.post("/client_properties", { body: { client_property: stripUndefined(args) } });
+            return textResult(`Deal created successfully.\n\n${formatDeal(deal)}`);
+        }
+        catch (err) {
+            return errorResult("Deal", err);
+        }
+    });
+    // ── update_deal ─────────────────────────────────────────────────
+    server.tool("update_deal", `Update an existing deal in Propstack.
+
+Use this tool to:
+- Move a deal to the next pipeline stage (change deal_stage_id)
+- Update expected/agreed price
+- Add or update notes
+- Change broker assignment
+- Update feeling score after contact
+- Record cancellation reason
+
+Only provide the fields you want to change.`, {
+        id: z.number()
+            .describe("Deal ID to update"),
+        client_id: z.number().optional()
+            .describe("Contact ID"),
+        property_id: z.number().optional()
+            .describe("Property ID"),
+        deal_stage_id: z.number().optional()
+            .describe("Pipeline stage ID — change this to move through pipeline"),
+        broker_id: z.number().optional()
+            .describe("Assigned broker ID"),
+        deal_pipeline_id: z.number().optional()
+            .describe("Pipeline ID"),
+        sold_price: z.number().optional()
+            .describe("Expected or agreed price"),
+        note: z.string().optional()
+            .describe("Free-text note about this deal"),
+        date: z.string().optional()
+            .describe("Deal date (ISO 8601)"),
+        feeling: z.number().optional()
+            .describe("Feeling score: 0=none, 1=cold, 2=warm, 3=hot"),
+        category: z.enum(["qualified", "unqualified", "lost"]).optional()
+            .describe("Deal category"),
+        reservation_reason_id: z.number().optional()
+            .describe("Cancellation/reservation reason ID (for lost deals)"),
+    }, async (args) => {
+        try {
+            const { id, ...fields } = args;
+            const deal = await client.put(`/client_properties/${id}`, { body: { client_property: stripUndefined(fields) } });
+            return textResult(`Deal updated successfully.\n\n${formatDeal(deal)}`);
+        }
+        catch (err) {
+            return errorResult("Deal", err);
+        }
+    });
+}
+//# sourceMappingURL=deals.js.map

package/dist/tools/deals.js.map

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

package/dist/tools/documents.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PropstackClient } from "../propstack-client.js";
+export declare function registerDocumentTools(server: McpServer, client: PropstackClient): void;
+//# sourceMappingURL=documents.d.ts.map

package/dist/tools/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA2B9D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAwGtF"}

package/dist/tools/documents.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { textResult, errorResult, fmt, stripUndefined } from "./helpers.js";
+// ── Response formatting ──────────────────────────────────────────────
+function formatDocument(d) {
+    const flags = [];
+    if (d.is_floorplan)
+        flags.push("floorplan");
+    if (d.is_exposee)
+        flags.push("exposé");
+    if (d.is_private)
+        flags.push("private");
+    if (d.on_landing_page)
+        flags.push("landing page");
+    const lines = [
+        `**${fmt(d.title ?? d.name, "Untitled")}** (ID: ${d.id})`,
+        fmt(d.url, "") ? `URL: ${fmt(d.url)}` : null,
+        flags.length ? `Flags: ${flags.join(", ")}` : null,
+        d.tags?.length ? `Tags: ${d.tags.join(", ")}` : null,
+        d.broker_id ? `Broker ID: ${d.broker_id}` : null,
+        `Created: ${fmt(d.created_at)}`,
+    ];
+    return lines.filter(Boolean).join("\n");
+}
+// ── Tool registration ────────────────────────────────────────────────
+export function registerDocumentTools(server, client) {
+    // ── list_documents ──────────────────────────────────────────────
+    server.tool("list_documents", `List documents attached to a property, project, or contact.
+
+Documents include floor plans (Grundrisse), exposés, contracts,
+photos, and any other uploaded files.
+
+Use this tool to:
+- See all documents for a property ("Where's the Grundriss?")
+- List a contact's uploaded files
+- Find exposés or contracts for a project
+- Check what's already been uploaded before adding more
+
+Filter by exactly one of property_id, project_id, or client_id.`, {
+        property_id: z.number().optional()
+            .describe("Filter by property ID"),
+        project_id: z.number().optional()
+            .describe("Filter by project ID"),
+        client_id: z.number().optional()
+            .describe("Filter by contact ID"),
+        sort: z.string().optional()
+            .describe("Sort string (e.g. 'created_at,desc')"),
+        page: z.number().optional()
+            .describe("Page number (default: 1)"),
+        per_page: z.number().optional()
+            .describe("Results per page (default: 25)"),
+    }, async (args) => {
+        try {
+            const res = await client.get("/documents", { params: args });
+            if (!res.data || res.data.length === 0) {
+                return textResult("No documents found.");
+            }
+            const header = res.meta?.total_count !== undefined
+                ? `Found ${res.meta.total_count} documents (showing ${res.data.length}):\n\n`
+                : `Found ${res.data.length} documents:\n\n`;
+            const formatted = res.data.map(formatDocument).join("\n\n---\n\n");
+            return textResult(header + formatted);
+        }
+        catch (err) {
+            return errorResult("Document", err);
+        }
+    });
+    // ── upload_document ─────────────────────────────────────────────
+    server.tool("upload_document", `Upload a document to a property, project, or contact in Propstack.
+
+The doc field must be a base64 data URI, e.g.:
+  "data:application/pdf;base64,JVBERi0xLjQ..."
+  "data:image/png;base64,iVBORw0KGgo..."
+
+Attach to exactly one entity: property_id, project_id, or client_id.
+
+Use the boolean flags to classify the document:
+- is_floorplan: Mark as a floor plan (Grundriss)
+- is_exposee: Mark as an exposé document
+- is_private: Hide from public/portal views
+- on_landing_page: Show on the property landing page`, {
+        title: z.string()
+            .describe("Document title"),
+        doc: z.string()
+            .describe("Base64 data URI (e.g. 'data:application/pdf;base64,...')"),
+        property_id: z.number().optional()
+            .describe("Attach to this property"),
+        project_id: z.number().optional()
+            .describe("Attach to this project"),
+        client_id: z.number().optional()
+            .describe("Attach to this contact"),
+        is_private: z.boolean().optional()
+            .describe("Mark as private (hidden from portals)"),
+        is_floorplan: z.boolean().optional()
+            .describe("Mark as floor plan (Grundriss)"),
+        is_exposee: z.boolean().optional()
+            .describe("Mark as exposé document"),
+        on_landing_page: z.boolean().optional()
+            .describe("Show on property landing page"),
+    }, async (args) => {
+        try {
+            const document = await client.post("/documents", { body: { document: stripUndefined(args) } });
+            return textResult(`Document uploaded successfully.\n\n${formatDocument(document)}`);
+        }
+        catch (err) {
+            return errorResult("Document", err);
+        }
+    });
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

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

package/dist/tools/emails.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PropstackClient } from "../propstack-client.js";
+export declare function registerEmailTools(server: McpServer, client: PropstackClient): void;
+//# sourceMappingURL=emails.d.ts.map

package/dist/tools/emails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emails.d.ts","sourceRoot":"","sources":["../../src/tools/emails.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAkC9D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAmGnF"}

package/dist/tools/emails.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { textResult, errorResult, fmt, stripUndefined } from "./helpers.js";
+// ── Response formatting ──────────────────────────────────────────────
+function formatEmail(e) {
+    const lines = [
+        `**${fmt(e.subject, "No subject")}** (ID: ${e.id})`,
+        `From: ${fmt(e.from)}`,
+        `To: ${e.to?.join(", ") ?? "none"}`,
+        e.cc?.length ? `CC: ${e.cc.join(", ")}` : null,
+        e.bcc?.length ? `BCC: ${e.bcc.join(", ")}` : null,
+        `Broker ID: ${fmt(e.broker_id)}`,
+        e.snippet_id ? `Template ID: ${e.snippet_id}` : null,
+        `Read: ${e.read ? "yes" : "no"}`,
+        `Archived: ${e.archived ? "yes" : "no"}`,
+        e.message_category_id ? `Category ID: ${e.message_category_id}` : null,
+    ];
+    if (e.client_ids?.length)
+        lines.push(`Contact IDs: ${e.client_ids.join(", ")}`);
+    if (e.property_ids?.length)
+        lines.push(`Property IDs: ${e.property_ids.join(", ")}`);
+    if (e.project_ids?.length)
+        lines.push(`Project IDs: ${e.project_ids.join(", ")}`);
+    if (e.attachments?.length) {
+        lines.push(`Attachments: ${e.attachments.map((a) => fmt(a.name, "unnamed")).join(", ")}`);
+    }
+    lines.push(`Date: ${fmt(e.created_at)}`);
+    return lines.filter(Boolean).join("\n");
+}
+// ── Tool registration ────────────────────────────────────────────────
+export function registerEmailTools(server, client) {
+    // ── send_email ──────────────────────────────────────────────────
+    server.tool("send_email", `Send an email using a Propstack email template (snippet).
+
+Propstack sends emails through connected broker email accounts. The
+broker_id determines which account sends the email. The snippet_id
+selects the email template to use.
+
+Use this tool to:
+- Send an exposé to an interested contact
+- Send a follow-up email after a viewing
+- Send a confirmation or rejection to a lead
+
+Link the email to contacts, properties, and projects so it appears
+in the correct CRM activity feeds.
+
+Important:
+- broker_id must be a broker with a connected email account
+- snippet_id is the email template ID — the template may contain
+  merge fields that Propstack fills automatically (contact name,
+  property details, etc.)
+- to[] are the recipient email addresses
+- cc[] are optional CC recipients`, {
+        broker_id: z.number()
+            .describe("Sender broker ID (must have connected email account)"),
+        to: z.array(z.string())
+            .describe("Recipient email addresses"),
+        snippet_id: z.number()
+            .describe("Email template (snippet) ID"),
+        cc: z.array(z.string()).optional()
+            .describe("CC recipient email addresses"),
+        client_ids: z.array(z.number()).optional()
+            .describe("Contact IDs to link this email to"),
+        property_ids: z.array(z.number()).optional()
+            .describe("Property IDs to link this email to"),
+        project_ids: z.array(z.number()).optional()
+            .describe("Project IDs to link this email to"),
+    }, async (args) => {
+        try {
+            const email = await client.post("/messages", { body: { message: stripUndefined(args) } });
+            return textResult(`Email sent successfully.\n\n${formatEmail(email)}`);
+        }
+        catch (err) {
+            return errorResult("Email", err);
+        }
+    });
+    // ── update_email ────────────────────────────────────────────────
+    server.tool("update_email", `Update an email in Propstack.
+
+Use this tool to:
+- Mark an email as read or unread
+- Archive an email
+- Categorize an email (set message_category_id)
+- Link an email to contacts, properties, or projects
+
+Only provide the fields you want to change.`, {
+        id: z.number()
+            .describe("Email/message ID to update"),
+        read: z.boolean().optional()
+            .describe("Mark as read (true) or unread (false)"),
+        archived: z.boolean().optional()
+            .describe("Archive (true) or unarchive (false)"),
+        message_category_id: z.number().optional()
+            .describe("Email category ID"),
+        client_ids: z.array(z.number()).optional()
+            .describe("Contact IDs to link this email to"),
+        property_ids: z.array(z.number()).optional()
+            .describe("Property IDs to link this email to"),
+        project_ids: z.array(z.number()).optional()
+            .describe("Project IDs to link this email to"),
+    }, async (args) => {
+        try {
+            const { id, ...fields } = args;
+            const email = await client.put(`/messages/${id}`, { body: { message: stripUndefined(fields) } });
+            return textResult(`Email updated successfully.\n\n${formatEmail(email)}`);
+        }
+        catch (err) {
+            return errorResult("Email", err);
+        }
+    });
+}
+//# sourceMappingURL=emails.js.map

package/dist/tools/emails.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,39 @@
+export declare function textResult(text: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Format any error into a user-friendly string.
+ */
+export declare function formatError(err: unknown): string;
+export declare function errorResult(entity: string, err: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+/**
+ * Propstack API with new=1/expand=1 returns nested objects like { value: X } or
+ * { value: X, pretty_value: Y }. Unwrap to the underlying primitive for display.
+ */
+export declare function unwrapPropstackValue(val: unknown): unknown;
+export declare function fmt(value: unknown, fallback?: string): string;
+/** Unwrap and coerce to number for price/area formatting. */
+export declare function unwrapNumber(val: unknown): number | null;
+export declare function fmtPrice(value: unknown): string;
+export declare function fmtArea(value: unknown, unit?: string): string;
+export declare function fmtNested(obj: unknown, key: string, fallback?: string): string;
+/**
+ * Remove keys with undefined values from an object so we don't send
+ * nulls to the API when optional fields are omitted.
+ */
+export declare function stripUndefined<T extends Record<string, unknown>>(obj: T): Partial<T>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM;;;;;EAEtC;AAiCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAyBhD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO;;;;;;;;;;;EAwBvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAY1D;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAS,GAAG,MAAM,CAK7D;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQxD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/C;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAO,GAAG,MAAM,CAI3D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAS,GAAG,MAAM,CAI9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQpF"}