posha-api-mcp 1.0.0

package/README.md

@@ -0,0 +1,150 @@
+# Posha API MCP Server
+
+MCP (Model Context Protocol) server that provides AI assistants with read-only access to the Posha API. Supports 13 tools covering all 45 endpoints across 17 resources.
+
+## Quick Start
+
+```bash
+cd resource-api-mcp
+npm install
+npm run build
+```
+
+## Configuration
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `RESOURCE_API_BASE_URL` | Yes | — | Posha API base URL (e.g. `http://localhost:8080/servicekit/api/v1`) |
+| `RESOURCE_API_KEY` | Yes | — | API key for `X-API-Key` header |
+| `RESOURCE_API_BEARER_TOKEN` | No | — | Firebase JWT for endpoints protected by Spring Security (e.g. `/recipes/**`) |
+| `MCP_TRANSPORT` | No | `stdio` | Transport: `stdio` or `sse` |
+| `MCP_PORT` | No | `3001` | SSE server port (only when `MCP_TRANSPORT=sse`) |
+
+## Setup
+
+### Install via npm
+
+```bash
+npm install -g posha-api-mcp
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` (global) or project-level:
+
+```json
+{
+  "mcpServers": {
+    "posha-api": {
+      "command": "npx",
+      "args": ["-y", "posha-api-mcp"],
+      "env": {
+        "RESOURCE_API_BASE_URL": "https://your-api-host/servicekit/api/v1",
+        "RESOURCE_API_KEY": "<your-api-key>",
+        "RESOURCE_API_BEARER_TOKEN": "<optional-firebase-jwt-for-recipes>"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "posha-api": {
+      "command": "npx",
+      "args": ["-y", "posha-api-mcp"],
+      "env": {
+        "RESOURCE_API_BASE_URL": "https://your-api-host/servicekit/api/v1",
+        "RESOURCE_API_KEY": "<your-api-key>",
+        "RESOURCE_API_BEARER_TOKEN": "<optional-firebase-jwt-for-recipes>"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add posha-api -- npx -y posha-api-mcp
+```
+
+Then set environment variables in your shell or `.env` file.
+
+## Available Tools
+
+### Generic Resource Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_available_resources` | Lists all 17 resource types with filterable fields, operators, and sort options |
+| `get_resource` | Get any resource by ID (user, session, recipe, machine, etc.) |
+| `query_resources` | Query any resource with filters, sorting, pagination, and projection |
+
+### Session Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_session_feedback` | Get feedback for a cooking session |
+| `get_session_customisations` | Get pre-cooking customisations |
+| `get_session_metadata` | Get session timing and step metadata |
+| `query_session_logs` | Query session log entries (logs, images, or instructions) |
+
+### Image Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_session_images` | List all images for a session |
+| `get_session_instruction_images` | Get images for a specific instruction |
+| `get_session_image_detail` | Get full metadata for an image |
+| `search_images` | Cross-session image search with time range |
+
+### Machine Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_machine_storage` | Get machine on-device storage snapshot |
+| `get_machine_details` | Get machine users and/or crash dump files |
+
+## Query Examples
+
+### Find a user by email
+
+```
+Use get_resource with resourceType "users" and id "user@example.com"
+```
+
+### Query recent sessions for a user
+
+```
+Use query_resources with resourceType "sessions", filter by cookedBy.uid equals "<uid>",
+sort by createdOn desc, limit 10
+```
+
+### Search images across sessions
+
+```
+Use search_images with startTime "2026-03-01T00:00:00Z", endTime "2026-03-31T00:00:00Z",
+machineId "g3.33", containerTypes ["Macro"]
+```
+
+## AWS Deployment (SSE mode)
+
+Build and deploy the Docker image:
+
+```bash
+docker build -t posha-api-mcp .
+docker run -p 3001:3001 \
+  -e RESOURCE_API_BASE_URL=http://resource-api:8080/servicekit/api/v1 \
+  -e RESOURCE_API_KEY=your-key \
+  posha-api-mcp
+```
+
+Clients connect via `http://<host>:3001/sse`.
+
+Health check: `GET http://<host>:3001/health`

