@supernal/interface 1.0.0

package/dist/esm/src/decorators/ToolPreset.js

@@ -0,0 +1,259 @@
+/**
+ * Tool Preset Decorator
+ *
+ * Allows defining common configuration at file or class level to reduce
+ * repetition across multiple tools.
+ *
+ * DRY Principle: Define once, apply to many.
+ *
+ * NOTE: Due to TypeScript decorator execution order (methods run before class),
+ * we use a two-phase approach:
+ * 1. Method decorators check for existing presets
+ * 2. Class decorator applies retroactively if needed via metadata
+ */
+import { ToolCategory } from '../types/index.js';
+import { ToolRegistry } from '../background/registry/ToolRegistry.js';
+/**
+ * Storage for preset configurations
+ * Keyed by class/file identifier
+ */
+const presetRegistry = new Map();
+/**
+ * Pending tools that need preset applied when class decorator runs
+ * Maps className -> array of {toolId, userConfig}
+ */
+const pendingPresets = new Map();
+/**
+ * Get the current preset for a class (if any)
+ */
+export function getToolPreset(target) {
+    // For method decorators, target is the prototype, so we need to get the constructor
+    const constructor = target.constructor || target;
+    const className = constructor.name;
+    return presetRegistry.get(className);
+}
+/**
+ * Register a tool as pending preset application
+ */
+export function registerPendingPreset(className, toolId, userConfig) {
+    if (!pendingPresets.has(className)) {
+        pendingPresets.set(className, []);
+    }
+    pendingPresets.get(className).push({ toolId, userConfig });
+}
+/**
+ * @ToolPreset - Define common tool configuration at class level
+ *
+ * All tools within this class will inherit these defaults unless overridden.
+ *
+ * Due to decorator execution order, this runs AFTER method decorators,
+ * so we retroactively apply the preset to all registered methods.
+ *
+ * @example
+ * ```typescript
+ * @ToolPreset({
+ *   category: ToolCategory.CHAT,
+ *   containerId: 'chat-modal',
+ *   tags: ['chat', 'messaging']
+ * })
+ * class ChatTools {
+ *   @AITool({ toolId: 'send-message' })
+ *   async sendMessage(text: string) {
+ *     // Inherits category, containerId, tags from preset
+ *   }
+ *
+ *   @AITool({
+ *     toolId: 'clear-chat',
+ *     category: ToolCategory.UTILITY  // Override preset category
+ *   })
+ *   async clearChat() {
+ *     // Uses UTILITY instead of CHAT
+ *   }
+ * }
+ * ```
+ */
+export function ToolPreset(preset) {
+    return function (constructor) {
+        const className = constructor.name;
+        // Store preset for this class
+        presetRegistry.set(className, preset);
+        // Apply preset retroactively to all pending tools in this class
+        const toolEntries = pendingPresets.get(className) || [];
+        for (const { toolId, userConfig } of toolEntries) {
+            const tool = ToolRegistry.getTool(toolId);
+            if (tool) {
+                // Merge with correct priority: userConfig > preset > tool defaults
+                const merged = {
+                    ...tool, // Tool with specialized defaults
+                    ...preset, // Preset overrides defaults
+                    ...userConfig, // User config overrides everything
+                    // Deep merge nested objects
+                    permissions: {
+                        ...tool.permissions,
+                        ...preset.permissions,
+                        ...userConfig.permissions,
+                    },
+                    callbacks: {
+                        ...tool.callbacks,
+                        ...preset.callbacks,
+                        ...userConfig.callbacks,
+                    },
+                    origin: {
+                        ...tool.origin,
+                        ...preset.origin,
+                        ...userConfig.origin,
+                    },
+                };
+                // Update the tool in registry
+                const [providerName, methodName] = toolId.split('.');
+                ToolRegistry.registerTool(providerName, methodName, merged);
+            }
+        }
+        // Clear pending for this class
+        pendingPresets.delete(className);
+        // Return the original class (decorator doesn't modify it)
+        return constructor;
+    };
+}
+/**
+ * Apply preset to a tool config if available
+ * Called internally by specialized tool decorators
+ *
+ * NOTE: This function now just returns the preset, the actual merging
+ * is done in the specialized decorator factory.
+ */
+export function applyPreset(target, config) {
+    const preset = getToolPreset(target);
+    return preset || {};
+}
+/**
+ * Clear all presets (useful for testing)
+ */
+export function clearToolPresets() {
+    presetRegistry.clear();
+}
+// ============================================================================
+// Predefined Preset Templates
+// ============================================================================
+/**
+ * Common preset templates for typical use cases
+ */
+export const PresetTemplates = {
+    /**
+     * Chat/Messaging preset
+     */
+    Chat: {
+        category: ToolCategory.CHAT,
+        tags: ['chat', 'messaging'],
+        executionContext: 'both',
+    },
+    /**
+     * Settings/Configuration preset
+     */
+    Settings: {
+        category: ToolCategory.SETTINGS,
+        tags: ['settings', 'configuration'],
+        executionContext: 'both',
+    },
+    /**
+     * Search preset
+     */
+    Search: {
+        category: ToolCategory.SEARCH,
+        tags: ['search', 'query'],
+        executionContext: 'api',
+    },
+    /**
+     * Navigation preset
+     */
+    Navigation: {
+        category: ToolCategory.NAVIGATION,
+        tags: ['navigation', 'routing'],
+        executionContext: 'ui',
+        callbacks: {
+            navigation: true,
+        },
+    },
+    /**
+     * Data Management preset
+     */
+    Data: {
+        category: ToolCategory.DATA,
+        tags: ['data', 'crud'],
+        executionContext: 'api',
+    },
+    /**
+     * Onboarding/Help preset
+     */
+    Onboarding: {
+        category: ToolCategory.ONBOARDING,
+        tags: ['onboarding', 'help', 'tutorial'],
+        executionContext: 'ui',
+        generateStories: true,
+    },
+};
+/**
+ * Helper function to create preset from template
+ *
+ * @example
+ * ```typescript
+ * @ToolPreset(createPreset('Chat', { containerId: 'chat-modal' }))
+ * class ChatTools {
+ *   // All tools inherit Chat preset + containerId
+ * }
+ * ```
+ */
+export function createPreset(template, overrides = {}) {
+    return {
+        ...PresetTemplates[template],
+        ...overrides,
+    };
+}
+// ============================================================================
+// Context-Based Presets (for modal/container-specific tools)
+// ============================================================================
+/**
+ * Create a preset for tools within a specific container/modal
+ *
+ * @example
+ * ```typescript
+ * @ToolPreset(containerPreset('chat-modal', ToolCategory.CHAT))
+ * class ChatModalTools {
+ *   @AITool({ toolId: 'send' })
+ *   async send(text: string) {
+ *     // Automatically knows it's in chat-modal
+ *   }
+ * }
+ * ```
+ */
+export function containerPreset(containerId, category, additionalConfig = {}) {
+    return {
+        containerId,
+        category,
+        origin: {
+            modal: containerId,
+        },
+        ...additionalConfig,
+    };
+}
+/**
+ * Create a preset for tools on a specific path/route
+ *
+ * @example
+ * ```typescript
+ * @ToolPreset(pathPreset('/settings', ToolCategory.SETTINGS))
+ * class SettingsPageTools {
+ *   // All tools inherit path context
+ * }
+ * ```
+ */
+export function pathPreset(path, category, additionalConfig = {}) {
+    return {
+        category,
+        origin: {
+            path,
+        },
+        ...additionalConfig,
+    };
+}
+//# sourceMappingURL=ToolPreset.js.map

