nitrostack 1.0.0

package/dist/core/builders.js

@@ -0,0 +1,129 @@
+import { Tool } from './tool.js';
+import { createResource } from './resource.js';
+import { createPrompt } from './prompt.js';
+import { createComponentFromNextRoute } from '../ui-next/index.js';
+import { extractTools, extractResources, extractPrompts, getWidgetMetadata } from './decorators.js';
+import { getGuardsMetadata } from './guards/use-guards.decorator.js';
+import { getMiddlewareMetadata } from './middleware/middleware.decorator.js';
+import { getInterceptorMetadata } from './interceptors/interceptor.decorator.js';
+import { getPipeMetadata } from './pipes/pipe.decorator.js';
+import { getExceptionFilterMetadata } from './filters/exception-filter.decorator.js';
+import { DIContainer } from './di/container.js';
+import { isInjectable } from './di/injectable.decorator.js';
+/**
+ * Build a Tool instance from a decorated method
+ */
+export function buildTool(controllerInstance, methodName, options, widgetRoute) {
+    const prototype = Object.getPrototypeOf(controllerInstance);
+    // Get the original method
+    const originalMethod = controllerInstance[methodName].bind(controllerInstance);
+    // Extract all decorator metadata
+    const guards = getGuardsMetadata(prototype, methodName);
+    const middlewares = getMiddlewareMetadata(prototype, methodName);
+    const interceptors = getInterceptorMetadata(prototype, methodName);
+    const pipes = getPipeMetadata(prototype, methodName);
+    const filters = getExceptionFilterMetadata(prototype, methodName);
+    // Create tool with all metadata
+    const tool = new Tool({
+        name: options.name,
+        description: options.description,
+        inputSchema: options.inputSchema,
+        handler: originalMethod,
+        guards,
+        middlewares,
+        interceptors,
+        pipes,
+        filters,
+        examples: options.examples,
+        widget: widgetRoute ? { route: widgetRoute } : undefined,
+        outputTemplate: widgetRoute,
+    });
+    // Create and attach component if widget route is specified
+    if (widgetRoute) {
+        const component = createComponentFromNextRoute(widgetRoute);
+        tool.setComponent(component);
+    }
+    return tool;
+}
+/**
+ * Build all tools from a controller
+ */
+export function buildTools(controllerInstance) {
+    const toolMetadata = extractTools(Object.getPrototypeOf(controllerInstance).constructor);
+    return toolMetadata.map(({ methodName, options }) => {
+        // Check if this method has a widget
+        const widgetRoute = getWidgetMetadata(Object.getPrototypeOf(controllerInstance), methodName);
+        return buildTool(controllerInstance, methodName, options, widgetRoute);
+    });
+}
+/**
+ * Build a Resource instance from a decorated method
+ */
+export function buildResource(controllerInstance, methodName, options) {
+    const originalMethod = controllerInstance[methodName].bind(controllerInstance);
+    const resourceDefinition = {
+        uri: options.uri,
+        name: options.name,
+        description: options.description,
+        mimeType: options.mimeType,
+        handler: async (context) => {
+            return await originalMethod(context);
+        },
+        metadata: options.metadata,
+    };
+    return createResource(resourceDefinition);
+}
+/**
+ * Build all resources from a controller
+ */
+export function buildResources(controllerInstance) {
+    const resourceMetadata = extractResources(Object.getPrototypeOf(controllerInstance).constructor);
+    return resourceMetadata.map(({ methodName, options }) => {
+        return buildResource(controllerInstance, methodName, options);
+    });
+}
+/**
+ * Build a Prompt instance from a decorated method
+ */
+export function buildPrompt(controllerInstance, methodName, options) {
+    const originalMethod = controllerInstance[methodName].bind(controllerInstance);
+    const promptDefinition = {
+        name: options.name,
+        description: options.description,
+        arguments: options.arguments,
+        handler: async (args, context) => {
+            return await originalMethod(args, context);
+        },
+    };
+    return createPrompt(promptDefinition);
+}
+/**
+ * Build all prompts from a controller
+ */
+export function buildPrompts(controllerInstance) {
+    const promptMetadata = extractPrompts(Object.getPrototypeOf(controllerInstance).constructor);
+    return promptMetadata.map(({ methodName, options }) => {
+        return buildPrompt(controllerInstance, methodName, options);
+    });
+}
+/**
+ * Build all tools, resources, and prompts from a controller
+ * Supports dependency injection
+ */
+export function buildController(controller) {
+    const container = DIContainer.getInstance();
+    // Create controller instance (with DI if available)
+    let instance;
+    if (isInjectable(controller) && container.has(controller)) {
+        instance = container.resolve(controller);
+    }
+    else {
+        instance = new controller();
+    }
+    return {
+        tools: buildTools(instance),
+        resources: buildResources(instance),
+        prompts: buildPrompts(instance),
+    };
+}
+//# sourceMappingURL=builders.js.map

