@pinepaper.studio/mcp-server 1.2.2 → 1.3.0

package/README.md

@@ -56,6 +56,54 @@ Open Claude Desktop and try:
 
 ## Features
 
+### 🔍 Asset Search & Import (NEW in v1.3.0)
+
+Search and import free SVG assets from multiple repositories:
+
+```
+"Search for a rocket icon"
+"Import a cat illustration"
+"Add a user avatar icon"
+```
+
+**Supported Repositories:**
+- **SVGRepo**: 500,000+ icons with various licenses
+- **OpenClipart**: 150,000+ public domain clipart (CC0)
+- **Iconify**: 200,000+ icons from multiple icon sets
+- **Font Awesome**: 2,000+ free icons (CC BY 4.0)
+
+**Tools:**
+- `pinepaper_search_assets` - Search across all repositories
+- `pinepaper_import_asset` - Import and place on canvas
+
+### 📊 Performance Metrics (NEW in v1.3.0)
+
+Built-in performance tracking helps Claude optimize workflows:
+
+- Automatic timing for all tool operations
+- Phase breakdown (validation, code generation, execution, screenshots)
+- Export formats: summary, detailed JSON, CSV
+- Self-optimization through `pinepaper_get_performance_metrics`
+
+**Example workflow:**
+```
+1. Run your scene creation workflow
+2. Call pinepaper_get_performance_metrics
+3. Identify bottlenecks (e.g., individual creates vs batch)
+4. Adjust approach and re-run
+```
+
+### 🐛 Enhanced Error Messages (NEW in v1.3.0)
+
+Errors now include canvas context for easier debugging:
+
+- Total item count and types
+- Active relations
+- Recent items created
+- Canvas state at time of error
+
+Makes troubleshooting much faster and more precise.
+
 ### 🎨 Item Creation
 
 Create text, shapes, and custom graphics:
@@ -127,6 +175,11 @@ Outputs pairs like:
 | `pinepaper_create_item` | Create text, shapes, graphics |
 | `pinepaper_modify_item` | Change item properties |
 | `pinepaper_delete_item` | Remove an item |
+| `pinepaper_batch_create` | Create multiple items at once |
+| `pinepaper_batch_modify` | Modify multiple items at once |
+| `pinepaper_create_grid` | Create items in a grid layout |
+| `pinepaper_create_glossy_sphere` | Create 3D glossy sphere effect |
+| `pinepaper_create_diagonal_stripes` | Create diagonal stripe pattern |
 
 ### Relation Tools
 | Tool | Description |
@@ -153,11 +206,18 @@ Outputs pairs like:
 |------|-------------|
 | `pinepaper_apply_effect` | Apply sparkle, blast effects |
 
+### Asset Tools (NEW)
+| Tool | Description |
+|------|-------------|
+| `pinepaper_search_assets` | Search for SVG assets across repositories |
+| `pinepaper_import_asset` | Import asset from search results |
+
 ### Query Tools
 | Tool | Description |
 |------|-------------|
 | `pinepaper_get_items` | Get canvas items |
 | `pinepaper_get_relation_stats` | Relation statistics |
+| `pinepaper_get_performance_metrics` | Get execution timing metrics (NEW) |
 
 ### Canvas Tools
 | Tool | Description |
@@ -366,10 +426,57 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
 | `PINEPAPER_DEBUG` | Enable debug logging | `false` |
 | `PINEPAPER_LOG_LEVEL` | Log level (error/warn/info/debug) | `info` |
 | `PINEPAPER_LOCALE` | Language locale code | `en` |