package/dist/esm/src/decorators/ToolPreset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolPreset.js","sourceRoot":"","sources":["../../../../src/decorators/ToolPreset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnE;;;GAGG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,EAA+B,CAAC;AAE9D;;;GAGG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,EAAoE,CAAC;AAEnG;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAW;IACvC,oFAAoF;IACpF,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC;IACjD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC;IACnC,OAAO,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,MAAc,EAAE,UAA+B;IACtG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,IAAI,CAAC,EAAC,MAAM,EAAE,UAAU,EAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,UAAU,CAAC,MAA2B;IACpD,OAAO,UAAiD,WAAc;QACpE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC;QAEnC,8BAA8B;QAC9B,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEtC,gEAAgE;QAChE,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAExD,KAAK,MAAM,EAAC,MAAM,EAAE,UAAU,EAAC,IAAI,WAAW,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE1C,IAAI,IAAI,EAAE,CAAC;gBACT,mEAAmE;gBACnE,MAAM,MAAM,GAAG;oBACb,GAAG,IAAI,EAAQ,iCAAiC;oBAChD,GAAG,MAAM,EAAM,4BAA4B;oBAC3C,GAAG,UAAU,EAAE,mCAAmC;oBAClD,4BAA4B;oBAC5B,WAAW,EAAE;wBACX,GAAG,IAAI,CAAC,WAAW;wBACnB,GAAG,MAAM,CAAC,WAAW;wBACrB,GAAG,UAAU,CAAC,WAAW;qBAC1B;oBACD,SAAS,EAAE;wBACT,GAAG,IAAI,CAAC,SAAS;wBACjB,GAAG,MAAM,CAAC,SAAS;wBACnB,GAAG,UAAU,CAAC,SAAS;qBACxB;oBACD,MAAM,EAAE;wBACN,GAAG,IAAI,CAAC,MAAM;wBACd,GAAG,MAAM,CAAC,MAAM;wBAChB,GAAG,UAAU,CAAC,MAAM;qBACrB;iBACF,CAAC;gBAEF,8BAA8B;gBAC9B,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACrD,YAAY,CAAC,YAAY,CAAC,YAAY,EAAE,UAAU,EAAE,MAAa,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEjC,0DAA0D;QAC1D,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,MAAW,EACX,MAA2B;IAE3B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,IAAI,EAAE;QACJ,QAAQ,EAAE,YAAY,CAAC,IAAI;QAC3B,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;QAC3B,gBAAgB,EAAE,MAAe;KACX;IAExB;;OAEG;IACH,QAAQ,EAAE;QACR,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,IAAI,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;QACnC,gBAAgB,EAAE,MAAe;KACX;IAExB;;OAEG;IACH,MAAM,EAAE;QACN,QAAQ,EAAE,YAAY,CAAC,MAAM;QAC7B,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACzB,gBAAgB,EAAE,KAAc;KACV;IAExB;;OAEG;IACH,UAAU,EAAE;QACV,QAAQ,EAAE,YAAY,CAAC,UAAU;QACjC,IAAI,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;QAC/B,gBAAgB,EAAE,IAAa;QAC/B,SAAS,EAAE;YACT,UAAU,EAAE,IAAI;SACjB;KACqB;IAExB;;OAEG;IACH,IAAI,EAAE;QACJ,QAAQ,EAAE,YAAY,CAAC,IAAI;QAC3B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,KAAc;KACV;IAExB;;OAEG;IACH,UAAU,EAAE;QACV,QAAQ,EAAE,YAAY,CAAC,UAAU;QACjC,IAAI,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC;QACxC,gBAAgB,EAAE,IAAa;QAC/B,eAAe,EAAE,IAAI;KACC;CAChB,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAsC,EACtC,YAAiC,EAAE;IAEnC,OAAO;QACL,GAAG,eAAe,CAAC,QAAQ,CAAC;QAC5B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,6DAA6D;AAC7D,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAmB,EACnB,QAAsB,EACtB,mBAAwC,EAAE;IAE1C,OAAO;QACL,WAAW;QACX,QAAQ;QACR,MAAM,EAAE;YACN,KAAK,EAAE,WAAW;SACnB;QACD,GAAG,gBAAgB;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,QAAsB,EACtB,mBAAwC,EAAE;IAE1C,OAAO;QACL,QAAQ;QACR,MAAM,EAAE;YACN,IAAI;SACL;QACD,GAAG,gBAAgB;KACpB,CAAC;AACJ,CAAC"}