package/dist/core/builders.js.map

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

package/dist/core/component.d.ts

@@ -0,0 +1,105 @@
+import { ExecutionContext } from './types.js';
+/**
+ * Component metadata for UI rendering
+ */
+export interface ComponentMetadata {
+    /** Unique identifier for the component */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of what the component displays */
+    description?: string;
+    /** HTML content or path to HTML file */
+    html: string;
+    /** CSS content or path to CSS file */
+    css?: string;
+    /** JavaScript content or path to JS file */
+    js?: string;
+    /** Whether component can initiate tool calls */
+    canInvokeTools?: boolean;
+    /** Content Security Policy domains */
+    csp?: {
+        connectDomains?: string[];
+        resourceDomains?: string[];
+    };
+    /** Custom subdomain for component rendering */
+    subdomain?: string;
+    /** Whether to show border around component */
+    prefersBorder?: boolean;
+    /** Provider-specific metadata */
+    providerMetadata?: Record<string, any>;
+    /** Internal metadata (not exposed to MCP) */
+    _meta?: Record<string, any>;
+}
+/**
+ * Component definition
+ */
+export interface ComponentDefinition extends ComponentMetadata {
+    /** Data transformation function */
+    transformer?: (data: any, context: ExecutionContext) => any;
+    /** Component initialization logic */
+    onInit?: (context: ExecutionContext) => void | Promise<void>;
+}
+/**
+ * Component class for defining UI components
+ */
+export declare class Component {
+    private definition;
+    private compiled;
+    private bundle;
+    constructor(definition: ComponentDefinition);
+    private validateDefinition;
+    /**
+     * Get component ID
+     */
+    get id(): string;
+    /**
+     * Get component name
+     */
+    get name(): string;
+    /**
+     * Get component description
+     */
+    get description(): string | undefined;
+    /**
+     * Compile component bundle
+     */
+    compile(): Promise<void>;
+    /**
+     * Get compiled bundle as HTML document
+     */
+    getBundle(): string;
+    /**
+     * Get component URI for resource registration
+     */
+    getResourceUri(): string;
+    /**
+     * Check if component is in dev mode
+     */
+    isDevMode(): boolean;
+    /**
+     * Get dev URL if in dev mode
+     */
+    getDevUrl(): string | null;
+    /**
+     * Transform data for component
+     */
+    transformData(data: any, context: ExecutionContext): Promise<any>;
+    /**
+     * Get provider-specific metadata
+     */
+    getProviderMetadata(provider: 'openai' | 'anthropic' | 'generic'): Record<string, any>;
+    /**
+     * Get resource metadata for MCP
+     */
+    getResourceMetadata(): any;
+    /**
+     * Initialize component
+     */
+    initialize(context: ExecutionContext): Promise<void>;
+}
+/**
+ * Helper function to create a component
+ */
+export declare function createComponent(definition: ComponentDefinition): Component;
+//# sourceMappingURL=component.d.ts.map