+| `PINEPAPER_METRICS_ENABLED` | Enable performance metrics tracking | `true` |
+| `PINEPAPER_METRICS_RETENTION` | Max metrics to retain in memory | `1000` |
+| `PINEPAPER_SCREENSHOT_MODE` | Screenshot mode (on_request/always/never) | `on_request` |
+
+### Performance Metrics
+
+PinePaper MCP Server includes built-in performance tracking to help Claude optimize workflows by identifying bottlenecks and choosing faster alternatives.
+
+**Key Features:**
+- ⚡ Automatic timing for all tool operations
+- 📊 Phase breakdown (validation, code generation, browser execution, screenshots)
+- 🎯 Real-time query via `pinepaper_get_performance_metrics` tool
+- 📈 Export formats: summary, JSON, CSV
+- 💾 In-memory storage (resets on restart)
+- 🚀 Minimal overhead (~1ms per operation)
+
+**Quick Example:**
+
+```
+Claude: "Let me check if batch operations are faster"
+→ pinepaper_get_performance_metrics(format: 'summary')
+
+Result:
+  - pinepaper_create_item: avg 145ms
+  - pinepaper_batch_create (10 items): avg 298ms (~30ms per item)
+
+Claude: "I'll use batch_create for the next 20 items"
+```
+
+**Configuration:**
+
+```bash
+# Disable metrics if not needed
+export PINEPAPER_METRICS_ENABLED=false
+
+# Increase retention for long sessions
+export PINEPAPER_METRICS_RETENTION=5000
+```
+
+**Learn More:** See [docs/PERFORMANCE_METRICS.md](docs/PERFORMANCE_METRICS.md) for complete documentation.
+
+## Documentation
+
+### Guides
+
+- **[Workflow Guide](docs/WORKFLOW_GUIDE.md)** - Decision trees, multi-step patterns, performance optimization, and troubleshooting
+- **[Performance Metrics](docs/PERFORMANCE_METRICS.md)** - In-memory metrics system for Claude self-optimization
+- **[PinePaper Reference](docs/CLAUDE_Pinepaper_v1_beta.md)** - Complete PinePaper Studio API reference
 
-## API Documentation
+### External Documentation
 
