crewly 1.13.0 → 1.13.1

package/dist/cli/backend/src/services/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../../../../backend/src/services/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAChC,sDAAsD;;;;;IAKtD,kDAAkD;;IAElD,yDAAyD;;CAEhD,CAAC;AAIX;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC/B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,gBAAgB;IAC5B,8CAA8C;IAC9C,OAAO,CAAC,WAAW,CAA+C;IAElE;;;;;;;;;;OAUG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDzE;;;;;;;OAOG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAcpC;;;;;OAKG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAgB7C;;;;;;;;;;OAUG;IACG,QAAQ,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAChC,OAAO,CAAC,aAAa,CAAC;IAqCzB;;;;;;;OAOG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrD;;;;OAIG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;OAIG;IACH,iBAAiB,IAAI,eAAe,EAAE;IAiBtC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,UAAU,CACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GACtC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAsB9B"}

package/dist/cli/backend/src/services/mcp-client.js

@@ -0,0 +1,302 @@
+/**
+ * MCP Client Service
+ *
+ * Enables Crewly agents to connect to external MCP (Model Context Protocol)
+ * servers and use their tools. This is the client-side counterpart to our
+ * existing MCP server — it lets agents consume tools from any MCP-compatible
+ * server (filesystem, GitHub, database, etc.).
+ *
+ * Supports stdio-based MCP servers (child process spawning) which is the
+ * standard transport for local MCP servers.
+ *
+ * @module services/mcp-client
+ */
+// ========================= Constants =========================
+/**
+ * MCP Client configuration constants
+ */
+export const MCP_CLIENT_CONSTANTS = {
+    /** Client identification sent during MCP handshake */
+    CLIENT_INFO: {
+        NAME: 'crewly-agent',
+        VERSION: '1.0.0',
+    },
+    /** Default timeout for tool calls (30 seconds) */
+    TOOL_CALL_TIMEOUT_MS: 30000,
+    /** Default timeout for server connection (15 seconds) */
+    CONNECTION_TIMEOUT_MS: 15000,
+};
+// ========================= Service =========================
+/**
+ * Manages connections to external MCP servers and provides a unified
+ * interface for discovering and calling tools across all connected servers.
+ *
+ * Agents use this service to:
+ * 1. Connect to configured MCP servers at startup
+ * 2. Discover available tools across all servers
+ * 3. Call tools by name with type-safe arguments
+ * 4. Gracefully disconnect on shutdown
+ *
+ * @example
+ * ```typescript
+ * const mcpClient = new McpClientService();
+ *
+ * // Connect to a filesystem MCP server
+ * await mcpClient.connectServer('filesystem', {
+ *   command: 'npx',
+ *   args: ['-y', '@anthropic/mcp-filesystem', '/home/user'],
+ * });
+ *
+ * // List all available tools
+ * const tools = mcpClient.listTools();
+ *
+ * // Call a tool
+ * const result = await mcpClient.callTool('filesystem', 'read_file', {
+ *   path: '/home/user/file.txt',
+ * });
+ *
+ * // Disconnect all servers
+ * await mcpClient.disconnectAll();
+ * ```
+ */
+export class McpClientService {
+    /** Map of server name -> active connection */
+    connections = new Map();
+    /**
+     * Connect to an external MCP server via stdio transport.
+     *
+     * Spawns the server as a child process, performs the MCP handshake,
+     * and caches the list of available tools.
+     *
+     * @param name - Unique identifier for this server connection
+     * @param config - Server configuration (command, args, env)
+     * @throws Error if already connected to a server with this name
+     * @throws Error if the connection or handshake fails
+     */
+    async connectServer(name, config) {
+        if (this.connections.has(name)) {
+            throw new Error(`MCP server "${name}" is already connected. Disconnect first before reconnecting.`);
+        }
+        const serverParams = {
+            command: config.command,
+            args: config.args,
+            env: config.env,
+            stderr: 'ignore',
+        };
+        const clientModule = await import('@modelcontextprotocol/sdk/client/index.js');
+        const stdioModule = await import('@modelcontextprotocol/sdk/client/stdio.js');
+        const ClientCtor = clientModule.Client ?? clientModule.default?.Client;
+        const StdioTransportCtor = stdioModule.StdioClientTransport ?? stdioModule.default?.StdioClientTransport;
+        if (!ClientCtor || !StdioTransportCtor) {
+            throw new Error('Failed to load MCP SDK client modules');
+        }
+        const transport = new StdioTransportCtor(serverParams);
+        const client = new ClientCtor({
+            name: MCP_CLIENT_CONSTANTS.CLIENT_INFO.NAME,
+            version: MCP_CLIENT_CONSTANTS.CLIENT_INFO.VERSION,
+        }, { capabilities: {} });
+        await client.connect(transport);
+        // Discover available tools
+        const toolsResult = await client.listTools();
+        const tools = (toolsResult.tools || []).map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            serverName: name,
+        }));
+        this.connections.set(name, {
+            client,
+            transport,
+            tools,
+            config,
+        });
+    }
+    /**
+     * Disconnect from a specific MCP server.
+     *
+     * Closes the transport and cleans up the child process.
+     *
+     * @param name - Name of the server to disconnect
+     * @throws Error if the server is not connected
+     */
+    async disconnectServer(name) {
+        const connection = this.connections.get(name);
+        if (!connection) {
+            throw new Error(`MCP server "${name}" is not connected.`);
+        }
+        await connection.client.close();
+        this.connections.delete(name);
+    }
+    /**
+     * Disconnect from all connected MCP servers.
+     *
+     * Closes all transports and cleans up child processes. Errors from
+     * individual disconnections are caught and do not prevent other
+     * servers from being disconnected. Connections are always removed
+     * from the internal map, even if `close()` fails.
+     */
+    async disconnectAll() {
+        const entries = Array.from(this.connections.entries());
+        await Promise.allSettled(entries.map(async ([name, connection]) => {
+            try {
+                await connection.client.close();
+            }
+            finally {
+                this.connections.delete(name);
+            }
+        }));
+    }
+    /**
+     * List all available tools across connected MCP servers.
+     *
+     * @param serverName - Optional: filter tools to a specific server
+     * @returns Array of tool information objects
+     */
+    listTools(serverName) {
+        if (serverName) {
+            const connection = this.connections.get(serverName);
+            if (!connection) {
+                return [];
+            }
+            return [...connection.tools];
+        }
+        const allTools = [];
+        for (const connection of this.connections.values()) {
+            allTools.push(...connection.tools);
+        }
+        return allTools;
+    }
+    /**
+     * Call a tool on a specific MCP server.
+     *
+     * @param serverName - Name of the server that provides the tool
+     * @param toolName - Name of the tool to call
+     * @param args - Arguments to pass to the tool
+     * @returns The tool's result containing content blocks and error status
+     * @throws Error if the server is not connected
+     * @throws Error if the tool is not found on the server
+     * @throws Error if the tool call fails
+     */
+    async callTool(serverName, toolName, args = {}) {
+        const connection = this.connections.get(serverName);
+        if (!connection) {
+            throw new Error(`MCP server "${serverName}" is not connected.`);
+        }
+        const toolExists = connection.tools.some((t) => t.name === toolName);
+        if (!toolExists) {
+            throw new Error(`Tool "${toolName}" not found on MCP server "${serverName}". ` +
+                `Available tools: ${connection.tools.map((t) => t.name).join(', ')}`);
+        }
+        const result = await connection.client.callTool({
+            name: toolName,
+            arguments: args,
+        });
+        // Normalize the result to our McpToolResult interface
+        const content = Array.isArray(result.content)
+            ? result.content.map((block) => ({
+                type: block.type,
+                text: block.text,
+                data: block.data,
+                mimeType: block.mimeType,
+            }))
+            : [];
+        return {
+            content,
+            isError: result.isError === true,
+        };
+    }
+    /**
+     * Refresh the tool list for a specific server.
+     *
+     * Useful when a server's tools may have changed since the initial connection.
+     *
+     * @param serverName - Name of the server to refresh
+     * @throws Error if the server is not connected
+     */
+    async refreshTools(serverName) {
+        const connection = this.connections.get(serverName);
+        if (!connection) {
+            throw new Error(`MCP server "${serverName}" is not connected.`);
+        }
+        const toolsResult = await connection.client.listTools();
+        connection.tools = (toolsResult.tools || []).map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            serverName,
+        }));
+    }
+    /**
+     * Get the names of all currently connected MCP servers.
+     *
+     * @returns Array of server names
+     */
+    getConnectedServers() {
+        return Array.from(this.connections.keys());
+    }
+    /**
+     * Check if a specific MCP server is currently connected.
+     *
+     * @param name - Server name to check
+     * @returns True if the server is connected
+     */
+    isServerConnected(name) {
+        return this.connections.has(name);
+    }
+    /**
+     * Get status information for all connected servers.
+     *
+     * @returns Array of server status objects including tool counts
+     */
+    getServerStatuses() {
+        const statuses = [];
+        for (const [name, connection] of this.connections.entries()) {
+            const serverVersion = connection.client.getServerVersion();
+            statuses.push({
+                name,
+                connected: true,
+                toolCount: connection.tools.length,
+                serverName: serverVersion?.name,
+                serverVersion: serverVersion?.version,
+            });
+        }
+        return statuses;
+    }
+    /**
+     * Connect to multiple MCP servers from a configuration map.
+     *
+     * This is the primary entrypoint for agent startup. Errors from
+     * individual connections are caught — failing servers do not prevent
+     * other servers from connecting.
+     *
+     * @param configs - Map of server name -> server config
+     * @returns Map of server name -> error (only for servers that failed to connect)
+     *
+     * @example
+     * ```typescript
+     * const errors = await mcpClient.connectAll({
+     *   filesystem: { command: 'npx', args: ['-y', '@anthropic/mcp-filesystem', '/tmp'] },
+     *   github: { command: 'npx', args: ['-y', '@anthropic/mcp-github'] },
+     * });
+     *
+     * if (errors.size > 0) {
+     *   console.warn('Some MCP servers failed to connect:', errors);
+     * }
+     * ```
+     */
+    async connectAll(configs) {
+        const errors = new Map();
+        const entries = Object.entries(configs);
+        const results = await Promise.allSettled(entries.map(([name, config]) => this.connectServer(name, config)));
+        results.forEach((result, index) => {
+            if (result.status === 'rejected') {
+                const [name] = entries[index];
+                errors.set(name, result.reason instanceof Error
+                    ? result.reason
+                    : new Error(String(result.reason)));
+            }
+        });
+        return errors;
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/cli/backend/src/services/mcp-client.js.map

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

package/dist/cli/backend/src/services/memory/mission-context.service.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Mission Context Service — auto-injectable mission card for agent prompts.
+ *
+ * Builds a compact (≤2KB) markdown card that summarizes the active
+ * project OKR, the team's most-relevant active missions, and the team
+ * sub-OKR (if any) so every agent wakes with the answer to "what
+ * mission am I serving right now?".
+ *
+ * Per Memory Phase 1 / Fix M1: today, agents must call `recall` or
+ * `get_goals` explicitly to find the mission they're serving — and per
+ * the architecture audit, an agent can finish a sprint without ever
+ * reading it. This service closes that gap by feeding a tiny mission
+ * card into prompt assembly automatically.
+ *
+ * Out of scope for Phase 1 (deferred to later phases):
+ *   - Narrative summarization of mission state (no LLM round-trip here)
+ *   - Vector embedding / semantic recall
+ *   - Memory review queue / supersession
+ *
+ * @module services/memory/mission-context.service
+ */
+import { type Mission } from '../../types/v2/mission.types.js';
+/**
+ * Hard upper bound on the rendered mission card. The spec calls for
+ * 1-2KB; we cap at 2KB and truncate by section priority (most-recent
+ * status → oldest first) when over budget.
+ */
+export declare const MISSION_CONTEXT_HARD_CAP_BYTES = 2048;
+/**
+ * Inputs accepted by `getContextForAgent`.
+ *
+ * `projectPath` is the absolute path to the project root (the directory
+ * containing `.crewly/`). `teamSlug` is the human-readable team slug
+ * used to resolve `<slug>-team-sub-okr.md`; if omitted, the team-sub-OKR
+ * section is skipped.
+ */
+export interface MissionContextRequest {
+    /** Agent session id, used for logging only. */
+    agentId: string;
+    /** Absolute path to the project root that owns `.crewly/`. */
+    projectPath: string;
+    /** Team id whose missions should be surfaced (matches `Mission.ownerTeamId`). */
+    teamId: string;
+    /**
+     * Optional ancestor team ids whose missions should ALSO be surfaced
+     * to the agent — covers the OKR hierarchy case where a sub-team agent
+     * needs to see the parent team / company-level mission they ladder up
+     * to. Supplied by the caller (PromptBuilderService) which has team-
+     * graph access; the service does no graph traversal of its own.
+     */
+    ancestorTeamIds?: string[];
+    /**
+     * Human-readable team slug used to find `<slug>-team-sub-okr.md`
+     * under `.crewly/goals/`. If omitted, the team-sub-OKR section
+     * is skipped.
+     */
+    teamSlug?: string;
+    /** Optional id (informational, not used for filtering today). */
+    projectId?: string;
+}
+/**
+ * Builds a small markdown card describing the agent's mission context.
+ *
+ * Singleton, side-effect-free reads. All file IO is fail-soft: any
+ * read or parse error skips the affected section but never throws into
+ * the prompt-assembly path.
+ *
+ * @example
+ * ```ts
+ * const svc = MissionContextService.getInstance();
+ * const card = await svc.getContextForAgent({
+ *   agentId: 'crewly-product-leo-21a5477e',
+ *   projectPath: '/Users/me/projects/crewly',
+ *   teamId: '28a4ac10-...',
+ *   teamSlug: 'product',
+ * });
+ * if (card) prompt += `\n${card}`;
+ * ```
+ */
+export declare class MissionContextService {
+    private static instance;
+    private readonly logger;
+    private readonly goalService;
+    private constructor();
+    /** Get the shared singleton instance. */
+    static getInstance(): MissionContextService;
+    /** Reset for tests. */
+    static clearInstance(): void;
+    /**
+     * Build the mission-context card for an agent.
+     *
+     * Returns the empty string when no signals are available — callers
+     * should treat empty output as "skip the section entirely" rather
+     * than rendering an empty heading.
+     *
+     * @param req - Request inputs
+     * @returns A ≤2KB markdown card, or `''` when nothing is worth showing
+     */
+    getContextForAgent(req: MissionContextRequest): Promise<string>;
+    /**
+     * Read up to `GOALS_MAX_LINES` non-empty, non-comment lines from
+     * the project's `goals.md`. Returns `[]` when the file is missing.
+     */
+    private loadProjectGoalsSlice;
+    /**
+     * Read all `*.json` files under `<projectPath>/.crewly/missions/`,
+     * filter to active missions whose `ownerTeamId` is in the supplied
+     * `teamScope` (own team + any ancestor teams the caller passed in),
+     * and sort by priority + recency. Returns `[]` on any error.
+     */
+    private loadActiveTeamMissions;
+    /**
+     * Read the team sub-OKR file at
+     * `<projectPath>/.crewly/goals/<teamSlug>-team-sub-okr.md`. Returns
+     * `[]` when no slug, no file, or any read error.
+     */
+    private loadTeamSubOkrSlice;
+}
+/**
+ * Recent mission status entry — pulled from `mission.lastReviewSummary`,
+ * ordered by `lastReviewAt` desc.
+ */
+export interface RecentMissionStatus {
+    missionId: string;
+    objective: string;
+    summary: string;
+    reviewedAt?: string;
+}
+/**
+ * Collect the most recent status updates across the supplied missions.
+ * A mission contributes at most one entry. Missions with no
+ * `lastReviewSummary` are skipped. Result is sorted by `lastReviewAt`
+ * descending; missions with no `lastReviewAt` sort last.
+ */
+export declare function collectRecentStatusUpdates(missions: Mission[]): RecentMissionStatus[];
+/**
+ * Extract up to `maxLines` "meaningful" lines from a markdown blob.
+ *
+ * Rules:
+ *   - skip empty lines
+ *   - skip standalone HTML/MD comments
+ *   - keep headings, prose, list items
+ *   - trim trailing whitespace
+ *   - de-duplicate consecutive identical lines
+ */
+export declare function extractMeaningfulLines(raw: string, maxLines: number): string[];
+/**
+ * Render the final mission card as markdown using the spec template.
+ * Sections with no data are omitted entirely (no empty headings).
+ */
+export declare function renderMissionCard(args: {
+    goalsLines: string[];
+    missions: Mission[];
+    teamSubOkrLines: string[];
+    statusUpdates: RecentMissionStatus[];
+}): string;
+/**
+ * Enforce the hard byte cap. If `card` already fits, returns it
+ * unchanged. Otherwise truncates line-by-line from the bottom until
+ * it fits, then appends a single ellipsis line so the card is
+ * obviously truncated.
+ */
+export declare function enforceHardCap(card: string, maxBytes: number): string;
+/**
+ * Module-level convenience: get the singleton in one call.
+ */
+export declare const getMissionContextService: () => MissionContextService;
+//# sourceMappingURL=mission-context.service.d.ts.map

package/dist/cli/backend/src/services/memory/mission-context.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-context.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/mission-context.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,EACL,KAAK,OAAO,EAEb,MAAM,iCAAiC,CAAC;AAOzC;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAkBnD;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAElD,OAAO;IAOP,yCAAyC;WAC3B,WAAW,IAAI,qBAAqB;IAOlD,uBAAuB;WACT,aAAa,IAAI,IAAI;IAQnC;;;;;;;;;OASG;IACU,kBAAkB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkD5E;;;OAGG;YACW,qBAAqB;IAcnC;;;;;OAKG;YACW,sBAAsB;IAkCpC;;;;OAIG;YACW,mBAAmB;CAmBlC;AAMD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EAAE,GAClB,mBAAmB,EAAE,CAiBvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAaV;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC,GAAG,MAAM,CAqCT;AAmBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAarE;AAuBD;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAO,qBACP,CAAC"}