package/dist/core/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/core/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IAEX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,sCAAsC;IACtC,GAAG,CAAC,EAAE;QACJ,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IAEF,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,mCAAmC;IACnC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,KAAK,GAAG,CAAC;IAE5D,qCAAqC;IACrC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAIG;gBAEL,UAAU,EAAE,mBAAmB;IAK3C,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;OAEG;IACH,SAAS,IAAI,MAAM;IAoBnB;;OAEG;IACH,cAAc,IAAI,MAAM;IAQxB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAOvE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAiDtF;;OAEG;IACH,mBAAmB,IAAI,GAAG;IAoB1B;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,SAAS,CAE1E"}

package/dist/core/component.js

@@ -0,0 +1,182 @@
+/**
+ * Component class for defining UI components
+ */
+export class Component {
+    definition;
+    compiled = false;
+    bundle = { html: '' };
+    constructor(definition) {
+        this.definition = definition;
+        this.validateDefinition();
+    }
+    validateDefinition() {
+        if (!this.definition.id) {
+            throw new Error('Component ID is required');
+        }
+        if (!this.definition.name) {
+            throw new Error('Component name is required');
+        }
+        if (!this.definition.html) {
+            throw new Error('Component HTML is required');
+        }
+    }
+    /**
+     * Get component ID
+     */
+    get id() {
+        return this.definition.id;
+    }
+    /**
+     * Get component name
+     */
+    get name() {
+        return this.definition.name;
+    }
+    /**
+     * Get component description
+     */
+    get description() {
+        return this.definition.description;
+    }
+    /**
+     * Compile component bundle
+     */
+    async compile() {
+        if (this.compiled)
+            return;
+        // Simple compilation - in production, use a proper bundler
+        this.bundle = {
+            html: this.definition.html,
+            css: this.definition.css,
+            js: this.definition.js,
+        };
+        this.compiled = true;
+    }
+    /**
+     * Get compiled bundle as HTML document
+     */
+    getBundle() {
+        if (!this.compiled) {
+            throw new Error('Component not compiled. Call compile() first.');
+        }
+        const cssTag = this.bundle.css
+            ? `<style>${this.bundle.css}</style>`
+            : '';
+        const jsTag = this.bundle.js
+            ? `<script type="module">${this.bundle.js}</script>`
+            : '';
+        return `
+${this.bundle.html}
+${cssTag}
+${jsTag}
+    `.trim();
+    }
+    /**
+     * Get component URI for resource registration
+     */
+    getResourceUri() {
+        // In dev mode, return the dev URL if available
+        if (this.definition._meta?.devMode && this.definition._meta?.devUrl) {
+            return this.definition._meta.devUrl;
+        }
+        return `ui://widget/${this.definition.id}.html`;
+    }
+    /**
+     * Check if component is in dev mode
+     */
+    isDevMode() {
+        return this.definition._meta?.devMode === true;
+    }
+    /**
+     * Get dev URL if in dev mode
+     */
+    getDevUrl() {
+        return this.definition._meta?.devUrl || null;
+    }
+    /**
+     * Transform data for component
+     */
+    async transformData(data, context) {
+        if (this.definition.transformer) {
+            return await this.definition.transformer(data, context);
+        }
+        return data;
+    }
+    /**
+     * Get provider-specific metadata
+     */
+    getProviderMetadata(provider) {
+        const metadata = {};
+        switch (provider) {
+            case 'openai':
+                metadata['openai/outputTemplate'] = this.getResourceUri();
+                metadata['openai/widgetAccessible'] = this.definition.canInvokeTools || false;
+                if (this.definition.description) {
+                    metadata['openai/widgetDescription'] = this.definition.description;
+                }
+                if (this.definition.prefersBorder) {
+                    metadata['openai/widgetPrefersBorder'] = true;
+                }
+                if (this.definition.subdomain) {
+                    metadata['openai/widgetDomain'] = this.definition.subdomain;
+                }
+                if (this.definition.csp) {
+                    metadata['openai/widgetCSP'] = {
+                        connect_domains: this.definition.csp.connectDomains || [],
+                        resource_domains: this.definition.csp.resourceDomains || [],
+                    };
+                }
+                break;
+            case 'anthropic':
+                // Future: Anthropic-specific metadata
+                metadata['anthropic/ui'] = this.getResourceUri();
+                break;
+            case 'generic':
+            default:
+                // Generic provider metadata
+                metadata['ui/template'] = this.getResourceUri();
+                metadata['ui/interactive'] = this.definition.canInvokeTools || false;
+                break;
+        }
+        // Merge with custom provider metadata
+        if (this.definition.providerMetadata) {
+            Object.assign(metadata, this.definition.providerMetadata);
+        }
+        return metadata;
+    }
+    /**
+     * Get resource metadata for MCP
+     */
+    getResourceMetadata() {
+        const metadata = {
+            mimeType: 'text/html',
+        };
+        // Add OpenAI-specific metadata
+        const openaiMeta = this.getProviderMetadata('openai');
+        if (openaiMeta['openai/widgetCSP']) {
+            metadata['openai/widgetCSP'] = openaiMeta['openai/widgetCSP'];
+        }
+        if (openaiMeta['openai/widgetDescription']) {
+            metadata['openai/widgetDescription'] = openaiMeta['openai/widgetDescription'];
+        }
+        if (openaiMeta['openai/widgetPrefersBorder']) {
+            metadata['openai/widgetPrefersBorder'] = openaiMeta['openai/widgetPrefersBorder'];
+        }
+        return metadata;
+    }
+    /**
+     * Initialize component
+     */
+    async initialize(context) {
+        if (this.definition.onInit) {
+            await this.definition.onInit(context);
+        }
+    }
+}
+/**
+ * Helper function to create a component
+ */
+export function createComponent(definition) {
+    return new Component(definition);
+}
+//# sourceMappingURL=component.js.map

