@supernal/interface 1.0.0

package/dist/esm/src/adapters/native/NativeAdapter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Native Adapter
+ *
+ * Implements ChatUIAdapter using our built-in ChatBubble component.
+ * Zero external dependencies - works out of the box.
+ *
+ * This adapter provides:
+ * - Lightweight chat UI
+ * - Direct tool execution via ToolRegistry
+ * - No LLM required (uses pattern matching)
+ */
+import React from 'react';
+import type { ChatUIAdapter, ChatUIProps, ReadableState, ToolExecutionCallback } from '../types';
+import type { ToolMetadata } from '../../decorators/Tool';
+/**
+ * Configuration for Native adapter
+ */
+export interface NativeAdapterConfig {
+    /** Default system message shown on first load */
+    welcomeMessage?: string;
+    /** Whether to use pattern matching for tool execution */
+    usePatternMatching?: boolean;
+}
+/**
+ * Native Adapter Implementation
+ */
+export declare class NativeAdapter implements ChatUIAdapter {
+    readonly name = "native";
+    private tools;
+    private readables;
+    private executionCallbacks;
+    private config;
+    constructor(config?: NativeAdapterConfig);
+    initialize(): Promise<void>;
+    registerTools(tools: ToolMetadata[]): void;
+    registerReadables(readables: ReadableState[]): void;
+    onToolExecution(callback: ToolExecutionCallback): () => void;
+    private notifyExecution;
+    isReady(): boolean;
+    dispose(): void;
+    render(props: ChatUIProps): React.ReactNode;
+}
+/**
+ * Factory function for creating Native adapter
+ */
+export declare function createNativeAdapter(config?: NativeAdapterConfig): NativeAdapter;
+//# sourceMappingURL=NativeAdapter.d.ts.map

package/dist/esm/src/adapters/native/NativeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/native/NativeAdapter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,aAAa,EAEb,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAa1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,GAAE,mBAAwB;IAOtC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI;IAI1C,iBAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,IAAI;IAInD,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAO5D,OAAO,CAAC,eAAe;IAUvB,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,IAAI;IAMf,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,SAAS;CAU5C;AAyMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAE/E"}

package/dist/esm/src/adapters/native/NativeAdapter.js