package/dist/esm/src/decorators/ToolProvider.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ToolProvider Decorator
+ *
+ * Class-level decorator for configuring AI tool providers.
+ * Provides default settings for all tools in a class.
+ */
+export interface ToolProviderConfig {
+    name?: string;
+    description?: string;
+    category?: string;
+    containerId?: string;
+    aiEnabled?: boolean;
+    dangerLevel?: 'safe' | 'moderate' | 'dangerous' | 'destructive';
+    requiresApproval?: boolean;
+    executionContext?: 'ui' | 'api' | 'both';
+    tags?: string[];
+    permissions?: {
+        level?: string;
+        sensitiveDataAccess?: boolean;
+        networkAccess?: boolean;
+        requiredScopes?: string[];
+    };
+}
+/**
+ * ToolProvider decorator - configures a class as an AI tool provider
+ *
+ * Automatically binds instances when they're created, so users don't need
+ * to manually call ToolRegistry.bindInstance().
+ *
+ * @example Shorthand syntax (just containerId)
+ * ```typescript
+ * @ToolProvider('MyContainer')
+ * class MyTools {
+ *   @Tool('button', { examples: ['click'] })
+ *   async action() {}
+ * }
+ * ```
+ *
+ * @example Full config syntax
+ * ```typescript
+ * @ToolProvider({
+ *   containerId: 'MyContainer',
+ *   category: 'user_interaction',
+ *   aiEnabled: true
+ * })
+ * class MyTools { }
+ * ```
+ *
+ * @param configOrContainerId Provider configuration or just containerId for shorthand
+ */
+export declare function ToolProvider(containerId: string): <T extends {
+    new (...args: any[]): {};
+}>(constructor: T) => T;
+export declare function ToolProvider(config: ToolProviderConfig): <T extends {
+    new (...args: any[]): {};
+}>(constructor: T) => T;
+/**
+ * Get tool provider configuration for a class
+ */
+export declare function getToolProviderConfig(target: any): ToolProviderConfig | undefined;
+/**
+ * Check if a class is a tool provider
+ */
+export declare function isToolProvider(target: any): boolean;
+//# sourceMappingURL=ToolProvider.d.ts.map