package/dist/core/component.js.map

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

package/dist/core/config-module.d.ts

@@ -0,0 +1,55 @@
+import 'reflect-metadata';
+/**
+ * Configuration Module Options
+ */
+export interface ConfigModuleOptions {
+    /**
+     * Path to .env file (relative to project root)
+     */
+    envFilePath?: string;
+    /**
+     * Whether to ignore .env file if it doesn't exist
+     */
+    ignoreEnvFile?: boolean;
+    /**
+     * Whether to validate environment variables
+     */
+    validate?: (config: Record<string, any>) => boolean;
+    /**
+     * Default values for environment variables
+     */
+    defaults?: Record<string, string>;
+}
+/**
+ * Configuration Service
+ * Provides type-safe access to environment variables
+ */
+export declare class ConfigService {
+    private config;
+    constructor(options?: ConfigModuleOptions);
+    /**
+     * Get a configuration value
+     */
+    get<T = string>(key: string): T | undefined;
+    get<T = string>(key: string, defaultValue: T): T;
+    /**
+     * Get a required configuration value
+     * Throws if not found
+     */
+    getOrThrow<T = string>(key: string): T;
+    /**
+     * Get all configuration
+     */
+    getAll(): Record<string, string>;
+}
+/**
+ * Configuration Module
+ * NestJS-style configuration management
+ */
+export declare class ConfigModule {
+    static forRoot(options?: ConfigModuleOptions): {
+        providers: any[];
+        exports: any[];
+    };
+}
+//# sourceMappingURL=config-module.d.ts.map

package/dist/core/config-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-module.d.ts","sourceRoot":"","sources":["../../src/core/config-module.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;IAEpD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAyCD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAyB;gBAE3B,OAAO,GAAE,mBAAwB;IAqB7C;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAC3C,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC;IAShD;;;OAGG;IACH,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAQtC;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGjC;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG;QACjD,SAAS,EAAE,GAAG,EAAE,CAAC;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC;KAChB;CAQF"}

package/dist/core/config-module.js