package/dist/api-client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * HTTP client for the Posha API. Handles authentication, timeouts,
+ * and structured error mapping for all REST calls.
+ */
+export interface ApiClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    bearerToken?: string;
+    timeoutMs?: number;
+}
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: unknown;
+    requestId?: string;
+}
+export declare class PoshaApiClient {
+    private baseUrl;
+    private apiKey;
+    private bearerToken?;
+    private timeoutMs;
+    constructor(config: ApiClientConfig);
+    get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    private request;
+}
+export declare function getClient(): PoshaApiClient;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,eAAe;IAO7B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYjE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;YAQxC,OAAO;CA0DtB;AAID,wBAAgB,SAAS,IAAI,cAAc,CAkB1C"}

package/dist/api-client.js

@@ -0,0 +1,106 @@
+/**
+ * HTTP client for the Posha API. Handles authentication, timeouts,
+ * and structured error mapping for all REST calls.
+ */
+export class PoshaApiClient {
+    baseUrl;
+    apiKey;
+    bearerToken;
+    timeoutMs;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+        this.bearerToken = config.bearerToken;
+        this.timeoutMs = config.timeoutMs ?? 15_000;
+    }
+    async get(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        return this.request(url.toString(), { method: "GET" });
+    }
+    async post(path, body) {
+        return this.request(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    async request(url, init) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                ...init,
+                signal: controller.signal,
+                headers: {
+                    ...init.headers,
+                    "X-API-Key": this.apiKey,
+                    ...(this.bearerToken && { Authorization: `Bearer ${this.bearerToken}` }),
+                    Accept: "application/json",
+                },
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                let apiError;
+                try {
+                    const parsed = JSON.parse(errorBody);
+                    apiError = {
+                        code: parsed.error?.code ?? `HTTP_${response.status}`,
+                        message: parsed.error?.message ?? response.statusText,
+                        details: parsed.error?.details,
+                        requestId: parsed.requestId,
+                    };
+                }
+                catch {
+                    apiError = {
+                        code: `HTTP_${response.status}`,
+                        message: `${response.statusText}: ${errorBody.slice(0, 500)}`,
+                    };
+                }
+                throw apiError;
+            }
+            return (await response.json());
+        }
+        catch (err) {
+            if (err && typeof err === "object" && "code" in err) {
+                throw err; // already an ApiError
+            }
+            if (err instanceof DOMException && err.name === "AbortError") {
+                throw {
+                    code: "TIMEOUT",
+                    message: `Request timed out after ${this.timeoutMs}ms`,
+                };
+            }
+            throw {
+                code: "CONNECTION_ERROR",
+                message: `Failed to connect to Posha API: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+let _client = null;
+export function getClient() {
+    if (!_client) {
+        const baseUrl = process.env.RESOURCE_API_BASE_URL;
+        const apiKey = process.env.RESOURCE_API_KEY;
+        if (!baseUrl) {
+            throw new Error("RESOURCE_API_BASE_URL environment variable is required");
+        }
+        if (!apiKey) {
+            throw new Error("RESOURCE_API_KEY environment variable is required");
+        }
+        const bearerToken = process.env.RESOURCE_API_BEARER_TOKEN;
+        _client = new PoshaApiClient({ baseUrl, apiKey, bearerToken });
+    }
+    return _client;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,OAAO,cAAc;IACjB,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,WAAW,CAAU;IACrB,SAAS,CAAS;IAE1B,YAAY,MAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,MAA+B;QACxD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QACvC,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,GAAW,EACX,IAAiB;QAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,GAAG,IAAI;gBACP,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE;oBACP,GAAG,IAAI,CAAC,OAAiC;oBACzC,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxE,MAAM,EAAE,kBAAkB;iBAC3B;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,IAAI,QAAkB,CAAC;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBACrC,QAAQ,GAAG;wBACT,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE;wBACrD,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU;wBACrD,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO;wBAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;qBAC5B,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,GAAG;wBACT,IAAI,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE;wBAC/B,OAAO,EAAE,GAAG,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;qBAC9D,CAAC;gBACJ,CAAC;gBACD,MAAM,QAAQ,CAAC;YACjB,CAAC;YAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;QACtC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACpD,MAAM,GAAG,CAAC,CAAC,sBAAsB;YACnC,CAAC;YACD,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC7D,MAAM;oBACJ,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,2BAA2B,IAAI,CAAC,SAAS,IAAI;iBAC3C,CAAC;YAChB,CAAC;YACD,MAAM;gBACJ,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,mCAAmC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aACnF,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,IAAI,OAAO,GAA0B,IAAI,CAAC;AAE1C,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAE5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,wDAAwD,CACzD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAC1D,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { createServer } from "./server.js";
+import http from "node:http";
+const transport = process.env.MCP_TRANSPORT ?? "stdio";
+async function main() {
+    const server = createServer();
+    if (transport === "sse") {
+        await startSSE(server);
+    }
+    else {
+        await startStdio(server);
+    }
+}
+async function startStdio(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Posha API MCP server running on stdio");
+}
+async function startSSE(server) {
+    const port = parseInt(process.env.MCP_PORT ?? "3001", 10);
+    let sseTransport = null;
+    const httpServer = http.createServer(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://localhost:${port}`);
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (url.pathname === "/sse" && req.method === "GET") {
+            sseTransport = new SSEServerTransport("/messages", res);
+            await server.connect(sseTransport);
+            return;
+        }
+        if (url.pathname === "/messages" && req.method === "POST") {
+            if (!sseTransport) {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "No SSE connection established. Connect to /sse first." }));
+                return;
+            }
+            await sseTransport.handlePostMessage(req, res);
+            return;
+        }
+        if (url.pathname === "/health") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", transport: "sse" }));
+            return;
+        }
+        res.writeHead(404, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Not found" }));
+    });
+    httpServer.listen(port, () => {
+        console.error(`Posha API MCP server running on SSE at http://0.0.0.0:${port}/sse`);
+        console.error(`Health check: http://0.0.0.0:${port}/health`);
+    });
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/resource-metadata.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Static metadata for all 17 resources, derived from the Java FieldRegistry
+ * implementations. Each entry describes the filterable/sortable fields,
+ * their types, tiers, and allowed operators.
+ */
+export type FieldType = "STRING" | "INTEGER" | "LONG" | "DOUBLE" | "BOOLEAN" | "DATETIME";
+export type FieldTier = "TIER_1" | "TIER_2" | "TIER_3";
+export type FilterOperator = "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "in" | "nin" | "regex" | "exists";
+export interface FieldDef {
+    name: string;
+    type: FieldType;
+    tier: FieldTier;
+    sortable: boolean;
+    operators: FilterOperator[];
+}
+export interface ResourceDef {
+    resourceName: string;
+    slug: string;
+    collectionName: string;
+    idField: string;
+    approximateDocCount: string;
+    fields: FieldDef[];
+}
+export declare const RESOURCES: ResourceDef[];
+export declare const RESOURCE_SLUGS: string[];
+export declare function getResourceBySlug(slug: string): ResourceDef | undefined;
+export declare function getFilterableFields(resource: ResourceDef): FieldDef[];
+export declare function getSortableFields(resource: ResourceDef): FieldDef[];
+//# sourceMappingURL=resource-metadata.d.ts.map

package/dist/resource-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-metadata.d.ts","sourceRoot":"","sources":["../src/resource-metadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAC1F,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3G,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAYD,eAAO,MAAM,SAAS,EAAE,WAAW,EAiQlC,CAAC;AAEF,eAAO,MAAM,cAAc,UAA+B,CAAC;AAE3D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEvE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,EAAE,CAErE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,EAAE,CAEnE"}