macro-agent 0.2.5 → 0.2.6

package/dist/map/adapter/websocket-integration.js

@@ -0,0 +1,134 @@
+/**
+ * MAP WebSocket Integration
+ *
+ * Provides WebSocket integration for the MAP adapter, enabling external clients
+ * to connect via WebSocket and use the MAP protocol.
+ *
+ * Reuses the existing webSocketStream() adapter to keep MAPAdapter transport-agnostic.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import { webSocketStream } from "../../acp/websocket-stream.js";
+// =============================================================================
+// WebSocket Handler Factory
+// =============================================================================
+/**
+ * Create a MAP WebSocket handler.
+ *
+ * This handler processes WebSocket connections for the MAP protocol.
+ * It creates a stream adapter from the WebSocket and passes it to the MAPAdapter.
+ *
+ * @param adapter - The MAPAdapter instance to use
+ * @returns Handler for managing MAP WebSocket connections
+ *
+ * @example
+ * ```typescript
+ * const mapHandler = createMAPWebSocketHandler(mapAdapter);
+ *
+ * wss.on("connection", (ws, req) => {
+ *   if (req.url?.startsWith("/map")) {
+ *     mapHandler.handleConnection(ws, req);
+ *   }
+ * });
+ * ```
+ */
+export function createMAPWebSocketHandler(adapter) {
+    const connections = new Map();
+    async function handleConnection(ws, req) {
+        const remoteAddress = req.socket.remoteAddress ?? "unknown";
+        console.error(`[ws-map] New connection from ${remoteAddress}`);
+        // Create stream adapter from WebSocket
+        const stream = webSocketStream(ws);
+        try {
+            // Let MAPAdapter handle the connection
+            const participant = await adapter.acceptConnection(stream);
+            // Track this connection
+            const tracked = {
+                ws,
+                participant,
+                createdAt: Date.now(),
+            };
+            connections.set(ws, tracked);
+            console.error(`[ws-map] Participant ${participant.id} connected`);
+            // Handle connection close
+            ws.on("close", (code, reason) => {
+                console.error(`[ws-map] Connection closed: participant=${participant.id}, code=${code}, reason=${reason.toString()}`);
+                connections.delete(ws);
+                // MAPAdapter handles cleanup internally via stream close
+            });
+            // Handle connection errors
+            ws.on("error", (err) => {
+                console.error(`[ws-map] Connection error: participant=${participant.id}`, err);
+                connections.delete(ws);
+            });
+        }
+        catch (error) {
+            console.error(`[ws-map] Failed to accept connection:`, error);
+            ws.close(1011, "Connection setup failed");
+        }
+    }
+    function getConnectionCount() {
+        return connections.size;
+    }
+    function closeAll() {
+        console.error(`[ws-map] Closing ${connections.size} connections...`);
+        for (const [ws, tracked] of connections) {
+            if (ws.readyState === ws.OPEN) {
+                // Disconnect via adapter first (for clean subscription cleanup)
+                adapter.disconnectParticipant(tracked.participant.id, "Server shutting down")
+                    .catch((err) => console.error(`[ws-map] Error disconnecting participant:`, err));
+                ws.close(1001, "Server shutting down");
+            }
+        }
+        connections.clear();
+    }
+    function getParticipant(ws) {
+        return connections.get(ws)?.participant;
+    }
+    return {
+        handleConnection,
+        getConnectionCount,
+        closeAll,
+        getParticipant,
+    };
+}
+/**
+ * Set up MAP WebSocket handling configuration.
+ *
+ * Returns a handler and path matcher for use in a combined server setup.
+ *
+ * @param config - MAP WebSocket configuration
+ * @returns Setup result with handler and path matcher
+ *
+ * @example
+ * ```typescript
+ * const mapSetup = setupMAPWebSocket({ adapter: mapAdapter });
+ * const acpSetup = setupACPWebSocket(wss, services);
+ *
+ * // Route connections based on path
+ * httpServer.on("upgrade", (req, socket, head) => {
+ *   if (mapSetup.matchesPath(req.url)) {
+ *     wss.handleUpgrade(req, socket, head, (ws) => {
+ *       mapSetup.handler.handleConnection(ws, req);
+ *     });
+ *   } else {
+ *     // ACP or other handling
+ *   }
+ * });
+ * ```
+ */
+export function setupMAPWebSocket(config) {
+    const { adapter, path = "/map" } = config;
+    const handler = createMAPWebSocketHandler(adapter);
+    function matchesPath(url) {
+        if (!url)
+            return false;
+        // Match exact path or path with query string
+        return url === path || url.startsWith(`${path}?`) || url.startsWith(`${path}/`);
+    }
+    return {
+        handler,
+        matchesPath,
+    };
+}
+//# sourceMappingURL=websocket-integration.js.map

