@pinepaper.studio/mcp-server 1.0.0

package/dist/index.js

@@ -0,0 +1,472 @@
+/**
+ * PinePaper MCP Server
+ *
+ * Main server implementation that exposes PinePaper tools via the Model Context Protocol.
+ *
+ * This server can operate in two modes:
+ * 1. Local (stdio): For Claude Desktop and local AI agents
+ * 2. Cloud (SSE/HTTP): For cloud-hosted premium features (future)
+ *
+ * Supports i18n for 41 locales matching PinePaper Studio.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { PINEPAPER_TOOLS } from './tools/definitions.js';
+import { handleToolCall } from './tools/handlers.js';
+import { initI18n, DEFAULT_LOCALE, } from './i18n/index.js';
+// =============================================================================
+// SERVER INFO
+// =============================================================================
+const SERVER_INFO = {
+    name: 'pinepaper-mcp',
+    version: '1.0.0',
+    description: 'MCP Server for PinePaper Studio - Create animated graphics with AI',
+};
+// =============================================================================
+// RESOURCES (Documentation & Examples)
+// =============================================================================
+const RESOURCES = [
+    {
+        uri: 'pinepaper://docs/getting-started',
+        name: 'Getting Started Guide',
+        description: 'Introduction to PinePaper MCP tools',
+        mimeType: 'text/markdown',
+    },
+    {
+        uri: 'pinepaper://docs/relations',
+        name: 'Relations Guide',
+        description: 'How to use relations for behavior-driven animation',
+        mimeType: 'text/markdown',
+    },
+    {
+        uri: 'pinepaper://docs/generators',
+        name: 'Background Generators',
+        description: 'Available procedural background generators',
+        mimeType: 'text/markdown',
+    },
+    {
+        uri: 'pinepaper://examples/solar-system',
+        name: 'Solar System Example',
+        description: 'Create an animated solar system with orbiting planets',
+        mimeType: 'text/markdown',
+    },
+];
+const RESOURCE_CONTENTS = {
+    'pinepaper://docs/getting-started': `# Getting Started with PinePaper MCP
+
+## Overview
+
+PinePaper is a canvas-based animation tool. This MCP server lets you create and animate graphics using natural language.
+
+## Quick Start
+
+1. **Connect to browser**: Use \`pinepaper_browser_connect\` to launch PinePaper Studio
+2. **Clear the canvas**: Use \`pinepaper_clear_canvas\` or \`pinepaper_refresh_page\` to start fresh
+3. **Create items**: Use \`pinepaper_create_item\` to add text, shapes, or graphics
+4. **Add animation**: Use \`pinepaper_add_relation\` for behavior-based animation
+5. **Verify**: Use \`pinepaper_browser_screenshot\` to see your work
+6. **Export**: Use \`pinepaper_export_svg\` to save your work
+
+## IMPORTANT: Welcome Template
+
+First-time visitors to PinePaper Studio see a **welcome template** with example items on the canvas. Before creating your own content:
+
+### To Clear the Welcome Template:
+- **Option 1**: Use \`pinepaper_clear_canvas\` to remove all items
+- **Option 2**: Use \`pinepaper_refresh_page\` to reload the page (most reliable)
+- After clearing, verify with \`pinepaper_get_items\` that the canvas is empty
+
+The welcome template only appears once. After refreshing or clearing, it won't appear again.
+
+## Key Concepts
+
+### Items
+Everything on the canvas is an item with a registry ID (e.g., "item_1"). Use this ID to reference items in other operations.
+
+**Creating Items:**
+- Use \`pinepaper_create_item\` with \`itemType\` (text, circle, star, rectangle, etc.)
+- Specify \`position\` as {x, y} coordinates
+- Add \`properties\` for styling (color, fontSize, radius, etc.)
+
+### Relations (Primary Animation Method)
+Relations describe HOW items behave relative to each other. This is the **recommended way** to create animations:
+- \`orbits\`: Circular motion around another item
+- \`follows\`: Move toward another item with smoothing
+- \`attached_to\`: Fixed offset from parent item
+- \`points_at\`: Rotate to face another item
+- \`maintains_distance\`: Keep fixed distance from target
+
+**Verifying Animations:**
+After adding a relation, use \`pinepaper_browser_screenshot\` to verify the animation is working. Check that:
+1. Items are positioned correctly
+2. Animation is visibly moving (take multiple screenshots at intervals)
+3. The relation appears in \`pinepaper_query_relations\`
+
+### Deleting Items
+- Use \`pinepaper_delete_item\` with the item's registry ID
+- Use \`pinepaper_get_items\` first to find item IDs
+- If deletion fails, try \`pinepaper_clear_canvas\` to remove everything
+
+### Generators
+Procedural backgrounds like sunburst, waves, grid patterns.
+
+## Example Workflow
+
+\`\`\`
+1. Connect: pinepaper_browser_connect
+2. Clear canvas: pinepaper_clear_canvas (removes welcome template)
+3. Verify empty: pinepaper_get_items (should return count: 0)
+4. Create sun: pinepaper_create_item type=circle, color=#fbbf24, radius=60
+5. Create earth: pinepaper_create_item type=circle, color=#3b82f6, radius=20
+6. Add orbit: pinepaper_add_relation earth orbits sun, radius=150
+7. Screenshot: pinepaper_browser_screenshot (verify animation)
+\`\`\`
+`,
+    'pinepaper://docs/relations': `# Relations Guide
+
+Relations are the PRIMARY way to add animation in PinePaper. They describe behavior, not keyframes.
+
+## Why Relations?
+
+1. **Natural Language**: "moon orbits earth" is easier than specifying every frame
+2. **Compositional**: Multiple relations can work together
+3. **Training Data**: Relations generate instruction/code pairs for LLM fine-tuning
+
+## Available Relations
+
+### orbits
+Circular motion around target.
+- \`radius\`: Orbit radius in pixels
+- \`speed\`: Rotation speed (1 = normal)
+- \`direction\`: 'clockwise' or 'counterclockwise'
+- \`phase\`: Starting angle offset in degrees
+
+### follows
+Move toward target with smoothing.
+- \`offset\`: [x, y] offset from target
+- \`smoothing\`: 0-1 (lower = more responsive)
+- \`delay\`: Seconds of lag
+
+### attached_to
+Fixed offset from target (parent-child).
+- \`offset\`: [x, y] fixed offset
+- \`inherit_rotation\`: Also rotate with parent
+
+### maintains_distance
+Stay at fixed distance from target.
+- \`distance\`: Target distance in pixels
+- \`strength\`: How strongly to maintain (0-1)
+
+### points_at
+Rotate to face target.
+- \`offset_angle\`: Additional rotation
+- \`smoothing\`: Rotation smoothing
+
+### mirrors
+Mirror position across axis.
+- \`axis\`: 'vertical', 'horizontal', or 'both'
+- \`center\`: [x, y] mirror center
+
+### parallax
+Move relative to target by depth.
+- \`depth\`: 0-1 (0 = no movement, 1 = full movement)
+- \`origin\`: [x, y] parallax origin
+
+### bounds_to
+Stay within target's bounds.
+- \`padding\`: Inner padding
+- \`bounce\`: Bounce off edges
+
+## Verifying Animations Are Working
+
+After adding a relation, **always verify** that the animation is actually running:
+
+### Method 1: Take Multiple Screenshots
+Take 2-3 screenshots with a small delay between them:
+\`\`\`
+1. pinepaper_browser_screenshot (save position)
+2. Wait 1-2 seconds
+3. pinepaper_browser_screenshot (compare position)
+\`\`\`
+If the orbiting item has moved, the animation is working.
+
+### Method 2: Query Relations
+Use \`pinepaper_query_relations\` to confirm the relation was added:
+\`\`\`
+pinepaper_query_relations itemId=earth direction=outgoing
+\`\`\`
+Should return the orbits relation.
+
+### Method 3: Check Item Animation State
+Use \`pinepaper_get_items\` with filter \`hasRelation: true\` to see animated items.
+
+### Troubleshooting Animation Issues
+If animations don't appear to be working:
+1. Verify both source and target items exist with \`pinepaper_get_items\`
+2. Check the relation was added with \`pinepaper_query_relations\`
+3. Try refreshing the page with \`pinepaper_refresh_page\` and recreating
+4. For keyframe animations, ensure \`pinepaper_play_timeline\` was called
+
+## Composition Example
+
+An item can have multiple relations:
+
+\`\`\`
+// Planet orbits star AND label stays attached
+addRelation(planet, star, 'orbits', { radius: 200, speed: 0.5 })
+addRelation(label, planet, 'attached_to', { offset: [0, -30] })
+\`\`\`
+
+The label will follow the planet as it orbits the star!
+`,
+    'pinepaper://docs/generators': `# Background Generators
+
+Procedural backgrounds that create dynamic patterns.
+
+## Available Generators
+
+### drawSunburst
+Radial rays from center.
+- \`rayCount\`: Number of rays (default: 16)
+- \`colors\`: Array of ray colors
+- \`bgColor\`: Background color
+- \`animated\`: Enable rotation
+
+### drawSunsetScene
+Animated sunset with clouds.
+- \`sunColor\`: Sun fill color
+- \`skyColors\`: Array for gradient
+- \`cloudCount\`: Number of clouds
+
+### drawGrid
+Geometric grid patterns.
+- \`gridType\`: 'lines', 'dots', or 'squares'
+- \`spacing\`: Cell size
+- \`lineColor\`: Grid color
+
+### drawWaves
+Layered wave pattern.
+- \`waveCount\`: Number of layers
+- \`colors\`: Wave colors
+- \`amplitude\`: Wave height
+- \`animated\`: Animate waves
+
+### drawCircuit
+Tech circuit board.
+- \`lineColor\`: Circuit lines
+- \`nodeColor\`: Junction color
+- \`density\`: 0-1 complexity
+- \`animated\`: Enable bolt effect
+`,
+    'pinepaper://examples/solar-system': `# Solar System Example
+
+Create an animated solar system with orbiting planets.
+
+## Step by Step
+
+### 1. Set up the canvas
+\`\`\`
+Set background color to #0f172a (dark blue)
+\`\`\`
+
+### 2. Create the sun
+\`\`\`
+Create a yellow circle at position (400, 300) with radius 60
+→ This creates item_1 (the sun)
+\`\`\`
+
+### 3. Create Earth
+\`\`\`
+Create a blue circle at position (550, 300) with radius 20
+→ This creates item_2 (Earth)
+\`\`\`
+
+### 4. Create the Moon
+\`\`\`
+Create a gray circle at position (590, 300) with radius 8
+→ This creates item_3 (Moon)
+\`\`\`
+
+### 5. Add orbital relations
+\`\`\`
+Add relation: item_2 (Earth) orbits item_1 (Sun) at radius 150, speed 0.3
+Add relation: item_3 (Moon) orbits item_2 (Earth) at radius 40, speed 0.8
+\`\`\`
+
+### 6. Add labels (optional)
+\`\`\`
+Create text "Sun" at (400, 250)
+Add relation: text attached_to item_1 with offset [0, -70]
+\`\`\`
+
+## Result
+
+The Earth orbits the Sun, and the Moon orbits the Earth, all with smooth automatic animation!
+
+## Training Data
+
+This scene generates training pairs like:
+- "Earth orbits Sun at radius 150" → \`app.addRelation('item_2', 'item_1', 'orbits', {radius: 150})\`
+`,
+};
+// =============================================================================
+// SERVER CREATION
+// =============================================================================
+export async function createServer(options = {}) {
+    // Initialize i18n with specified locale
+    const locale = options.locale || detectLocaleFromEnvironment();
+    const i18n = await initI18n(locale);
+    const server = new Server(SERVER_INFO, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // ---------------------------------------------------------------------------
+    // TOOL HANDLERS
+    // ---------------------------------------------------------------------------
+    // List available tools (with optional localization)
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        // Tool descriptions are kept in English for AI understanding
+        // but can be localized if needed for UI display
+        return {
+            tools: PINEPAPER_TOOLS,
+        };
+    });
+    // Handle tool calls with i18n support for errors and success messages
+    // Browser mode enables live execution in PinePaper Studio
+    const executeInBrowser = options.browserMode ?? true; // Default to browser mode
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return handleToolCall(name, args, {
+            i18n,
+            executeInBrowser,
+        });
+    });
+    // ---------------------------------------------------------------------------
+    // RESOURCE HANDLERS
+    // ---------------------------------------------------------------------------
+    // List available resources
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: RESOURCES,
+        };
+    });
+    // Read resource content
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        const content = RESOURCE_CONTENTS[uri];
+        if (!content) {
+            throw new Error(`Resource not found: ${uri}`);
+        }
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'text/markdown',
+                    text: content,
+                },
+            ],
+        };
+    });
+    return server;
+}
+// =============================================================================
+// LOCALE DETECTION
+// =============================================================================
+/**
+ * Detect locale from environment variables
+ * Checks PINEPAPER_LOCALE, LANG, LC_ALL, LC_MESSAGES
+ */
+function detectLocaleFromEnvironment() {
+    // Check explicit PinePaper locale setting
+    const pinepaperLocale = process.env.PINEPAPER_LOCALE;
+    if (pinepaperLocale && isValidLocale(pinepaperLocale)) {
+        return pinepaperLocale;
+    }
+    // Check standard locale environment variables
+    const envLocale = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || '';
+    // Parse locale string (e.g., "en_US.UTF-8" -> "en")
+    const localePart = envLocale.split('.')[0]; // Remove encoding
+    const langPart = localePart.split('_')[0]; // Get language code
+    if (isValidLocale(langPart)) {
+        return langPart;
+    }
+    // Check for regional variants (e.g., "zh_CN" -> "zh-CN")
+    const regionalLocale = localePart.replace('_', '-');
+    if (isValidLocale(regionalLocale)) {
+        return regionalLocale;
+    }
+    return DEFAULT_LOCALE;
+}
+/**
+ * Check if a string is a valid supported locale
+ */
+function isValidLocale(locale) {
+    const SUPPORTED = [
+        'en',
+        'es',
+        'fr',
+        'de',
+        'it',
+        'pt',
+        'pt-BR',
+        'nl',
+        'pl',
+        'ru',
+        'uk',
+        'zh-CN',
+        'zh-TW',
+        'ja',
+        'ko',
+        'th',
+        'vi',
+        'id',
+        'ms',
+        'tl',
+        'hi',
+        'bn',
+        'ta',
+        'te',
+        'mr',
+        'gu',
+        'kn',
+        'ml',
+        'pa',
+        'ar',
+        'he',
+        'fa',
+        'tr',
+        'sv',
+        'da',
+        'no',
+        'fi',
+        'cs',
+        'el',
+        'hu',
+        'ro',
+    ];
+    return SUPPORTED.includes(locale);
+}
+// =============================================================================
+// MAIN ENTRY POINT
+// =============================================================================
+async function main() {
+    const locale = detectLocaleFromEnvironment();
+    const server = await createServer({ locale });
+    const transport = new StdioServerTransport();
+    console.error('PinePaper MCP Server starting...');
+    console.error(`Version: ${SERVER_INFO.version}`);
+    console.error(`Locale: ${locale}`);
+    console.error(`Tools: ${PINEPAPER_TOOLS.length}`);
+    console.error(`Resources: ${RESOURCES.length}`);
+    await server.connect(transport);
+    console.error('PinePaper MCP Server running on stdio');
+}
+// Run if executed directly
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * PinePaper MCP Server - Transport Factory
+ *
+ * This module provides a unified interface for creating server transports.
+ * The public package only includes stdio transport. Cloud transports
+ * (SSE/HTTP) are available via the optional @pinepaper/mcp-cloud package.
+ */
+export type TransportType = 'stdio' | 'sse';
+export interface TransportConfig {
+    type: TransportType;
+    port?: number;
+    host?: string;
+    apiKey?: string;
+    corsOrigins?: string[];
+}
+export interface TransportResult {
+    transport: unknown;
+    type: TransportType;
+    info: {
+        description: string;
+        connectionInfo?: string;
+    };
+}
+/**
+ * Create a transport based on configuration
+ *
+ * @param config - Transport configuration
+ * @returns Transport instance
+ */
+export declare function createTransport(config: TransportConfig): Promise<TransportResult>;
+/**
+ * Check if cloud features are available
+ */
+export declare function isCloudAvailable(): Promise<boolean>;
+/**
+ * Get available transport types
+ */
+export declare function getAvailableTransports(): Promise<TransportType[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBvF;AAwCD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAOzD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAQvE"}

package/dist/server/index.js

@@ -0,0 +1,89 @@
+/**
+ * PinePaper MCP Server - Transport Factory
+ *
+ * This module provides a unified interface for creating server transports.
+ * The public package only includes stdio transport. Cloud transports
+ * (SSE/HTTP) are available via the optional @pinepaper/mcp-cloud package.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+// =============================================================================
+// TRANSPORT FACTORY
+// =============================================================================
+/**
+ * Create a transport based on configuration
+ *
+ * @param config - Transport configuration
+ * @returns Transport instance
+ */
+export async function createTransport(config) {
+    switch (config.type) {
+        case 'stdio':
+            return {
+                transport: new StdioServerTransport(),
+                type: 'stdio',
+                info: {
+                    description: 'Standard I/O transport for local use with Claude Desktop',
+                },
+            };
+        case 'sse':
+            return createCloudTransport(config);
+        default:
+            throw new Error(`Unknown transport type: ${config.type}`);
+    }
+}
+/**
+ * Attempt to create a cloud transport using the optional @pinepaper/mcp-cloud package
+ */
+async function createCloudTransport(config) {
+    try {
+        // Try to dynamically import the cloud package
+        // This will fail gracefully if the package is not installed
+        const cloudModule = await import('@pinepaper/mcp-cloud');
+        const transport = cloudModule.createSSEServer({
+            port: config.port || 3000,
+            host: config.host || '0.0.0.0',
+            apiKey: config.apiKey,
+            corsOrigins: config.corsOrigins || ['*'],
+        });
+        await transport.start();
+        return {
+            transport,
+            type: 'sse',
+            info: {
+                description: 'SSE/HTTP transport for cloud deployment',
+                connectionInfo: `http://${config.host || '0.0.0.0'}:${config.port || 3000}`,
+            },
+        };
+    }
+    catch (error) {
+        if (error.code === 'ERR_MODULE_NOT_FOUND') {
+            throw new Error('SSE transport requires the @pinepaper/mcp-cloud package.\n' +
+                'This is a Pro tier feature. Visit https://pinepaper.studio/pro for more info.\n\n' +
+                'For local development, use the stdio transport with Claude Desktop.');
+        }
+        throw error;
+    }
+}
+/**
+ * Check if cloud features are available
+ */
+export async function isCloudAvailable() {
+    try {
+        await import('@pinepaper/mcp-cloud');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get available transport types
+ */
+export async function getAvailableTransports() {
+    const transports = ['stdio'];
+    if (await isCloudAvailable()) {
+        transports.push('sse');
+    }
+    return transports;
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AA0BjF,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAuB;IAC3D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO;gBACL,SAAS,EAAE,IAAI,oBAAoB,EAAE;gBACrC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE;oBACJ,WAAW,EAAE,0DAA0D;iBACxE;aACF,CAAC;QAEJ,KAAK,KAAK;YACR,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAEtC;YACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAAC,MAAuB;IACzD,IAAI,CAAC;QACH,8CAA8C;QAC9C,4DAA4D;QAC5D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAEzD,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,CAAC;YAC5C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;YAC9B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC;SACzC,CAAC,CAAC;QAEH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAExB,OAAO;YACL,SAAS;YACT,IAAI,EAAE,KAAK;YACX,IAAI,EAAE;gBACJ,WAAW,EAAE,yCAAyC;gBACtD,cAAc,EAAE,UAAU,MAAM,CAAC,IAAI,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE;aAC5E;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACb,4DAA4D;gBAC1D,mFAAmF;gBACnF,qEAAqE,CACxE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,UAAU,GAAoB,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,MAAM,gBAAgB,EAAE,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/tools/definitions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * PinePaper MCP Tool Definitions
+ *
+ * This file contains all the tool definitions for the MCP server.
+ * Each tool has a name, description, and JSON schema for inputs.
+ *
+ * Note: Tool descriptions remain in English for optimal AI/LLM understanding.
+ * User-facing messages (errors, success) are translated via i18n.
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { I18nManager } from '../i18n/index.js';
+export declare const PINEPAPER_TOOLS: Tool[];
+/**
+ * Get a tool definition by name
+ */
+export declare function getToolByName(name: string): Tool | undefined;
+/**
+ * Get all tool names
+ */
+export declare function getToolNames(): string[];
+/**
+ * Get tools with localized descriptions from i18n manager
+ * Tool descriptions remain in English for AI, but names can be localized for UI
+ */
+export declare function getLocalizedTools(i18n: I18nManager): Tool[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/tools/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C,eAAO,MAAM,eAAe,EAAE,IAAI,EAmwBjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,CAO3D"}