@@ -0,0 +1,94 @@
+import 'reflect-metadata';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Parse .env file manually to avoid stdout pollution
+ * (dotenv.config() can write to stdout which breaks MCP stdio protocol)
+ */
+function parseEnvFile(filePath) {
+    const envVars = {};
+    if (!fs.existsSync(filePath)) {
+        return envVars;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    content.split('\n').forEach(line => {
+        line = line.trim();
+        // Skip empty lines and comments
+        if (!line || line.startsWith('#')) {
+            return;
+        }
+        // Parse KEY=VALUE
+        const [key, ...valueParts] = line.split('=');
+        if (key && valueParts.length > 0) {
+            let value = valueParts.join('=').trim();
+            // Remove quotes if present
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            envVars[key.trim()] = value;
+        }
+    });
+    return envVars;
+}
+/**
+ * Configuration Service
+ * Provides type-safe access to environment variables
+ */
+export class ConfigService {
+    config;
+    constructor(options = {}) {
+        this.config = { ...options.defaults };
+        // Load environment variables from .env file
+        if (!options.ignoreEnvFile) {
+            const envPath = options.envFilePath || '.env';
+            const fullPath = path.resolve(process.cwd(), envPath);
+            const parsed = parseEnvFile(fullPath);
+            this.config = { ...this.config, ...parsed };
+        }
+        // Merge with process.env (already loaded by Studio)
+        this.config = { ...this.config, ...process.env };
+        // Validate if validator provided
+        if (options.validate && !options.validate(this.config)) {
+            throw new Error('Environment variable validation failed');
+        }
+    }
+    get(key, defaultValue) {
+        const value = this.config[key];
+        if (value === undefined) {
+            return defaultValue;
+        }
+        return value;
+    }
+    /**
+     * Get a required configuration value
+     * Throws if not found
+     */
+    getOrThrow(key) {
+        const value = this.get(key);
+        if (value === undefined) {
+            throw new Error(`Configuration key "${key}" is required but not found`);
+        }
+        return value;
+    }
+    /**
+     * Get all configuration
+     */
+    getAll() {
+        return { ...this.config };
+    }
+}
+/**
+ * Configuration Module
+ * NestJS-style configuration management
+ */
+export class ConfigModule {
+    static forRoot(options = {}) {
+        const configService = new ConfigService(options);
+        return {
+            providers: [configService],
+            exports: [ConfigService],
+        };
+    }
+}
+//# sourceMappingURL=config-module.js.map

package/dist/core/config-module.js.map

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

package/dist/core/decorators/cache.decorator.d.ts

@@ -0,0 +1,61 @@
+import 'reflect-metadata';
+/**
+ * Cache options
+ */
+export interface CacheOptions {
+    /** Time to live in seconds */
+    ttl: number;
+    /** Custom cache key generator */
+    key?: (input: any, context: any) => string;
+    /** Cache storage (default: in-memory) */
+    storage?: CacheStorage;
+}
+/**
+ * Cache storage interface
+ */
+export interface CacheStorage {
+    get(key: string): Promise<any> | any;
+    set(key: string, value: any, ttl: number): Promise<void> | void;
+    delete(key: string): Promise<void> | void;
+    clear(): Promise<void> | void;
+}
+/**
+ * Default in-memory cache storage
+ */
+export declare class InMemoryCacheStorage implements CacheStorage {
+    private cache;
+    get(key: string): any;
+    set(key: string, value: any, ttl: number): void;
+    delete(key: string): void;
+    clear(): void;
+    private cleanup;
+}
+/**
+ * Cache decorator - caches tool results for a specified duration
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'get_products', ... })
+ * @Cache({ ttl: 300 }) // Cache for 5 minutes
+ * async getProducts(input: any) {
+ *   return await this.database.query('SELECT * FROM products');
+ * }
+ *
+ * // With custom cache key
+ * @Cache({
+ *   ttl: 300,
+ *   key: (input) => `products:${input.category}`
+ * })
+ * async getProducts(input: any) { }
+ * ```
+ */
+export declare function Cache(options: CacheOptions): MethodDecorator;
+/**
+ * Get cache options from metadata
+ */
+export declare function getCacheMetadata(target: any, propertyKey: string | symbol): CacheOptions | undefined;
+/**
+ * Clear cache for a specific key or all keys
+ */
+export declare function clearCache(key?: string): Promise<void>;
+//# sourceMappingURL=cache.decorator.d.ts.map

package/dist/core/decorators/cache.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/cache.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IAEZ,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;IAE3C,yCAAyC;IACzC,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,KAAK,CAAsD;IAEnE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAYrB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAO/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,OAAO;CAQhB;AAKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CA4C5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5D"}