@@ -0,0 +1,230 @@
+/**
+ * Native Adapter
+ *
+ * Implements ChatUIAdapter using our built-in ChatBubble component.
+ * Zero external dependencies - works out of the box.
+ *
+ * This adapter provides:
+ * - Lightweight chat UI
+ * - Direct tool execution via ToolRegistry
+ * - No LLM required (uses pattern matching)
+ */
+import React, { useState, useCallback, useRef, useEffect } from 'react';
+import { ChatBubble } from '../../ui/react/chat/ChatBubble.js';
+/**
+ * Native Adapter Implementation
+ */
+export class NativeAdapter {
+    constructor(config = {}) {
+        this.name = 'native';
+        this.tools = [];
+        this.readables = [];
+        this.executionCallbacks = [];
+        this.config = {
+            usePatternMatching: true,
+            ...config,
+        };
+    }
+    async initialize() {
+        // Native adapter doesn't need initialization
+    }
+    registerTools(tools) {
+        this.tools = tools;
+    }
+    registerReadables(readables) {
+        this.readables = readables;
+    }
+    onToolExecution(callback) {
+        this.executionCallbacks.push(callback);
+        return () => {
+            this.executionCallbacks = this.executionCallbacks.filter(cb => cb !== callback);
+        };
+    }
+    notifyExecution(execution) {
+        this.executionCallbacks.forEach(cb => {
+            try {
+                cb(execution);
+            }
+            catch {
+                // Ignore callback errors
+            }
+        });
+    }
+    isReady() {
+        return true; // Always ready
+    }
+    dispose() {
+        this.executionCallbacks = [];
+        this.tools = [];
+        this.readables = [];
+    }
+    render(props) {
+        return (React.createElement(NativeChatWrapper, { adapter: this, tools: this.tools, config: this.config, ...props }));
+    }
+}
+function NativeChatWrapper({ adapter, tools, config: _config, ...props }) {
+    // Suppress unused props warning for spreading
+    void props;
+    const [messages, setMessages] = useState([]);
+    const toolsRef = useRef(tools);
+    // Keep tools ref updated
+    useEffect(() => {
+        toolsRef.current = tools;
+    }, [tools]);
+    /**
+     * Find matching tool using pattern matching
+     */
+    const findMatchingTool = useCallback((query) => {
+        const lowerQuery = query.toLowerCase().trim();
+        let bestTool = null;
+        let bestScore = 0;
+        const params = [];
+        for (const tool of toolsRef.current) {
+            let score = 0;
+            // Check examples
+            if (tool.examples && Array.isArray(tool.examples)) {
+                for (const example of tool.examples) {
+                    if (typeof example !== 'string')
+                        continue;
+                    const exampleLower = example.toLowerCase();
+                    // Exact match
+                    if (exampleLower === lowerQuery) {
+                        score += 20;
+                    }
+                    // Query starts with example pattern
+                    else if (lowerQuery.startsWith(exampleLower.replace(/\{[^}]+\}/g, '').trim())) {
+                        score += 15;
+                        // Extract parameter from trailing text
+                        const pattern = exampleLower.replace(/\{[^}]+\}/g, '').trim();
+                        const trailing = query.substring(pattern.length).trim();
+                        if (trailing) {
+                            params.push(trailing);
+                        }
+                    }
+                    // Partial match
+                    else if (exampleLower.includes(lowerQuery) || lowerQuery.includes(exampleLower)) {
+                        score += 5;
+                    }
+                }
+            }
+            // Check method name
+            if (tool.methodName) {
+                const methodLower = tool.methodName.toLowerCase();
+                if (lowerQuery.includes(methodLower)) {
+                    score += 3;
+                }
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                bestTool = tool;
+            }
+        }
+        return { tool: bestTool, params };
+    }, []);
+    /**
+     * Execute a tool
+     */
+    const executeTool = useCallback(async (tool, params) => {
+        const start = Date.now();
+        try {
+            let result;
+            if (tool.method) {
+                result = await tool.method(...params);
+            }
+            else if (tool.instance && tool.methodName) {
+                result = await tool.instance[tool.methodName](...params);
+            }
+            else {
+                throw new Error(`Tool ${tool.name} has no executable method`);
+            }
+            const execution = {
+                toolId: tool.toolId,
+                toolName: tool.name || tool.methodName || 'unknown',
+                args: params.reduce((acc, p, i) => ({ ...acc, [`arg${i}`]: p }), {}),
+                result,
+                success: true,
+                timestamp: new Date(),
+                duration: Date.now() - start,
+                containerId: tool.containerId,
+                dangerLevel: tool.dangerLevel,
+                approvalRequired: tool.requiresApproval,
+            };
+            adapter.notifyExecution(execution);
+            // Extract message from result
+            if (typeof result === 'object' && result !== null && 'message' in result) {
+                return { success: true, message: result.message };
+            }
+            return { success: true, message: `✅ Executed ${tool.name}` };
+        }
+        catch (error) {
+            const execution = {
+                toolId: tool.toolId,
+                toolName: tool.name || tool.methodName || 'unknown',
+                args: params.reduce((acc, p, i) => ({ ...acc, [`arg${i}`]: p }), {}),
+                result: null,
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+                timestamp: new Date(),
+                duration: Date.now() - start,
+                containerId: tool.containerId,
+                dangerLevel: tool.dangerLevel,
+                approvalRequired: tool.requiresApproval,
+            };
+            adapter.notifyExecution(execution);
+            return {
+                success: false,
+                message: `❌ Error: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }, [adapter]);
+    /**
+     * Handle user message
+     */
+    const handleSendMessage = useCallback(async (text) => {
+        // Add user message
+        const userMessage = {
+            id: `user-${Date.now()}`,
+            text,
+            type: 'user',
+            timestamp: new Date().toISOString(),
+        };
+        setMessages(prev => [...prev, userMessage]);
+        // Find and execute tool
+        const { tool, params } = findMatchingTool(text);
+        if (!tool) {
+            // No matching tool
+            const systemMessage = {
+                id: `system-${Date.now()}`,
+                text: `❓ No matching command found. Try: ${toolsRef.current.slice(0, 3).flatMap(t => t.examples?.slice(0, 1) || []).join(', ')}`,
+                type: 'system',
+                timestamp: new Date().toISOString(),
+            };
+            setMessages(prev => [...prev, systemMessage]);
+            return;
+        }
+        // Execute tool
+        const result = await executeTool(tool, params);
+        // Add response message
+        const responseMessage = {
+            id: `ai-${Date.now()}`,
+            text: result.message,
+            type: result.success ? 'ai' : 'system',
+            timestamp: new Date().toISOString(),
+        };
+        setMessages(prev => [...prev, responseMessage]);
+    }, [findMatchingTool, executeTool]);
+    /**
+     * Clear chat
+     */
+    const handleClearChat = useCallback(() => {
+        setMessages([]);
+    }, []);
+    return (React.createElement(ChatBubble, { messages: messages, onSendMessage: handleSendMessage, onClearChat: handleClearChat }));
+}
+/**
+ * Factory function for creating Native adapter
+ */
+export function createNativeAdapter(config) {
+    return new NativeAdapter(config);
+}
+//# sourceMappingURL=NativeAdapter.js.map

package/dist/esm/src/adapters/native/NativeAdapter.js.map

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

package/dist/esm/src/adapters/native/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Native Adapter Exports
+ */
+export { NativeAdapter, createNativeAdapter } from './NativeAdapter';
+export type { NativeAdapterConfig } from './NativeAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/adapters/native/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/native/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/esm/src/adapters/native/index.js

@@ -0,0 +1,5 @@
+/**
+ * Native Adapter Exports
+ */
+export { NativeAdapter, createNativeAdapter } from './NativeAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/src/adapters/native/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/native/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/esm/src/adapters/types/index.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Chat UI Adapter Types
+ *
+ * Defines the interface for swappable chat UI providers.
+ * Adapters bridge between UI libraries and our ToolRegistry.
+ */
+import type { ToolMetadata } from '../../decorators/Tool';
+/**
+ * Readable state that can be exposed to AI
+ */
+export interface ReadableState {
+    /** Unique identifier */
+    id: string;
+    /** Human-readable description for AI context */
+    description: string;
+    /** Function to get current value */
+    getValue: () => unknown;
+    /** Optional: Subscribe to value changes */
+    subscribe?: (callback: (value: unknown) => void) => () => void;
+}
+/**
+ * Tool execution event for audit trails
+ */
+export interface ToolExecution {
+    /** Tool identifier */
+    toolId: string;
+    /** Tool display name */
+    toolName: string;
+    /** Arguments passed to tool */
+    args: Record<string, unknown>;
+    /** Execution result */
+    result: unknown;
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Error if failed */
+    error?: Error;
+    /** When execution occurred */
+    timestamp: Date;
+    /** How long execution took (ms) */
+    duration: number;
+    /** Container where tool was executed */
+    containerId?: string;
+    /** Tool's danger classification */
+    dangerLevel?: 'safe' | 'moderate' | 'dangerous' | 'destructive';
+    /** Whether approval was required */
+    approvalRequired?: boolean;
+}
+/**
+ * Callback for tool execution events
+ */
+export type ToolExecutionCallback = (execution: ToolExecution) => void;
+/**
+ * Chat UI rendering props
+ */
+export interface ChatUIProps {
+    /** Position of chat widget */
+    position?: 'bottom-right' | 'bottom-left' | 'sidebar' | 'inline';
+    /** Color theme */
+    theme?: 'light' | 'dark' | 'system';
+    /** Chat window title */
+    title?: string;
+    /** Input placeholder text */
+    placeholder?: string;
+    /** Initial message from AI */
+    initialMessage?: string;
+    /** System prompt for AI */
+    systemPrompt?: string;
+    /** Whether chat starts open */
+    defaultOpen?: boolean;
+    /** Callback when user sends message */
+    onMessage?: (message: string) => void;
+    /** Additional className */
+    className?: string;
+}
+/**
+ * Chat UI Adapter Interface
+ *
+ * Implement this to add support for any chat UI library.
+ * The adapter bridges between the UI and our ToolRegistry.
+ *
+ * @example
+ * ```typescript
+ * class CopilotKitAdapter implements ChatUIAdapter {
+ *   name = 'copilotkit';
+ *
+ *   registerTools(tools) {
+ *     // Convert to useCopilotAction calls
+ *   }
+ *
+ *   render(props) {
+ *     return <CopilotPopup {...props} />;
+ *   }
+ * }
+ * ```
+ */
+export interface ChatUIAdapter {
+    /** Adapter name for identification */
+    readonly name: string;
+    /**
+     * Register tools from ToolRegistry
+     * Adapter converts to its native format (e.g., useCopilotAction)
+     * Called once on initialization
+     */
+    registerTools(tools: ToolMetadata[]): void;
+    /**
+     * Register readable state from ComponentRegistry
+     * Adapter converts to its native format (e.g., useCopilotReadable)
+     * Called once on initialization, updates via subscription
+     */
+    registerReadables(readables: ReadableState[]): void;
+    /**
+     * Subscribe to tool execution events
+     * Critical for audit trails, analytics, compliance
+     * Returns unsubscribe function
+     */
+    onToolExecution(callback: ToolExecutionCallback): () => void;
+    /**
+     * Render the chat UI component
+     * This is the main entry point for displaying the chat
+     */
+    render(props: ChatUIProps): React.ReactNode;
+    /**
+     * Optional: Initialize adapter (e.g., connect to runtime)
+     * Called before first render
+     */
+    initialize?(): Promise<void>;
+    /**
+     * Optional: Cleanup on unmount
+     * Called when adapter is disposed
+     */
+    dispose?(): void;
+    /**
+     * Optional: Check if adapter is ready
+     * Returns false if dependencies not met (e.g., missing API key)
+     */
+    isReady?(): boolean;
+}
+/**
+ * Adapter factory function type
+ */
+export type AdapterFactory<TConfig = unknown> = (config?: TConfig) => ChatUIAdapter;
+/**
+ * Configuration for ChatUIProvider
+ */
+export interface ChatUIProviderConfig {
+    /** The adapter to use */
+    adapter: ChatUIAdapter;
+    /** Whether to auto-register tools from ToolRegistry */
+    autoRegisterTools?: boolean;
+    /** Whether to auto-register component state as readables */
+    autoRegisterReadables?: boolean;
+    /** Filter function for which tools to register */
+    toolFilter?: (tool: ToolMetadata) => boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/adapters/types/index.d.ts.map

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

package/dist/esm/src/adapters/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Chat UI Adapter Types
+ *
+ * Defines the interface for swappable chat UI providers.
+ * Adapters bridge between UI libraries and our ToolRegistry.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/esm/src/adapters/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/esm/src/ai/ToolExecutor.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ToolExecutor - Universal execution engine for tools
+ *
+ * Supports multiple execution strategies:
+ * - Programmatic (direct method call)
+ * - DOM-based (Playwright/browser automation)
+ * - Navigation (route changes)
+ */
+import type { ToolMetadata } from '../decorators/Tool';
+/**
+ * Execution result
+ */
+export interface ExecutionResult {
+    success: boolean;
+    message: string;
+    data?: any;
+    error?: Error;
+    timing?: number;
+}
+/**
+ * Base interface for execution strategies
+ */
+export interface ExecutorStrategy {
+    name: string;
+    /**
+     * Check if this strategy can execute the given tool
+     */
+    canExecute(tool: ToolMetadata): boolean;
+    /**
+     * Execute the tool with given parameters
+     */
+    execute(tool: ToolMetadata, parameters: any[]): Promise<ExecutionResult>;
+}
+/**
+ * Main ToolExecutor orchestrator
+ */
+export declare class ToolExecutor {
+    private strategies;
+    constructor();
+    /**
+     * Register a new execution strategy
+     */
+    registerStrategy(strategy: ExecutorStrategy): void;
+    /**
+     * Execute a tool using the appropriate strategy
+     */
+    execute(tool: ToolMetadata, parameters?: any[]): Promise<ExecutionResult>;
+}
+//# sourceMappingURL=ToolExecutor.d.ts.map

package/dist/esm/src/ai/ToolExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../../../src/ai/ToolExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IAExC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1E;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAA0B;;IAS5C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIlD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,eAAe,CAAC;CA8BpF"}