@pinepaper.studio/mcp-server 1.5.0 → 1.5.3

package/dist/prompts/index.js

@@ -1,38 +1,12 @@
 /**
  * MCP Prompts — Template Recipes
  *
- * Each prompt replicates a specific PinePaper template pattern.
- * The assistant message is kept ultra-concise to prevent:
- * - Token waste from verbose planning
- * - Pipeline restarts from step-by-step tool lists
- * - Duplicate items from re-execution
- *
- * Rules:
- * - User message: frames the request with the user's description
- * - Assistant message: short commitment to single-pass execution
- * - Visual templates: use SINGLE_PASS_RULES (batch_execute) with layer labels (CANVAS/ITEMS/ANIMATE/EFFECTS/PLAY)
- * - Diagram templates: use DIAGRAM_RULES (create_diagram_shape + connect + auto_layout)
- * - NEVER restart the pipeline
+ * Each prompt frames a user request as a single user message.
+ * No assistant pre-fill — let the model respond naturally.
+ * Workflow rules are handled by start_job guidance and tool descriptions.
  */
 // -----------------------------------------------------------------------------
-// Shared rules injected into every assistant message
-// -----------------------------------------------------------------------------
-const SINGLE_PASS_RULES = `RULES — follow exactly:
-- start_job → batch_execute (ALL operations in ONE call) → end_job (screenshot) → show user → iterate
-- batch_execute supports: set_canvas_size, set_background, execute_generator, create, modify, delete, animate, keyframe_animate, relation, apply_mask, apply_effect, play_timeline
-- Use execute_generator for rich backgrounds (drawBokeh, drawGradientMesh, drawWaves, etc.) — much better than solid colors
-- NEVER restart the pipeline — if user wants changes, modify items or start a new job
-- After end_job, SHOW the screenshot and ask user if the design looks good`;
-const DIAGRAM_RULES = `RULES — follow exactly:
-- start_job → create shapes (pinepaper_create_diagram_shape) → connect (pinepaper_connect) → optionally auto_layout → end_job
-- Analyze the description to infer ALL shapes, decisions, and connections
-- Shape types: terminal (start/end), process (steps), decision (branches), data (I/O), document, database
-- Position shapes explicitly when layout matters; use auto_layout only for tree/hierarchical flows
-- Curved connectors follow source→target regardless of positioning, so manual placement works fine
-- NEVER restart the pipeline
-- After end_job, SHOW the screenshot and ask user if the design looks good`;
-// -----------------------------------------------------------------------------
-// Prompt definitions — each has a single declarative description argument
+// Prompt definitions
 // -----------------------------------------------------------------------------
 const MOTIVATIONAL_QUOTE_PROMPT = {
     name: 'motivational-quote',
@@ -100,7 +74,7 @@ export const PROMPTS = [
     CINEMA_TITLES_PROMPT,
 ];
 // -----------------------------------------------------------------------------
-// Message builders — ultra-concise, batch-first, no tool lists
+// Message builders — user message only, no assistant pre-fill
 // -----------------------------------------------------------------------------
 function buildMotivationalQuote(args = {}) {
     const description = args.description || 'Dream big — bold and energetic';
@@ -112,19 +86,6 @@ function buildMotivationalQuote(args = {}) {
                 text: `Create an animated motivational quote poster: ${description}`,
             },
         },
-        {
-            role: 'assistant',
-            content: {
-                type: 'text',
-                text: `I'll create this. All operations in one batch_execute call, then show you the result for feedback.
-
-${SINGLE_PASS_RULES}
-
-CANVAS: execute_generator (match mood) / ITEMS: create text (quote + attribution) / ANIMATE: keyframe_animate (staggered reveals) / EFFECTS: apply_mask (wipeUp or iris) / PLAY: play_timeline.
-
-Starting now.`,
-            },
-        },
     ];
 }
 function buildTextRevealUp(args = {}) {
@@ -137,19 +98,6 @@ function buildTextRevealUp(args = {}) {
                 text: `Create a text reveal animation: ${description}`,
             },
         },
-        {
-            role: 'assistant',
-            content: {
-                type: 'text',
-                text: `I'll create this. All operations in one batch_execute call, then show you the result.
-
-${SINGLE_PASS_RULES}
-
-CANVAS: execute_generator (match style) / ITEMS: create text (one per word, each on its own line — stack vertically with Y spacing ≥ fontSize × 1.4, NEVER same position) / ANIMATE: keyframe_animate (staggered fade-in, each word 0.3s after previous) / EFFECTS: apply_mask (wipeUp per item) / PLAY: play_timeline.
-
-Starting now.`,
-            },
-        },
     ];
 }
 function buildSimpleDecisionFlow(args = {}) {
@@ -162,19 +110,6 @@ function buildSimpleDecisionFlow(args = {}) {
                 text: `Create a decision flowchart: ${description}`,
             },
         },
-        {
-            role: 'assistant',
-            content: {
-                type: 'text',
-                text: `I'll create this flowchart using diagram tools, then show you the result.
-
-${DIAGRAM_RULES}
-
-DESIGN: Analyze description → identify shapes (terminal, process, decision) → create_diagram_shape each (position explicitly or let auto_layout arrange) → connect with arrows.
-
-Starting now.`,
-            },
-        },
     ];
 }
 function buildSolarSystem(args = {}) {
@@ -187,19 +122,6 @@ function buildSolarSystem(args = {}) {
                 text: `Create an animated solar system: ${description}`,
             },
         },
