too-many-cooks-core 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NIMBLESITE PTY LTD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# too-many-cooks-core
+
+Core types, tools, and interfaces for [Too Many Cooks](https://github.com/MelbourneDeveloper/too-many-cooks) multi-agent coordination.
+
+## Install
+
+```bash
+npm install too-many-cooks-core
+```
+
+## What's Inside
+
+- **Database interface** (`TooManyCooksDb`) - the contract every backend implements
+- **Database contract tests** - portable test suite to verify any backend implementation
+- **Tool definitions** - MCP tool schemas and handlers for register, lock, message, plan, status
+- **Result type** - `Result<T, E>` for error handling without exceptions
+- **Server utilities** - Streamable HTTP transport setup, admin routes, notification emitter
+- **Type definitions** - `Agent`, `FileLock`, `Message`, `AgentPlan`, and more
+
+## Usage
+
+```typescript
+import type { TooManyCooksDb, Agent, Message } from "too-many-cooks-core";
+import { success, error } from "too-many-cooks-core";
+```
+
+This package is used by:
+- [`too-many-cooks`](https://www.npmjs.com/package/too-many-cooks) - the MCP server
+- [`tmc-cloud`](https://github.com/MelbourneDeveloper/tmc-cloud) - the SaaS backend
+
+## Documentation
+
+See the [spec](https://github.com/MelbourneDeveloper/too-many-cooks/blob/main/docs/spec.md) for the full protocol specification.
+
+[tmc-mcp.dev](https://tmc-mcp.dev)
+
+## License
+
+MIT

package/build/admin_routes.d.ts

@@ -0,0 +1,15 @@
+import { type Express } from "express";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import type { TooManyCooksDb } from "./db-interface.js";
+/** Admin event hub - manages Streamable HTTP transports for pushing real-time events to the VSIX. */
+export type AdminEventHub = {
+    readonly transports: Map<string, StreamableHTTPServerTransport>;
+    readonly servers: Map<string, McpServer>;
+    readonly pushEvent: (event: string, payload: Record<string, unknown>) => void;
+};
+/** Create an admin event hub for Streamable HTTP push. */
+export declare const createAdminEventHub: () => AdminEventHub;
+/** Register all admin routes on an Express app. */
+export declare const registerAdminRoutes: (app: Express, db: TooManyCooksDb, hub: AdminEventHub) => void;
+//# sourceMappingURL=admin_routes.d.ts.map

package/build/admin_routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin_routes.d.ts","sourceRoot":"","sources":["../src/admin_routes.ts"],"names":[],"mappings":"AAMA,OAAgB,EAAE,KAAK,OAAO,EAA+B,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACxG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAexD,qGAAqG;AACrG,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAC;CACX,CAAC;AAkCF,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,EAAE,MAAM,aA0BvC,CAAC;AAmLF,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,EAAE,CAChC,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,aAAa,KACf,IAYJ,CAAC"}

package/build/admin_routes.js

@@ -0,0 +1,183 @@
+/// Admin REST endpoints for the VSCode extension.
+///
+/// The VSIX talks to these endpoints - never touches the DB directly.
+/// Streamable HTTP endpoint pushes all state changes in real-time.
+/// SHARED: Used by both local and cloud deployments.
+import express from "express";
+import { agentIdentityToJson, agentPlanToJson, agentRegistrationToJson, dbErrorToJson, fileLockToJson, messageToJson, } from "./types.gen.js";
+/** Logger name for admin push events. */
+const ADMIN_LOGGER_NAME = "too-many-cooks-admin";
+/** Send a push event to all connected admin servers. */
+const sendToServer = async (entry, data, servers, transports) => {
+    const [key, server] = entry;
+    console.error(`[TMC] [PUSH] Sending to ${key}`);
+    try {
+        await server.sendLoggingMessage({
+            level: "info",
+            logger: ADMIN_LOGGER_NAME,
+            data,
+        });
+        console.error(`[TMC] [PUSH] Sent OK to ${key}`);
+    }
+    catch {
+        console.error(`[TMC] [PUSH] FAILED ${key}`);
+        servers.delete(key);
+        transports.delete(key);
+    }
+};
+/** Helper to safely extract body as Record. */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-return
+const extractBody = (req) => { return req.body; };
+/** Create an admin event hub for Streamable HTTP push. */
+export const createAdminEventHub = () => {
+    const transports = new Map();
+    const servers = new Map();
+    const pushEvent = (event, payload) => {
+        console.error(`[TMC] [PUSH] ${event} -> ${String(servers.size)} server(s), ${String(transports.size)} transport(s)`);
+        const data = {
+            event,
+            timestamp: Date.now(),
+            payload,
+        };
+        // eslint-disable-next-line @typescript-eslint/no-floating-promises
+        Promise.all([...servers.entries()].map(
+        // eslint-disable-next-line require-await
+        async (entry) => { return sendToServer(entry, data, servers, transports); }));
+    };
+    return { transports, servers, pushEvent };
+};
+/** Send an error response. */
+const sendError = (res, code, message) => {
+    res.status(code).send(message);
+};
+/** Extract a string field from the request body, or undefined. */
+const stringField = (body, field) => {
+    const value = body[field];
+    return typeof value === "string" ? value : undefined;
+};
+/** Register GET /admin/status route. */
+const registerStatusRoute = (app, db) => {
+    app.get("/admin/status", async (_req, res) => {
+        const agentsResult = await db.listAgents();
+        const agents = agentsResult.ok
+            ? agentsResult.value.map(agentIdentityToJson)
+            : [];
+        const locksResult = await db.listLocks();
+        const locks = locksResult.ok
+            ? locksResult.value.map(fileLockToJson)
+            : [];
+        const plansResult = await db.listPlans();
+        const plans = plansResult.ok
+            ? plansResult.value.map(agentPlanToJson)
+            : [];
+        const messagesResult = await db.listAllMessages();
+        const messages = messagesResult.ok
+            ? messagesResult.value.map(messageToJson)
+            : [];
+        res
+            .set("Content-Type", "application/json")
+            .send(JSON.stringify({ agents, locks, plans, messages }));
+    });
+};
+/** Register POST /admin/delete-lock route. */
+const registerDeleteLockRoute = (app, db, hub) => {
+    app.post("/admin/delete-lock", async (req, res) => {
+        const filePath = stringField(extractBody(req), "filePath");
+        if (filePath === undefined) {
+            sendError(res, 400, "filePath required");
+            return;
+        }
+        const result = await db.adminDeleteLock(filePath);
+        if (result.ok) {
+            hub.pushEvent("lock_released", { file_path: filePath });
+            res.send(JSON.stringify({ deleted: true }));
+        }
+        else {
+            sendError(res, 400, JSON.stringify(dbErrorToJson(result.error)));
+        }
+    });
+};
+/** Register POST /admin/delete-agent route. */
+const registerDeleteAgentRoute = (app, db, hub) => {
+    app.post("/admin/delete-agent", async (req, res) => {
+        const agentName = stringField(extractBody(req), "agentName");
+        if (agentName === undefined) {
+            sendError(res, 400, "agentName required");
+            return;
+        }
+        const result = await db.adminDeleteAgent(agentName);
+        if (result.ok) {
+            hub.pushEvent("agent_deleted", { agent_name: agentName });
+            res.send(JSON.stringify({ deleted: true }));
+        }
+        else {
+            sendError(res, 400, JSON.stringify(dbErrorToJson(result.error)));
+        }
+    });
+};
+/** Register POST /admin/reset-key route. */
+const registerResetKeyRoute = (app, db) => {
+    app.post("/admin/reset-key", async (req, res) => {
+        const agentName = stringField(extractBody(req), "agentName");
+        if (agentName === undefined) {
+            sendError(res, 400, "agentName required");
+            return;
+        }
+        const result = await db.adminResetKey(agentName);
+        if (result.ok) {
+            res.send(JSON.stringify(agentRegistrationToJson(result.value)));
+        }
+        else {
+            sendError(res, 400, JSON.stringify(dbErrorToJson(result.error)));
+        }
+    });
+};
+/** Register POST /admin/send-message route. */
+const registerSendMessageRoute = (app, db, hub) => {
+    app.post("/admin/send-message", async (req, res) => {
+        const body = extractBody(req);
+        const fromAgent = stringField(body, "fromAgent");
+        const toAgent = stringField(body, "toAgent");
+        const content = stringField(body, "content");
+        if (fromAgent === undefined || toAgent === undefined || content === undefined) {
+            sendError(res, 400, "fromAgent, toAgent, content required");
+            return;
+        }
+        const result = await db.adminSendMessage(fromAgent, toAgent, content);
+        if (result.ok) {
+            hub.pushEvent("message_sent", {
+                from_agent: fromAgent,
+                to_agent: toAgent,
+                message_id: result.value,
+            });
+            res.send(JSON.stringify({ sent: true, message_id: result.value }));
+        }
+        else {
+            sendError(res, 400, JSON.stringify(dbErrorToJson(result.error)));
+        }
+    });
+};
+/** Register POST /admin/reset route. */
+const registerResetRoute = (app, db, hub) => {
+    app.post("/admin/reset", async (_req, res) => {
+        const result = await db.adminReset();
+        if (result.ok) {
+            hub.pushEvent("state_reset", {});
+            res.send(JSON.stringify({ reset: true }));
+        }
+        else {
+            sendError(res, 500, JSON.stringify(dbErrorToJson(result.error)));
+        }
+    });
+};
+/** Register all admin routes on an Express app. */
+export const registerAdminRoutes = (app, db, hub) => {
+    app.use(express.json());
+    registerStatusRoute(app, db);
+    registerDeleteLockRoute(app, db, hub);
+    registerDeleteAgentRoute(app, db, hub);
+    registerResetKeyRoute(app, db);
+    registerSendMessageRoute(app, db, hub);
+    registerResetRoute(app, db, hub);
+};
+//# sourceMappingURL=admin_routes.js.map

package/build/admin_routes.js.map

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

package/build/config.d.ts

@@ -0,0 +1,35 @@
+/** Data layer configuration. */
+export type TooManyCooksDataConfig = {
+    readonly dbPath: string;
+    readonly lockTimeoutMs: number;
+    readonly maxMessageLength: number;
+    readonly maxPlanLength: number;
+};
+/** Resolve database path for a workspace folder. */
+export declare const resolveDbPath: (workspaceFolder: string) => string;
+/** Default lock timeout in milliseconds (10 minutes). */
+export declare const DEFAULT_LOCK_TIMEOUT_MS: number;
+/** Default maximum message length in characters. */
+export declare const DEFAULT_MAX_MESSAGE_LENGTH: number;
+/** Default maximum plan field length in characters. */
+export declare const DEFAULT_MAX_PLAN_LENGTH: number;
+/** Create config with explicit dbPath. */
+export declare const createDataConfig: (params: {
+    readonly dbPath: string;
+    readonly lockTimeoutMs?: number;
+    readonly maxMessageLength?: number;
+    readonly maxPlanLength?: number;
+}) => TooManyCooksDataConfig;
+/** Create config from workspace folder. */
+export declare const createDataConfigFromWorkspace: (workspaceFolder: string) => TooManyCooksDataConfig;
+/** Get workspace folder from TMC_WORKSPACE env var or process.cwd(). */
+export declare const getWorkspaceFolder: () => string;
+/** Default server port. */
+export declare const DEFAULT_PORT: number;
+/** Get server port from TMC_PORT env var or default (4040). */
+export declare const getServerPort: () => number;
+/** Default configuration using the resolved workspace folder. */
+export declare const defaultConfig: TooManyCooksDataConfig;
+/** Join path segments. */
+export declare const pathJoin: (segments: readonly string[]) => string;
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,gCAAgC;AAChC,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,MACF,CAAC;AAExD,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,EAAE,MAAe,CAAC;AAEtD,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,EAAE,MAAY,CAAC;AAEtD,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,EAAE,MAAY,CAAC;AAEnD,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,EAAE,CAAC,MAAM,EAAE;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC,KAAK,sBAUJ,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,6BAA6B,EAAE,CAC1C,eAAe,EAAE,MAAM,KACpB,sBAE6F,CAAC;AAEnG,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAE,MAAM,MACc,CAAC;AAEtD,2BAA2B;AAC3B,eAAO,MAAM,YAAY,EAAE,MAAa,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,aAAa,EAAE,MAAM,MAKjC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,sBACyB,CAAC;AAEtD,0BAA0B;AAC1B,eAAO,MAAM,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,KAAK,MACvB,CAAC"}

package/build/config.js

@@ -0,0 +1,44 @@
+/// Configuration for Too Many Cooks data layer.
+///
+/// SINGLE SOURCE OF TRUTH for database path resolution.
+/// Only the MCP server uses the database. The VSCode extension
+/// communicates exclusively via HTTP to the MCP server.
+/// The database is ALWAYS at `${workspaceFolder}/.too_many_cooks/data.db`.
+import path from "node:path";
+/** Resolve database path for a workspace folder. */
+export const resolveDbPath = (workspaceFolder) => { return `${workspaceFolder}/.too_many_cooks/data.db`; };
+/** Default lock timeout in milliseconds (10 minutes). */
+export const DEFAULT_LOCK_TIMEOUT_MS = 600000;
+/** Default maximum message length in characters. */
+export const DEFAULT_MAX_MESSAGE_LENGTH = 200;
+/** Default maximum plan field length in characters. */
+export const DEFAULT_MAX_PLAN_LENGTH = 100;
+/** Create config with explicit dbPath. */
+export const createDataConfig = (params) => {
+    return {
+        dbPath: params.dbPath,
+        lockTimeoutMs: params.lockTimeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS,
+        maxMessageLength: params.maxMessageLength ?? DEFAULT_MAX_MESSAGE_LENGTH,
+        maxPlanLength: params.maxPlanLength ?? DEFAULT_MAX_PLAN_LENGTH,
+    };
+};
+/** Create config from workspace folder. */
+export const createDataConfigFromWorkspace = (workspaceFolder) => { return createDataConfig({ dbPath: resolveDbPath(workspaceFolder) }); };
+/** Get workspace folder from TMC_WORKSPACE env var or process.cwd(). */
+export const getWorkspaceFolder = () => { return process.env.TMC_WORKSPACE ?? process.cwd(); };
+/** Default server port. */
+export const DEFAULT_PORT = 4040;
+/** Get server port from TMC_PORT env var or default (4040). */
+export const getServerPort = () => {
+    const raw = process.env.TMC_PORT;
+    if (raw === undefined) {
+        return DEFAULT_PORT;
+    }
+    const parsed = parseInt(raw, 10);
+    return isNaN(parsed) ? DEFAULT_PORT : parsed;
+};
+/** Default configuration using the resolved workspace folder. */
+export const defaultConfig = createDataConfigFromWorkspace(getWorkspaceFolder());
+/** Join path segments. */
+export const pathJoin = (segments) => { return path.join(...segments); };
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,GAAG;AACH,wDAAwD;AACxD,+DAA+D;AAC/D,wDAAwD;AACxD,2EAA2E;AAE3E,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAAwC,CAAC,eAAuB,EAAU,EAAE,GACnG,OAAO,GAAG,eAAe,0BAA0B,CAAA,CAAA,CAAC,CAAC;AAExD,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAW,MAAM,CAAC;AAEtD,oDAAoD;AACpD,MAAM,CAAC,MAAM,0BAA0B,GAAW,GAAG,CAAC;AAEtD,uDAAuD;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAW,GAAG,CAAC;AAEnD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAKE,CAAC,MAK/B,EAA0B,EAAE;IAAE,OAAO;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,uBAAuB;QAC9D,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,0BAA0B;QACvE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,uBAAuB;KAC/D,CAAA;AAAA,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,6BAA6B,GAEZ,CAC5B,eAAuB,EACC,EAAE,GAAE,OAAO,gBAAgB,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA,CAAA,CAAC,CAAC;AAEnG,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAiB,GAAW,EAAE,GAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA,CAAA,CAAC,CAAC;AAEtD,2BAA2B;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAW,IAAI,CAAC;AAEzC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAiB,GAAW,EAAE;IACtD,MAAM,GAAG,GAAuB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAAA,OAAO,YAAY,CAAC;IAAA,CAAC;IAC7C,MAAM,MAAM,GAAW,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,aAAa,GACxB,6BAA6B,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEtD,0BAA0B;AAC1B,MAAM,CAAC,MAAM,QAAQ,GAA4C,CAAC,QAA2B,EAAU,EAAE,GACtG,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA,CAAA,CAAC,CAAC"}

package/build/db-contract-tests.d.ts

@@ -0,0 +1,16 @@
+import type { TooManyCooksDb } from "./db-interface.js";
+/** Result of creating a test db instance. */
+type DbInstance = {
+    readonly db: TooManyCooksDb;
+    readonly cleanup: () => Promise<void>;
+};
+/** Factory type for creating test db instances. */
+type DbFactory = () => Promise<DbInstance>;
+/**
+ * Run the full TooManyCooksDb contract test suite.
+ *
+ * @param createTestDb - Factory that creates a fresh db instance per test
+ */
+export declare const runDbContractTests: (createTestDb: DbFactory) => void;
+export {};
+//# sourceMappingURL=db-contract-tests.d.ts.map

package/build/db-contract-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-contract-tests.d.ts","sourceRoot":"","sources":["../src/db-contract-tests.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,6CAA6C;AAC7C,KAAK,UAAU,GAAG;IAChB,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAEF,mDAAmD;AACnD,KAAK,SAAS,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;AA2mB3C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,CAAC,YAAY,EAAE,SAAS,KAAK,IAQ7D,CAAC"}