-Full API documentation available at:
 - [PinePaper API Docs](https://pinepaper.studio/docs/api)
 - [MCP Tools Specification](https://pinepaper.studio/docs/mcp)
 

package/dist/assets/asset-manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Asset Manager
+ *
+ * Coordinates asset searching, downloading, and caching across multiple repositories.
+ */
+import { AssetRepository, AssetResult, AssetMetadata, AssetCacheEntry } from './types.js';
+/**
+ * Asset Manager configuration
+ */
+export interface AssetManagerConfig {
+    /** Cache directory (default: .pinepaper-cache/assets) */
+    cacheDir?: string;
+    /** Enable caching (default: true) */
+    enableCache?: boolean;
+    /** Maximum cache size in MB (default: 100) */
+    maxCacheSizeMB?: number;
+    /** Repositories to enable (default: all) */
+    repositories?: ('svgrepo' | 'openclipart' | 'iconify' | 'fontawesome')[];
+}
+/**
+ * Asset Manager
+ *
+ * Provides unified interface for searching and downloading assets from multiple repositories.
+ */
+export declare class AssetManager {
+    private repositories;
+    private cache;
+    private config;
+    constructor(config?: AssetManagerConfig);
+    /**
+     * Register an asset repository
+     */
+    registerRepository(repository: AssetRepository): void;
+    /**
+     * Search for assets across repositories
+     *
+     * @param query Search term
+     * @param repository Specific repository to search (or 'all' for all repositories)
+     * @param limit Maximum results per repository
+     */
+    search(query: string, repository?: string, limit?: number): Promise<AssetResult[]>;
+    /**
+     * Download asset SVG content
+     *
+     * @param assetId Asset ID from search results
+     */
+    download(assetId: string): Promise<{
+        svg: string;
+        metadata: AssetMetadata;
+    }>;
+    /**
+     * Get asset from cache
+     */
+    getCached(assetId: string): AssetCacheEntry | null;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+}
+/**
+ * Get or create the global asset manager instance
+ */
+export declare function getAssetManager(config?: AssetManagerConfig): AssetManager;
+/**
+ * Reset the global asset manager (mainly for testing)
+ */
+export declare function resetAssetManager(): void;
+//# sourceMappingURL=asset-manager.d.ts.map

package/dist/assets/asset-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-manager.d.ts","sourceRoot":"","sources":["../../src/assets/asset-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM1F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,CAAC,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,CAAC,EAAE,CAAC;CAC1E;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,GAAE,kBAAuB;IAuB3C;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAIrD;;;;;;OAMG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAc,EAC1B,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC;IA8BzB;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAA;KAAE,CAAC;IAqClF;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAIlD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB;CAMF;AAKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAKzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/assets/asset-manager.js

@@ -0,0 +1,156 @@
+/**
+ * Asset Manager
+ *
+ * Coordinates asset searching, downloading, and caching across multiple repositories.
+ */
+import { createSVGRepoAdapter } from './repositories/svgrepo.js';
+import { createOpenClipartAdapter } from './repositories/openclipart.js';
+import { createIconifyAdapter } from './repositories/iconify.js';
+import { createFontAwesomeAdapter } from './repositories/fontawesome.js';
+/**
+ * Asset Manager
+ *
+ * Provides unified interface for searching and downloading assets from multiple repositories.
+ */
+export class AssetManager {
+    repositories = new Map();
+    cache = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = {
+            cacheDir: config.cacheDir || '.pinepaper-cache/assets',
+            enableCache: config.enableCache ?? true,
+            maxCacheSizeMB: config.maxCacheSizeMB || 100,
+            repositories: config.repositories || ['svgrepo', 'openclipart', 'iconify', 'fontawesome'],
+        };
+        // Register default repositories based on config
+        if (this.config.repositories?.includes('svgrepo')) {
+            this.registerRepository(createSVGRepoAdapter());
+        }
+        if (this.config.repositories?.includes('openclipart')) {
+            this.registerRepository(createOpenClipartAdapter());
+        }
+        if (this.config.repositories?.includes('iconify')) {
+            this.registerRepository(createIconifyAdapter());
+        }
+        if (this.config.repositories?.includes('fontawesome')) {
+            this.registerRepository(createFontAwesomeAdapter());
+        }
+    }
+    /**
+     * Register an asset repository
+     */
+    registerRepository(repository) {
+        this.repositories.set(repository.name, repository);
+    }
+    /**
+     * Search for assets across repositories
+     *
+     * @param query Search term
+     * @param repository Specific repository to search (or 'all' for all repositories)
+     * @param limit Maximum results per repository
+     */
+    async search(query, repository = 'all', limit = 10) {
+        const results = [];
+        if (repository === 'all') {
+            // Search all repositories
+            for (const [_, repo] of this.repositories) {
+                try {
+                    const repoResults = await repo.search(query, limit);
+                    results.push(...repoResults);
+                }
+                catch (error) {
+                    console.error(`[AssetManager] Error searching ${repo.name}:`, error);
+                    // Continue with other repositories
+                }
+            }
+        }
+        else {
+            // Search specific repository
+            const repo = this.repositories.get(repository);
+            if (!repo) {
+                throw new Error(`Repository '${repository}' not found`);
+            }
+            const repoResults = await repo.search(query, limit);
+            results.push(...repoResults);
+        }
+        // Sort by relevance (for now, just return as-is)
+        // In production, implement relevance scoring
+        return results.slice(0, limit);
+    }
+    /**
+     * Download asset SVG content
+     *
+     * @param assetId Asset ID from search results
+     */
+    async download(assetId) {
+        // Check cache first
+        if (this.config.enableCache) {
+            const cached = this.cache.get(assetId);
+            if (cached) {
+                return {
+                    svg: cached.svg,
+                    metadata: cached.metadata,
+                };
+            }
+        }
+        // Extract repository from asset ID (format: "repository_id")
+        const parts = assetId.split('_');
+        const repositoryName = parts[0];
+        const repository = this.repositories.get(repositoryName);
+        if (!repository) {
+            throw new Error(`Repository '${repositoryName}' not found in asset ID: ${assetId}`);
+        }
+        // Download asset
+        const svg = await repository.download(assetId);
+        const metadata = await repository.getMetadata(assetId);
+        // Cache the result
+        if (this.config.enableCache) {
+            this.cache.set(assetId, {
+                svg,
+                metadata,
+                cachedAt: Date.now(),
+            });
+        }
+        return { svg, metadata };
+    }
+    /**
+     * Get asset from cache
+     */
+    getCached(assetId) {
+        return this.cache.get(assetId) || null;
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys()),
+        };
+    }
+}
+// Global singleton instance
+let globalAssetManager = null;
+/**
+ * Get or create the global asset manager instance
+ */
+export function getAssetManager(config) {
+    if (!globalAssetManager) {
+        globalAssetManager = new AssetManager(config);
+    }
+    return globalAssetManager;
+}
+/**
+ * Reset the global asset manager (mainly for testing)
+ */
+export function resetAssetManager() {
+    globalAssetManager = null;
+}
+//# sourceMappingURL=asset-manager.js.map

package/dist/assets/asset-manager.js.map

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