package/dist/esm/src/decorators/ToolProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolProvider.d.ts","sourceRoot":"","sources":["../../../../src/decorators/ToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;AAEjH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,CAAC,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;AA+DxH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,kBAAkB,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAEnD"}

package/dist/esm/src/decorators/ToolProvider.js

@@ -0,0 +1,81 @@
+/**
+ * ToolProvider Decorator
+ *
+ * Class-level decorator for configuring AI tool providers.
+ * Provides default settings for all tools in a class.
+ */
+// We'll get ToolRegistry lazily to avoid circular dependency issues
+let ToolRegistryRef = null;
+function getToolRegistry() {
+    if (!ToolRegistryRef) {
+        // Import ToolRegistry (works in both browser and Node.js)
+        ToolRegistryRef = require('../background/registry/ToolRegistry').ToolRegistry;
+    }
+    return ToolRegistryRef;
+}
+// eslint-disable-next-line no-redeclare
+export function ToolProvider(configOrContainerId) {
+    return function (constructor) {
+        // Normalize to ToolProviderConfig
+        const config = typeof configOrContainerId === 'string'
+            ? { containerId: configOrContainerId }
+            : configOrContainerId;
+        // Store provider config on the class
+        constructor.__toolProvider__ = {
+            name: constructor.name,
+            config,
+            registeredAt: new Date().toISOString(),
+        };
+        // Update all tools registered for this provider with inherited values
+        const TR = getToolRegistry();
+        if (TR) {
+            const tools = TR.getToolsByProvider(constructor.name);
+            tools.forEach((tool) => {
+                // Apply inherited values from provider config
+                if (config.containerId && !tool.containerId) {
+                    tool.containerId = config.containerId;
+                }
+                if (config.aiEnabled !== undefined && tool.aiEnabled === undefined) {
+                    tool.aiEnabled = config.aiEnabled;
+                }
+            });
+        }
+        // Wrap constructor to auto-bind instance on creation
+        const WrappedConstructor = class extends constructor {
+            constructor(...args) {
+                super(...args);
+                // Auto-bind this instance's methods to ToolRegistry
+                // Only on client side (not during SSR)
+                if (typeof window !== 'undefined') {
+                    const TR = getToolRegistry();
+                    if (TR) {
+                        TR.bindInstance(this);
+                    }
+                    else {
+                        console.warn(`⚠️  [ToolProvider] ToolRegistry not available for ${constructor.name}`);
+                    }
+                }
+            }
+        };
+        // Preserve original class name for debugging
+        Object.defineProperty(WrappedConstructor, 'name', {
+            value: constructor.name,
+            writable: false
+        });
+        console.log(`🏭 Registered Tool Provider: ${constructor.name} (auto-binding enabled)`);
+        return WrappedConstructor;
+    };
+}
+/**
+ * Get tool provider configuration for a class
+ */
+export function getToolProviderConfig(target) {
+    return target.constructor?.__toolProvider__?.config;
+}
+/**
+ * Check if a class is a tool provider
+ */
+export function isToolProvider(target) {
+    return !!target.constructor?.__toolProvider__;
+}
+//# sourceMappingURL=ToolProvider.js.map