package/dist/map/adapter/websocket-integration.js.map

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

package/dist/map/cascade-action-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-action-handler.d.ts","sourceRoot":"","sources":["../../src/map/cascade-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACjD,IAAI,CAAC;IACR,eAAe,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACjD,IAAI,CAAC;CACT;AAYD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,uBAAuB,EACnC,OAAO,EAAE,iBAAiB,GACzB,MAAM,IAAI,CAgKZ"}
+{"version":3,"file":"cascade-action-handler.d.ts","sourceRoot":"","sources":["../../src/map/cascade-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,MAAM,WAAW,uBAAuB;IACtC,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACjD,IAAI,CAAC;IACR,eAAe,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACjD,IAAI,CAAC;CACT;AAYD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,uBAAuB,EACnC,OAAO,EAAE,iBAAiB,GACzB,MAAM,IAAI,CA0KZ"}

package/dist/map/cascade-action-handler.js

@@ -11,6 +11,8 @@
  *
  * @module map/cascade-action-handler
  */
+import { execFileSync } from 'node:child_process';
+import { assertSafeGitRef, GitInputError } from '../util/git-safety.js';
 const REQUEST_METHODS = {
     MERGE: 'x-cascade/request.merge',
     ABANDON: 'x-cascade/request.abandon',
@@ -114,12 +116,24 @@ export function setupCascadeActionHandlers(connection, adapter) {
         const worktreePath = findWorktreeForStream(p.stream_id);
         if (!worktreePath)
             return;
-        const remote = p.remote ?? 'origin';
+        // `remote` and `target_ref` are hub-controlled and were previously
+        // interpolated into a `git push` shell string — a command-injection sink.
+        // Validate them as plain refs and invoke git via execFileSync array args
+        // (no shell) so metacharacters cannot be interpreted.
+        let remote;
+        let targetRef;
         const streamBranch = `stream/${p.stream_id}`;
-        const targetRef = p.target_ref ?? streamBranch;
         try {
-            const { execSync } = require('child_process');
-            execSync(`git push ${remote} ${streamBranch}:refs/heads/${targetRef}`, {
+            remote = assertSafeGitRef(p.remote ?? 'origin', 'remote');
+            targetRef = assertSafeGitRef(p.target_ref ?? streamBranch, 'target_ref');
+        }
+        catch (err) {
+            if (err instanceof GitInputError)
+                return; // reject unsafe push silently
+            throw err;
+        }
+        try {
+            execFileSync('git', ['push', '--', remote, `${streamBranch}:refs/heads/${targetRef}`], {
                 cwd: worktreePath,
                 stdio: 'pipe',
                 encoding: 'utf-8',
@@ -128,7 +142,7 @@ export function setupCascadeActionHandlers(connection, adapter) {
             adapter.notifyStreamPushed?.({
                 streamId: p.stream_id,
                 agentId: 'hub-request',
-                pushedCommit: execSync('git rev-parse HEAD', {
+                pushedCommit: execFileSync('git', ['rev-parse', 'HEAD'], {
                     cwd: worktreePath,
                     encoding: 'utf-8',
                 }).trim(),

package/dist/map/cascade-action-handler.js.map

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

package/dist/map/federation/envelope.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Federation Envelope Handling
+ *
+ * Wraps and unwraps messages for cross-system federation communication.
+ * The envelope adds metadata needed for routing and tracing across systems.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import type { SystemId } from "../types.js";
+/**
+ * Federation metadata attached to cross-system messages.
+ */
+export interface FederationMetadata {
+    /** Source system identifier */
+    sourceSystem: SystemId;
+    /** Target system identifier */
+    targetSystem: SystemId;
+    /** Unix timestamp when envelope was created */
+    timestamp: number;
+    /** Optional correlation ID for request/response tracking */
+    correlationId?: string;
+}
+/**
+ * Federation envelope wrapping a message for cross-system transport.
+ */
+export interface FederationEnvelope<T = unknown> {
+    /** The wrapped message payload */
+    message: T;
+    /** Federation routing metadata */
+    federation: FederationMetadata;
+}
+/**
+ * Wrap a message in a federation envelope.
+ *
+ * @param message - The message to wrap
+ * @param sourceSystem - The source system identifier
+ * @param targetSystem - The target system identifier
+ * @param options - Optional envelope options
+ * @returns The wrapped envelope
+ */
+export declare function wrapMessage<T>(message: T, sourceSystem: SystemId, targetSystem: SystemId, options?: {
+    correlationId?: string;
+    timestamp?: number;
+}): FederationEnvelope<T>;
+/**
+ * Unwrap a message from a federation envelope.
+ *
+ * @param envelope - The envelope to unwrap
+ * @returns The unwrapped message
+ */
+export declare function unwrapMessage<T>(envelope: FederationEnvelope<T>): T;
+/**
+ * Get the federation metadata from an envelope.
+ *
+ * @param envelope - The envelope
+ * @returns The federation metadata
+ */
+export declare function getMetadata(envelope: FederationEnvelope): FederationMetadata;
+/**
+ * Check if an object is a valid federation envelope.
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a valid federation envelope
+ */
+export declare function isEnvelope(obj: unknown): obj is FederationEnvelope;
+/**
+ * Validate envelope metadata.
+ *
+ * @param envelope - The envelope to validate
+ * @returns Array of validation errors, empty if valid
+ */
+export declare function validateEnvelope(envelope: FederationEnvelope): string[];
+/**
+ * Create a response envelope from a request envelope.
+ * Swaps source and target systems.
+ *
+ * @param requestEnvelope - The original request envelope
+ * @param responseMessage - The response message
+ * @returns A new envelope for the response
+ */
+export declare function createResponseEnvelope<T>(requestEnvelope: FederationEnvelope, responseMessage: T): FederationEnvelope<T>;
+/**
+ * Check if an envelope is a response to a request.
+ *
+ * @param request - The request envelope
+ * @param response - The potential response envelope
+ * @returns True if response matches the request
+ */
+export declare function isResponseTo(request: FederationEnvelope, response: FederationEnvelope): boolean;
+/**
+ * Get age of an envelope in milliseconds.
+ *
+ * @param envelope - The envelope
+ * @param now - Current timestamp (defaults to Date.now())
+ * @returns Age in milliseconds
+ */
+export declare function getEnvelopeAge(envelope: FederationEnvelope, now?: number): number;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/map/federation/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/map/federation/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,YAAY,EAAE,QAAQ,CAAC;IAEvB,+BAA+B;IAC/B,YAAY,EAAE,QAAQ,CAAC;IAEvB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAElB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,kCAAkC;IAClC,OAAO,EAAE,CAAC,CAAC;IAEX,kCAAkC;IAClC,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,CAAC,EACV,YAAY,EAAE,QAAQ,EACtB,YAAY,EAAE,QAAQ,EACtB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,kBAAkB,CAAC,CAAC,CAAC,CAUvB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB,CAE5E;AAMD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,kBAAkB,CAuClE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAsBvE;AAMD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,eAAe,EAAE,kBAAkB,EACnC,eAAe,EAAE,CAAC,GACjB,kBAAkB,CAAC,CAAC,CAAC,CASvB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAeT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,GAAE,MAAmB,GACvB,MAAM,CAER"}

package/dist/map/federation/envelope.js

@@ -0,0 +1,160 @@
+/**
+ * Federation Envelope Handling
+ *
+ * Wraps and unwraps messages for cross-system federation communication.
+ * The envelope adds metadata needed for routing and tracing across systems.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+// =============================================================================
+// Envelope Functions
+// =============================================================================
+/**
+ * Wrap a message in a federation envelope.
+ *
+ * @param message - The message to wrap
+ * @param sourceSystem - The source system identifier
+ * @param targetSystem - The target system identifier
+ * @param options - Optional envelope options
+ * @returns The wrapped envelope
+ */
+export function wrapMessage(message, sourceSystem, targetSystem, options) {
+    return {
+        message,
+        federation: {
+            sourceSystem,
+            targetSystem,
+            timestamp: options?.timestamp ?? Date.now(),
+            ...(options?.correlationId && { correlationId: options.correlationId }),
+        },
+    };
+}
+/**
+ * Unwrap a message from a federation envelope.
+ *
+ * @param envelope - The envelope to unwrap
+ * @returns The unwrapped message
+ */
+export function unwrapMessage(envelope) {
+    return envelope.message;
+}
+/**
+ * Get the federation metadata from an envelope.
+ *
+ * @param envelope - The envelope
+ * @returns The federation metadata
+ */
+export function getMetadata(envelope) {
+    return envelope.federation;
+}
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Check if an object is a valid federation envelope.
+ *
+ * @param obj - The object to check
+ * @returns True if the object is a valid federation envelope
+ */
+export function isEnvelope(obj) {
+    if (typeof obj !== "object" || obj === null) {
+        return false;
+    }
+    const envelope = obj;
+    // Must have message property
+    if (!("message" in envelope)) {
+        return false;
+    }
+    // Must have federation metadata
+    if (!("federation" in envelope) || typeof envelope.federation !== "object") {
+        return false;
+    }
+    const federation = envelope.federation;
+    // Required federation fields
+    if (typeof federation.sourceSystem !== "string") {
+        return false;
+    }
+    if (typeof federation.targetSystem !== "string") {
+        return false;
+    }
+    if (typeof federation.timestamp !== "number") {
+        return false;
+    }
+    // Optional correlationId must be string if present
+    if ("correlationId" in federation &&
+        typeof federation.correlationId !== "string") {
+        return false;
+    }
+    return true;
+}
+/**
+ * Validate envelope metadata.
+ *
+ * @param envelope - The envelope to validate
+ * @returns Array of validation errors, empty if valid
+ */
+export function validateEnvelope(envelope) {
+    const errors = [];
+    if (!envelope.federation.sourceSystem) {
+        errors.push("sourceSystem is required");
+    }
+    if (!envelope.federation.targetSystem) {
+        errors.push("targetSystem is required");
+    }
+    if (typeof envelope.federation.timestamp !== "number") {
+        errors.push("timestamp must be a number");
+    }
+    else if (envelope.federation.timestamp <= 0) {
+        errors.push("timestamp must be positive");
+    }
+    if (envelope.federation.sourceSystem === envelope.federation.targetSystem) {
+        errors.push("sourceSystem and targetSystem cannot be the same");
+    }
+    return errors;
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Create a response envelope from a request envelope.
+ * Swaps source and target systems.
+ *
+ * @param requestEnvelope - The original request envelope
+ * @param responseMessage - The response message
+ * @returns A new envelope for the response
+ */
+export function createResponseEnvelope(requestEnvelope, responseMessage) {
+    return wrapMessage(responseMessage, requestEnvelope.federation.targetSystem, requestEnvelope.federation.sourceSystem, {
+        correlationId: requestEnvelope.federation.correlationId,
+    });
+}
+/**
+ * Check if an envelope is a response to a request.
+ *
+ * @param request - The request envelope
+ * @param response - The potential response envelope
+ * @returns True if response matches the request
+ */
+export function isResponseTo(request, response) {
+    // Systems must be swapped
+    if (response.federation.sourceSystem !== request.federation.targetSystem ||
+        response.federation.targetSystem !== request.federation.sourceSystem) {
+        return false;
+    }
+    // If request had correlationId, response must match
+    if (request.federation.correlationId) {
+        return response.federation.correlationId === request.federation.correlationId;
+    }
+    return true;
+}
+/**
+ * Get age of an envelope in milliseconds.
+ *
+ * @param envelope - The envelope
+ * @param now - Current timestamp (defaults to Date.now())
+ * @returns Age in milliseconds
+ */
+export function getEnvelopeAge(envelope, now = Date.now()) {
+    return now - envelope.federation.timestamp;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/map/federation/envelope.js.map

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

package/dist/map/federation/federation-handler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * FederationHandler - MAP Federation Implementation
+ *
+ * Wraps the existing PeerManager infrastructure with MAP semantics,
+ * providing cross-system communication capabilities.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import type { PeerManager } from "../../peer/peer-manager.js";
+import type { PeerMessage, PeerRequest, PeerResponse } from "../../peer/types.js";
+import type { SystemId, FederatedAddress } from "../types.js";
+import type { FederationHandler, MAPFederationConfig, FederationCapabilities } from "./types.js";
+/**
+ * Create a FederationHandler instance.
+ *
+ * @param peerManager - The PeerManager to use for transport
+ * @param config - Federation configuration
+ * @returns FederationHandler instance
+ */
+export declare function createFederationHandler(peerManager: PeerManager, config: MAPFederationConfig): FederationHandler;
+/**
+ * Convert a federated address to a peer address.
+ *
+ * @param address - The federated address
+ * @returns The peer address string
+ */
+export declare function federatedAddressToPeerAddress(address: FederatedAddress): string;
+/**
+ * Extract the system ID from a federated address.
+ *
+ * @param address - The federated address
+ * @returns The system ID
+ */
+export declare function getSystemFromAddress(address: FederatedAddress): SystemId;
+/**
+ * Create a capability exchange request handler.
+ * This should be registered with PeerManager to handle incoming capability requests.
+ *
+ * @param localCapabilities - This system's capabilities
+ * @returns Handler function
+ */
+export declare function createCapabilityExchangeHandler(localCapabilities: FederationCapabilities): (request: PeerRequest) => PeerResponse;
+/**
+ * Unwrap a federated message from a peer message.
+ *
+ * @param message - The peer message
+ * @returns The unwrapped message or null if not a federated message
+ */
+export declare function unwrapFederatedMessage(message: PeerMessage): unknown | null;
+//# sourceMappingURL=federation-handler.d.ts.map

package/dist/map/federation/federation-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-handler.d.ts","sourceRoot":"","sources":["../../../src/map/federation/federation-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAiB,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EAEnB,sBAAsB,EAKvB,MAAM,YAAY,CAAC;AAkBpB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,mBAAmB,GAC1B,iBAAiB,CAmUnB;AAMD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAM/E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAExE;AAMD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,iBAAiB,EAAE,sBAAsB,GACxC,CAAC,OAAO,EAAE,WAAW,KAAK,YAAY,CAOxC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,GAAG,IAAI,CAU3E"}