@supernal/interface 1.0.0

package/dist/esm/src/background/registry/ComponentRegistry.d.ts.map

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

package/dist/esm/src/background/registry/ComponentRegistry.js

@@ -0,0 +1,336 @@
+/**
+ * Component Registry
+ *
+ * Handles two-phase registration for DOM-free decorators:
+ * - Phase A (Decorator): Collect metadata without DOM access
+ * - Phase B (Hydration): Query DOM after it's ready
+ *
+ * This enables SSR/MV3 compatibility.
+ */
+/**
+ * Component Registry with two-phase registration
+ */
+export class ComponentRegistry {
+    /**
+     * Phase A: Register component metadata (decorator-time, NO DOM)
+     */
+    static register(metadata) {
+        if (this.metadata.has(metadata.componentId)) {
+            // eslint-disable-next-line no-console
+            console.warn(`[ComponentRegistry] Component ${metadata.componentId} already registered`);
+            return;
+        }
+        // Validate SSR requirements for UI components
+        if (metadata.kind === 'ui-component') {
+            if (!metadata.htmlTag) {
+                throw new Error(`[ComponentRegistry] UI component ${metadata.componentId} missing required htmlTag (SSR requirement)`);
+            }
+        }
+        // Validate function tool requirements
+        if (metadata.kind === 'function-tool') {
+            if (!metadata.operationType) {
+                throw new Error(`[ComponentRegistry] Function tool ${metadata.componentId} missing required operationType`);
+            }
+        }
+        this.metadata.set(metadata.componentId, metadata);
+        // eslint-disable-next-line no-console
+        console.log(`[ComponentRegistry] Registered ${metadata.kind}: ${metadata.componentId}`);
+    }
+    /**
+     * Phase B: Hydrate component from DOM (user-initiated, after DOM ready)
+     *
+     * For UI components: Queries DOM to extract current state
+     * For function tools: Creates initial state
+     */
+    static hydrate(componentId) {
+        const meta = this.metadata.get(componentId);
+        if (!meta) {
+            // eslint-disable-next-line no-console
+            console.error(`[ComponentRegistry] No metadata for component ${componentId}`);
+            return null;
+        }
+        let state;
+        if (meta.kind === 'ui-component') {
+            // UI Component: Query DOM
+            state = this.hydrateUIComponent(meta);
+        }
+        else {
+            // Function Tool: Create initial state
+            state = this.hydrateFunctionTool(meta);
+        }
+        this.hydrated.set(componentId, state);
+        // eslint-disable-next-line no-console
+        console.log(`[ComponentRegistry] Hydrated ${meta.kind}: ${componentId}`);
+        return state;
+    }
+    /**
+     * Hydrate UI component from DOM
+     */
+    static hydrateUIComponent(meta) {
+        const element = meta.selector
+            ? document.querySelector(meta.selector)
+            : document.querySelector(`[data-component-id="${meta.componentId}"]`);
+        if (!element) {
+            // eslint-disable-next-line no-console
+            console.warn(`[ComponentRegistry] Element not found for ${meta.componentId}, using defaults`);
+        }
+        // Extract state from DOM
+        const options = element ? this.extractOptionsFromDOM(element) : undefined;
+        const value = element ? this.extractValueFromDOM(element, meta.htmlTag) : null;
+        const disabled = element ? element.disabled : false;
+        const readOnly = element ? element.readOnly : false;
+        const required = element ? element.required : false;
+        const visible = element ? element.offsetParent !== null : true;
+        return {
+            kind: 'ui-component',
+            componentId: meta.componentId,
+            description: meta.description,
+            containerId: meta.containerId,
+            htmlTag: meta.htmlTag,
+            htmlType: meta.htmlType,
+            htmlRole: meta.htmlRole,
+            value,
+            options,
+            disabled,
+            readOnly,
+            required,
+            visible,
+        };
+    }
+    /**
+     * Extract value from DOM element based on tag
+     */
+    static extractValueFromDOM(element, htmlTag) {
+        const el = element;
+        switch (htmlTag) {
+            case 'input': {
+                const inputEl = el;
+                if (inputEl.type === 'checkbox' || inputEl.type === 'radio') {
+                    return inputEl.checked;
+                }
+                return inputEl.value;
+            }
+            case 'select':
+                return el.value;
+            case 'textarea':
+                return el.value;
+            case 'checkbox':
+            case 'toggle':
+                return el.checked;
+            default:
+                return el.textContent || el.getAttribute('value') || null;
+        }
+    }
+    /**
+     * Extract options from DOM (for select, radio, checkbox groups)
+     */
+    static extractOptionsFromDOM(element) {
+        const tag = element.tagName.toLowerCase();
+        if (tag === 'select') {
+            const selectEl = element;
+            const options = Array.from(selectEl.options);
+            return options.map(opt => ({
+                label: opt.text,
+                value: opt.value,
+                disabled: opt.disabled,
+            }));
+        }
+        // For radio/checkbox groups, find siblings with same name
+        // Skip in non-browser environments
+        if (typeof HTMLInputElement === 'undefined') {
+            return undefined;
+        }
+        if (element instanceof HTMLInputElement && (element.type === 'radio' || element.type === 'checkbox')) {
+            const name = element.name;
+            if (name) {
+                const siblings = document.querySelectorAll(`input[name="${name}"]`);
+                return Array.from(siblings).map(el => {
+                    const input = el;
+                    return {
+                        label: input.labels?.[0]?.textContent || input.value,
+                        value: input.value,
+                        disabled: input.disabled,
+                    };
+                });
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Hydrate function tool (no DOM access)
+     */
+    static hydrateFunctionTool(meta) {
+        return {
+            kind: 'function-tool',
+            componentId: meta.componentId,
+            description: meta.description,
+            containerId: meta.containerId,
+            operationType: meta.operationType,
+            executionCount: 0,
+        };
+    }
+    /**
+     * Hydrate all registered components
+     */
+    static hydrateAll() {
+        const results = new Map();
+        for (const componentId of this.metadata.keys()) {
+            const state = this.hydrate(componentId);
+            if (state) {
+                results.set(componentId, state);
+            }
+        }
+        return results;
+    }
+    /**
+     * Get registered metadata (Phase A)
+     */
+    static getMetadata(componentId) {
+        return this.metadata.get(componentId);
+    }
+    /**
+     * Get all registered metadata
+     */
+    static getAllMetadata() {
+        return new Map(this.metadata);
+    }
+    /**
+     * Get hydrated state (Phase B)
+     */
+    static getHydrated(componentId) {
+        return this.hydrated.get(componentId);
+    }
+    /**
+     * Get all hydrated states
+     */
+    static getAllHydrated() {
+        return new Map(this.hydrated);
+    }
+    /**
+     * Check if component is registered
+     */
+    static isRegistered(componentId) {
+        return this.metadata.has(componentId);
+    }
+    /**
+     * Check if component is hydrated
+     */
+    static isHydrated(componentId) {
+        return this.hydrated.has(componentId);
+    }
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    static clear() {
+        this.metadata.clear();
+        this.hydrated.clear();
+    }
+    /**
+     * Unregister a component
+     */
+    static unregister(componentId) {
+        this.metadata.delete(componentId);
+        this.hydrated.delete(componentId);
+    }
+    // ============================================================================
+    // STATEFUL COMPONENT MANAGEMENT (Week 2 - Story System)
+    // ============================================================================
+    /**
+     * Register a stateful component instance
+     *
+     * @param componentName - Name of the component (from @Component decorator)
+     * @param instance - StatefulComponent instance
+     */
+    static registerInstance(componentName, instance) {
+        this.instances.set(componentName, instance);
+        // eslint-disable-next-line no-console
+        console.log(`[ComponentRegistry] Registered stateful instance: ${componentName}`);
+    }
+    /**
+     * Get a stateful component instance
+     *
+     * @param componentName - Name of the component
+     * @returns StatefulComponent instance or undefined
+     */
+    static getInstance(componentName) {
+        return this.instances.get(componentName);
+    }
+    /**
+     * Get component state via instance
+     *
+     * @param componentName - Name of the component
+     * @returns Current component state
+     * @throws Error if component not found
+     */
+    static getState(componentName) {
+        const instance = this.instances.get(componentName);
+        if (!instance) {
+            throw new Error(`[ComponentRegistry] Component not found: ${componentName}`);
+        }
+        return instance.getState();
+    }
+    /**
+     * Set component state via instance
+     *
+     * @param componentName - Name of the component
+     * @param state - State to set
+     * @throws Error if component not found
+     */
+    static setState(componentName, state) {
+        const instance = this.instances.get(componentName);
+        if (!instance) {
+            throw new Error(`[ComponentRegistry] Component not found: ${componentName}`);
+        }
+        instance.setState(state);
+    }
+    /**
+     * Reset component to initial state
+     *
+     * @param componentName - Name of the component
+     * @throws Error if component not found
+     */
+    static resetComponentState(componentName) {
+        const instance = this.instances.get(componentName);
+        if (!instance) {
+            throw new Error(`[ComponentRegistry] Component not found: ${componentName}`);
+        }
+        instance.resetState();
+    }
+    /**
+     * Get all registered stateful component names
+     *
+     * @returns Array of component names
+     */
+    static getAllInstanceNames() {
+        return Array.from(this.instances.keys());
+    }
+    /**
+     * Check if a stateful component instance is registered
+     *
+     * @param componentName - Name of the component
+     * @returns True if instance is registered
+     */
+    static hasInstance(componentName) {
+        return this.instances.has(componentName);
+    }
+    /**
+     * Clear stateful component instances (for testing)
+     */
+    static clearInstances() {
+        this.instances.clear();
+    }
+}
+/**
+ * Registered component metadata (Phase A)
+ */
+ComponentRegistry.metadata = new Map();
+/**
+ * Hydrated components (Phase B)
+ */
+ComponentRegistry.hydrated = new Map();
+/**
+ * Stateful component instances (Week 2 - Story System)
+ * Maps component name to StatefulComponent instance
+ */
+ComponentRegistry.instances = new Map();
+//# sourceMappingURL=ComponentRegistry.js.map

package/dist/esm/src/background/registry/ComponentRegistry.js.map

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

package/dist/esm/src/background/registry/ToolRegistry.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Tool Registry - Simple registry for tool discovery and metadata
+ *
+ * This registry ONLY handles:
+ * - Tool registration
+ * - Tool discovery
+ * - Metadata management
+ *
+ * Execution is handled separately by:
+ * - PlaywrightExecutor (for testing)
+ * - DOMExecutor (for AI control)
+ */
+import { ToolMetadata } from '../../decorators/Tool';
+export interface UniversalExecutionContext {
+    toolId: string;
+    parameters: any;
+    userId?: string;
+    sessionId?: string;
+    timestamp: number;
+}
+export interface UniversalToolResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+    executionTime?: number;
+    context?: UniversalExecutionContext;
+    tool?: string;
+}
+export declare class ToolRegistry {
+    private static get tools();
+    private static get activeInstances();
+    /**
+     * Register a tool
+     */
+    static registerTool(providerName: string, methodName: string, metadata: ToolMetadata): void;
+    /**
+     * Get a specific tool by identifier
+     * Supports both class-based IDs (Counter.increment) and component-namespaced IDs (counter.increment)
+     */
+    static getTool(toolIdentifier: string): ToolMetadata | undefined;
+    /**
+     * Get all registered tools
+     */
+    static getAllTools(): Map<string, ToolMetadata>;
+    /**
+     * Get all registered tools as array
+     */
+    static getTools(): ToolMetadata[];
+    /**
+     * Find tool by element ID (data-testid)
+     */
+    static findToolByElementId(elementId: string): ToolMetadata | undefined;
+    /**
+     * Register active component instance
+     */
+    static registerInstance(storageKey: string, element: HTMLElement): void;
+    /**
+     * Unregister component instance on unmount
+     */
+    static unregisterInstance(storageKey: string): void;
+    /**
+     * Check if instance exists (for duplicate detection)
+     */
+    static getActiveInstance(storageKey: string): HTMLElement | undefined;
+    /**
+     * Bind a class instance to all its registered tool methods
+     *
+     * This allows @Tool decorated methods to be called by AI without needing
+     * the instance to be called once first (which sets tool.instance = this).
+     *
+     * @param instance The class instance with @Tool decorated methods
+     */
+    static bindInstance(instance: any): void;
+    /**
+     * Get AI-enabled tools only
+     */
+    static getAIEnabledTools(): ToolMetadata[];
+    /**
+     * Get test-only tools
+     */
+    static getTestOnlyTools(): ToolMetadata[];
+    /**
+     * Get tools by category
+     */
+    static getToolsByCategory(category: string): ToolMetadata[];
+    /**
+     * Search tools by query
+     */
+    static searchTools(query: string): ToolMetadata[];
+    /**
+     * Search tools with container scoping
+     *
+     * Prioritizes tools in currentContainer, then global tools.
+     * This enables "local > global" resolution like lexical scope.
+     *
+     * @param query Search query
+     * @param currentContainer Current page/container context
+     * @returns Tools sorted by: local matches, global matches
+     */
+    static searchScoped(query: string, currentContainer?: string): ToolMetadata[];
+    /**
+     * Get tools by component name
+     *
+     * Returns all methods for a specific component.
+     *
+     * @example
+     * getToolsByComponent('counter')
+     * // → [counter.increment, counter.decrement, counter.reset]
+     */
+    static getToolsByComponent(componentName: string): ToolMetadata[];
+    /**
+     * Get tools by container (page scope)
+     */
+    static getToolsByContainer(containerId: string): ToolMetadata[];
+    /**
+     * Get component names in a container
+     *
+     * @example
+     * getComponentsInContainer('Dashboard')
+     * // → ['counter', 'chart', 'settings']
+     */
+    static getComponentsInContainer(containerId: string): string[];
+    /**
+     * Find tool by natural language query (alias for searchTools)
+     */
+    static findToolsByQuery(query: string): ToolMetadata[];
+    /**
+     * Get registry statistics
+     */
+    static getStats(): {
+        total: number;
+        aiEnabled: number;
+        testOnly: number;
+        byCategory: Record<string, number>;
+        byDangerLevel: Record<string, number>;
+        requiresApproval: number;
+    };
+    /**
+     * Get tools by class/provider name
+     */
+    static getToolsByProvider(providerName: string): ToolMetadata[];
+    /**
+     * Get all unique provider names
+     */
+    static getProviders(): string[];
+    /**
+     * List all tools in a CLI-friendly format
+     * Similar to 'ls' command
+     */
+    static list(options?: {
+        provider?: string;
+        category?: string;
+        aiEnabled?: boolean;
+        dangerLevel?: string;
+        verbose?: boolean;
+    }): string;
+    /**
+     * Show help for a specific tool
+     * Similar to 'man' or 'help' command
+     */
+    static help(toolId: string): string;
+    /**
+     * Show overview of all tools and providers
+     * Similar to 'ls -la' or directory overview
+     */
+    static overview(): string;
+    /**
+     * Search and display tools matching query
+     */
+    static find(query: string): string;
+    private static formatCompactList;
+    private static formatVerboseList;
+    private static formatToolSummary;
+    private static formatToolHelp;
+    /**
+     * Execute a tool for AI (only if AI-enabled)
+     */
+    static executeForAI(toolIdentifier: string, parameters?: any): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+        tool: string;
+        requiresApproval?: boolean;
+    }>;
+    /**
+     * Request approval for a dangerous operation
+     */
+    static requestApproval(toolIdentifier: string, parameters?: any): Promise<{
+        id: string;
+        approved: boolean;
+    }>;
+    /**
+     * Generate tool documentation
+     */
+    static generateDocumentation(): string;
+    /**
+     * Clear all tools (for testing)
+     */
+    static clear(): void;
+    /**
+     * Get tools grouped by container for MCP/AI consumption
+     *
+     * Returns a hierarchical structure:
+     * {
+     *   global: [...tools without containerId...],
+     *   DemoSimple: [...tools with containerId='DemoSimple'...],
+     *   Examples: [...tools with containerId='Examples'...],
+     *   ...
+     * }
+     *
+     * This helps AI agents understand tool organization and prioritize
+     * contextually relevant tools.
+     */
+    static getToolsGroupedByContainer(): Record<string, ToolMetadata[]>;
+    /**
+     * Get tools grouped by component within a container
+     *
+     * Returns a hierarchical structure:
+     * {
+     *   DemoSimple: {
+     *     counter: [...counter tools...],
+     *     timer: [...timer tools...],
+     *   },
+     *   global: {
+     *     navigation: [...navigation tools...],
+     *     theme: [...theme tools...],
+     *   }
+     * }
+     */
+    static getToolsGroupedByComponentAndContainer(): Record<string, Record<string, ToolMetadata[]>>;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/esm/src/background/registry/ToolRegistry.d.ts.map

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