package/dist/assets/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Assets Module
+ *
+ * Asset fetching from open SVG repositories (SVGRepo, OpenClipart, Iconify, FontAwesome)
+ */
+export * from './types.js';
+export * from './asset-manager.js';
+export * from './repositories/svgrepo.js';
+export * from './repositories/openclipart.js';
+export * from './repositories/iconify.js';
+export * from './repositories/fontawesome.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/assets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC"}

package/dist/assets/index.js

@@ -0,0 +1,12 @@
+/**
+ * Assets Module
+ *
+ * Asset fetching from open SVG repositories (SVGRepo, OpenClipart, Iconify, FontAwesome)
+ */
+export * from './types.js';
+export * from './asset-manager.js';
+export * from './repositories/svgrepo.js';
+export * from './repositories/openclipart.js';
+export * from './repositories/iconify.js';
+export * from './repositories/fontawesome.js';
+//# sourceMappingURL=index.js.map

package/dist/assets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC"}

package/dist/assets/repositories/fontawesome.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Font Awesome Asset Repository Adapter
+ *
+ * Fetches free SVG icons from Font Awesome
+ * Repository info: 2,000+ free icons (CC BY 4.0 license)
+ */
+import { AssetRepository, AssetResult, AssetMetadata } from '../types.js';
+/**
+ * Font Awesome adapter
+ *
+ * Provides access to Font Awesome free icons
+ * Note: This uses the CDN for SVG delivery since Font Awesome doesn't have a public search API
+ */
+export declare class FontAwesomeAdapter implements AssetRepository {
+    name: string;
+    private cdnBase;
+    /**
+     * Font Awesome Free icon categories and common icons
+     * Since FA doesn't have a public search API, we maintain a curated list
+     */
+    private iconDatabase;
+    /**
+     * Search for icons
+     */
+    search(query: string, limit: number): Promise<AssetResult[]>;
+    /**
+     * Create asset result for an icon
+     */
+    private createResult;
+    /**
+     * Download SVG content
+     */
+    download(assetId: string): Promise<string>;
+    /**
+     * Get asset metadata
+     */
+    getMetadata(assetId: string): Promise<AssetMetadata>;
+}
+/**
+ * Create Font Awesome adapter instance
+ */
+export declare function createFontAwesomeAdapter(): AssetRepository;
+//# sourceMappingURL=fontawesome.d.ts.map

package/dist/assets/repositories/fontawesome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontawesome.d.ts","sourceRoot":"","sources":["../../../src/assets/repositories/fontawesome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAkBxF;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,IAAI,SAAiB;IAErB,OAAO,CAAC,OAAO,CAAoE;IAEnF;;;OAGG;IACH,OAAO,CAAC,YAAY,CAgClB;IAEF;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6BlE;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmChD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAe3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D"}

package/dist/assets/repositories/fontawesome.js