package/dist/esm/src/decorators/ToolProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolProvider.js","sourceRoot":"","sources":["../../../../src/decorators/ToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,oEAAoE;AACpE,IAAI,eAAe,GAAmC,IAAI,CAAC;AAE3D,SAAS,eAAe;IACtB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,0DAA0D;QAC1D,eAAe,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAAC,YAAY,CAAC;IAChF,CAAC;IACD,OAAO,eAAgB,CAAC;AAC1B,CAAC;AAoDD,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAC1B,mBAAgD;IAEhD,OAAO,UAAkD,WAAc;QACrE,kCAAkC;QAClC,MAAM,MAAM,GAAuB,OAAO,mBAAmB,KAAK,QAAQ;YACxE,CAAC,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE;YACtC,CAAC,CAAC,mBAAmB,CAAC;QAExB,qCAAqC;QACpC,WAAmB,CAAC,gBAAgB,GAAG;YACtC,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,MAAM;YACN,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAC;QAEF,sEAAsE;QACtE,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7B,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,KAAK,GAAG,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACtD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE;gBAC1B,8CAA8C;gBAC9C,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC5C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;gBACxC,CAAC;gBACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACnE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;gBACpC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,MAAM,kBAAkB,GAAG,KAAM,SAAQ,WAAW;YAClD,YAAY,GAAG,IAAW;gBACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;gBAEf,oDAAoD;gBACpD,uCAAuC;gBACvC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;oBAC7B,IAAI,EAAE,EAAE,CAAC;wBACP,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;oBACxB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,qDAAqD,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;oBACxF,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;QAEF,6CAA6C;QAC7C,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,MAAM,EAAE;YAChD,KAAK,EAAE,WAAW,CAAC,IAAI;YACvB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,gCAAgC,WAAW,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAEvF,OAAO,kBAAuB,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAW;IAC/C,OAAO,MAAM,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAW;IACxC,OAAO,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC;AAChD,CAAC"}

