macro-agent 0.2.4 → 0.2.6

package/dist/map/federation/federation-handler.js

@@ -0,0 +1,306 @@
+/**
+ * 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 { isFederatedAgentAddress } from "../types.js";
+import { FederationError } from "./types.js";
+import { wrapMessage, unwrapMessage, isEnvelope } from "./envelope.js";
+// =============================================================================
+// Constants
+// =============================================================================
+/** Protocol method for capability exchange */
+const CAPABILITY_EXCHANGE_METHOD = "_federation/capabilities";
+/** Protocol method for federated messages */
+const FEDERATED_MESSAGE_TYPE = "_federation/message";
+// =============================================================================
+// Implementation
+// =============================================================================
+/**
+ * Create a FederationHandler instance.
+ *
+ * @param peerManager - The PeerManager to use for transport
+ * @param config - Federation configuration
+ * @returns FederationHandler instance
+ */
+export function createFederationHandler(peerManager, config) {
+    // State
+    const peers = new Map();
+    const eventHandlers = new Set();
+    // Build local capabilities from config
+    const localCapabilities = {
+        systemId: config.systemId,
+        systemInfo: config.systemInfo,
+        messaging: { canSend: true, canReceive: true },
+        lifecycle: { canSpawn: false, canStop: false },
+        query: { canListAgents: true, canGetAgent: true, canQueryHierarchy: true },
+        extensions: ["_macro/task/*", "_macro/wake", "_macro/workspace/info"],
+    };
+    // ==========================================================================
+    // Event Emission
+    // ==========================================================================
+    function emit(event) {
+        for (const handler of eventHandlers) {
+            try {
+                handler(event);
+            }
+            catch (err) {
+                console.error("[federation] Event handler error:", err);
+            }
+        }
+    }
+    // ==========================================================================
+    // Peer Management
+    // ==========================================================================
+    function updatePeerStatus(systemId, status, error) {
+        const peer = peers.get(systemId);
+        if (peer) {
+            peer.status = status;
+            peer.lastActivityAt = Date.now();
+            if (error) {
+                peer.error = error;
+            }
+            else {
+                delete peer.error;
+            }
+        }
+    }
+    // ==========================================================================
+    // FederationHandler Implementation
+    // ==========================================================================
+    async function connect(peerConfig) {
+        if (!config.enabled) {
+            throw new FederationError("Federation is not enabled", "FEDERATION_DISABLED");
+        }
+        const { systemId } = peerConfig;
+        // Check if already connected
+        const existing = peers.get(systemId);
+        if (existing && existing.status === "connected") {
+            throw new FederationError(`Already connected to ${systemId}`, "PEER_ALREADY_CONNECTED", systemId);
+        }
+        // Emit connecting event
+        emit({
+            type: "peer:connecting",
+            systemId,
+            timestamp: Date.now(),
+        });
+        // Create initial peer state
+        const peer = {
+            systemId,
+            capabilities: {
+                systemId,
+                messaging: { canSend: false, canReceive: false },
+                lifecycle: { canSpawn: false, canStop: false },
+                query: { canListAgents: false, canGetAgent: false, canQueryHierarchy: false },
+                extensions: [],
+            },
+            status: "connecting",
+            connectedAt: Date.now(),
+            lastActivityAt: Date.now(),
+        };
+        peers.set(systemId, peer);
+        try {
+            // Exchange capabilities with peer
+            const response = await peerManager.sendRequest(config.systemId, systemId, {
+                method: CAPABILITY_EXCHANGE_METHOD,
+                params: localCapabilities,
+            });
+            if (response.error) {
+                throw new FederationError(response.error.message, "CONNECTION_FAILED", systemId);
+            }
+            // Parse peer capabilities from response
+            const peerCapabilities = response.result;
+            // Update peer state
+            peer.capabilities = peerCapabilities;
+            peer.status = "connected";
+            peer.lastActivityAt = Date.now();
+            // Emit connected event
+            emit({
+                type: "peer:connected",
+                systemId,
+                timestamp: Date.now(),
+                capabilities: peerCapabilities,
+            });
+            return peerCapabilities;
+        }
+        catch (err) {
+            // Update peer state on error
+            updatePeerStatus(systemId, "error", err instanceof Error ? err.message : "Unknown error");
+            // Emit error event
+            emit({
+                type: "peer:error",
+                systemId,
+                timestamp: Date.now(),
+                error: err instanceof Error ? err.message : "Unknown error",
+            });
+            // Clean up on failure
+            peers.delete(systemId);
+            if (err instanceof FederationError) {
+                throw err;
+            }
+            throw new FederationError(`Failed to connect to ${systemId}: ${err instanceof Error ? err.message : "Unknown error"}`, "CONNECTION_FAILED", systemId);
+        }
+    }
+    async function disconnect(systemId) {
+        const peer = peers.get(systemId);
+        if (!peer) {
+            throw new FederationError(`Not connected to ${systemId}`, "PEER_NOT_FOUND", systemId);
+        }
+        // Update status
+        updatePeerStatus(systemId, "disconnecting");
+        // Remove peer
+        peers.delete(systemId);
+        // Emit disconnected event
+        emit({
+            type: "peer:disconnected",
+            systemId,
+            timestamp: Date.now(),
+            reason: "Manual disconnect",
+        });
+    }
+    function getPeer(systemId) {
+        return peers.get(systemId);
+    }
+    function listPeers() {
+        return Array.from(peers.values());
+    }
+    function getCapabilities(systemId) {
+        const peer = peers.get(systemId);
+        return peer?.capabilities;
+    }
+    function isConnected(systemId) {
+        const peer = peers.get(systemId);
+        return peer?.status === "connected";
+    }
+    async function sendMessage(systemId, message) {
+        if (!config.enabled) {
+            throw new FederationError("Federation is not enabled", "FEDERATION_DISABLED");
+        }
+        const peer = peers.get(systemId);
+        if (!peer) {
+            throw new FederationError(`Not connected to ${systemId}`, "PEER_NOT_FOUND", systemId);
+        }
+        if (peer.status !== "connected") {
+            throw new FederationError(`Peer ${systemId} is not connected (status: ${peer.status})`, "PEER_NOT_CONNECTED", systemId);
+        }
+        // Wrap message in federation envelope
+        const envelope = wrapMessage(message, config.systemId, systemId);
+        // Send via PeerManager
+        await peerManager.sendMessage(config.systemId, systemId, {
+            type: FEDERATED_MESSAGE_TYPE,
+            payload: envelope,
+        });
+        // Update activity timestamp
+        peer.lastActivityAt = Date.now();
+    }
+    async function sendRequest(systemId, method, params) {
+        if (!config.enabled) {
+            throw new FederationError("Federation is not enabled", "FEDERATION_DISABLED");
+        }
+        const peer = peers.get(systemId);
+        if (!peer) {
+            throw new FederationError(`Not connected to ${systemId}`, "PEER_NOT_FOUND", systemId);
+        }
+        if (peer.status !== "connected") {
+            throw new FederationError(`Peer ${systemId} is not connected (status: ${peer.status})`, "PEER_NOT_CONNECTED", systemId);
+        }
+        // Send request via PeerManager
+        const response = await peerManager.sendRequest(config.systemId, systemId, { method, params });
+        // Update activity timestamp
+        peer.lastActivityAt = Date.now();
+        if (response.error) {
+            throw new FederationError(response.error.message, "CAPABILITY_DENIED", systemId);
+        }
+        return response.result;
+    }
+    function on(handler) {
+        eventHandlers.add(handler);
+        return () => {
+            eventHandlers.delete(handler);
+        };
+    }
+    function getConfig() {
+        return config;
+    }
+    function getLocalCapabilities() {
+        return localCapabilities;
+    }
+    // ==========================================================================
+    // Return Handler
+    // ==========================================================================
+    return {
+        connect,
+        disconnect,
+        getPeer,
+        listPeers,
+        getCapabilities,
+        isConnected,
+        sendMessage,
+        sendRequest,
+        on,
+        getConfig,
+        getLocalCapabilities,
+    };
+}
+// =============================================================================
+// Address Utilities
+// =============================================================================
+/**
+ * Convert a federated address to a peer address.
+ *
+ * @param address - The federated address
+ * @returns The peer address string
+ */
+export function federatedAddressToPeerAddress(address) {
+    if (isFederatedAgentAddress(address)) {
+        return `${address.system}/${address.agent}`;
+    }
+    // For scope addresses (or any other federated address), route to the system root
+    return address.system;
+}
+/**
+ * Extract the system ID from a federated address.
+ *
+ * @param address - The federated address
+ * @returns The system ID
+ */
+export function getSystemFromAddress(address) {
+    return address.system;
+}
+// =============================================================================
+// Message Handling Utilities
+// =============================================================================
+/**
+ * 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 function createCapabilityExchangeHandler(localCapabilities) {
+    return (request) => {
+        if (request.method === CAPABILITY_EXCHANGE_METHOD) {
+            return { result: localCapabilities };
+        }
+        return { error: { code: -32601, message: "Method not found" } };
+    };
+}
+/**
+ * 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 function unwrapFederatedMessage(message) {
+    if (message.type !== FEDERATED_MESSAGE_TYPE) {
+        return null;
+    }
+    if (!isEnvelope(message.payload)) {
+        return null;
+    }
+    return unwrapMessage(message.payload);
+}
+//# sourceMappingURL=federation-handler.js.map

package/dist/map/federation/federation-handler.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * MAP Federation Module
+ *
+ * Provides federation capabilities for cross-system communication
+ * between MAP-compliant systems.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+export type { MAPPeerConfig, MAPFederationConfig, MessagingCapabilities, LifecycleCapabilities, QueryCapabilities, FederationCapabilities, PeerConnectionStatus, ConnectedPeer, FederationEventType, FederationEventBase, PeerConnectingEvent, PeerConnectedEvent, PeerDisconnectedEvent, PeerErrorEvent, PeerCapabilitiesUpdatedEvent, FederationEvent, FederationEventHandler, FederationHandler, FederationErrorCode, } from "./types.js";
+export { FederationError } from "./types.js";
+export type { FederationMetadata, FederationEnvelope, } from "./envelope.js";
+export { wrapMessage, unwrapMessage, getMetadata, isEnvelope, validateEnvelope, createResponseEnvelope, isResponseTo, getEnvelopeAge, } from "./envelope.js";
+export { createFederationHandler, federatedAddressToPeerAddress, getSystemFromAddress, createCapabilityExchangeHandler, unwrapFederatedMessage, } from "./federation-handler.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/map/federation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAEV,aAAa,EACb,mBAAmB,EAEnB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EAEtB,oBAAoB,EACpB,aAAa,EAEb,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,4BAA4B,EAC5B,eAAe,EACf,sBAAsB,EAEtB,iBAAiB,EAEjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,oBAAoB,EACpB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}

package/dist/map/federation/index.js

@@ -0,0 +1,13 @@
+/**
+ * MAP Federation Module
+ *
+ * Provides federation capabilities for cross-system communication
+ * between MAP-compliant systems.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+export { FederationError } from "./types.js";
+export { wrapMessage, unwrapMessage, getMetadata, isEnvelope, validateEnvelope, createResponseEnvelope, isResponseTo, getEnvelopeAge, } from "./envelope.js";
+// Federation handler
+export { createFederationHandler, federatedAddressToPeerAddress, getSystemFromAddress, createCapabilityExchangeHandler, unwrapFederatedMessage, } from "./federation-handler.js";
+//# sourceMappingURL=index.js.map

package/dist/map/federation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/map/federation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ7C,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,oBAAoB,EACpB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,239 @@
+/**
+ * MAP Federation Types
+ *
+ * Types for cross-system federation between MAP-compliant systems.
+ * Federation enables macro-agent instances to communicate with each other
+ * and with other MAP systems.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+import type { SystemId } from "../types.js";
+/**
+ * Configuration for a federated peer system.
+ */
+export interface MAPPeerConfig {
+    /** System identifier of the peer */
+    systemId: SystemId;
+    /** WebSocket endpoint URL for the peer */
+    endpoint: string;
+    /** Whether to connect automatically on startup (default: false) */
+    autoConnect?: boolean;
+    /** Authentication configuration */
+    auth?: {
+        method: "bearer" | "api-key" | "mutual-tls";
+        credentials: unknown;
+    };
+}
+/**
+ * Configuration for MAP federation.
+ */
+export interface MAPFederationConfig {
+    /** Whether federation is enabled */
+    enabled: boolean;
+    /** This system's identifier (e.g., "example.com/macro-agent/prod-east") */
+    systemId: SystemId;
+    /** System metadata for capability advertisement */
+    systemInfo?: {
+        /** Human-readable system name */
+        name?: string;
+        /** System version */
+        version?: string;
+    };
+    /** Pre-configured peer systems */
+    peers?: MAPPeerConfig[];
+}
+/**
+ * Messaging capabilities advertised by a system.
+ */
+export interface MessagingCapabilities {
+    /** Can send messages to this system */
+    canSend: boolean;
+    /** Can receive messages from this system */
+    canReceive: boolean;
+}
+/**
+ * Lifecycle capabilities advertised by a system.
+ */
+export interface LifecycleCapabilities {
+    /** Can spawn agents in this system */
+    canSpawn: boolean;
+    /** Can stop agents in this system */
+    canStop: boolean;
+}
+/**
+ * Query capabilities advertised by a system.
+ */
+export interface QueryCapabilities {
+    /** Can list agents in this system */
+    canListAgents: boolean;
+    /** Can query agent details */
+    canGetAgent: boolean;
+    /** Can query hierarchy */
+    canQueryHierarchy: boolean;
+}
+/**
+ * Capabilities advertised by a federated system.
+ * Exchanged during federation connection establishment.
+ */
+export interface FederationCapabilities {
+    /** System identifier */
+    systemId: SystemId;
+    /** System metadata */
+    systemInfo?: {
+        name?: string;
+        version?: string;
+    };
+    /** Messaging capabilities */
+    messaging: MessagingCapabilities;
+    /** Agent lifecycle capabilities */
+    lifecycle: LifecycleCapabilities;
+    /** Query capabilities */
+    query: QueryCapabilities;
+    /** Supported extension methods (e.g., ["_macro/task/*", "_macro/wake"]) */
+    extensions: string[];
+}
+/**
+ * Connection status for a federated peer.
+ */
+export type PeerConnectionStatus = "connecting" | "connected" | "disconnecting" | "disconnected" | "error";
+/**
+ * State of a connected federated peer.
+ */
+export interface ConnectedPeer {
+    /** System identifier of the peer */
+    systemId: SystemId;
+    /** Peer's advertised capabilities */
+    capabilities: FederationCapabilities;
+    /** Connection status */
+    status: PeerConnectionStatus;
+    /** Timestamp when connection was established */
+    connectedAt: number;
+    /** Last activity timestamp */
+    lastActivityAt: number;
+    /** Error message if status is "error" */
+    error?: string;
+}
+/**
+ * Events emitted by the federation handler.
+ */
+export type FederationEventType = "peer:connecting" | "peer:connected" | "peer:disconnected" | "peer:error" | "peer:capabilities_updated";
+/**
+ * Base federation event.
+ */
+export interface FederationEventBase {
+    type: FederationEventType;
+    systemId: SystemId;
+    timestamp: number;
+}
+/**
+ * Peer connecting event.
+ */
+export interface PeerConnectingEvent extends FederationEventBase {
+    type: "peer:connecting";
+}
+/**
+ * Peer connected event.
+ */
+export interface PeerConnectedEvent extends FederationEventBase {
+    type: "peer:connected";
+    capabilities: FederationCapabilities;
+}
+/**
+ * Peer disconnected event.
+ */
+export interface PeerDisconnectedEvent extends FederationEventBase {
+    type: "peer:disconnected";
+    reason?: string;
+}
+/**
+ * Peer error event.
+ */
+export interface PeerErrorEvent extends FederationEventBase {
+    type: "peer:error";
+    error: string;
+}
+/**
+ * Peer capabilities updated event.
+ */
+export interface PeerCapabilitiesUpdatedEvent extends FederationEventBase {
+    type: "peer:capabilities_updated";
+    capabilities: FederationCapabilities;
+}
+/**
+ * Union of all federation events.
+ */
+export type FederationEvent = PeerConnectingEvent | PeerConnectedEvent | PeerDisconnectedEvent | PeerErrorEvent | PeerCapabilitiesUpdatedEvent;
+/**
+ * Handler for federation events.
+ */
+export type FederationEventHandler = (event: FederationEvent) => void;
+/**
+ * Interface for federation handling.
+ * Wraps the lower-level PeerManager with MAP semantics.
+ */
+export interface FederationHandler {
+    /**
+     * Connect to a federated peer system.
+     * @param config - Peer configuration
+     * @returns Peer's capabilities on successful connection
+     */
+    connect(config: MAPPeerConfig): Promise<FederationCapabilities>;
+    /**
+     * Disconnect from a federated peer.
+     * @param systemId - System identifier of the peer
+     */
+    disconnect(systemId: SystemId): Promise<void>;
+    /**
+     * Get a connected peer by system ID.
+     * @param systemId - System identifier
+     */
+    getPeer(systemId: SystemId): ConnectedPeer | undefined;
+    /**
+     * List all connected peers.
+     */
+    listPeers(): ConnectedPeer[];
+    /**
+     * Get capabilities of a connected peer.
+     * @param systemId - System identifier
+     */
+    getCapabilities(systemId: SystemId): FederationCapabilities | undefined;
+    /**
+     * Check if a peer is connected.
+     * @param systemId - System identifier
+     */
+    isConnected(systemId: SystemId): boolean;
+    /**
+     * Send a message to a federated system.
+     * Used internally by MessageRouter for federated addresses.
+     */
+    sendMessage(systemId: SystemId, message: unknown): Promise<void>;
+    /**
+     * Send a request to a federated system and wait for response.
+     */
+    sendRequest(systemId: SystemId, method: string, params?: unknown): Promise<unknown>;
+    /**
+     * Subscribe to federation events.
+     */
+    on(handler: FederationEventHandler): () => void;
+    /**
+     * Get this system's configuration.
+     */
+    getConfig(): MAPFederationConfig;
+    /**
+     * Get this system's capabilities (for advertisement).
+     */
+    getLocalCapabilities(): FederationCapabilities;
+}
+/**
+ * Error codes for federation operations.
+ */
+export type FederationErrorCode = "PEER_NOT_FOUND" | "PEER_NOT_CONNECTED" | "PEER_ALREADY_CONNECTED" | "CONNECTION_FAILED" | "CONNECTION_TIMEOUT" | "CAPABILITY_DENIED" | "INVALID_SYSTEM_ID" | "FEDERATION_DISABLED";
+/**
+ * Error thrown by federation operations.
+ */
+export declare class FederationError extends Error {
+    readonly code: FederationErrorCode;
+    readonly systemId?: SystemId | undefined;
+    constructor(message: string, code: FederationErrorCode, systemId?: SystemId | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/map/federation/types.js

@@ -0,0 +1,23 @@
+/**
+ * MAP Federation Types
+ *
+ * Types for cross-system federation between MAP-compliant systems.
+ * Federation enables macro-agent instances to communicate with each other
+ * and with other MAP systems.
+ *
+ * @see specs/s-5qir_map_integration_for_macro_agent.md
+ */
+/**
+ * Error thrown by federation operations.
+ */
+export class FederationError extends Error {
+    code;
+    systemId;
+    constructor(message, code, systemId) {
+        super(message);
+        this.code = code;
+        this.systemId = systemId;
+        this.name = "FederationError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/map/federation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/map/federation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmUH;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGtB;IACA;IAHlB,YACE,OAAe,EACC,IAAyB,EACzB,QAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAqB;QACzB,aAAQ,GAAR,QAAQ,CAAW;QAGnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/map/mail-bridge.d.ts

@@ -13,6 +13,13 @@
  *   2. The classifier recognizes `x-dispatch/work` schema and routes the
  *      prompt to a worker agent (existing or freshly spawned).
  *
+ * Turns that aren't structured `x-dispatch/work` envelopes (e.g.
+ * natural-language spec-discussion replies) are delivered into the inbox as
+ * plain-text messages instead of being dropped. The classifier won't match
+ * them (so no worker spawns), but the delivery still wakes the agent via
+ * TriggerSystemV2 (importance → wake action) so it reads the reply on its
+ * next turn.
+ *
  * Without this bridge, hub-side mail turns never reach macro-agent's
  * dispatcher. The MessagePort is wired to local inbox events only.
  */

package/dist/map/mail-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail-bridge.d.ts","sourceRoot":"","sources":["../../src/map/mail-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,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;AA0DD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,oBAAoB,CAAC;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,MAAM,IAAI,CAAC,CA8FrB"}
+{"version":3,"file":"mail-bridge.d.ts","sourceRoot":"","sources":["../../src/map/mail-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,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;AA0DD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,oBAAoB,CAAC;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,MAAM,IAAI,CAAC,CAuIrB"}