-        {
-            role: 'assistant',
-            content: {
-                type: 'text',
-                text: `I'll create this. All operations in one batch_execute call, then show you the result.
-
-${SINGLE_PASS_RULES}
-
-CANVAS: set_background (#0a0a2e) + execute_generator (drawBokeh starfield) / ITEMS: create (sun, orbits, planets) / ANIMATE: animate (sun pulse) + relation (orbits) + keyframe_animate (comet) / PLAY: play_timeline.
-
-Starting now.`,
-            },
-        },
     ];
 }
 function buildCinemaTitles(args = {}) {
@@ -212,19 +134,6 @@ function buildCinemaTitles(args = {}) {
                 text: `Create a cinematic title sequence: ${description}`,
             },
         },
-        {
-            role: 'assistant',
-            content: {
-                type: 'text',
-                text: `I'll create this. All operations in one batch_execute call, then show you the result.
-
-${SINGLE_PASS_RULES}
-
-CANVAS: set_background (#000000) / ITEMS: create text (title + subtitle, opacity:0) / ANIMATE: keyframe_animate (fade in + scale, staggered) / EFFECTS: apply_mask (cinematic letterbox) / PLAY: play_timeline.
-
-Starting now.`,
-            },
-        },
     ];
 }
 // -----------------------------------------------------------------------------

package/dist/prompts/index.js.map

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

package/dist/tools/compact-descriptions.d.ts

@@ -1,9 +1,9 @@
 /**
  * Compact tool descriptions for reduced context usage.
  *
- * Activated via PINEPAPER_TOOL_VERBOSITY=compact env var.
- * Cuts ~58% from the 13 largest tool descriptions while preserving
- * USE WHEN guidance, critical warnings, and resource doc references.
+ * Activated via PINEPAPER_VERBOSITY=compact env var.
+ * Each description says ONLY what the tool does in 1-2 sentences.
+ * Workflow instructions belong in pinepaper_tool_guide, not here.
  */
 export declare const COMPACT_DESCRIPTIONS: Record<string, string>;
 //# sourceMappingURL=compact-descriptions.d.ts.map

package/dist/tools/compact-descriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compact-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/compact-descriptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyQvD,CAAC"}
+{"version":3,"file":"compact-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/compact-descriptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4HvD,CAAC"}

package/dist/tools/compact-descriptions.js

