conductor-figma 0.1.0 → 0.3.0

package/bin/conductor.js

@@ -3,21 +3,28 @@
 import { startServer } from '../src/server.js';
 import { TOOLS, CATEGORIES } from '../src/tools/registry.js';
 
-const args = process.argv.slice(2);
+var args = process.argv.slice(2);
 
 if (args.includes('--help') || args.includes('-h')) {
   console.log(`
   ⊞ CONDUCTOR — Design-intelligent MCP server for Figma
 
   Usage:
-    conductor-figma              Start MCP server (stdio)
-    conductor-figma --list       List all ${TOOLS.length} tools
-    conductor-figma --categories Show tool categories
-    conductor-figma --help       Show this help
+    conductor-figma                Start MCP server + orchestrator
+    conductor-figma --port 9800    Set WebSocket port (default: 9800)
+    conductor-figma --list         List all ${TOOLS.length} tools
+    conductor-figma --categories   Show tool categories
+    conductor-figma --help         Show this help
 
-  MCP Setup (Cursor):
-    Add to ~/.cursor/mcp.json:
+  How it works:
+    1. You say "create a pricing page" in Cursor
+    2. CONDUCTOR generates a blueprint (30-50 commands)
+    3. Each command executes sequentially on your Figma canvas
+    4. Frames, text, cards, buttons appear in real-time
+    5. All auto-layout. All grid-aligned. All design-intelligent.
 
+  Setup:
+    ~/.cursor/mcp.json:
     {
       "mcpServers": {
         "conductor": {
@@ -27,32 +34,43 @@ if (args.includes('--help') || args.includes('-h')) {
       }
     }
 
-  ${TOOLS.length} tools · ${Object.keys(CATEGORIES).length} categories · Zero dependencies
+  Then open the CONDUCTOR plugin in Figma and click Connect.
+
+  ${TOOLS.length} tools · ${Object.keys(CATEGORIES).length} categories
   Built by 0xDragoon · MIT License
 `);
   process.exit(0);
 }
 
 if (args.includes('--list')) {
-  for (const [catKey, cat] of Object.entries(CATEGORIES)) {
-    const tools = TOOLS.filter(t => t.category === catKey);
-    console.log(`\n  ${cat.icon} ${cat.label} (${tools.length})`);
-    for (const t of tools) {
-      console.log(`    ${t.name.padEnd(28)} ${t.description.slice(0, 70)}`);
+  for (var entries = Object.entries(CATEGORIES), i = 0; i < entries.length; i++) {
+    var catKey = entries[i][0], cat = entries[i][1];
+    var tools = TOOLS.filter(function(t) { return t.category === catKey; });
+    console.log('\n  ' + cat.icon + ' ' + cat.label + ' (' + tools.length + ')');
+    for (var j = 0; j < tools.length; j++) {
+      console.log('    ' + tools[j].name.padEnd(28) + ' ' + tools[j].description.slice(0, 70));
     }
   }
-  console.log(`\n  ${TOOLS.length} tools total\n`);
+  console.log('\n  ' + TOOLS.length + ' tools total\n');
   process.exit(0);
 }
 
 if (args.includes('--categories')) {
-  for (const [key, cat] of Object.entries(CATEGORIES)) {
-    const tools = TOOLS.filter(t => t.category === key);
-    console.log(`  ${cat.icon} ${cat.label.padEnd(18)} ${tools.length} tools`);
+  for (var entries2 = Object.entries(CATEGORIES), k = 0; k < entries2.length; k++) {
+    var key = entries2[k][0], cat2 = entries2[k][1];
+    var count = TOOLS.filter(function(t) { return t.category === key; }).length;
+    console.log('  ' + cat2.icon + ' ' + cat2.label.padEnd(18) + ' ' + count + ' tools');
   }
-  console.log(`\n  ${TOOLS.length} tools total`);
+  console.log('\n  ' + TOOLS.length + ' tools total');
   process.exit(0);
 }
 
-// Default: start MCP server
-startServer();
+// Parse port
+var port = 9800;
+var portIdx = args.indexOf('--port');
+if (portIdx !== -1 && args[portIdx + 1]) {
+  port = parseInt(args[portIdx + 1]) || 9800;
+}
+
+// Start MCP server with relay
+startServer({ port: port });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-figma",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Design-intelligent MCP server for Figma. 61 tools across 10 categories. 8px grid, type scale ratios, auto-layout, component reuse, accessibility — real design intelligence, not shape proxying.",
   "author": "0xDragoon",
   "license": "MIT",
@@ -33,5 +33,8 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {}
+  "dependencies": {},
+  "optionalDependencies": {
+    "ws": "^8.0.0"
+  }
 }

package/src/blueprints.js

@@ -0,0 +1,656 @@
+// ═══════════════════════════════════════════
+// CONDUCTOR — Blueprints
+// ═══════════════════════════════════════════
+// Each blueprint generates a complete command sequence.
+// Commands reference previous results via '$N.id' tokens.
+// All values are grid-aligned and design-intelligent.
+
+import { snapToGrid, generateTypeScale, generateSemanticColors, generatePalette } from './design/intelligence.js';
+
+// ─── Helpers ───
+
+function frame(name, opts) {
+  return {
+    type: 'create_frame',
+    data: Object.assign({
+      name: name,
+      direction: 'VERTICAL',
+      padding: 0,
+      gap: 0,
+      fill: '#0f0f1a',
+      cornerRadius: 0,
+    }, opts),
+  };
+}
+
+function hframe(name, opts) {
+  return frame(name, Object.assign({ direction: 'HORIZONTAL' }, opts));
+}
+
+function text(content, opts) {
+  return {
+    type: 'create_text',
+    data: Object.assign({
+      text: content,
+      fontSize: 16,
+      color: '#ffffff',
+      fontName: { family: 'Inter', style: 'Regular' },
+    }, opts),
+  };
+}
+
+function rect(name, opts) {
+  return {
+    type: 'create_rect',
+    data: Object.assign({ name: name, width: 100, height: 100 }, opts),
+  };
+}
+
+function appendTo(parentRef, cmd) {
+  cmd.data.parentId = parentRef;
+  return cmd;
+}
+
+// ═══════════════════════════════════════════
+// PAGE BLUEPRINTS
+// ═══════════════════════════════════════════
+
+export function buildLandingPage(args) {
+  var brandColor = args.brandColor || '#6366f1';
+  var colors = generateSemanticColors(brandColor);
+  var pageWidth = args.width || 1440;
+  var dark = args.darkMode !== false;
+  var bg = dark ? '#0f0f1a' : '#ffffff';
+  var textColor = dark ? '#ffffff' : '#111111';
+  var mutedColor = dark ? '#888899' : '#666677';
+  var cardBg = dark ? '#16162e' : '#f5f5f7';
+  var title = args.title || 'Ship faster with less overhead';
+  var subtitle = args.subtitle || 'The modern platform for teams that move fast. Everything you need to build, deploy, and scale.';
+  var ctaText = args.ctaText || 'Get started free';
+  var navItems = args.navItems || ['Features', 'Pricing', 'Docs', 'Blog'];
+  var features = args.features || [
+    { icon: '⚡', title: 'Instant Deploy', desc: 'Push to deploy in seconds. Zero config. Automatic HTTPS and global CDN.' },
+    { icon: '📈', title: 'Auto Scale', desc: 'Scales to millions automatically. Pay only for what you use.' },
+    { icon: '🔒', title: 'Enterprise Security', desc: 'SOC 2 compliant. End-to-end encryption. SSO and RBAC built in.' },
+  ];
+  var stats = args.stats || [
+    { value: '10,000+', label: 'Teams worldwide' },
+    { value: '99.9%', label: 'Uptime SLA' },
+    { value: '< 50ms', label: 'Global latency' },
+  ];
+
+  var cmds = [];
+
+  // 0: Page root
+  cmds.push(frame('Landing Page', { width: pageWidth, height: 2000, fill: bg, gap: 0 }));
+
+  // 1: Nav
+  cmds.push(appendTo('$0.id', hframe('Navigation', {
+    width: pageWidth, height: 64, padding: 24, gap: 16, fill: bg,
+    counterAxisAlignItems: 'CENTER',
+  })));
+
+  // 2: Logo
+  cmds.push(appendTo('$1.id', text(args.brand || 'acme', {
+    fontSize: 18, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+  })));
+
+  // 3: Nav spacer
+  cmds.push(appendTo('$1.id', frame('Spacer', {
+    width: 1, height: 1, fill: bg,
+    primaryAxisSizingMode: 'FILL',
+  })));
+
+  // 4-N: Nav links
+  for (var i = 0; i < navItems.length; i++) {
+    cmds.push(appendTo('$1.id', text(navItems[i], {
+      fontSize: 14, color: mutedColor, fontName: { family: 'Inter', style: 'Medium' },
+    })));
+  }
+
+  // Nav CTA button frame
+  var navBtnIdx = cmds.length;
+  cmds.push(appendTo('$1.id', hframe('Nav CTA', {
+    width: 120, height: 36, padding: 12, gap: 0,
+    fill: brandColor, cornerRadius: 8,
+    primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+  })));
+  cmds.push(appendTo('$' + navBtnIdx + '.id', text('Sign up', {
+    fontSize: 13, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' },
+  })));
+
+  // Hero section
+  var heroIdx = cmds.length;
+  cmds.push(appendTo('$0.id', frame('Hero Section', {
+    width: pageWidth, height: 520, padding: 80, gap: 24, fill: bg,
+    primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+  })));
+
+  // Hero overline
+  cmds.push(appendTo('$' + heroIdx + '.id', text('INTRODUCING ' + (args.brand || 'ACME').toUpperCase(), {
+    fontSize: 12, color: brandColor, fontName: { family: 'Inter', style: 'Semi Bold' },
+  })));
+
+  // Hero heading
+  cmds.push(appendTo('$' + heroIdx + '.id', text(title, {
+    fontSize: 56, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  // Hero subtitle
+  cmds.push(appendTo('$' + heroIdx + '.id', text(subtitle, {
+    fontSize: 18, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  // Hero button row
+  var btnRowIdx = cmds.length;
+  cmds.push(appendTo('$' + heroIdx + '.id', hframe('Hero Buttons', {
+    width: 340, height: 48, gap: 12, fill: bg,
+    primaryAxisAlignItems: 'CENTER',
+  })));
+
+  // Primary CTA
+  var primaryBtnIdx = cmds.length;
+  cmds.push(appendTo('$' + btnRowIdx + '.id', hframe('Primary CTA', {
+    width: 160, height: 48, padding: 16, fill: brandColor, cornerRadius: 10,
+    primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+  })));
+  cmds.push(appendTo('$' + primaryBtnIdx + '.id', text(ctaText, {
+    fontSize: 15, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' },
+  })));
+
+  // Secondary CTA
+  var secBtnIdx = cmds.length;
+  cmds.push(appendTo('$' + btnRowIdx + '.id', hframe('Secondary CTA', {
+    width: 160, height: 48, padding: 16, fill: dark ? '#1a1a2e' : '#eeeeee', cornerRadius: 10,
+    primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+  })));
+  cmds.push(appendTo('$' + secBtnIdx + '.id', text('View demo →', {
+    fontSize: 15, color: dark ? '#ccccdd' : '#333333', fontName: { family: 'Inter', style: 'Medium' },
+  })));
+
+  // Stats bar
+  var statsIdx = cmds.length;
+  cmds.push(appendTo('$0.id', hframe('Stats Bar', {
+    width: pageWidth, height: 120, padding: 48, gap: 80, fill: dark ? '#13132a' : '#f8f8fa',
+    counterAxisAlignItems: 'CENTER',
+  })));
+
+  for (var s = 0; s < stats.length; s++) {
+    var statIdx = cmds.length;
+    cmds.push(appendTo('$' + statsIdx + '.id', frame('Stat ' + (s + 1), {
+      width: 200, height: 64, gap: 4, fill: dark ? '#13132a' : '#f8f8fa',
+      counterAxisAlignItems: 'CENTER',
+    })));
+    cmds.push(appendTo('$' + statIdx + '.id', text(stats[s].value, {
+      fontSize: 32, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+    })));
+    cmds.push(appendTo('$' + statIdx + '.id', text(stats[s].label, {
+      fontSize: 13, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+    })));
+  }
+
+  // Features section
+  var featSectionIdx = cmds.length;
+  cmds.push(appendTo('$0.id', frame('Features Section', {
+    width: pageWidth, padding: 64, gap: 32, fill: bg,
+    counterAxisAlignItems: 'CENTER',
+  })));
+
+  cmds.push(appendTo('$' + featSectionIdx + '.id', text('Everything you need', {
+    fontSize: 36, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  cmds.push(appendTo('$' + featSectionIdx + '.id', text('Powerful features to help your team ship faster and with more confidence.', {
+    fontSize: 16, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  // Feature card row
+  var cardRowIdx = cmds.length;
+  cmds.push(appendTo('$' + featSectionIdx + '.id', hframe('Feature Cards', {
+    width: pageWidth - 128, gap: 20, fill: bg,
+  })));
+
+  for (var f = 0; f < features.length; f++) {
+    var cardIdx = cmds.length;
+    var cardWidth = Math.floor((pageWidth - 128 - (features.length - 1) * 20) / features.length);
+    cmds.push(appendTo('$' + cardRowIdx + '.id', frame(features[f].title, {
+      width: cardWidth, height: 200, padding: 24, gap: 12, fill: cardBg, cornerRadius: 14,
+    })));
+    cmds.push(appendTo('$' + cardIdx + '.id', text(features[f].icon + '  ' + features[f].title, {
+      fontSize: 18, color: textColor, fontName: { family: 'Inter', style: 'Semi Bold' },
+    })));
+    cmds.push(appendTo('$' + cardIdx + '.id', text(features[f].desc, {
+      fontSize: 14, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+    })));
+  }
+
+  // CTA section
+  var ctaSectionIdx = cmds.length;
+  cmds.push(appendTo('$0.id', frame('CTA Section', {
+    width: pageWidth, padding: 80, gap: 24, fill: dark ? '#0a0a14' : '#f0f0f2',
+    primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+  })));
+
+  cmds.push(appendTo('$' + ctaSectionIdx + '.id', text('Ready to get started?', {
+    fontSize: 40, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  cmds.push(appendTo('$' + ctaSectionIdx + '.id', text('Join thousands of teams already shipping faster.', {
+    fontSize: 16, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  var ctaBtnIdx = cmds.length;
+  cmds.push(appendTo('$' + ctaSectionIdx + '.id', hframe('CTA Button', {
+    width: 200, height: 52, padding: 16, fill: brandColor, cornerRadius: 12,
+    primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+  })));
+  cmds.push(appendTo('$' + ctaBtnIdx + '.id', text(ctaText, {
+    fontSize: 16, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' },
+  })));
+
+  // Footer
+  var footerIdx = cmds.length;
+  cmds.push(appendTo('$0.id', hframe('Footer', {
+    width: pageWidth, height: 80, padding: 24, gap: 16, fill: dark ? '#080812' : '#f5f5f7',
+    counterAxisAlignItems: 'CENTER',
+  })));
+
+  cmds.push(appendTo('$' + footerIdx + '.id', text('© 2025 ' + (args.brand || 'Acme') + '. All rights reserved.', {
+    fontSize: 13, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+  })));
+
+  return {
+    commands: cmds,
+    description: 'Landing page with nav, hero, stats, features (' + features.length + ' cards), CTA, and footer. ' + cmds.length + ' elements, all auto-layout, ' + (dark ? 'dark' : 'light') + ' theme.',
+  };
+}
+
+// ═══════════════════════════════════════════
+// PRICING PAGE
+// ═══════════════════════════════════════════
+
+export function buildPricingPage(args) {
+  var brandColor = args.brandColor || '#6366f1';
+  var pageWidth = args.width || 1440;
+  var bg = '#0f0f1a';
+  var textColor = '#ffffff';
+  var mutedColor = '#888899';
+  var cardBg = '#16162e';
+  var tiers = args.tiers || [
+    { name: 'Starter', price: '$0', period: '/mo', desc: 'For individuals and small projects', features: ['1 project', '100 API calls/day', 'Community support', 'Basic analytics'], cta: 'Start free', highlighted: false },
+    { name: 'Pro', price: '$29', period: '/mo', desc: 'For growing teams that need more', features: ['Unlimited projects', '10,000 API calls/day', 'Priority support', 'Advanced analytics', 'Team collaboration', 'Custom domains'], cta: 'Start free trial', highlighted: true },
+    { name: 'Enterprise', price: 'Custom', period: '', desc: 'For large organizations', features: ['Everything in Pro', 'Unlimited API calls', 'Dedicated support', 'SSO & SAML', 'SLA guarantee', 'Custom integrations', 'On-premise option'], cta: 'Contact sales', highlighted: false },
+  ];
+
+  var cmds = [];
+
+  // 0: Page
+  cmds.push(frame('Pricing Page', { width: pageWidth, height: 1400, fill: bg, gap: 0 }));
+
+  // 1: Header
+  var headerIdx = cmds.length;
+  cmds.push(appendTo('$0.id', frame('Pricing Header', {
+    width: pageWidth, padding: 80, gap: 16, fill: bg,
+    primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+  })));
+
+  cmds.push(appendTo('$' + headerIdx + '.id', text('Simple, transparent pricing', {
+    fontSize: 48, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  cmds.push(appendTo('$' + headerIdx + '.id', text('No hidden fees. No surprises. Cancel anytime.', {
+    fontSize: 18, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+    textAlignHorizontal: 'CENTER',
+  })));
+
+  // Tier cards row
+  var tierRowIdx = cmds.length;
+  cmds.push(appendTo('$0.id', hframe('Pricing Tiers', {
+    width: pageWidth, padding: 48, gap: 20, fill: bg,
+    primaryAxisAlignItems: 'CENTER',
+  })));
+
+  for (var t = 0; t < tiers.length; t++) {
+    var tier = tiers[t];
+    var cardW = Math.min(380, Math.floor((pageWidth - 96 - (tiers.length - 1) * 20) / tiers.length));
+    var isHighlighted = tier.highlighted;
+
+    var tierIdx = cmds.length;
+    cmds.push(appendTo('$' + tierRowIdx + '.id', frame(tier.name + ' Tier', {
+      width: cardW, padding: 32, gap: 16, cornerRadius: 16,
+      fill: isHighlighted ? '#1e1e40' : cardBg,
+    })));
+
+    if (isHighlighted) {
+      var badgeIdx = cmds.length;
+      cmds.push(appendTo('$' + tierIdx + '.id', hframe('Popular Badge', {
+        width: 100, height: 24, padding: 6, fill: brandColor, cornerRadius: 6,
+        primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+      })));
+      cmds.push(appendTo('$' + badgeIdx + '.id', text('POPULAR', {
+        fontSize: 10, color: '#ffffff', fontName: { family: 'Inter', style: 'Bold' },
+      })));
+    }
+
+    cmds.push(appendTo('$' + tierIdx + '.id', text(tier.name, {
+      fontSize: 20, color: textColor, fontName: { family: 'Inter', style: 'Semi Bold' },
+    })));
+
+    // Price row
+    var priceRowIdx = cmds.length;
+    cmds.push(appendTo('$' + tierIdx + '.id', hframe('Price', {
+      gap: 2, fill: isHighlighted ? '#1e1e40' : cardBg,
+      counterAxisAlignItems: 'BASELINE',
+    })));
+    cmds.push(appendTo('$' + priceRowIdx + '.id', text(tier.price, {
+      fontSize: 40, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+    })));
+    if (tier.period) {
+      cmds.push(appendTo('$' + priceRowIdx + '.id', text(tier.period, {
+        fontSize: 16, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+      })));
+    }
+
+    cmds.push(appendTo('$' + tierIdx + '.id', text(tier.desc, {
+      fontSize: 14, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+    })));
+
+    // Divider
+    cmds.push(appendTo('$' + tierIdx + '.id', rect('Divider', {
+      width: cardW - 64, height: 1, fill: '#252540',
+    })));
+
+    // Features
+    for (var fi = 0; fi < tier.features.length; fi++) {
+      cmds.push(appendTo('$' + tierIdx + '.id', text('✓  ' + tier.features[fi], {
+        fontSize: 13, color: mutedColor, fontName: { family: 'Inter', style: 'Regular' },
+      })));
+    }
+
+    // CTA button
+    var tierBtnIdx = cmds.length;
+    cmds.push(appendTo('$' + tierIdx + '.id', hframe(tier.cta, {
+      height: 44, padding: 12,
+      fill: isHighlighted ? brandColor : 'transparent',
+      cornerRadius: 8,
+      primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER',
+      primaryAxisSizingMode: 'FILL',
+    })));
+    cmds.push(appendTo('$' + tierBtnIdx + '.id', text(tier.cta, {
+      fontSize: 14, color: isHighlighted ? '#ffffff' : brandColor,
+      fontName: { family: 'Inter', style: 'Semi Bold' },
+    })));
+  }
+
+  return {
+    commands: cmds,
+    description: 'Pricing page with ' + tiers.length + ' tiers (' + tiers.map(function(t) { return t.name; }).join(', ') + '). ' + cmds.length + ' elements, all auto-layout.',
+  };
+}
+
+// ═══════════════════════════════════════════
+// DASHBOARD PAGE
+// ═══════════════════════════════════════════
+
+export function buildDashboardPage(args) {
+  var pageWidth = args.width || 1440;
+  var bg = '#0f0f1a';
+  var cardBg = '#16162e';
+  var textColor = '#ffffff';
+  var mutedColor = '#888899';
+  var brandColor = args.brandColor || '#6366f1';
+  var metrics = args.metrics || [
+    { label: 'Total Revenue', value: '$48,290', change: '+12.5%', positive: true },
+    { label: 'Active Users', value: '2,420', change: '+8.3%', positive: true },
+    { label: 'Conversion', value: '3.24%', change: '-0.8%', positive: false },
+    { label: 'Avg. Session', value: '4m 32s', change: '+15.2%', positive: true },
+  ];
+
+  var cmds = [];
+
+  // 0: Page
+  cmds.push(hframe('Dashboard', { width: pageWidth, height: 900, fill: bg, gap: 0 }));
+
+  // 1: Sidebar
+  var sidebarIdx = cmds.length;
+  cmds.push(appendTo('$0.id', frame('Sidebar', {
+    width: 240, height: 900, padding: 16, gap: 8, fill: '#0a0a14',
+  })));
+
+  // Sidebar logo
+  cmds.push(appendTo('$' + sidebarIdx + '.id', text('◆  Dashboard', {
+    fontSize: 14, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+  })));
+
+  // Sidebar spacer
+  cmds.push(appendTo('$' + sidebarIdx + '.id', frame('Spacer', { width: 1, height: 16, fill: '#0a0a14' })));
+
+  // Sidebar nav items
+  var sideNavItems = ['Overview', 'Analytics', 'Customers', 'Products', 'Settings'];
+  for (var si = 0; si < sideNavItems.length; si++) {
+    var navItemIdx = cmds.length;
+    cmds.push(appendTo('$' + sidebarIdx + '.id', hframe(sideNavItems[si], {
+      height: 36, padding: 12, gap: 8, cornerRadius: 6,
+      fill: si === 0 ? '#1a1a30' : '#0a0a14',
+      primaryAxisSizingMode: 'FILL', counterAxisAlignItems: 'CENTER',
+    })));
+    cmds.push(appendTo('$' + navItemIdx + '.id', text(sideNavItems[si], {
+      fontSize: 13, color: si === 0 ? textColor : mutedColor,
+      fontName: { family: 'Inter', style: si === 0 ? 'Medium' : 'Regular' },
+    })));
+  }
+
+  // Main content area
+  var mainIdx = cmds.length;
+  cmds.push(appendTo('$0.id', frame('Main Content', {
+    width: pageWidth - 240, height: 900, padding: 32, gap: 24, fill: bg,
+  })));
+
+  // Header row
+  var headerIdx = cmds.length;
+  cmds.push(appendTo('$' + mainIdx + '.id', hframe('Header', {
+    gap: 16, fill: bg, counterAxisAlignItems: 'CENTER',
+    primaryAxisSizingMode: 'FILL',
+  })));
+  cmds.push(appendTo('$' + headerIdx + '.id', text('Overview', {
+    fontSize: 24, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+  })));
+
+  // Metric cards row
+  var metricsRowIdx = cmds.length;
+  cmds.push(appendTo('$' + mainIdx + '.id', hframe('Metrics', {
+    gap: 16, fill: bg, primaryAxisSizingMode: 'FILL',
+  })));
+
+  for (var mi = 0; mi < metrics.length; mi++) {
+    var metricIdx = cmds.length;
+    var metricW = Math.floor((pageWidth - 240 - 64 - (metrics.length - 1) * 16) / metrics.length);
+    cmds.push(appendTo('$' + metricsRowIdx + '.id', frame(metrics[mi].label, {
+      width: metricW, padding: 20, gap: 8, fill: cardBg, cornerRadius: 12,
+    })));
+    cmds.push(appendTo('$' + metricIdx + '.id', text(metrics[mi].label, {
+      fontSize: 12, color: mutedColor, fontName: { family: 'Inter', style: 'Medium' },
+    })));
+    cmds.push(appendTo('$' + metricIdx + '.id', text(metrics[mi].value, {
+      fontSize: 28, color: textColor, fontName: { family: 'Inter', style: 'Bold' },
+    })));
+    cmds.push(appendTo('$' + metricIdx + '.id', text(metrics[mi].change, {
+      fontSize: 12, color: metrics[mi].positive ? '#4ade80' : '#f87171',
+      fontName: { family: 'Inter', style: 'Medium' },
+    })));
+  }
+
+  // Chart placeholder
+  var chartIdx = cmds.length;
+  cmds.push(appendTo('$' + mainIdx + '.id', frame('Chart Area', {
+    height: 300, padding: 24, gap: 12, fill: cardBg, cornerRadius: 12,
+    primaryAxisSizingMode: 'FILL',
+  })));
+  cmds.push(appendTo('$' + chartIdx + '.id', text('Revenue Over Time', {
+    fontSize: 16, color: textColor, fontName: { family: 'Inter', style: 'Semi Bold' },
+  })));
+  cmds.push(appendTo('$' + chartIdx + '.id', rect('Chart Placeholder', {
+    width: 900, height: 200, fill: '#1a1a30', cornerRadius: 8,
+  })));
+
+  return {
+    commands: cmds,
+    description: 'Dashboard with sidebar nav, header, ' + metrics.length + ' metric cards, and chart area. ' + cmds.length + ' elements, all auto-layout.',
+  };
+}
+
+// ═══════════════════════════════════════════
+// SECTION BLUEPRINTS
+// ═══════════════════════════════════════════
+
+export function buildSection(sectionType, args) {
+  switch (sectionType) {
+    case 'hero': return buildHeroSection(args);
+    case 'features': return buildFeaturesSection(args);
+    case 'pricing': return buildPricingSection(args);
+    case 'cta': return buildCTASection(args);
+    case 'testimonials': return buildTestimonialsSection(args);
+    case 'faq': return buildFAQSection(args);
+    default: return buildHeroSection(args);
+  }
+}
+
+function buildHeroSection(args) {
+  var w = args.width || 1440;
+  var brandColor = args.brandColor || '#6366f1';
+  var cmds = [];
+
+  cmds.push(frame('Hero', { width: w, padding: 80, gap: 24, fill: '#0f0f1a', primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER' }));
+  cmds.push(appendTo('$0.id', text(args.heading || 'Build something great', { fontSize: 56, color: '#ffffff', fontName: { family: 'Inter', style: 'Bold' }, textAlignHorizontal: 'CENTER' })));
+  cmds.push(appendTo('$0.id', text(args.subheading || 'The platform for modern teams.', { fontSize: 18, color: '#888899', fontName: { family: 'Inter', style: 'Regular' }, textAlignHorizontal: 'CENTER' })));
+
+  var btnIdx = cmds.length;
+  cmds.push(appendTo('$0.id', hframe('CTA', { width: 180, height: 48, padding: 16, fill: brandColor, cornerRadius: 10, primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER' })));
+  cmds.push(appendTo('$' + btnIdx + '.id', text(args.ctaText || 'Get started', { fontSize: 15, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' } })));
+
+  return { commands: cmds, description: 'Hero section with heading, subtitle, and CTA.' };
+}
+
+function buildFeaturesSection(args) {
+  var w = args.width || 1440;
+  var features = args.features || [
+    { title: 'Fast', desc: 'Blazing fast performance.' },
+    { title: 'Secure', desc: 'Enterprise-grade security.' },
+    { title: 'Scalable', desc: 'Grows with your team.' },
+  ];
+  var cmds = [];
+
+  cmds.push(frame('Features', { width: w, padding: 64, gap: 32, fill: '#0f0f1a', counterAxisAlignItems: 'CENTER' }));
+  cmds.push(appendTo('$0.id', text(args.heading || 'Features', { fontSize: 36, color: '#ffffff', fontName: { family: 'Inter', style: 'Bold' }, textAlignHorizontal: 'CENTER' })));
+
+  var rowIdx = cmds.length;
+  cmds.push(appendTo('$0.id', hframe('Feature Cards', { width: w - 128, gap: 20, fill: '#0f0f1a' })));
+
+  for (var i = 0; i < features.length; i++) {
+    var cw = Math.floor((w - 128 - (features.length - 1) * 20) / features.length);
+    var ci = cmds.length;
+    cmds.push(appendTo('$' + rowIdx + '.id', frame(features[i].title, { width: cw, height: 160, padding: 24, gap: 10, fill: '#16162e', cornerRadius: 12 })));
+    cmds.push(appendTo('$' + ci + '.id', text(features[i].title, { fontSize: 18, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' } })));
+    cmds.push(appendTo('$' + ci + '.id', text(features[i].desc, { fontSize: 14, color: '#888899', fontName: { family: 'Inter', style: 'Regular' } })));
+  }
+
+  return { commands: cmds, description: 'Features section with ' + features.length + ' cards.' };
+}
+
+function buildPricingSection(args) {
+  return buildPricingPage(args);
+}
+
+function buildCTASection(args) {
+  var w = args.width || 1440;
+  var brandColor = args.brandColor || '#6366f1';
+  var cmds = [];
+
+  cmds.push(frame('CTA Section', { width: w, padding: 80, gap: 24, fill: '#0a0a14', primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER' }));
+  cmds.push(appendTo('$0.id', text(args.heading || 'Ready to start?', { fontSize: 40, color: '#ffffff', fontName: { family: 'Inter', style: 'Bold' }, textAlignHorizontal: 'CENTER' })));
+  cmds.push(appendTo('$0.id', text(args.subheading || 'Join thousands of teams.', { fontSize: 16, color: '#888899', fontName: { family: 'Inter', style: 'Regular' }, textAlignHorizontal: 'CENTER' })));
+
+  var btnIdx = cmds.length;
+  cmds.push(appendTo('$0.id', hframe('CTA Button', { width: 200, height: 52, padding: 16, fill: brandColor, cornerRadius: 12, primaryAxisAlignItems: 'CENTER', counterAxisAlignItems: 'CENTER' })));
+  cmds.push(appendTo('$' + btnIdx + '.id', text(args.ctaText || 'Get started free', { fontSize: 16, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' } })));
+
+  return { commands: cmds, description: 'CTA section with heading, subtitle, and button.' };
+}
+
+function buildTestimonialsSection(args) {
+  var w = args.width || 1440;
+  var testimonials = args.testimonials || [
+    { quote: 'This product transformed how our team works. Absolutely incredible.', author: 'Sarah Chen', role: 'CTO, TechCorp' },
+    { quote: 'The best tool we have adopted this year. Our productivity doubled.', author: 'Marcus Rivera', role: 'VP Engineering, ScaleUp' },
+  ];
+  var cmds = [];
+
+  cmds.push(frame('Testimonials', { width: w, padding: 64, gap: 32, fill: '#0f0f1a', counterAxisAlignItems: 'CENTER' }));
+  cmds.push(appendTo('$0.id', text('What people say', { fontSize: 36, color: '#ffffff', fontName: { family: 'Inter', style: 'Bold' }, textAlignHorizontal: 'CENTER' })));
+
+  var rowIdx = cmds.length;
+  cmds.push(appendTo('$0.id', hframe('Testimonial Cards', { width: w - 128, gap: 20, fill: '#0f0f1a' })));
+
+  for (var i = 0; i < testimonials.length; i++) {
+    var tw = Math.floor((w - 128 - (testimonials.length - 1) * 20) / testimonials.length);
+    var ti = cmds.length;
+    cmds.push(appendTo('$' + rowIdx + '.id', frame('Testimonial ' + (i + 1), { width: tw, padding: 24, gap: 16, fill: '#16162e', cornerRadius: 14 })));
+    cmds.push(appendTo('$' + ti + '.id', text('"' + testimonials[i].quote + '"', { fontSize: 15, color: '#ccccdd', fontName: { family: 'Inter', style: 'Regular' } })));
+    cmds.push(appendTo('$' + ti + '.id', text(testimonials[i].author, { fontSize: 14, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' } })));
+    cmds.push(appendTo('$' + ti + '.id', text(testimonials[i].role, { fontSize: 12, color: '#888899', fontName: { family: 'Inter', style: 'Regular' } })));
+  }
+
+  return { commands: cmds, description: 'Testimonials with ' + testimonials.length + ' cards.' };
+}
+
+function buildFAQSection(args) {
+  var w = args.width || 1440;
+  var faqs = args.faqs || [
+    { q: 'How do I get started?', a: 'Sign up for free and follow our quick-start guide. Takes less than 5 minutes.' },
+    { q: 'Can I cancel anytime?', a: 'Yes. No contracts, no cancellation fees. Cancel with one click.' },
+    { q: 'Do you offer support?', a: 'All plans include email support. Pro and Enterprise get priority support.' },
+  ];
+  var cmds = [];
+
+  cmds.push(frame('FAQ', { width: w, padding: 64, gap: 32, fill: '#0f0f1a', counterAxisAlignItems: 'CENTER' }));
+  cmds.push(appendTo('$0.id', text('Frequently asked questions', { fontSize: 36, color: '#ffffff', fontName: { family: 'Inter', style: 'Bold' }, textAlignHorizontal: 'CENTER' })));
+
+  var listIdx = cmds.length;
+  cmds.push(appendTo('$0.id', frame('FAQ List', { width: Math.min(700, w - 128), gap: 12, fill: '#0f0f1a' })));
+
+  for (var i = 0; i < faqs.length; i++) {
+    var faqIdx = cmds.length;
+    cmds.push(appendTo('$' + listIdx + '.id', frame('FAQ ' + (i + 1), { padding: 20, gap: 8, fill: '#16162e', cornerRadius: 10, primaryAxisSizingMode: 'FILL' })));
+    cmds.push(appendTo('$' + faqIdx + '.id', text(faqs[i].q, { fontSize: 15, color: '#ffffff', fontName: { family: 'Inter', style: 'Semi Bold' } })));
+    cmds.push(appendTo('$' + faqIdx + '.id', text(faqs[i].a, { fontSize: 13, color: '#888899', fontName: { family: 'Inter', style: 'Regular' } })));
+  }
+
+  return { commands: cmds, description: 'FAQ section with ' + faqs.length + ' items.' };
+}
+
+// ═══════════════════════════════════════════
+// BLUEPRINT ROUTER
+// ═══════════════════════════════════════════
+
+export function getBlueprint(toolName, args) {
+  switch (toolName) {
+    case 'create_page':
+      switch (args.pageType) {
+        case 'landing': return buildLandingPage(args);
+        case 'pricing': return buildPricingPage(args);
+        case 'dashboard': return buildDashboardPage(args);
+        default: return buildLandingPage(args);
+      }
+    case 'create_section':
+      return buildSection(args.sectionType, args);
+    default:
+      return null;
+  }
+}

package/src/index.js

@@ -3,6 +3,9 @@
 // ═══════════════════════════════════════════
 
 export { startServer } from './server.js';
+export { Relay } from './relay.js';
+export { executeSequence } from './orchestrator.js';
+export { getBlueprint, buildLandingPage, buildPricingPage, buildDashboardPage, buildSection } from './blueprints.js';
 export { TOOLS, CATEGORIES, getToolByName, getToolsByCategory, getAllToolNames } from './tools/registry.js';
 export { handleTool } from './tools/handlers.js';
 

package/src/orchestrator.js

@@ -0,0 +1,100 @@
+// ═══════════════════════════════════════════
+// CONDUCTOR — Orchestrator
+// ═══════════════════════════════════════════
+// Takes a blueprint (sequence of commands) and executes them
+// through the relay one at a time. Each command can reference
+// results from previous commands via $ref tokens.
+//
+// Example: create a frame, then create text inside it.
+// The text command references the frame's ID via $ref.
+//
+// { type: 'create_frame', name: 'Hero', ... }          → returns { id: '5:2' }
+// { type: 'create_text', parentId: '$0.id', text: ... } → parentId resolved to '5:2'
+
+/**
+ * Execute a sequence of Figma commands through the relay.
+ * Supports $ref tokens: '$N.field' references result N's field.
+ *
+ * @param {Object} relay - The WebSocket relay instance
+ * @param {Array} commands - Array of { type, data } command objects
+ * @param {Function} onProgress - Optional callback(stepIndex, totalSteps, result)
+ * @returns {Promise<{ results: Array, errors: Array, success: boolean }>}
+ */
+export async function executeSequence(relay, commands, onProgress) {
+  var results = [];
+  var errors = [];
+
+  for (var i = 0; i < commands.length; i++) {
+    var cmd = commands[i];
+    var resolvedData = resolveRefs(cmd.data || {}, results);
+
+    try {
+      var result = await relay.sendToPlugin(cmd.type, resolvedData, 10000);
+
+      if (result && result.error) {
+        errors.push({ step: i, command: cmd.type, error: result.error });
+        results.push(result);
+        // Don't stop on error — skip and continue
+        process.stderr.write('CONDUCTOR orchestrator: step ' + i + ' (' + cmd.type + ') error: ' + result.error + '\n');
+      } else {
+        results.push(result || {});
+        if (onProgress) onProgress(i, commands.length, result);
+        process.stderr.write('CONDUCTOR orchestrator: step ' + (i + 1) + '/' + commands.length + ' ' + cmd.type + ' -> ' + (result && (result.id || result.name) || 'ok') + '\n');
+      }
+    } catch (err) {
+      errors.push({ step: i, command: cmd.type, error: String(err) });
+      results.push({ error: String(err) });
+      process.stderr.write('CONDUCTOR orchestrator: step ' + i + ' (' + cmd.type + ') threw: ' + String(err) + '\n');
+    }
+
+    // Small delay between commands to let Figma process
+    await sleep(50);
+  }
+
+  return {
+    results: results,
+    errors: errors,
+    success: errors.length === 0,
+    totalSteps: commands.length,
+    completedSteps: commands.length - errors.length,
+  };
+}
+
+/**
+ * Resolve $ref tokens in command data.
+ * '$0.id' → results[0].id
+ * '$parent' → results[results.length-1].id (last result's id)
+ * '$2.name' → results[2].name
+ */
+function resolveRefs(data, results) {
+  if (typeof data === 'string') {
+    // Check for $ref pattern
+    return data.replace(/\$(\d+)\.(\w+)/g, function(match, idx, field) {
+      var r = results[parseInt(idx)];
+      return (r && r[field] !== undefined) ? r[field] : match;
+    }).replace(/\$parent/g, function() {
+      var last = results[results.length - 1];
+      return (last && last.id) ? last.id : '';
+    });
+  }
+
+  if (Array.isArray(data)) {
+    return data.map(function(item) { return resolveRefs(item, results); });
+  }
+
+  if (data && typeof data === 'object') {
+    var resolved = {};
+    for (var key in data) {
+      if (data.hasOwnProperty(key)) {
+        resolved[key] = resolveRefs(data[key], results);
+      }
+    }
+    return resolved;
+  }
+
+  return data;
+}
+
+function sleep(ms) {
+  return new Promise(function(resolve) { setTimeout(resolve, ms); });
+}

package/src/relay.js

@@ -0,0 +1,174 @@
+// ═══════════════════════════════════════════
+// CONDUCTOR — WebSocket Relay
+// ═══════════════════════════════════════════
+// Bridges MCP stdio (from Cursor) to WebSocket (to Figma plugin).
+//
+// Flow:
+//   Cursor → MCP stdio → CONDUCTOR → design logic (local)
+//                                   → figma commands (WebSocket) → Plugin → Figma API
+//                                   ← results ← WebSocket ←
+//         ← MCP stdio ← CONDUCTOR ←
+
+import { createServer } from 'node:http';
+
+// Tools that need Figma (sent over WebSocket to plugin)
+const FIGMA_COMMANDS = new Set([
+  // Create
+  'create_frame', 'create_text', 'create_rect', 'create_section', 'create_component',
+  // Layout
+  'set_auto_layout', 'set_constraints', 'apply_grid', 'align_nodes',
+  // Style
+  'set_fills', 'set_strokes', 'set_effects', 'set_corner_radius', 'set_opacity',
+  // Typography
+  'set_text_props', 'load_font',
+  // Read
+  'get_selection', 'get_page_info', 'get_styles', 'get_components',
+  'read_node', 'read_tree', 'read_spacing', 'read_colors', 'read_typography',
+  // Edit
+  'rename_node', 'move_node', 'resize_node', 'delete_node',
+  'clone_node', 'group_nodes', 'ungroup_node', 'reorder_node',
+  // Export
+  'export_png', 'export_svg',
+  // Viewport
+  'zoom_to', 'scroll_to',
+  // Meta
+  'ping',
+]);
+
+export class Relay {
+  constructor(port) {
+    this.port = port || 9800;
+    this.pluginSocket = null;
+    this.pendingCallbacks = new Map();
+    this.cmdId = 0;
+    this.server = null;
+    this.wss = null;
+  }
+
+  async start() {
+    // Dynamic import ws (may not be installed — we bundle our own minimal WS)
+    let WebSocketServer;
+    try {
+      const ws = await import('ws');
+      WebSocketServer = ws.WebSocketServer || ws.default.WebSocketServer;
+    } catch (e) {
+      process.stderr.write('CONDUCTOR relay: "ws" package not found. Install with: npm install ws\n');
+      process.stderr.write('Falling back to MCP-only mode (no Figma bridge).\n');
+      return false;
+    }
+
+    this.server = createServer();
+    this.wss = new WebSocketServer({ server: this.server });
+
+    this.wss.on('connection', (socket) => {
+      this.pluginSocket = socket;
+      process.stderr.write('CONDUCTOR relay: Figma plugin connected\n');
+
+      socket.on('message', (data) => {
+        try {
+          const msg = JSON.parse(data.toString());
+          this.handlePluginMessage(msg);
+        } catch (e) {
+          // ignore
+        }
+      });
+
+      socket.on('close', () => {
+        this.pluginSocket = null;
+        process.stderr.write('CONDUCTOR relay: Figma plugin disconnected\n');
+      });
+
+      socket.on('error', () => {
+        this.pluginSocket = null;
+      });
+    });
+
+    return new Promise((resolve) => {
+      this.server.listen(this.port, () => {
+        process.stderr.write(`CONDUCTOR relay: WebSocket listening on ws://localhost:${this.port}\n`);
+        resolve(true);
+      });
+    });
+  }
+
+  handlePluginMessage(msg) {
+    if (msg.type === 'plugin_ready') {
+      process.stderr.write(`CONDUCTOR relay: Plugin ready (v${msg.version || '?'})\n`);
+      return;
+    }
+
+    if (msg.type === 'result' && msg.id !== undefined) {
+      const callback = this.pendingCallbacks.get(msg.id);
+      if (callback) {
+        this.pendingCallbacks.delete(msg.id);
+        callback(msg.data || {});
+      }
+      return;
+    }
+  }
+
+  isConnected() {
+    return this.pluginSocket !== null && this.pluginSocket.readyState === 1; // WebSocket.OPEN
+  }
+
+  /**
+   * Send a command to the Figma plugin and wait for result.
+   * Returns a Promise that resolves with the plugin's response.
+   */
+  sendToPlugin(commandType, commandData, timeout) {
+    timeout = timeout || 15000;
+
+    return new Promise((resolve, reject) => {
+      if (!this.isConnected()) {
+        resolve({ error: 'Figma plugin not connected. Open the CONDUCTOR plugin in Figma and click Connect.' });
+        return;
+      }
+
+      var id = ++this.cmdId;
+      var timer = setTimeout(function() {
+        this.pendingCallbacks.delete(id);
+        resolve({ error: 'Timeout waiting for Figma plugin response' });
+      }.bind(this), timeout);
+
+      this.pendingCallbacks.set(id, function(result) {
+        clearTimeout(timer);
+        resolve(result);
+      });
+
+      this.pluginSocket.send(JSON.stringify({
+        type: 'command',
+        id: id,
+        command: { type: commandType, data: commandData || {} },
+      }));
+    });
+  }
+
+  /**
+   * Check if a tool name maps to a Figma command.
+   */
+  isFigmaCommand(toolName) {
+    return FIGMA_COMMANDS.has(toolName);
+  }
+
+  /**
+   * Map a high-level tool call to one or more Figma commands.
+   * Some tools (like create_page) produce multiple Figma commands.
+   * Some tools (like color_palette) are pure design logic — no Figma needed.
+   */
+  getFigmaCommand(toolName, toolArgs) {
+    // Direct mappings — tool name IS the Figma command
+    if (FIGMA_COMMANDS.has(toolName)) {
+      return { command: toolName, data: toolArgs };
+    }
+
+    // Tools that generate Figma commands from design logic output
+    // The handler produces a JSON response with an "action" field
+    // that maps to a Figma command
+    return null;
+  }
+
+  stop() {
+    if (this.wss) this.wss.close();
+    if (this.server) this.server.close();
+  }
+}

package/src/server.js

@@ -1,115 +1,204 @@
 // ═══════════════════════════════════════════
-// CONDUCTOR — MCP Server
+// CONDUCTOR — MCP Server + Orchestrator
 // ═══════════════════════════════════════════
-// Model Context Protocol server over stdio.
-// Registers 61 design-intelligent tools for AI editors.
+// When create_page or create_section is called:
+//   1. Generates a blueprint (30-50 sequential commands)
+//   2. Executes each one through the relay to the Figma plugin
+//   3. Each command references results from previous commands ($ref)
+//   4. Returns a summary of everything created
 
 import { TOOLS } from './tools/registry.js';
 import { handleTool } from './tools/handlers.js';
+import { Relay } from './relay.js';
+import { getBlueprint } from './blueprints.js';
+import { executeSequence } from './orchestrator.js';
 
-const SERVER_INFO = {
-  name: 'conductor-figma',
-  version: '0.1.0',
-};
+var SERVER_INFO = { name: 'conductor-figma', version: '0.3.0' };
+var CAPABILITIES = { tools: {} };
+var relay = null;
 
-const CAPABILITIES = {
-  tools: {},
-};
+// Tools that trigger blueprint orchestration (multi-command sequences)
+var BLUEPRINT_TOOLS = new Set(['create_page', 'create_section']);
 
-/**
- * Start the MCP server on stdio.
- * Reads JSON-RPC messages from stdin, writes responses to stdout.
- */
-export function startServer() {
-  let buffer = '';
+export async function startServer(options) {
+  options = options || {};
+  var port = options.port || 9800;
+
+  relay = new Relay(port);
+  var relayStarted = await relay.start();
+
+  if (relayStarted) {
+    process.stderr.write('CONDUCTOR v0.3.0: MCP + orchestrator ready (' + TOOLS.length + ' tools, ws://localhost:' + port + ')\n');
+  } else {
+    process.stderr.write('CONDUCTOR v0.3.0: MCP ready (' + TOOLS.length + ' tools, no relay — install ws)\n');
+  }
+
+  var buffer = '';
 
   process.stdin.setEncoding('utf-8');
-  process.stdin.on('data', (chunk) => {
+  process.stdin.on('data', function(chunk) {
     buffer += chunk;
-
-    // Process complete lines
-    const lines = buffer.split('\n');
+    var lines = buffer.split('\n');
     buffer = lines.pop() || '';
 
-    for (const line of lines) {
-      const trimmed = line.trim();
+    for (var i = 0; i < lines.length; i++) {
+      var trimmed = lines[i].trim();
       if (!trimmed) continue;
-
       try {
-        const message = JSON.parse(trimmed);
-        handleMessage(message);
+        handleMessage(JSON.parse(trimmed));
       } catch (err) {
         sendError(null, -32700, 'Parse error');
       }
     }
   });
 
-  process.stdin.on('end', () => {
+  process.stdin.on('end', function() {
+    if (relay) relay.stop();
     process.exit(0);
   });
-
-  // Log startup to stderr (not stdout — that's for MCP protocol)
-  process.stderr.write(`CONDUCTOR MCP server started (${TOOLS.length} tools)\n`);
 }
 
-function handleMessage(msg) {
-  // JSON-RPC 2.0
-  const { id, method, params } = msg;
+async function handleMessage(msg) {
+  var id = msg.id;
+  var method = msg.method;
+  var params = msg.params || {};
 
   switch (method) {
     case 'initialize':
-      sendResult(id, {
-        protocolVersion: '2024-11-05',
-        serverInfo: SERVER_INFO,
-        capabilities: CAPABILITIES,
-      });
+      sendResult(id, { protocolVersion: '2024-11-05', serverInfo: SERVER_INFO, capabilities: CAPABILITIES });
       break;
 
     case 'initialized':
-      // Notification, no response needed
       break;
 
     case 'tools/list':
       sendResult(id, {
-        tools: TOOLS.map(t => ({
-          name: t.name,
-          description: t.description,
-          inputSchema: t.inputSchema,
-        })),
+        tools: TOOLS.map(function(t) { return { name: t.name, description: t.description, inputSchema: t.inputSchema }; }),
       });
       break;
 
-    case 'tools/call': {
-      const toolName = params?.name;
-      const toolArgs = params?.arguments || {};
-
-      if (!toolName) {
-        sendError(id, -32602, 'Missing tool name');
-        return;
-      }
-
-      const result = handleTool(toolName, toolArgs, null);
-      sendResult(id, result);
+    case 'tools/call':
+      var toolName = params.name;
+      var toolArgs = params.arguments || {};
+      if (!toolName) { sendError(id, -32602, 'Missing tool name'); return; }
+      await handleToolCall(id, toolName, toolArgs);
       break;
-    }
 
     case 'ping':
       sendResult(id, {});
       break;
 
     default:
-      if (id !== undefined) {
-        sendError(id, -32601, `Method not found: ${method}`);
+      if (id !== undefined) sendError(id, -32601, 'Method not found: ' + method);
+  }
+}
+
+async function handleToolCall(id, toolName, toolArgs) {
+
+  // ═══ ORCHESTRATED BLUEPRINTS ═══
+  // create_page and create_section generate 20-50 commands and execute them all
+  if (BLUEPRINT_TOOLS.has(toolName) && relay && relay.isConnected()) {
+    var blueprint = getBlueprint(toolName, toolArgs);
+
+    if (blueprint && blueprint.commands && blueprint.commands.length > 0) {
+      process.stderr.write('CONDUCTOR orchestrator: ' + toolName + ' -> ' + blueprint.commands.length + ' commands\n');
+      process.stderr.write('CONDUCTOR orchestrator: ' + blueprint.description + '\n');
+
+      var outcome = await executeSequence(relay, blueprint.commands);
+
+      var summary = {
+        tool: toolName,
+        description: blueprint.description,
+        totalCommands: outcome.totalSteps,
+        completed: outcome.completedSteps,
+        errors: outcome.errors.length,
+        success: outcome.success,
+        createdNodes: [],
+      };
+
+      // Collect all created node IDs and names
+      for (var r = 0; r < outcome.results.length; r++) {
+        var res = outcome.results[r];
+        if (res && res.id) {
+          summary.createdNodes.push({ id: res.id, name: res.name || '', type: res.type || '' });
+        }
       }
+
+      if (outcome.errors.length > 0) {
+        summary.errorDetails = outcome.errors;
+      }
+
+      sendResult(id, { content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }] });
+      return;
+    }
   }
+
+  // ═══ DIRECT FIGMA COMMANDS ═══
+  // Single commands forwarded directly to plugin
+  if (relay && relay.isFigmaCommand(toolName) && relay.isConnected()) {
+    process.stderr.write('CONDUCTOR: -> Figma: ' + toolName + '\n');
+    try {
+      var figmaResult = await relay.sendToPlugin(toolName, toolArgs);
+      process.stderr.write('CONDUCTOR: <- Figma: ' + (figmaResult.name || figmaResult.id || 'ok') + '\n');
+      sendResult(id, { content: [{ type: 'text', text: JSON.stringify(figmaResult, null, 2) }] });
+    } catch (err) {
+      sendResult(id, { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }] });
+    }
+    return;
+  }
+
+  // ═══ DESIGN INTELLIGENCE (local) ═══
+  var result = handleTool(toolName, toolArgs, null);
+
+  // Check if handler produced a Figma action to forward
+  if (relay && relay.isConnected()) {
+    try {
+      var data = JSON.parse(result.content[0].text);
+      if (data.action && relay.isFigmaCommand(data.action)) {
+        process.stderr.write('CONDUCTOR: -> Figma (via ' + toolName + '): ' + data.action + '\n');
+        var fResult = await relay.sendToPlugin(data.action, data);
+        process.stderr.write('CONDUCTOR: <- Figma: ' + (fResult.name || fResult.id || 'ok') + '\n');
+        data._figmaResult = fResult;
+        sendResult(id, { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
+        return;
+      }
+    } catch (e) { /* not JSON or no action */ }
+  }
+
+  // Blueprint tool but plugin not connected — return the blueprint spec
+  if (BLUEPRINT_TOOLS.has(toolName)) {
+    var bp = getBlueprint(toolName, toolArgs);
+    if (bp) {
+      var spec = {
+        tool: toolName,
+        description: bp.description,
+        commandCount: bp.commands.length,
+        _note: relay && !relay.isConnected()
+          ? 'Figma plugin not connected. Connect the CONDUCTOR plugin to execute these ' + bp.commands.length + ' commands on canvas.'
+          : 'WebSocket relay not available. Install ws package for Figma bridge.',
+        commands: bp.commands.map(function(c, i) { return { step: i, type: c.type, name: c.data.name || c.data.text || '' }; }),
+      };
+      sendResult(id, { content: [{ type: 'text', text: JSON.stringify(spec, null, 2) }] });
+      return;
+    }
+  }
+
+  // Figma command but not connected — add note
+  if (relay && relay.isFigmaCommand(toolName) && !relay.isConnected()) {
+    try {
+      var parsed = JSON.parse(result.content[0].text);
+      parsed._note = 'Figma plugin not connected. Connect the CONDUCTOR plugin in Figma to execute on canvas.';
+      result = { content: [{ type: 'text', text: JSON.stringify(parsed, null, 2) }] };
+    } catch (e) { /* ignore */ }
+  }
+
+  sendResult(id, result);
 }
 
 function sendResult(id, result) {
-  const response = { jsonrpc: '2.0', id, result };
-  process.stdout.write(JSON.stringify(response) + '\n');
+  process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: id, result: result }) + '\n');
 }
 
 function sendError(id, code, message) {
-  const response = { jsonrpc: '2.0', id, error: { code, message } };
-  process.stdout.write(JSON.stringify(response) + '\n');
+  process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: id, error: { code: code, message: message } }) + '\n');
 }