@supernal/interface 1.0.0

package/dist/cjs/names/index.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Names Index - Export all name contracts
+ *
+ * This is the main entry point for importing name contracts.
+ * Components, services, and utilities import from this file to reference
+ * stable IDs before tools are generated.
+ *
+ * @example
+ * import { Components, API, Functions } from '@supernal-interface/core/names';
+ *
+ * // Use hierarchical names in components
+ * <button data-testid={Components.Chat.sendButton}>Send</button>
+ *
+ * // Use in @Tool decorators
+ * @Tool({ toolId: Components.Chat.sendButton })
+ * async handleSendClick() { ... }
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Names = void 0;
+exports.validateAllNames = validateAllNames;
+exports.getNameStats = getNameStats;
+__exportStar(require("./Components"), exports);
+__exportStar(require("./Containers"), exports);
+__exportStar(require("./API"), exports);
+__exportStar(require("./Functions"), exports);
+const Components_1 = require("./Components");
+const Containers_1 = require("./Containers");
+const API_1 = require("./API");
+const Functions_1 = require("./Functions");
+/**
+ * Validate all name contracts for uniqueness
+ */
+function validateAllNames() {
+    const errors = [];
+    // Validate component IDs
+    const componentValidation = (0, Components_1.validateComponentIds)();
+    if (!componentValidation.valid) {
+        errors.push(`Duplicate component IDs: ${componentValidation.duplicates.join(', ')}`);
+    }
+    // Validate container IDs
+    const containerValidation = (0, Containers_1.validateContainerIds)();
+    if (!containerValidation.valid) {
+        errors.push(`Duplicate container IDs: ${containerValidation.duplicates.join(', ')}`);
+    }
+    // Validate API IDs
+    const apiValidation = (0, API_1.validateAPIIds)();
+    if (!apiValidation.valid) {
+        errors.push(`Duplicate API IDs: ${apiValidation.duplicates.join(', ')}`);
+    }
+    // Validate function IDs
+    const functionValidation = (0, Functions_1.validateFunctionIds)();
+    if (!functionValidation.valid) {
+        errors.push(`Duplicate function IDs: ${functionValidation.duplicates.join(', ')}`);
+    }
+    // Check for cross-category duplicates
+    const allIds = [
+        ...(0, Components_1.getAllComponentIds)(),
+        ...(0, Containers_1.getAllContainerIds)(),
+        ...(0, API_1.getAllAPIIds)(),
+        ...(0, Functions_1.getAllFunctionIds)(),
+    ];
+    const seen = new Set();
+    const crossDuplicates = [];
+    for (const id of allIds) {
+        if (seen.has(id)) {
+            crossDuplicates.push(id);
+        }
+        else {
+            seen.add(id);
+        }
+    }
+    if (crossDuplicates.length > 0) {
+        errors.push(`Cross-category duplicate IDs: ${crossDuplicates.join(', ')}`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Get statistics about name contracts
+ */
+function getNameStats() {
+    return {
+        components: (0, Components_1.getAllComponentIds)().length,
+        containers: (0, Containers_1.getAllContainerIds)().length,
+        api: (0, API_1.getAllAPIIds)().length,
+        functions: (0, Functions_1.getAllFunctionIds)().length,
+        total: (0, Components_1.getAllComponentIds)().length + (0, Containers_1.getAllContainerIds)().length + (0, API_1.getAllAPIIds)().length + (0, Functions_1.getAllFunctionIds)().length,
+    };
+}
+/**
+ * Export namespace for convenient access
+ */
+exports.Names = {
+    Components: Components_1.Components,
+    Containers: Containers_1.Containers,
+    API: API_1.API,
+    Functions: Functions_1.Functions,
+    validate: validateAllNames,
+    stats: getNameStats,
+};
+//# sourceMappingURL=index.js.map

package/dist/cjs/names/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../names/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;;;;;;;;AAeH,4CAyDC;AAKD,oCAQC;AAnFD,+CAA6B;AAC7B,+CAA6B;AAC7B,wCAAsB;AACtB,8CAA4B;AAE5B,6CAAoF;AACpF,6CAAoF;AACpF,+BAA0D;AAC1D,2CAAgF;AAEhF;;GAEG;AACH,SAAgB,gBAAgB;IAI9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,yBAAyB;IACzB,MAAM,mBAAmB,GAAG,IAAA,iCAAoB,GAAE,CAAC;IACnD,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,4BAA4B,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,yBAAyB;IACzB,MAAM,mBAAmB,GAAG,IAAA,iCAAoB,GAAE,CAAC;IACnD,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,4BAA4B,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,mBAAmB;IACnB,MAAM,aAAa,GAAG,IAAA,oBAAc,GAAE,CAAC;IACvC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,sBAAsB,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,wBAAwB;IACxB,MAAM,kBAAkB,GAAG,IAAA,+BAAmB,GAAE,CAAC;IACjD,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,2BAA2B,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,sCAAsC;IACtC,MAAM,MAAM,GAAG;QACb,GAAG,IAAA,+BAAkB,GAAE;QACvB,GAAG,IAAA,+BAAkB,GAAE;QACvB,GAAG,IAAA,kBAAY,GAAE;QACjB,GAAG,IAAA,6BAAiB,GAAE;KACvB,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,iCAAiC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO;QACL,UAAU,EAAE,IAAA,+BAAkB,GAAE,CAAC,MAAM;QACvC,UAAU,EAAE,IAAA,+BAAkB,GAAE,CAAC,MAAM;QACvC,GAAG,EAAE,IAAA,kBAAY,GAAE,CAAC,MAAM;QAC1B,SAAS,EAAE,IAAA,6BAAiB,GAAE,CAAC,MAAM;QACrC,KAAK,EAAE,IAAA,+BAAkB,GAAE,CAAC,MAAM,GAAG,IAAA,+BAAkB,GAAE,CAAC,MAAM,GAAG,IAAA,kBAAY,GAAE,CAAC,MAAM,GAAG,IAAA,6BAAiB,GAAE,CAAC,MAAM;KACtH,CAAC;AACJ,CAAC;AAED;;GAEG;AACU,QAAA,KAAK,GAAG;IACnB,UAAU,EAAV,uBAAU;IACV,UAAU,EAAV,uBAAU;IACV,GAAG,EAAH,SAAG;IACH,SAAS,EAAT,qBAAS;IACT,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,YAAY;CACX,CAAC"}

package/dist/cjs/src/adapters/ChatUIProvider.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Chat UI Provider
+ *
+ * React context that manages the active chat adapter and provides
+ * automatic tool/state bridging to any chat UI library.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatUI = useChatUI;
+exports.useChatUIOptional = useChatUIOptional;
+exports.ChatUIProvider = ChatUIProvider;
+exports.ChatUI = ChatUI;
+exports.withChatUI = withChatUI;
+const react_1 = __importStar(require("react"));
+const ToolRegistry_1 = require("../background/registry/ToolRegistry");
+const ChatUIContext = (0, react_1.createContext)(null);
+/**
+ * Hook to access the chat UI context
+ */
+function useChatUI() {
+    const context = (0, react_1.useContext)(ChatUIContext);
+    if (!context) {
+        throw new Error('useChatUI must be used within a ChatUIProvider');
+    }
+    return context;
+}
+/**
+ * Hook to check if chat UI is available
+ */
+function useChatUIOptional() {
+    return (0, react_1.useContext)(ChatUIContext);
+}
+/**
+ * Chat UI Provider Component
+ *
+ * Wraps your app and provides chat UI capabilities through the selected adapter.
+ *
+ * @example
+ * ```tsx
+ * import { ChatUIProvider } from '@supernal-interface/core';
+ * import { CopilotKitAdapter } from '@supernal-interface/adapters/copilotkit';
+ *
+ * function App() {
+ *   return (
+ *     <ChatUIProvider adapter={new CopilotKitAdapter()}>
+ *       <YourApp />
+ *       <ChatUI />
+ *     </ChatUIProvider>
+ *   );
+ * }
+ * ```
+ */
+function ChatUIProvider({ adapter, autoRegisterTools = true, autoRegisterReadables = true, toolFilter = (tool) => tool.aiEnabled === true, children, }) {
+    const [isReady, setIsReady] = (0, react_1.useState)(false);
+    const [recentExecutions, setRecentExecutions] = (0, react_1.useState)([]);
+    // Initialize adapter
+    (0, react_1.useEffect)(() => {
+        let mounted = true;
+        async function init() {
+            try {
+                // Call adapter's initialize if it exists
+                if (adapter.initialize) {
+                    await adapter.initialize();
+                }
+                // Auto-register tools
+                if (autoRegisterTools) {
+                    const allTools = Array.from(ToolRegistry_1.ToolRegistry.getAllTools().values());
+                    const filteredTools = allTools.filter(toolFilter);
+                    adapter.registerTools(filteredTools);
+                    // eslint-disable-next-line no-console
+                    console.log(`[ChatUIProvider] Registered ${filteredTools.length} tools with ${adapter.name} adapter`);
+                }
+                // Auto-register readables (component state)
+                if (autoRegisterReadables) {
+                    // TODO: Implement ComponentRegistry.getAllReadables()
+                    // For now, this is a placeholder
+                    adapter.registerReadables([]);
+                }
+                // Subscribe to tool executions
+                const unsubscribe = adapter.onToolExecution((execution) => {
+                    setRecentExecutions((prev) => [execution, ...prev.slice(0, 9)]); // Keep last 10
+                });
+                if (mounted) {
+                    setIsReady(true);
+                }
+                return unsubscribe;
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.error(`[ChatUIProvider] Failed to initialize ${adapter.name} adapter:`, error);
+                return () => { };
+            }
+        }
+        const cleanupPromise = init();
+        return () => {
+            mounted = false;
+            cleanupPromise.then((cleanup) => cleanup?.());
+            adapter.dispose?.();
+        };
+    }, [adapter, autoRegisterTools, autoRegisterReadables, toolFilter]);
+    // Render function that delegates to adapter
+    const renderChat = (0, react_1.useCallback)((props) => {
+        if (!isReady) {
+            return null;
+        }
+        return adapter.render(props || {});
+    }, [adapter, isReady]);
+    const contextValue = {
+        adapter,
+        isReady,
+        recentExecutions,
+        renderChat,
+    };
+    return react_1.default.createElement(ChatUIContext.Provider, { value: contextValue }, children);
+}
+/**
+ * Convenience component that renders the chat UI from context
+ *
+ * @example
+ * ```tsx
+ * <ChatUIProvider adapter={adapter}>
+ *   <App />
+ *   <ChatUI position="bottom-right" />
+ * </ChatUIProvider>
+ * ```
+ */
+function ChatUI(props) {
+    const { renderChat, isReady } = useChatUI();
+    if (!isReady) {
+        return null;
+    }
+    return react_1.default.createElement(react_1.default.Fragment, null, renderChat(props));
+}
+/**
+ * HOC to inject chat UI capabilities
+ */
+function withChatUI(WrappedComponent) {
+    return function WithChatUIComponent(props) {
+        const chatUI = useChatUI();
+        return react_1.default.createElement(WrappedComponent, { ...props, chatUI: chatUI });
+    };
+}
+//# sourceMappingURL=ChatUIProvider.js.map

package/dist/cjs/src/adapters/ChatUIProvider.js.map

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

package/dist/cjs/src/adapters/bridge.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Auto-Bridging Utilities
+ *
+ * Zero-config bridging from @supernal-interface registries to any ChatUIAdapter.
+ * These utilities automatically expose tools and state to the chat UI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bridgeToolRegistry = bridgeToolRegistry;
+exports.bridgeComponentState = bridgeComponentState;
+exports.registerReadable = registerReadable;
+exports.createAuditTrail = createAuditTrail;
+exports.setupBridge = setupBridge;
+const ToolRegistry_1 = require("../background/registry/ToolRegistry");
+/**
+ * Bridge ToolRegistry to a ChatUIAdapter
+ *
+ * Automatically registers all AI-enabled tools from ToolRegistry
+ * with the adapter, converting them to the adapter's native format.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createCopilotKitAdapter();
+ * const unsubscribe = bridgeToolRegistry(adapter);
+ *
+ * // Later, to stop watching for new tools:
+ * unsubscribe();
+ * ```
+ */
+function bridgeToolRegistry(adapter, options = {}) {
+    const { filter = (tool) => tool.aiEnabled === true, watch = true, onBridge, } = options;
+    // Get current tools and register them
+    const allTools = Array.from(ToolRegistry_1.ToolRegistry.getAllTools().values());
+    const filteredTools = allTools.filter(filter);
+    adapter.registerTools(filteredTools);
+    onBridge?.(filteredTools);
+    // eslint-disable-next-line no-console
+    console.log(`[bridgeToolRegistry] Bridged ${filteredTools.length} tools to ${adapter.name}`);
+    // Watch for new registrations if enabled
+    if (watch) {
+        // Note: ToolRegistry.onRegister would need to be implemented
+        // For now, return a no-op unsubscribe
+        return () => {
+            // eslint-disable-next-line no-console
+            console.log(`[bridgeToolRegistry] Unsubscribed from ${adapter.name}`);
+        };
+    }
+    return () => { };
+}
+/**
+ * Bridge ComponentRegistry state to a ChatUIAdapter as readables
+ *
+ * Automatically exposes component state so the AI can "see"
+ * the current state of the application.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createCopilotKitAdapter();
+ * bridgeComponentState(adapter);
+ *
+ * // AI can now see: "Counter is currently at 5"
+ * ```
+ */
+function bridgeComponentState(adapter, options = {}) {
+    const { filter: _filter = () => true, descriptionGenerator: _descriptionGenerator = defaultDescriptionGenerator, } = options;
+    const readables = [];
+    // Try to get components from ComponentRegistry
+    // Note: ComponentRegistry may not have getAllComponents - check if it exists
+    try {
+        // Get registered component IDs from metadata
+        // ComponentRegistry stores metadata internally, we can access via getState
+        // For now, we'll register readables that are explicitly provided
+        // This is a placeholder until ComponentRegistry exposes getAllComponents
+        // eslint-disable-next-line no-console
+        console.log(`[bridgeComponentState] ComponentRegistry state bridging not yet implemented`);
+        // eslint-disable-next-line no-console
+        console.log(`[bridgeComponentState] Use registerReadables directly on the adapter for now`);
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console
+        console.warn(`[bridgeComponentState] Could not bridge component state:`, error);
+    }
+    adapter.registerReadables(readables);
+    // eslint-disable-next-line no-console
+    console.log(`[bridgeComponentState] Bridged ${readables.length} component states to ${adapter.name}`);
+    return () => {
+        // Cleanup subscriptions if needed
+    };
+}
+/**
+ * Manually register a readable state
+ *
+ * Use this when you want to expose specific state to the AI.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createCopilotKitAdapter();
+ *
+ * // Register a counter's state
+ * registerReadable(adapter, {
+ *   id: 'counter',
+ *   description: 'Current counter value',
+ *   getValue: () => counterState.value,
+ * });
+ * ```
+ */
+function registerReadable(adapter, readable) {
+    adapter.registerReadables([readable]);
+}
+/**
+ * Default description generator for component state
+ */
+function defaultDescriptionGenerator(id, state) {
+    const componentName = id.split('.').pop() || id;
+    if (state === null || state === undefined) {
+        return `${componentName} has no state`;
+    }
+    if (typeof state === 'object') {
+        const keys = Object.keys(state);
+        if (keys.length === 0) {
+            return `${componentName} is empty`;
+        }
+        if (keys.length === 1) {
+            const key = keys[0];
+            const value = state[key];
+            return `${componentName} ${key} is ${formatValue(value)}`;
+        }
+        return `${componentName} state: ${JSON.stringify(state)}`;
+    }
+    return `${componentName} is ${formatValue(state)}`;
+}
+/**
+ * Format a value for display
+ */
+function formatValue(value) {
+    if (typeof value === 'boolean') {
+        return value ? 'enabled' : 'disabled';
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    if (typeof value === 'string') {
+        return `"${value}"`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Create an audit trail for tool executions
+ *
+ * Tracks all tool executions through the adapter for compliance,
+ * debugging, and analytics purposes.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createCopilotKitAdapter();
+ * const { getExecutions, clear, unsubscribe } = createAuditTrail(adapter);
+ *
+ * // Later:
+ * const history = getExecutions();
+ * console.log(`${history.length} tools executed`);
+ * ```
+ */
+function createAuditTrail(adapter, options = {}) {
+    const { maxExecutions = 100, logToConsole = false, logger, filter = () => true, } = options;
+    const executions = [];
+    const callback = (execution) => {
+        if (!filter(execution))
+            return;
+        executions.push(execution);
+        // Trim if over max
+        while (executions.length > maxExecutions) {
+            executions.shift();
+        }
+        // Log if enabled
+        if (logToConsole) {
+            const status = execution.success ? '✅' : '❌';
+            // eslint-disable-next-line no-console
+            console.log(`[AuditTrail] ${status} ${execution.toolName} (${execution.duration}ms)`, execution.args);
+        }
+        // Custom logger
+        logger?.(execution);
+    };
+    const unsubscribe = adapter.onToolExecution(callback);
+    return {
+        getExecutions: () => [...executions],
+        getLastExecution: () => executions[executions.length - 1],
+        clear: () => {
+            executions.length = 0;
+        },
+        unsubscribe,
+    };
+}
+/**
+ * Combined bridge setup for convenience
+ *
+ * Sets up tool bridging, state bridging, and audit trail in one call.
+ *
+ * @example
+ * ```typescript
+ * const adapter = createCopilotKitAdapter();
+ * const { audit, cleanup } = setupBridge(adapter);
+ *
+ * // Use the app...
+ *
+ * // Check audit trail
+ * console.log(audit.getExecutions());
+ *
+ * // Cleanup when done
+ * cleanup();
+ * ```
+ */
+function setupBridge(adapter, options = {}) {
+    const toolCleanup = bridgeToolRegistry(adapter, options.tools);
+    const stateCleanup = bridgeComponentState(adapter, options.state);
+    const audit = createAuditTrail(adapter, options.audit);
+    return {
+        audit,
+        cleanup: () => {
+            toolCleanup();
+            stateCleanup();
+            audit.unsubscribe();
+        },
+    };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/cjs/src/adapters/bridge.js.map

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