package/dist/esm/src/decorators/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Supernal AI Interface - Decorator System Exports
+ *
+ * Enhanced decorators for automatic AI tool generation with safety controls.
+ */
+export { Tool, ToolConfig, ToolMetadata } from './Tool';
+export { ToolProvider, ToolProviderConfig, getToolProviderConfig, isToolProvider, } from './ToolProvider';
+export { Component, ComponentConfig, getComponentConfig, isComponent, } from './Component';
+export { AITool, DangerousTool, DestructiveTool, TestTool, OnboardingTool, DataReadTool, DataWriteTool, NavigationTool, AIAndTestTool, OnboardingAndTestTool, SpecializedTools, } from './SpecializedTools';
+export type { SpecializedToolType } from './SpecializedTools';
+export { ToolPreset, getToolPreset, applyPreset, registerPendingPreset, clearToolPresets, PresetTemplates, createPreset, containerPreset, pathPreset, } from './ToolPreset';
+export type { ToolOptions } from '../types/Tool';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,MAAM,EACN,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/src/decorators/index.js

@@ -0,0 +1,14 @@
+/**
+ * Supernal AI Interface - Decorator System Exports
+ *
+ * Enhanced decorators for automatic AI tool generation with safety controls.
+ */
+// Base decorators
+export { Tool } from './Tool.js';
+export { ToolProvider, getToolProviderConfig, isToolProvider, } from './ToolProvider.js';
+export { Component, getComponentConfig, isComponent, } from './Component.js';
+// Specialized decorators (simplified API)
+export { AITool, DangerousTool, DestructiveTool, TestTool, OnboardingTool, DataReadTool, DataWriteTool, NavigationTool, AIAndTestTool, OnboardingAndTestTool, SpecializedTools, } from './SpecializedTools.js';
+// Preset system for DRY configuration
+export { ToolPreset, getToolPreset, applyPreset, registerPendingPreset, clearToolPresets, PresetTemplates, createPreset, containerPreset, pathPreset, } from './ToolPreset.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/src/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EAAE,IAAI,EAA4B,MAAM,QAAQ,CAAC;AACxD,OAAO,EACL,YAAY,EAEZ,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EAET,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,0CAA0C;AAC1C,OAAO,EACL,MAAM,EACN,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,sCAAsC;AACtC,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC"}

package/dist/esm/src/execution/DOMExecutor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * DOM Executor
+ *
+ * Executes tools in live browser environment using DOM APIs.
+ * Handles real-time UI interactions and browser automation.
+ */
+import { ToolMetadata } from '../decorators/Tool';
+import { UniversalExecutionContext, UniversalToolResult } from '../background/registry/ToolRegistry';
+export declare class DOMExecutor {
+    /**
+     * Execute a tool in live DOM context
+     */
+    execute(tool: ToolMetadata, parameters: any, context: UniversalExecutionContext): Promise<UniversalToolResult>;
+    /**
+     * Execute UI-based tool using DOM APIs
+     */
+    private executeUITool;
+    /**
+     * Execute API tool using fetch
+     */
+    private executeAPITool;
+    /**
+     * Perform UI action on element
+     */
+    private performUIAction;
+    /**
+     * Wait for element to appear
+     */
+    waitForElement(selector: string, timeout?: number): Promise<Element | null>;
+    /**
+     * Wait for condition to be true
+     */
+    waitForCondition(condition: () => boolean, timeout?: number): Promise<boolean>;
+    /**
+     * Get element information
+     */
+    getElementInfo(element: Element): any;
+    /**
+     * Take screenshot (if supported)
+     */
+    captureScreenshot(): Promise<string | null>;
+}
+//# sourceMappingURL=DOMExecutor.d.ts.map

package/dist/esm/src/execution/DOMExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DOMExecutor.d.ts","sourceRoot":"","sources":["../../../../src/execution/DOMExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAErG,qBAAa,WAAW;IACtB;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,GAAG,EACf,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC;IAyB/B;;OAEG;YACW,aAAa;IAqC3B;;OAEG;YACW,cAAc;IA0D5B;;OAEG;YACW,eAAe;IAkD7B;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAcvF;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,OAAO,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1F;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG;IAgBrC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAelD"}