@supernal/interface 1.0.0

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

@@ -0,0 +1,218 @@
+/**
+ * Specialized Tool Decorators
+ *
+ * Simplified, context-specific decorators that reduce boilerplate by providing
+ * sensible defaults for different use cases.
+ *
+ * DRY Principle: All specialized decorators inherit from base Tool decorator
+ * with context-specific overrides.
+ */
+import { ToolConfig } from './Tool';
+/**
+ * @AITool - Tools that AI can safely use
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @AITool({ toolId: 'search-button' })
+ * async search(query: string) {
+ *   return await api.search(query);
+ * }
+ * ```
+ */
+export declare const AITool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @DangerousTool - Tools that require approval before AI can use
+ *
+ * Default Configuration:
+ * - aiEnabled: true (but requires approval)
+ * - toolType: 'ai-dangerous'
+ * - dangerLevel: 'dangerous'
+ * - requiresApproval: true
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @DangerousTool({
+ *   toolId: 'delete-account',
+ *   description: 'Permanently delete user account'
+ * })
+ * async deleteAccount(userId: string) {
+ *   return await api.deleteAccount(userId);
+ * }
+ * ```
+ */
+export declare const DangerousTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @DestructiveTool - Tools for irreversible, destructive operations
+ *
+ * Default Configuration:
+ * - aiEnabled: true (but requires approval)
+ * - toolType: 'ai-dangerous'
+ * - dangerLevel: 'destructive'
+ * - requiresApproval: true
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @DestructiveTool({
+ *   toolId: 'purge-database',
+ *   description: 'Delete all data - cannot be undone'
+ * })
+ * async purgeDatabase() {
+ *   return await api.purgeAllData();
+ * }
+ * ```
+ */
+export declare const DestructiveTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @TestTool - Tools exclusively for testing (AI cannot use)
+ *
+ * Default Configuration:
+ * - aiEnabled: false
+ * - toolType: 'test-only'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @TestTool({ toolId: 'test-helper' })
+ * async seedTestData() {
+ *   return await db.seedTestData();
+ * }
+ * ```
+ */
+export declare const TestTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @OnboardingTool - Tools for user tutorials and feature tours
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true (critical for onboarding flows)
+ * - category: ToolCategory.ONBOARDING
+ *
+ * @example
+ * ```typescript
+ * @OnboardingTool({
+ *   toolId: 'show-tooltip',
+ *   description: 'Display contextual help tooltip'
+ * })
+ * async showTooltip(elementId: string, message: string) {
+ *   return showTooltip(elementId, message);
+ * }
+ * ```
+ */
+export declare const OnboardingTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @DataReadTool - Safe read-only data access tools
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - category: ToolCategory.DATA
+ *
+ * @example
+ * ```typescript
+ * @DataReadTool({ toolId: 'fetch-users' })
+ * async fetchUsers(filters: UserFilters) {
+ *   return await api.getUsers(filters);
+ * }
+ * ```
+ */
+export declare const DataReadTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @DataWriteTool - Tools that create/update data (requires approval)
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-restricted'
+ * - dangerLevel: 'moderate'
+ * - requiresApproval: true
+ * - category: ToolCategory.DATA
+ *
+ * @example
+ * ```typescript
+ * @DataWriteTool({ toolId: 'update-profile' })
+ * async updateProfile(userId: string, data: ProfileData) {
+ *   return await api.updateUser(userId, data);
+ * }
+ * ```
+ */
+export declare const DataWriteTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @NavigationTool - Tools for page/view navigation
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - category: ToolCategory.NAVIGATION
+ * - executionContext: 'ui'
+ *
+ * @example
+ * ```typescript
+ * @NavigationTool({ toolId: 'goto-settings' })
+ * async goToSettings() {
+ *   router.push('/settings');
+ * }
+ * ```
+ */
+export declare const NavigationTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @AIAndTestTool - Tools for both AI use and testing
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @AIAndTestTool({ toolId: 'search' })
+ * async search(query: string) {
+ *   return await api.search(query);
+ * }
+ * ```
+ */
+export declare const AIAndTestTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+/**
+ * @OnboardingAndTestTool - Tools for onboarding flows and testing
+ *
+ * Alias for OnboardingTool (they have the same config)
+ */
+export declare const OnboardingAndTestTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare const SpecializedTools: {
+    readonly AITool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly DangerousTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly DestructiveTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly TestTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly OnboardingTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly DataReadTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly DataWriteTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly NavigationTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly AIAndTestTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+    readonly OnboardingAndTestTool: (config?: Partial<ToolConfig>) => (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+};
+export type SpecializedToolType = keyof typeof SpecializedTools;
+//# sourceMappingURL=SpecializedTools.d.ts.map

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

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

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

@@ -0,0 +1,383 @@
+/**
+ * Specialized Tool Decorators
+ *
+ * Simplified, context-specific decorators that reduce boilerplate by providing
+ * sensible defaults for different use cases.
+ *
+ * DRY Principle: All specialized decorators inherit from base Tool decorator
+ * with context-specific overrides.
+ */
+import { Tool } from './Tool.js';
+import { ToolCategory } from '../types/index.js';
+import { applyPreset, registerPendingPreset } from './ToolPreset.js';
+/**
+ * Base function to create specialized tool decorators
+ * DRY: All specialized decorators use this factory
+ *
+ * Merge order (highest priority first):
+ * 1. User config (explicit overrides)
+ * 2. Preset config (class-level @ToolPreset) - applied retroactively
+ * 3. Specialized defaults (from decorator type)
+ * 4. Base defaults (from Tool decorator)
+ */
+function createSpecializedTool(defaults) {
+    return function (config = {}) {
+        // Return decorator function that can access target
+        return function (target, propertyKey, descriptor) {
+            // Get preset if available (only for class methods)
+            // Note: Preset might not be registered yet due to decorator execution order
+            const preset = propertyKey ? applyPreset(target, {}) : {};
+            // Merge with correct priority:
+            // config (user) > preset > defaults (specialized)
+            const mergedConfig = {
+                ...defaults, // Specialized defaults (lowest priority)
+                ...preset, // Preset (middle priority) - might be empty initially
+                ...config, // User config (highest priority)
+                // Deep merge nested objects
+                permissions: {
+                    ...defaults.permissions,
+                    ...preset.permissions,
+                    ...config.permissions,
+                },
+                callbacks: {
+                    ...defaults.callbacks,
+                    ...preset.callbacks,
+                    ...config.callbacks,
+                },
+                origin: {
+                    ...defaults.origin,
+                    ...preset.origin,
+                    ...config.origin,
+                },
+            };
+            // Apply the base Tool decorator
+            const result = Tool(mergedConfig)(target, propertyKey, descriptor);
+            // Register this tool as pending preset application (for class methods only)
+            if (propertyKey) {
+                const className = target.constructor?.name || 'Unknown';
+                const methodName = String(propertyKey);
+                const toolId = `${className}.${methodName}`;
+                registerPendingPreset(className, toolId, config); // Pass user config
+            }
+            return result;
+        };
+    };
+}
+// ============================================================================
+// AI-Enabled Tools
+// ============================================================================
+/**
+ * @AITool - Tools that AI can safely use
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @AITool({ toolId: 'search-button' })
+ * async search(query: string) {
+ *   return await api.search(query);
+ * }
+ * ```
+ */
+export const AITool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-safe',
+    dangerLevel: 'safe',
+    requiresApproval: false,
+    generateSimulation: true,
+    generateStories: true,
+    permissions: {
+        level: 'auto_approve',
+        sensitiveDataAccess: false,
+        networkAccess: false,
+    },
+});
+/**
+ * @DangerousTool - Tools that require approval before AI can use
+ *
+ * Default Configuration:
+ * - aiEnabled: true (but requires approval)
+ * - toolType: 'ai-dangerous'
+ * - dangerLevel: 'dangerous'
+ * - requiresApproval: true
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @DangerousTool({
+ *   toolId: 'delete-account',
+ *   description: 'Permanently delete user account'
+ * })
+ * async deleteAccount(userId: string) {
+ *   return await api.deleteAccount(userId);
+ * }
+ * ```
+ */
+export const DangerousTool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-dangerous',
+    dangerLevel: 'dangerous',
+    requiresApproval: true,
+    generateSimulation: true,
+    generateStories: true,
+    permissions: {
+        level: 'approve_once',
+        sensitiveDataAccess: true,
+        networkAccess: true,
+    },
+});
+/**
+ * @DestructiveTool - Tools for irreversible, destructive operations
+ *
+ * Default Configuration:
+ * - aiEnabled: true (but requires approval)
+ * - toolType: 'ai-dangerous'
+ * - dangerLevel: 'destructive'
+ * - requiresApproval: true
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @DestructiveTool({
+ *   toolId: 'purge-database',
+ *   description: 'Delete all data - cannot be undone'
+ * })
+ * async purgeDatabase() {
+ *   return await api.purgeAllData();
+ * }
+ * ```
+ */
+export const DestructiveTool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-dangerous',
+    dangerLevel: 'destructive',
+    requiresApproval: true,
+    generateSimulation: true,
+    generateStories: true,
+    permissions: {
+        level: 'approve_once',
+        sensitiveDataAccess: true,
+        networkAccess: true,
+    },
+});
+// ============================================================================
+// Testing Tools
+// ============================================================================
+/**
+ * @TestTool - Tools exclusively for testing (AI cannot use)
+ *
+ * Default Configuration:
+ * - aiEnabled: false
+ * - toolType: 'test-only'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @TestTool({ toolId: 'test-helper' })
+ * async seedTestData() {
+ *   return await db.seedTestData();
+ * }
+ * ```
+ */
+export const TestTool = createSpecializedTool({
+    aiEnabled: false,
+    toolType: 'test-only',
+    dangerLevel: 'safe',
+    requiresApproval: false,
+    generateSimulation: true,
+    generateStories: true,
+});
+// ============================================================================
+// Onboarding & Help Tools
+// ============================================================================
+/**
+ * @OnboardingTool - Tools for user tutorials and feature tours
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true (critical for onboarding flows)
+ * - category: ToolCategory.ONBOARDING
+ *
+ * @example
+ * ```typescript
+ * @OnboardingTool({
+ *   toolId: 'show-tooltip',
+ *   description: 'Display contextual help tooltip'
+ * })
+ * async showTooltip(elementId: string, message: string) {
+ *   return showTooltip(elementId, message);
+ * }
+ * ```
+ */
+export const OnboardingTool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-safe',
+    dangerLevel: 'safe',
+    requiresApproval: false,
+    generateSimulation: true,
+    generateStories: true, // Critical for onboarding flows
+    category: ToolCategory.ONBOARDING,
+});
+// ============================================================================
+// Data Tools
+// ============================================================================
+/**
+ * @DataReadTool - Safe read-only data access tools
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - category: ToolCategory.DATA
+ *
+ * @example
+ * ```typescript
+ * @DataReadTool({ toolId: 'fetch-users' })
+ * async fetchUsers(filters: UserFilters) {
+ *   return await api.getUsers(filters);
+ * }
+ * ```
+ */
+export const DataReadTool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-safe',
+    dangerLevel: 'safe',
+    requiresApproval: false,
+    category: ToolCategory.DATA,
+    permissions: {
+        level: 'auto_approve',
+        sensitiveDataAccess: false,
+        networkAccess: true,
+    },
+});
+/**
+ * @DataWriteTool - Tools that create/update data (requires approval)
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-restricted'
+ * - dangerLevel: 'moderate'
+ * - requiresApproval: true
+ * - category: ToolCategory.DATA
+ *
+ * @example
+ * ```typescript
+ * @DataWriteTool({ toolId: 'update-profile' })
+ * async updateProfile(userId: string, data: ProfileData) {
+ *   return await api.updateUser(userId, data);
+ * }
+ * ```
+ */
+export const DataWriteTool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-restricted',
+    dangerLevel: 'moderate',
+    requiresApproval: true,
+    category: ToolCategory.DATA,
+    permissions: {
+        level: 'approve_once',
+        sensitiveDataAccess: true,
+        networkAccess: true,
+    },
+});
+// ============================================================================
+// Navigation Tools
+// ============================================================================
+/**
+ * @NavigationTool - Tools for page/view navigation
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - category: ToolCategory.NAVIGATION
+ * - executionContext: 'ui'
+ *
+ * @example
+ * ```typescript
+ * @NavigationTool({ toolId: 'goto-settings' })
+ * async goToSettings() {
+ *   router.push('/settings');
+ * }
+ * ```
+ */
+export const NavigationTool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-safe',
+    dangerLevel: 'safe',
+    requiresApproval: false,
+    category: ToolCategory.NAVIGATION,
+    executionContext: 'ui',
+    callbacks: {
+        navigation: true,
+    },
+});
+// ============================================================================
+// Combined Tools (Multiple Contexts)
+// ============================================================================
+/**
+ * @AIAndTestTool - Tools for both AI use and testing
+ *
+ * Default Configuration:
+ * - aiEnabled: true
+ * - toolType: 'ai-safe'
+ * - dangerLevel: 'safe'
+ * - requiresApproval: false
+ * - generateSimulation: true
+ * - generateStories: true
+ *
+ * @example
+ * ```typescript
+ * @AIAndTestTool({ toolId: 'search' })
+ * async search(query: string) {
+ *   return await api.search(query);
+ * }
+ * ```
+ */
+export const AIAndTestTool = createSpecializedTool({
+    aiEnabled: true,
+    toolType: 'ai-safe',
+    dangerLevel: 'safe',
+    requiresApproval: false,
+    generateSimulation: true,
+    generateStories: true,
+});
+/**
+ * @OnboardingAndTestTool - Tools for onboarding flows and testing
+ *
+ * Alias for OnboardingTool (they have the same config)
+ */
+export const OnboardingAndTestTool = OnboardingTool;
+// ============================================================================
+// Export all specialized decorators
+// ============================================================================
+export const SpecializedTools = {
+    AITool,
+    DangerousTool,
+    DestructiveTool,
+    TestTool,
+    OnboardingTool,
+    DataReadTool,
+    DataWriteTool,
+    NavigationTool,
+    AIAndTestTool,
+    OnboardingAndTestTool,
+};
+//# sourceMappingURL=SpecializedTools.js.map

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

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