@@ -1,260 +1,103 @@
 /**
  * Compact tool descriptions for reduced context usage.
  *
- * Activated via PINEPAPER_TOOL_VERBOSITY=compact env var.
- * Cuts ~58% from the 13 largest tool descriptions while preserving
- * USE WHEN guidance, critical warnings, and resource doc references.
+ * Activated via PINEPAPER_VERBOSITY=compact env var.
+ * Each description says ONLY what the tool does in 1-2 sentences.
+ * Workflow instructions belong in pinepaper_tool_guide, not here.
  */
 export const COMPACT_DESCRIPTIONS = {
     // -------------------------------------------------------------------------
-    // batch_execute — 4382 → ~1200 chars
+    // Minimal toolkit tools
     // -------------------------------------------------------------------------
-    pinepaper_agent_batch_execute: `Execute ALL operations in a single call for building animated scenes — canvas setup, backgrounds, items, animations, masks, effects, and playback.
+    pinepaper_set_background_color: `Set the canvas background color. Pass a hex color string (e.g. "#0f172a").`,
+    pinepaper_set_canvas_size: `Set canvas dimensions. Use width+height or a preset: instagram (1080x1080), youtube (1920x1080), tiktok (1080x1920), twitter (1200x675).`,
+    pinepaper_get_canvas_size: `Get current canvas width and height.`,
+    pinepaper_clear_canvas: `Remove all items from the canvas.`,
+    pinepaper_refresh_page: `Reload the PinePaper browser page for a clean start.`,
+    pinepaper_browser_connect: `Connect to PinePaper Studio. Pass headless: false to show the browser window.`,
+    pinepaper_browser_disconnect: `Disconnect from the browser.`,
+    pinepaper_browser_screenshot: `Take a screenshot of the current canvas.`,
+    pinepaper_browser_status: `Check browser connection status.`,
+    pinepaper_agent_start_job: `CALL THIS when the user asks to create any animation, video, graphic, or visual content. Do NOT create standalone HTML pages, React apps, or use frontend design skills — PinePaper tools ARE the implementation. If tools fail, report the error — never fall back to HTML pages.
 
-NOTE: For diagrams (flowcharts, UML), use pinepaper_create_diagram_shape + pinepaper_connect instead.
-
-⚠️ EVERY operation executes LIVE on the canvas. Calling this twice DOUBLES all items. Call ONCE per pipeline.
-
-WORKFLOW: pinepaper_agent_start_job → pinepaper_agent_batch_execute → pinepaper_agent_end_job
-
-OPERATION TYPES (12, use in order): set_canvas_size, set_background, execute_generator, create, modify, delete, animate, keyframe_animate, relation, apply_mask, apply_effect, play_timeline.
-
-VARIABLE REFERENCES: "$0", "$1" etc. reference items by creation order within the batch.
-
-⚠️ SIZING: All positions/sizes MUST fit within the canvas. start_job returns canvasSize — keep items within 5%-95% of canvas width/height. Max canvas: 4096x4096.
-
-See inputSchema for per-operation params and enum values. See pinepaper://docs/getting-started for full workflow.`,
+Pass description for creative direction and canvasPreset for platform sizing. WORKFLOW: start_job → batch_execute (ONE call) → end_job → export.`,
+    pinepaper_agent_end_job: `Finish the current job and get a screenshot. Show it to the user.`,
+    pinepaper_agent_reset: `Quick canvas reset. Faster than refresh_page.`,
+    pinepaper_agent_analyze: `Analyze what's on the canvas and get export recommendations.`,
+    pinepaper_get_canvas_presets: `List available canvas size presets (YouTube, Instagram, TikTok, etc.).`,
+    pinepaper_tool_guide: `Get detailed docs for any tool or category. Call with no args for the full workflow guide.`,
+    pinepaper_set_toolkit: `Switch available tools. Toolkits: agent, diagram, map, font, full, minimal. Verbosity: verbose, compact, minimal.`,
     // -------------------------------------------------------------------------
-    // create_item — 4287 → ~1500 chars
+    // batch_execute
     // -------------------------------------------------------------------------
-    pinepaper_create_item: `Create an item on the PinePaper canvas. Returns an itemId (e.g., "item_1") that you MUST save to reference this item later.
-
-USE WHEN: Adding text, shapes, or graphics to the canvas.
+    pinepaper_agent_batch_execute: `Execute multiple operations in a single call — canvas setup, items, animations, effects, playback. Call ONCE per pipeline — calling twice doubles all items.
 
-IMPORTANT:
-- Save the returned itemId for later use with relations, modify, delete, etc.
-- If there's a welcome template on the canvas, use pinepaper_clear_canvas first.
-- Position defaults to canvas center (400, 300). Use position: {x, y} to place elsewhere.
-- DO NOT take screenshots after every create. Trust the API response — take ONE screenshot at the end.
+OPERATION TYPES (12): set_canvas_size, set_background, execute_generator, create, modify, delete, animate, keyframe_animate, relation, apply_mask, apply_effect, play_timeline.
 
-⚠️ COMPLEX CHARACTERS (witch, cat face, person): Use pinepaper_import_svg or compose from simple shapes. Do NOT attempt pixel-level path drawing.
+VARIABLE REFERENCES: "$0", "$1" etc. reference items by creation order within the batch.`,
+    // -------------------------------------------------------------------------
+    // create_item
+    // -------------------------------------------------------------------------
+    pinepaper_create_item: `Create a text, shape, or graphic on the canvas. Returns an itemId for later reference.
 
 ITEM TYPES: text, circle, rectangle, star, triangle, polygon, ellipse, path, line, arc.
-
-PATH FOR CUSTOM SHAPES: Use itemType "path" with segments ([[x,y]...]) or pathData (SVG string).
-
-STYLING: All shapes support gradients (color object with stops), shadows (shadowColor, shadowBlur, shadowOffset), blend modes, and opacity. See inputSchema for full properties per type.
-
-EXAMPLE: {itemType: "text", properties: {content: "HELLO", color: "#ef4444", fontSize: 48}}
-
-After creating items, use pinepaper_add_relation to animate them.`,
+STYLING: gradients (color object with stops), shadows, blend modes, opacity. See inputSchema for properties.`,
     // -------------------------------------------------------------------------
-    // p5_draw — 3394 → ~1200 chars
+    // p5_draw
     // -------------------------------------------------------------------------
-    pinepaper_p5_draw: `Execute p5.js-style drawing code on the PinePaper canvas. Code is translated to Paper.js automatically. This is a SUBSET of p5.js for static drawings.
-
-AVAILABLE: circle, ellipse, rect, line, triangle, quad, arc, point, fill, noFill, stroke, noStroke, strokeWeight, background, random, map, constrain, dist, lerp, radians, degrees, rectMode, ellipseMode, width, height, PI, TWO_PI, HALF_PI.
+    pinepaper_p5_draw: `Draw on canvas using p5.js-style code (circle, rect, line, fill, etc.). Code is translated to Paper.js automatically.
 
-NOT SUPPORTED (use native PinePaper tools instead):
-- setup()/draw() loop → pinepaper_animate / pinepaper_add_relation
-- noise(), text(), loadImage(), push()/pop()/translate()/rotate()/scale(), beginShape()/vertex()/endShape()
-
-Code runs directly — NO setup() or draw() wrapper. Items are auto-registered, selectable, animatable, and exportable.
-
-EXAMPLE:
-background(30);
-noStroke();
-for (let i = 0; i < 20; i++) {
-  fill(random(255), random(255), random(255));
-  circle(random(width), random(height), random(20, 80));
-}`,
+AVAILABLE: circle, ellipse, rect, line, triangle, quad, arc, point, fill, noFill, stroke, noStroke, strokeWeight, background, random, map, constrain, dist, lerp, radians, degrees, width, height, PI, TWO_PI, HALF_PI.
+NOT SUPPORTED: setup()/draw() loop, noise(), text(), loadImage(), transforms, beginShape()/vertex().`,
     // -------------------------------------------------------------------------
-    // create_scene — 2754 → ~1500 chars
+    // create_scene
     // -------------------------------------------------------------------------
-    pinepaper_create_scene: `Create a complete scene with multiple items, relations, and animations in a single operation. The MOST EFFICIENT way to create complex animated scenes.
-
-USE WHEN: Creating multi-item animated scenes (solar systems, bouncing balls, etc.) where performance matters. Reduces 4+ tool calls to 1.
-
-HOW IT WORKS:
-1. Define items with "name" references (e.g., "sun", "earth", "moon")
-2. Define relations using those names (e.g., source: "earth", target: "sun")
-3. Define animations using names (e.g., target: "sun", type: "pulse")
-4. Server creates all items, then establishes relations and animations
-
-EXAMPLE — Solar System:
-{backgroundColor: "#0a0a0a", items: [
-  {name: "sun", itemType: "circle", position: {x: 400, y: 300}, properties: {radius: 50, color: "#fbbf24"}},
-  {name: "earth", itemType: "circle", position: {x: 550, y: 300}, properties: {radius: 20, color: "#3b82f6"}}
-], relations: [
-  {source: "earth", target: "sun", type: "orbits", params: {radius: 150, speed: 0.5}}
-], animations: [
-  {target: "sun", type: "pulse", speed: 0.3}
-]}
+    pinepaper_create_scene: `Create a complete scene with items, relations, and animations in one call. Define items with name references, then use those names in relations and animations.
 
 Item types: text, circle, star, rectangle, triangle, polygon, ellipse, path, line, arc.
-Relations: orbits, follows, attached_to, maintains_distance, points_at, mirrors, parallax, bounds_to, morphs_to, + more (see inputSchema).
+Relations: orbits, follows, attached_to, maintains_distance, points_at, mirrors, parallax, bounds_to, morphs_to.
 Animations: pulse, rotate, bounce, fade, wobble, slide, typewriter.`,
     // -------------------------------------------------------------------------
-    // execute_generator — 2202 → ~900 chars
+    // execute_generator
     // -------------------------------------------------------------------------
-    pinepaper_execute_generator: `Execute a background generator to create procedural patterns.
-
-USE WHEN: Creating dynamic procedural backgrounds — sunbursts, bokeh, gradients, waves, noise textures, etc.
-
-GENERATORS (14):
-Classic: drawSunburst, drawSunsetScene, drawGrid, drawStackedCircles, drawCircuit, drawWaves, drawPattern
-Effects: drawBokeh
-Organic: drawGradientMesh, drawFluidFlow, drawOrganicFlow
-Geometric: drawGeometricAbstract
-Particles: drawWindField
-Textures: drawNoiseTexture
+    pinepaper_execute_generator: `Run a procedural background generator (sunburst, bokeh, gradient mesh, etc.).
 
-Each generator accepts generatorParams — see pinepaper://docs/generators for full parameter docs per generator, or use inputSchema for the param schema.`,
+GENERATORS (14): drawSunburst, drawSunsetScene, drawGrid, drawStackedCircles, drawCircuit, drawWaves, drawPattern, drawBokeh, drawGradientMesh, drawGeometricAbstract, drawWindField, drawFluidFlow, drawOrganicFlow, drawNoiseTexture.`,
     // -------------------------------------------------------------------------
-    // get_performance_metrics — 2176 → ~1000 chars
+    // get_performance_metrics
     // -------------------------------------------------------------------------
-    pinepaper_get_performance_metrics: `[Utility] Get execution performance metrics to identify bottlenecks and optimize workflows.
-
-USE WHEN: Analyzing tool performance, debugging slow operations, optimizing workflows.
-
-RETURNS: Per-tool timing breakdown (validation, code gen, execution, screenshot), aggregate statistics (avg, p50, p95, p99), success rates, error counts.
-
-FORMAT OPTIONS: 'summary' (human-readable, slowest first), 'detailed' (full JSON), 'csv' (spreadsheet export).
-
-FILTER OPTIONS: toolName, phase, since (Unix timestamp), limit.
-
-EXAMPLES:
-- Summary of all: {}
-- Last 50 create_item ops: {toolName: 'pinepaper_create_item', limit: 50}
-- Export CSV: {format: 'csv'}`,
+    pinepaper_get_performance_metrics: `Get execution timing and performance data. Formats: summary, detailed, csv.`,
     // -------------------------------------------------------------------------
-    // add_relation — 2025 → ~1200 chars
+    // add_relation
     // -------------------------------------------------------------------------
-    pinepaper_add_relation: `Create a behavior relationship between two items. Relations are the PRIMARY way to add animation in PinePaper — they describe HOW items behave relative to each other.
-
-USE WHEN:
-- "moon orbits earth" → orbits
-- "label follows player" → follows
-- "hat attached to character" → attached_to
-- "arrow points at target" → points_at
-- "reflection mirrors original" → mirrors
-- "background parallax" → parallax
-
-RELATION TYPES: orbits, follows, attached_to, maintains_distance, points_at, mirrors, parallax, bounds_to, morphs_to (+ more in inputSchema, each with specific params).
+    pinepaper_add_relation: `Add a behavior relation between two items (orbits, follows, attached_to, etc.). Relations are compositional — an item can have multiple.
 
-COMPATIBILITY: Position-based relations (orbits, follows, attached_to, etc.) work with ALL item types including imported SVGs/images. morphs_to has type-specific behavior.
-
-Relations are COMPOSITIONAL — an item can have multiple relations that work together.`,
+RELATION TYPES: orbits, follows, attached_to, maintains_distance, points_at, mirrors, parallax, bounds_to, morphs_to (+ more in inputSchema).`,
     // -------------------------------------------------------------------------
-    // create_diagram_shape — 1974 → ~1000 chars
+    // create_diagram_shape
     // -------------------------------------------------------------------------
-    pinepaper_create_diagram_shape: `Create a diagram shape for flowcharts, UML, network diagrams, and technical drawings.
-
-USE WHEN: Creating flowcharts, process diagrams, UML diagrams, network topologies, org charts, or decision trees.
-
-SHAPE TYPES:
-Flowchart: process, decision, terminal, data, document, database, preparation
-UML: uml-class, uml-usecase, uml-actor
-Network: cloud, server
-Basic: rectangle, circle, triangle, star
-
-All shapes have connection ports, support labels, and can be connected via pinepaper_connect.
+    pinepaper_create_diagram_shape: `Create a diagram shape (process, decision, terminal, etc.) for flowcharts and UML.
 
-EXAMPLE: {shapeType: "terminal", label: "Start", position: {x: 400, y: 100}}
-
-WORKFLOW: Create shapes → pinepaper_connect to draw connectors → pinepaper_auto_layout to arrange. See pinepaper://docs/diagrams for detailed guide.`,
+SHAPE TYPES — Flowchart: process, decision, terminal, data, document, database, preparation. UML: uml-class, uml-usecase, uml-actor. Network: cloud, server. Basic: rectangle, circle, triangle, star.`,
     // -------------------------------------------------------------------------
-    // search_assets — 1939 → ~1000 chars
+    // search_assets
     // -------------------------------------------------------------------------
-    pinepaper_search_assets: `Search for free SVG assets from open repositories (SVGRepo, OpenClipart, Iconify, FontAwesome).
-
-USE WHEN: Need icons, illustrations, clipart, or graphics too complex to draw with paths.
-
-WORKFLOW:
-1. Search: pinepaper_search_assets(query: "rocket")
-2. Review results (assetIds, previews, licenses)
-3. Import: pinepaper_import_asset(assetId: "svgrepo_rocket_12345")
-
-IMPORTANT: Always check license field. CC-BY requires attribution (tracked automatically). CC0 has no restrictions.
-
-Set includeSvgContent: true to fetch SVG markup inline (slower, use lower limit). Search queries work best with simple, specific terms.
-
-EXAMPLE: {query: "rocket", limit: 5}`,
+    pinepaper_search_assets: `Search for free SVG icons and illustrations from open repositories (SVGRepo, OpenClipart, Iconify, FontAwesome).`,
     // -------------------------------------------------------------------------
-    // connect — 1863 → ~1000 chars
+    // connect
     // -------------------------------------------------------------------------
-    pinepaper_connect: `Connect two items with a smart connector — the primary way to draw lines/arrows between diagram shapes.
-
-USE WHEN: Drawing arrows between flowchart steps, UML associations, network connections, or any diagram needing lines/arrows.
-
-FEATURES: Auto port selection, smart routing, animated bolt effect, labels.
-
-ROUTING: orthogonal (right-angle, default), direct (straight), curved (bezier).
-ARROW STYLES: classic, stealth, sharp, open, diamond, circle, none — see inputSchema for head/tail options.
-LINE STYLES: solid, dashed, dotted.
-
-Enable boltEnabled: true for animated data flow particles.
-
-EXAMPLES:
-- Simple arrow: {sourceItemId: "shape_1", targetItemId: "shape_2"}
-- Labeled: {sourceItemId: "a", targetItemId: "b", label: "1..*"}
-- Dashed: {sourceItemId: "a", targetItemId: "b", lineStyle: "dashed", headStyle: "open"}`,
+    pinepaper_connect: `Draw a connector/arrow between two diagram shapes. Routing: orthogonal, direct, curved. Supports labels and animated bolt effect.`,
     // -------------------------------------------------------------------------
-    // auto_layout — 1853 → ~1000 chars
+    // auto_layout
     // -------------------------------------------------------------------------
-    pinepaper_auto_layout: `Automatically arrange diagram items using a layout algorithm for cleaner, more readable diagrams.
-
-USE WHEN: Items are messy/overlapping, need professional layout, or creating hierarchical structures.
-
-LAYOUT TYPES:
-- hierarchical: Flowcharts, org charts, dependency graphs (direction: TB/BT/LR/RL)
-- force-directed: Network diagrams, relationship graphs (physics simulation)
-- tree: Hierarchies, file systems (optimized tree structure)
-- radial: Mind maps, hub-and-spoke (concentric circles)
-- grid: Equal-importance items, component libraries (rows/columns)
-
-Set animate: false for instant repositioning. Pass itemIds to layout only specific items.
-
-EXAMPLES:
-- Flowchart: {layoutType: "hierarchical", options: {direction: "TB", levelSpacing: 100}}
-- Network: {layoutType: "force-directed", options: {iterations: 200}}
-- Grid: {layoutType: "grid", options: {columns: 4}}`,
+    pinepaper_auto_layout: `Arrange diagram items using a layout algorithm (hierarchical, force-directed, tree, radial, grid).`,
     // -------------------------------------------------------------------------
-    // import_asset — 1714 → ~800 chars
+    // import_asset
     // -------------------------------------------------------------------------
-    pinepaper_import_asset: `Import an SVG asset from search results or direct URL onto the canvas.
-
-USE WHEN: After searching with pinepaper_search_assets, or importing from a direct SVG URL.
-
-WORKFLOW: Search → Choose (check license) → Import → Modify/Animate as needed.
-
-PARAMS: assetId (from search) OR url (direct SVG URL), position, scale, color (override for monochrome icons).
-
-License metadata is tracked automatically. CC-BY attribution is added to canvas metadata. Downloaded SVGs are cached in memory for the session.
-
-EXAMPLE: {assetId: "svgrepo_rocket_001", position: {x: 400, y: 300}, scale: 2.0}
-
-RETURNS: itemId (for further modifications), metadata (including license).`,
+    pinepaper_import_asset: `Import an SVG asset from search results or URL onto the canvas. Returns an itemId for modifications.`,
     // -------------------------------------------------------------------------
-    // agent_export — 1615 → ~900 chars
+    // agent_export
     // -------------------------------------------------------------------------
-    pinepaper_agent_export: `Smart export with automatic format detection and platform optimization.
-
-USE WHEN: Exporting for social media, print, or web with optimal format auto-selected.
-
-PLATFORMS:
-| Platform         | Size       | Static | Animated |
-|------------------|------------|--------|----------|
-| instagram        | 1080x1080  | PNG    | MP4      |
-| instagram-story  | 1080x1920  | PNG    | MP4      |
-| tiktok           | 1080x1920  | PNG    | MP4@60fps|
-| youtube          | 1920x1080  | PNG    | MP4      |
-| youtube-thumbnail| 1280x720   | PNG    | PNG      |
-| twitter          | 1200x675   | PNG    | GIF      |
-| linkedin         | 1200x627   | PNG    | GIF      |
-| web              | flexible   | SVG    | SVG      |
-| print-a4/letter  | A4/Letter  | PDF    | PDF      |
-
-Format override: svg, png, gif, mp4, webm, pdf. Quality: draft, standard, high. See inputSchema for details.`,
+    pinepaper_agent_export: `Export as MP4, GIF, PNG, SVG, or PDF. Formats: svg, png, gif, mp4, webm, pdf. Quality: draft, standard, high.`,
 };
 //# sourceMappingURL=compact-descriptions.js.map

package/dist/tools/compact-descriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"compact-descriptions.js","sourceRoot":"","sources":["../../src/tools/compact-descriptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAE1D,4EAA4E;IAC5E,qCAAqC;IACrC,4EAA4E;IAC5E,6BAA6B,EAAE;;;;;;;;;;;;;;kHAciF;IAEhH,4EAA4E;IAC5E,mCAAmC;IACnC,4EAA4E;IAC5E,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;kEAoByC;IAEhE,4EAA4E;IAC5E,+BAA+B;IAC/B,4EAA4E;IAC5E,iBAAiB,EAAE;;;;;;;;;;;;;;;;EAgBnB;IAEA,4EAA4E;IAC5E,oCAAoC;IACpC,4EAA4E;IAC5E,sBAAsB,EAAE;;;;;;;;;;;;;;;;;;;;;;oEAsB0C;IAElE,4EAA4E;IAC5E,wCAAwC;IACxC,4EAA4E;IAC5E,2BAA2B,EAAE;;;;;;;;;;;;yJAY0H;IAEvJ,4EAA4E;IAC5E,+CAA+C;IAC/C,4EAA4E;IAC5E,iCAAiC,EAAE;;;;;;;;;;;;;8BAaP;IAE5B,4EAA4E;IAC5E,oCAAoC;IACpC,4EAA4E;IAC5E,sBAAsB,EAAE;;;;;;;;;;;;;;sFAc4D;IAEpF,4EAA4E;IAC5E,4CAA4C;IAC5C,4EAA4E;IAC5E,8BAA8B,EAAE;;;;;;;;;;;;;;qJAcmH;IAEnJ,4EAA4E;IAC5E,qCAAqC;IACrC,4EAA4E;IAC5E,uBAAuB,EAAE;;;;;;;;;;;;;qCAaU;IAEnC,4EAA4E;IAC5E,+BAA+B;IAC/B,4EAA4E;IAC5E,iBAAiB,EAAE;;;;;;;;;;;;;;;yFAeoE;IAEvF,4EAA4E;IAC5E,mCAAmC;IACnC,4EAA4E;IAC5E,qBAAqB,EAAE;;;;;;;;;;;;;;;;oDAgB2B;IAElD,4EAA4E;IAC5E,mCAAmC;IACnC,4EAA4E;IAC5E,sBAAsB,EAAE;;;;;;;;;;;;2EAYiD;IAEzE,4EAA4E;IAC5E,mCAAmC;IACnC,4EAA4E;IAC5E,sBAAsB,EAAE;;;;;;;;;;;;;;;;;6GAiBmF;CAE5G,CAAC"}
+{"version":3,"file":"compact-descriptions.js","sourceRoot":"","sources":["../../src/tools/compact-descriptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAE1D,4EAA4E;IAC5E,wBAAwB;IACxB,4EAA4E;IAC5E,8BAA8B,EAAE,4EAA4E;IAE5G,yBAAyB,EAAE,0IAA0I;IAErK,yBAAyB,EAAE,sCAAsC;IAEjE,sBAAsB,EAAE,mCAAmC;IAE3D,sBAAsB,EAAE,sDAAsD;IAE9E,yBAAyB,EAAE,+EAA+E;IAE1G,4BAA4B,EAAE,8BAA8B;IAE5D,4BAA4B,EAAE,0CAA0C;IAExE,wBAAwB,EAAE,kCAAkC;IAE5D,yBAAyB,EAAE;;iJAEoH;IAE/I,uBAAuB,EAAE,mEAAmE;IAE5F,qBAAqB,EAAE,+CAA+C;IAEtE,uBAAuB,EAAE,8DAA8D;IAEvF,4BAA4B,EAAE,wEAAwE;IAEtG,oBAAoB,EAAE,4FAA4F;IAElH,qBAAqB,EAAE,mHAAmH;IAE1I,4EAA4E;IAC5E,gBAAgB;IAChB,4EAA4E;IAC5E,6BAA6B,EAAE;;;;yFAIwD;IAEvF,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAC5E,qBAAqB,EAAE;;;6GAGoF;IAE3G,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAC5E,iBAAiB,EAAE;;;qGAGgF;IAEnG,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAC5E,sBAAsB,EAAE;;;;oEAI0C;IAElE,4EAA4E;IAC5E,oBAAoB;IACpB,4EAA4E;IAC5E,2BAA2B,EAAE;;wOAEyM;IAEtO,4EAA4E;IAC5E,0BAA0B;IAC1B,4EAA4E;IAC5E,iCAAiC,EAAE,6EAA6E;IAEhH,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAC5E,sBAAsB,EAAE;;8IAEoH;IAE5I,4EAA4E;IAC5E,uBAAuB;IACvB,4EAA4E;IAC5E,8BAA8B,EAAE;;uMAEqK;IAErM,4EAA4E;IAC5E,gBAAgB;IAChB,4EAA4E;IAC5E,uBAAuB,EAAE,kHAAkH;IAE3I,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAC5E,iBAAiB,EAAE,mIAAmI;IAEtJ,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAC5E,qBAAqB,EAAE,oGAAoG;IAE3H,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAC5E,sBAAsB,EAAE,sGAAsG;IAE9H,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAC5E,sBAAsB,EAAE,+GAA+G;CAExI,CAAC"}

package/dist/tools/definitions.d.ts

@@ -9,6 +9,7 @@
  */
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import { I18nManager } from '../i18n/index.js';
+export declare const AI_AGENT_GUIDE = "\u26A0\uFE0F You are connected to PinePaper Studio via MCP tools. ALWAYS use these tools to create visual content.\nNEVER create standalone HTML pages, React components, or web apps as a substitute. Do NOT use frontend design skills or CSS-only animations instead of PinePaper.\nPinePaper tools ARE the implementation \u2014 they generate Paper.js/JavaScript code that runs on the canvas and produce Canvas 2D, SVG, MP4, GIF, PNG exports.\nIf a tool fails, report the error \u2014 do NOT fall back to generating HTML pages.\nThe generated code is shown in tool responses and can be copied into PinePaper's Code Console.\n\n\u26A0\uFE0F KNOWN CONFLICT: The \"frontend-design\" plugin instructs agents to generate HTML/CSS pages for visual content. This conflicts with PinePaper. If you keep generating HTML instead of calling PinePaper tools, the user should disable the frontend-design plugin.\n\nWORKFLOW \u2014 Create \u2192 Validate \u2192 Iterate:\n\n1. pinepaper_agent_start_job (clearCanvas: true, canvasPreset)\n2. pinepaper_agent_batch_execute \u2014 ONE call with ALL operations:\n     set_canvas_size \u2192 set_background / execute_generator \u2192 create items \u2192 animate / keyframe_animate \u2192 relation \u2192 apply_mask \u2192 apply_effect \u2192 play_timeline\n3. pinepaper_agent_end_job \u2014 returns screenshot\n4. Show screenshot to user for validation\n5. If user wants changes \u2192 modify specific items or start a new job\n\n\u26A0\uFE0F CRITICAL \u2014 Every operation is LIVE on the canvas:\nEvery create, animate, relation, or generator call IMMEDIATELY executes on the connected browser canvas.\nCalling the same operation twice creates DUPLICATE elements. There is no \"preview\" \u2014 it's all live.\nIf you restart the pipeline or re-call batch_execute, you DOUBLE every item on the canvas.\nTo fix mistakes: use modify/delete operations, or start a NEW job with clearCanvas: true.\n\nRULES:\n- NEVER restart the pipeline \u2014 one start_job, one batch_execute, one end_job\n- ALL operations go in batch_execute \u2014 canvas, background, items, animation, masks, effects, playback\n- EXCEPTION: Diagrams (flowcharts, UML) use pinepaper_create_diagram_shape + pinepaper_connect, NOT batch_execute\n- Use generators for rich backgrounds \u2014 the built-in templates are limited, generators create much better visuals\n- Use \"$0\", \"$1\" to reference items by creation order within the batch\n\n\u2500\u2500\u2500 BATCH OPERATIONS (12 types, in order) \u2500\u2500\u2500\n\nCANVAS:  set_canvas_size (width/height or preset) \u2192 set_background (color) \u2192 execute_generator (procedural art)\nITEMS:   create (itemType, position, properties) \u2192 modify (itemId, properties) \u2192 delete (itemId)\nANIMATE: animate (loop presets) \u2192 keyframe_animate (timed reveals) \u2192 relation (behavioral links)\nEFFECTS: apply_mask (reveal animations) \u2192 apply_effect (sparkle/blast)\nPLAY:    play_timeline (start playback)\n\n\u2500\u2500\u2500 GENERATORS (prefer these for backgrounds) \u2500\u2500\u2500\n\nGenerators fill the canvas with procedural art \u2014 much richer than solid colors.\nChoose based on mood:\n  Dreamy/soft:  drawBokeh, drawGradientMesh, drawOrganicFlow\n  Techy/modern: drawCircuit, drawGrid, drawWindField\n  Nature/warm:  drawSunsetScene, drawSunburst, drawWaves\n  Abstract:     drawGeometricAbstract, drawFluidFlow, drawNoiseTexture\n  Decorative:   drawPattern, drawStackedCircles\n\n\u2500\u2500\u2500 ITEMS \u2500\u2500\u2500\n\nShapes: circle, rectangle, star, ellipse, triangle, polygon, line, arc, path\nText: text (content, fontSize, fontFamily, color, fontWeight)\nAll items: opacity, shadowColor, shadowBlur, blendMode, strokeColor, strokeWidth\n\nSVG imports for recognizable objects (planes, cars, animals, buildings):\n  pinepaper_search_assets \u2192 pinepaper_import_asset (850k+ SVG icons)\n\n\u2500\u2500\u2500 ANIMATION (all in batch) \u2500\u2500\u2500\n\nLoop presets (animate): pulse, rotate, bounce, fade, wobble, slide, typewriter\nKeyframe (keyframe_animate): [{time, properties, easing}] \u2192 opacity, scale, scaleX, scaleY, x, y, rotation, fillColor, strokeColor, fontSize\nRelations (relation): orbits, follows, attached_to, points_at, mirrors, parallax, wave_through, morphs_to (+ 9 more in batch_execute schema)\nMasks (apply_mask): wipeLeft, wipeRight, wipeUp, wipeDown, iris, irisOut, star, heart, curtainHorizontal, curtainVertical, cinematic, diagonalWipe, revealUp, revealDown\nEffects (apply_effect): sparkle, blast\n\nComposability: one item can have loop + keyframe + relation + mask simultaneously.\n\nTiming templates (stagger reveals across duration):\n  5s:  bg 0s \u2192 elements 1-2s \u2192 text 2.5-3.5s \u2192 final 4-5s\n  10s: bg 0-1s \u2192 elements 1-4s \u2192 main 4-7s \u2192 details 7-9s \u2192 finale 9-10s\n\n\u2500\u2500\u2500 VISUAL COMPOSITION \u2500\u2500\u2500\n\nLayer order: background \u2192 large shapes (low opacity) \u2192 main subjects \u2192 text on top\nColor: dark bg (#0f172a) + bright accents (#f472b6, #818cf8, #fbbf24)\nScale: main subject 40-60% of canvas, supporting elements smaller\nSpacing: distribute across canvas with breathing room, don't cluster\n\n\u26A0\uFE0F SIZING \u2014 All positions and sizes MUST fit within the canvas:\n  Default canvas is 800x600. For infographics/social media, SET A PRESET FIRST.\n  start_job returns canvasSize \u2014 use it to calculate positions.\n  Keep all items within 5%-95% of canvas width/height (leave margins).\n  Font sizes relative to canvas: titles \u2264 5% of canvas width, body \u2264 3%.\n  Example for 1080x1080: title fontSize \u2264 54, body \u2264 32, positions 54-1026.\n  Example for 800x600: title fontSize \u2264 40, body \u2264 24, positions 40-760.\n\n\u26A0\uFE0F TEXT OVERLAP \u2014 NEVER place multiple text items at the same position:\n  Each text item MUST have a unique Y position. Stack vertically with spacing \u2265 fontSize \u00D7 1.4.\n  For N words stacked vertically: startY = centerY - (N-1) \u00D7 spacing / 2, then increment Y by spacing.\n  Example for 5 words at fontSize 48 on 800x600: spacing=67, startY=166, positions: 166, 233, 300, 367, 434.\n\n\u2500\u2500\u2500 DIAGRAMS (flowcharts, UML \u2014 do NOT use batch_execute) \u2500\u2500\u2500\n\nDiagrams use their own tools, not batch_execute:\n  pinepaper_create_diagram_shape \u2192 pinepaper_connect \u2192 pinepaper_auto_layout\nShapes: process (rect), decision (diamond), terminal (rounded), data, document, database, cloud, server\nWorkflow: create shapes with positions \u2192 connect with arrows \u2192 optional auto_layout\nSee pinepaper://docs/diagrams for full examples.\n\n\u2500\u2500\u2500 CANVAS & EXPORT \u2500\u2500\u2500\n\nPresets: instagram (1080x1080), youtube (1920x1080), tiktok (1080x1920), twitter (1200x675)\nExport: pinepaper_agent_export (SVG/PNG/GIF/MP4/WebM/PDF), pinepaper_export_svg";
 export declare const PINEPAPER_TOOLS: Tool[];
 /**
  * Get a tool definition by name
@@ -25,14 +26,15 @@ export declare function getToolNames(): string[];
 export declare function getLocalizedTools(i18n: I18nManager): Tool[];
 /**
  * Tool description verbosity level.
- * - 'verbose': Full descriptions (default, ~42K tokens)
+ * - 'verbose': Full descriptions (~42K tokens for full toolkit)
  * - 'compact': Trimmed descriptions for the 13 largest tools (~37K tokens)
+ * - 'minimal': 1-line summaries for all tools (~22K tokens). Use pinepaper_tool_guide for details.
  */
-export type ToolVerbosity = 'verbose' | 'compact';
+export type ToolVerbosity = 'verbose' | 'compact' | 'minimal';
 /**
  * Get tools with the specified verbosity level.
- * Compact mode swaps in shorter descriptions for the 13 largest tools,
- * reducing context usage by ~5K tokens while preserving critical guidance.
+ * Compact mode swaps in shorter descriptions for the 13 largest tools.
+ * Minimal mode swaps in 1-line summaries for ALL tools (on-demand guide available).
  */
 export declare function getToolsForVerbosity(verbosity: ToolVerbosity): Tool[];
 //# sourceMappingURL=definitions.d.ts.map

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

@@ -1 +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;AA4G/C,eAAO,MAAM,eAAe,EAAE,IAAI,EAq5LjC,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;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,EAAE,CAMrE"}
+{"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;AAQ/C,eAAO,MAAM,cAAc,+vNAsGqD,CAAC;AAWjF,eAAO,MAAM,eAAe,EAAE,IAAI,EAumNjC,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;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,EAAE,CAQrE"}