@supernal/interface 1.0.0

package/dist/esm/names/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../names/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAO5B;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsDA;AAED;;GAEG;AACH,wBAAgB,YAAY;;;;;;EAQ3B;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOR,CAAC"}

package/dist/esm/names/index.js

@@ -0,0 +1,99 @@
+/**
+ * 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() { ... }
+ */
+export * from './Components.js';
+export * from './Containers.js';
+export * from './API.js';
+export * from './Functions.js';
+import { Components, validateComponentIds, getAllComponentIds } from './Components.js';
+import { Containers, validateContainerIds, getAllContainerIds } from './Containers.js';
+import { API, validateAPIIds, getAllAPIIds } from './API.js';
+import { Functions, validateFunctionIds, getAllFunctionIds } from './Functions.js';
+/**
+ * Validate all name contracts for uniqueness
+ */
+export function validateAllNames() {
+    const errors = [];
+    // Validate component IDs
+    const componentValidation = validateComponentIds();
+    if (!componentValidation.valid) {
+        errors.push(`Duplicate component IDs: ${componentValidation.duplicates.join(', ')}`);
+    }
+    // Validate container IDs
+    const containerValidation = validateContainerIds();
+    if (!containerValidation.valid) {
+        errors.push(`Duplicate container IDs: ${containerValidation.duplicates.join(', ')}`);
+    }
+    // Validate API IDs
+    const apiValidation = validateAPIIds();
+    if (!apiValidation.valid) {
+        errors.push(`Duplicate API IDs: ${apiValidation.duplicates.join(', ')}`);
+    }
+    // Validate function IDs
+    const functionValidation = validateFunctionIds();
+    if (!functionValidation.valid) {
+        errors.push(`Duplicate function IDs: ${functionValidation.duplicates.join(', ')}`);
+    }
+    // Check for cross-category duplicates
+    const allIds = [
+        ...getAllComponentIds(),
+        ...getAllContainerIds(),
+        ...getAllAPIIds(),
+        ...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
+ */
+export function getNameStats() {
+    return {
+        components: getAllComponentIds().length,
+        containers: getAllContainerIds().length,
+        api: getAllAPIIds().length,
+        functions: getAllFunctionIds().length,
+        total: getAllComponentIds().length + getAllContainerIds().length + getAllAPIIds().length + getAllFunctionIds().length,
+    };
+}
+/**
+ * Export namespace for convenient access
+ */
+export const Names = {
+    Components,
+    Containers,
+    API,
+    Functions,
+    validate: validateAllNames,
+    stats: getNameStats,
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/esm/src/adapters/ChatUIProvider.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Chat UI Provider
+ *
+ * React context that manages the active chat adapter and provides
+ * automatic tool/state bridging to any chat UI library.
+ */
+import React, { ReactNode } from 'react';
+import type { ChatUIAdapter, ChatUIProviderConfig, ChatUIProps, ToolExecution } from './types';
+/**
+ * Context value provided to children
+ */
+interface ChatUIContextValue {
+    /** The active adapter */
+    adapter: ChatUIAdapter | null;
+    /** Whether the adapter is initialized */
+    isReady: boolean;
+    /** Recent tool executions (for UI display) */
+    recentExecutions: ToolExecution[];
+    /** Render the chat UI */
+    renderChat: (props?: ChatUIProps) => ReactNode;
+}
+/**
+ * Hook to access the chat UI context
+ */
+export declare function useChatUI(): ChatUIContextValue;
+/**
+ * Hook to check if chat UI is available
+ */
+export declare function useChatUIOptional(): ChatUIContextValue | null;
+/**
+ * Props for ChatUIProvider
+ */
+interface ChatUIProviderProps extends ChatUIProviderConfig {
+    children: ReactNode;
+}
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+export declare function ChatUIProvider({ adapter, autoRegisterTools, autoRegisterReadables, toolFilter, children, }: ChatUIProviderProps): React.JSX.Element;
+/**
+ * Convenience component that renders the chat UI from context
+ *
+ * @example
+ * ```tsx
+ * <ChatUIProvider adapter={adapter}>
+ *   <App />
+ *   <ChatUI position="bottom-right" />
+ * </ChatUIProvider>
+ * ```
+ */
+export declare function ChatUI(props: ChatUIProps): React.JSX.Element | null;
+/**
+ * HOC to inject chat UI capabilities
+ */
+export declare function withChatUI<P extends object>(WrappedComponent: React.ComponentType<P & {
+    chatUI: ChatUIContextValue;
+}>): (props: P) => React.JSX.Element;
+export {};
+//# sourceMappingURL=ChatUIProvider.d.ts.map

package/dist/esm/src/adapters/ChatUIProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatUIProvider.d.ts","sourceRoot":"","sources":["../../../../src/adapters/ChatUIProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAA+D,SAAS,EAAE,MAAM,OAAO,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG/F;;GAEG;AACH,UAAU,kBAAkB;IAC1B,yBAAyB;IACzB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,yBAAyB;IACzB,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,KAAK,SAAS,CAAC;CAChD;AAID;;GAEG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,UAAU,mBAAoB,SAAQ,oBAAoB;IACxD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,iBAAwB,EACxB,qBAA4B,EAC5B,UAA8C,EAC9C,QAAQ,GACT,EAAE,mBAAmB,qBA6ErB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,4BAQxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC,IAErC,OAAO,CAAC,uBAI7C"}

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

@@ -0,0 +1,136 @@
+/**
+ * Chat UI Provider
+ *
+ * React context that manages the active chat adapter and provides
+ * automatic tool/state bridging to any chat UI library.
+ */
+import React, { createContext, useContext, useEffect, useState, useCallback } from 'react';
+import { ToolRegistry } from '../background/registry/ToolRegistry.js';
+const ChatUIContext = createContext(null);
+/**
+ * Hook to access the chat UI context
+ */
+export function useChatUI() {
+    const context = useContext(ChatUIContext);
+    if (!context) {
+        throw new Error('useChatUI must be used within a ChatUIProvider');
+    }
+    return context;
+}
+/**
+ * Hook to check if chat UI is available
+ */
+export function useChatUIOptional() {
+    return 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>
+ *   );
+ * }
+ * ```
+ */
+export function ChatUIProvider({ adapter, autoRegisterTools = true, autoRegisterReadables = true, toolFilter = (tool) => tool.aiEnabled === true, children, }) {
+    const [isReady, setIsReady] = useState(false);
+    const [recentExecutions, setRecentExecutions] = useState([]);
+    // Initialize adapter
+    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.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 = useCallback((props) => {
+        if (!isReady) {
+            return null;
+        }
+        return adapter.render(props || {});
+    }, [adapter, isReady]);
+    const contextValue = {
+        adapter,
+        isReady,
+        recentExecutions,
+        renderChat,
+    };
+    return React.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>
+ * ```
+ */
+export function ChatUI(props) {
+    const { renderChat, isReady } = useChatUI();
+    if (!isReady) {
+        return null;
+    }
+    return React.createElement(React.Fragment, null, renderChat(props));
+}
+/**
+ * HOC to inject chat UI capabilities
+ */
+export function withChatUI(WrappedComponent) {
+    return function WithChatUIComponent(props) {
+        const chatUI = useChatUI();
+        return React.createElement(WrappedComponent, { ...props, chatUI: chatUI });
+    };
+}
+//# sourceMappingURL=ChatUIProvider.js.map

package/dist/esm/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/esm/src/adapters/bridge.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Auto-Bridging Utilities
+ *
+ * Zero-config bridging from @supernal-interface registries to any ChatUIAdapter.
+ * These utilities automatically expose tools and state to the chat UI.
+ */
+import type { ChatUIAdapter, ReadableState, ToolExecution } from './types';
+import type { ToolMetadata } from '../decorators/Tool';
+/**
+ * Options for bridgeToolRegistry
+ */
+export interface BridgeToolRegistryOptions {
+    /** Filter which tools to bridge (default: aiEnabled tools only) */
+    filter?: (tool: ToolMetadata) => boolean;
+    /** Whether to watch for new tool registrations */
+    watch?: boolean;
+    /** Callback when tools are bridged */
+    onBridge?: (tools: ToolMetadata[]) => void;
+}
+/**
+ * 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();
+ * ```
+ */
+export declare function bridgeToolRegistry(adapter: ChatUIAdapter, options?: BridgeToolRegistryOptions): () => void;
+/**
+ * Options for bridgeComponentState
+ */
+export interface BridgeComponentStateOptions {
+    /** Filter which components to bridge */
+    filter?: (component: {
+        id: string;
+        state: unknown;
+    }) => boolean;
+    /** Whether to watch for state changes */
+    watch?: boolean;
+    /** Custom description generator */
+    descriptionGenerator?: (id: string, state: unknown) => string;
+}
+/**
+ * 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"
+ * ```
+ */
+export declare function bridgeComponentState(adapter: ChatUIAdapter, options?: BridgeComponentStateOptions): () => void;
+/**
+ * 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,
+ * });
+ * ```
+ */
+export declare function registerReadable(adapter: ChatUIAdapter, readable: ReadableState): void;
+/**
+ * Options for createAuditTrail
+ */
+export interface AuditTrailOptions {
+    /** Maximum number of executions to keep */
+    maxExecutions?: number;
+    /** Whether to log to console */
+    logToConsole?: boolean;
+    /** Custom logger */
+    logger?: (execution: ToolExecution) => void;
+    /** Filter which executions to track */
+    filter?: (execution: ToolExecution) => boolean;
+}
+/**
+ * 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`);
+ * ```
+ */
+export declare function createAuditTrail(adapter: ChatUIAdapter, options?: AuditTrailOptions): {
+    getExecutions: () => ToolExecution[];
+    getLastExecution: () => ToolExecution | undefined;
+    clear: () => void;
+    unsubscribe: () => void;
+};
+/**
+ * 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();
+ * ```
+ */
+export declare function setupBridge(adapter: ChatUIAdapter, options?: {
+    tools?: BridgeToolRegistryOptions;
+    state?: BridgeComponentStateOptions;
+    audit?: AuditTrailOptions;
+}): {
+    audit: ReturnType<typeof createAuditTrail>;
+    cleanup: () => void;
+};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/esm/src/adapters/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../../src/adapters/bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAyB,MAAM,SAAS,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mEAAmE;IACnE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,yBAA8B,GACtC,MAAM,IAAI,CA4BZ;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;IAChE,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,oBAAoB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAC/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,2BAAgC,GACxC,MAAM,IAAI,CAkCZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAEN;AA4CD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB;IACpB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,uCAAuC;IACvC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,OAAO,CAAC;CAChD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,iBAAsB,GAC9B;IACD,aAAa,EAAE,MAAM,aAAa,EAAE,CAAC;IACrC,gBAAgB,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;IAClD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CA4CA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACtB,GACL;IACD,KAAK,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAaA"}