@@ -0,0 +1,163 @@
+/**
+ * Font Awesome Asset Repository Adapter
+ *
+ * Fetches free SVG icons from Font Awesome
+ * Repository info: 2,000+ free icons (CC BY 4.0 license)
+ */
+/**
+ * Font Awesome adapter
+ *
+ * Provides access to Font Awesome free icons
+ * Note: This uses the CDN for SVG delivery since Font Awesome doesn't have a public search API
+ */
+export class FontAwesomeAdapter {
+    name = 'fontawesome';
+    cdnBase = 'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/svgs';
+    /**
+     * Font Awesome Free icon categories and common icons
+     * Since FA doesn't have a public search API, we maintain a curated list
+     */
+    iconDatabase = {
+        'user': ['user', 'user-circle', 'user-plus', 'user-minus', 'user-check', 'users'],
+        'arrow': ['arrow-up', 'arrow-down', 'arrow-left', 'arrow-right', 'arrows'],
+        'heart': ['heart', 'heart-circle-check', 'heart-pulse'],
+        'star': ['star', 'star-half'],
+        'home': ['home', 'house'],
+        'search': ['search', 'magnifying-glass'],
+        'settings': ['gear', 'cog', 'sliders'],
+        'mail': ['envelope', 'envelope-open', 'at'],
+        'phone': ['phone', 'mobile'],
+        'calendar': ['calendar', 'calendar-days'],
+        'clock': ['clock', 'hourglass'],
+        'check': ['check', 'check-circle', 'circle-check'],
+        'cross': ['xmark', 'times', 'circle-xmark'],
+        'plus': ['plus', 'circle-plus'],
+        'minus': ['minus', 'circle-minus'],
+        'trash': ['trash', 'trash-can'],
+        'edit': ['pen', 'pencil', 'pen-to-square'],
+        'file': ['file', 'file-lines', 'folder'],
+        'image': ['image', 'images', 'photo'],
+        'music': ['music', 'volume-high'],
+        'video': ['video', 'film'],
+        'download': ['download', 'cloud-arrow-down'],
+        'upload': ['upload', 'cloud-arrow-up'],
+        'link': ['link', 'chain'],
+        'lock': ['lock', 'unlock'],
+        'eye': ['eye', 'eye-slash'],
+        'location': ['location-dot', 'map-marker', 'map'],
+        'comment': ['comment', 'comments', 'message'],
+        'share': ['share', 'share-nodes'],
+        'print': ['print'],
+        'save': ['floppy-disk', 'save'],
+    };
+    /**
+     * Search for icons
+     */
+    async search(query, limit) {
+        const results = [];
+        const lowerQuery = query.toLowerCase();
+        // Search through our icon database
+        for (const [category, icons] of Object.entries(this.iconDatabase)) {
+            // Match category or icon names
+            if (category.includes(lowerQuery)) {
+                // Add all icons from matching category
+                for (const iconName of icons) {
+                    if (results.length >= limit)
+                        break;
+                    results.push(this.createResult(iconName, 'solid'));
+                }
+            }
+            else {
+                // Search individual icon names
+                for (const iconName of icons) {
+                    if (results.length >= limit)
+                        break;
+                    if (iconName.includes(lowerQuery)) {
+                        results.push(this.createResult(iconName, 'solid'));
+                    }
+                }
+            }
+            if (results.length >= limit)
+                break;
+        }
+        return results;
+    }
+    /**
+     * Create asset result for an icon
+     */
+    createResult(iconName, style) {
+        return {
+            id: `fontawesome_${style}_${iconName}`,
+            repository: 'fontawesome',
+            title: iconName.replace(/-/g, ' '),
+            description: `Font Awesome ${style} ${iconName} icon`,
+            previewUrl: `${this.cdnBase}/${style}/${iconName}.svg`,
+            downloadUrl: `${this.cdnBase}/${style}/${iconName}.svg`,
+            license: {
+                type: 'CC-BY-4.0',
+                name: 'Creative Commons Attribution 4.0',
+                requiresAttribution: true,
+                allowsCommercial: true,
+                url: 'https://fontawesome.com/license/free',
+            },
+            tags: [iconName, style],
+        };
+    }
+    /**
+     * Download SVG content
+     */
+    async download(assetId) {
+        try {
+            // Parse asset ID: fontawesome_solid_icon-name
+            const match = assetId.match(/fontawesome_([^_]+)_(.+)/);
+            if (!match) {
+                throw new Error(`Invalid FontAwesome asset ID: ${assetId}`);
+            }
+            const [, style, iconName] = match;
+            const svgUrl = `${this.cdnBase}/${style}/${iconName}.svg`;
+            const response = await fetch(svgUrl, {
+                headers: {
+                    'User-Agent': 'PinePaper-MCP-Server/1.2.2',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to download icon: ${response.status}`);
+            }
+            const svg = await response.text();
+            // Validate SVG
+            if (!svg.trim().startsWith('<svg') && !svg.includes('<svg')) {
+                throw new Error('Downloaded content is not valid SVG');
+            }
+            return svg;
+        }
+        catch (error) {
+            console.error('[FontAwesomeAdapter] Download error:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get asset metadata
+     */
+    async getMetadata(assetId) {
+        return {
+            id: assetId,
+            repository: this.name,
+            title: assetId.replace('fontawesome_', '').replace(/_/g, ' '),
+            license: {
+                type: 'CC-BY-4.0',
+                name: 'Creative Commons Attribution 4.0',
+                requiresAttribution: true,
+                allowsCommercial: true,
+                url: 'https://fontawesome.com/license/free',
+            },
+            downloadedAt: Date.now(),
+        };
+    }
+}
+/**
+ * Create Font Awesome adapter instance
+ */
+export function createFontAwesomeAdapter() {
+    return new FontAwesomeAdapter();
+}
+//# sourceMappingURL=fontawesome.js.map

package/dist/assets/repositories/fontawesome.js.map

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