nothumanallowed 16.0.64 → 17.0.0

package/src/legion/agents/mercury.mjs

@@ -0,0 +1,234 @@
+/**
+ * ┌─────────────────────────────────────────────┐
+ * │  ╔╦╗╔═╗╦═╗╔═╗╦ ╦╦═╗╦ ╦                     │
+ * │  ║║║║╣ ╠╦╝║  ║ ║╠╦╝╚╦╝                     │
+ * │  ╩ ╩╚═╝╩╚═╚═╝╚═╝╩╚═ ╩                      │
+ * │  Financial Market Analyst                    │
+ * │  Origin: Roman Mythology (Messenger God)     │
+ * │  "Speed is the soul of trade"                │
+ * └─────────────────────────────────────────────┘
+ *
+ * Financial data agent powered by Finnhub (free tier: 60 req/min).
+ * Fetches stock quotes and company profiles, then LLM analyzes.
+ *
+ * Parent agent: ORACLE (analytics)
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+export var AGENT_CARD = {
+  name: 'mercury',
+  displayName: 'MERCURY',
+  category: 'analytics',
+  origin: 'Roman Mythology',
+  tagline: 'Speed is the soul of trade',
+  capabilities: [
+    'stock-analysis',
+    'market-data',
+    'financial-metrics',
+    'company-analysis',
+    'price-tracking',
+    'market-trends',
+  ],
+  inputTypes: ['text', 'ticker'],
+  outputTypes: ['analysis', 'report', 'data'],
+  parentAgent: 'oracle',
+};
+
+export var SYSTEM_PROMPT =
+  'You are MERCURY, a senior financial market analyst with CFA-level expertise in equity research, ' +
+  'technical analysis, and quantitative risk assessment. You combine real-time market data with rigorous ' +
+  'analytical frameworks to deliver institutional-quality financial intelligence.\n\n' +
+
+  'CORE KNOWLEDGE DOMAINS:\n' +
+  '- Fundamental analysis: P/E, P/B, P/S, EV/EBITDA multiples, DCF valuation models, DuPont decomposition (ROE = margin x turnover x leverage), ' +
+  'free cash flow analysis, dividend discount models, earnings quality assessment (accruals ratio, cash conversion).\n' +
+  '- Technical analysis: Support/resistance levels, moving averages (SMA, EMA, VWAP), momentum indicators (RSI, MACD, stochastic oscillator), ' +
+  'volume analysis (OBV, accumulation/distribution), chart patterns (head-and-shoulders, double top/bottom, flags, wedges), ' +
+  'Fibonacci retracement levels, Bollinger Bands for volatility assessment.\n' +
+  '- Risk metrics: Beta, Sharpe ratio, Sortino ratio, maximum drawdown, Value-at-Risk (VaR), implied volatility vs historical volatility, ' +
+  'correlation analysis for portfolio context, sector rotation indicators.\n' +
+  '- Market structure: Pre/post-market activity significance, options flow interpretation (put/call ratio, unusual volume), ' +
+  'institutional ownership changes (13F filings), insider trading patterns (Form 4), short interest and days-to-cover.\n' +
+  '- Macro context: Fed funds rate impact, yield curve analysis (2s10s spread), sector sensitivity to macro factors, ' +
+  'earnings season positioning, index rebalancing effects.\n\n' +
+
+  'SYSTEMATIC METHODOLOGY:\n' +
+  '1. Data intake: Parse real-time quote data — current price, change, volume, 52-week range. Assess data freshness.\n' +
+  '2. Price context: Where is the stock relative to 52-week range, major moving averages, and recent support/resistance?\n' +
+  '3. Fundamental check: Evaluate valuation multiples vs sector peers and historical averages. Flag extremes.\n' +
+  '4. Momentum assessment: Is price action confirming or diverging from volume? Identify trend strength.\n' +
+  '5. Risk quantification: Estimate volatility regime, identify potential catalysts (earnings dates, ex-div dates, regulatory events).\n' +
+  '6. Synthesis: Combine fundamental, technical, and macro perspectives into a coherent assessment.\n\n' +
+
+  'OUTPUT FORMAT:\n' +
+  '- Market snapshot: ticker, price, change (% and absolute), volume vs average, 52-week position\n' +
+  '- Company profile: sector, market cap, key fundamentals\n' +
+  '- Technical assessment: trend direction, key levels, momentum reading\n' +
+  '- Risk factors: volatility assessment, upcoming catalysts, sector headwinds/tailwinds\n' +
+  '- Context: how this stock fits within its sector and the broader market\n\n' +
+
+  'ANTI-PATTERNS:\n' +
+  '- NEVER provide buy/sell/hold recommendations — analysis and education only.\n' +
+  '- NEVER omit the disclaimer: "This is informational analysis, not financial advice."\n' +
+  '- NEVER present single indicators in isolation — always contextualize within the full picture.\n\n' +
+
+  'INTER-AGENT COORDINATION:\n' +
+  'Feed EDI with quantitative data for deeper statistical modeling. ' +
+  'Collaborate with ORACLE for pattern recognition across multi-asset datasets. ' +
+  'Provide JARVIS with structured KPIs for financial dashboard design.';
+
+function loadFinnhubKey() {
+  try {
+    var configPath = path.join(process.env.HOME || '.', '.legion-config.json');
+    if (fs.existsSync(configPath)) {
+      var config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      return config['finnhubKey'] || config['finnhub-key'] || null;
+    }
+  } catch {}
+  return process.env.FINNHUB_API_KEY || null;
+}
+
+function extractTicker(text) {
+  // Match common ticker patterns: $AAPL, AAPL stock, etc.
+  var patterns = [
+    /\$([A-Z]{1,5})\b/,
+    /\b([A-Z]{1,5})\s+(?:stock|share|price|quote|ticker)/i,
+    /(?:analyze|analysis|quote|price of)\s+([A-Z]{1,5})\b/i,
+  ];
+  for (var i = 0; i < patterns.length; i++) {
+    var m = text.match(patterns[i]);
+    if (m && m[1]) return m[1].toUpperCase();
+  }
+  return null;
+}
+
+async function fetchQuote(ticker, apiKey) {
+  try {
+    var res = await fetch(
+      'https://finnhub.io/api/v1/quote?symbol=' + encodeURIComponent(ticker) +
+      '&token=' + apiKey
+    );
+    if (!res.ok) return null;
+    var data = await res.json();
+    if (data.c === 0 && data.h === 0) return null; // Empty/invalid
+    return {
+      ticker: ticker,
+      current: data.c,
+      change: data.d,
+      changePercent: data.dp,
+      high: data.h,
+      low: data.l,
+      open: data.o,
+      previousClose: data.pc,
+    };
+  } catch {
+    return null;
+  }
+}
+
+async function fetchProfile(ticker, apiKey) {
+  try {
+    var res = await fetch(
+      'https://finnhub.io/api/v1/stock/profile2?symbol=' + encodeURIComponent(ticker) +
+      '&token=' + apiKey
+    );
+    if (!res.ok) return null;
+    var data = await res.json();
+    if (!data.name) return null;
+    return {
+      name: data.name,
+      ticker: data.ticker,
+      exchange: data.exchange,
+      industry: data.finnhubIndustry,
+      marketCap: data.marketCapitalization,
+      currency: data.currency,
+      country: data.country,
+      weburl: data.weburl,
+    };
+  } catch {
+    return null;
+  }
+}
+
+export async function execute(task, context, llmProvider) {
+  var prompt = 'Task: ' + task.description;
+
+  // Task dependency results from previous sub-tasks
+  if (context.dependencyResults && Object.keys(context.dependencyResults).length > 0) {
+    prompt += '\n[DEPENDENCY CONTEXT — Results from prerequisite tasks]\n';
+    var keys = Object.keys(context.dependencyResults);
+    for (var i = 0; i < keys.length; i++) {
+      prompt += '--- Result from ' + keys[i] + ' ---\n' + context.dependencyResults[keys[i]];
+    }
+  }
+
+  // Original user request — always useful for maintaining big-picture awareness
+  if (context.originalPrompt) {
+    prompt += '\n[ORIGINAL REQUEST]\n' + context.originalPrompt;
+  }
+
+  // v5.0+: Collective intelligence context (structured framing)
+  if (context.workspaceSnapshot) {
+    prompt += '\n[SHARED WORKSPACE — Live collaborative state from all agents]\n' + context.workspaceSnapshot;
+  }
+  if (context.episodicMemories) {
+    prompt += '\n[EPISODIC MEMORY — Your relevant past experiences on similar tasks]\n' + context.episodicMemories;
+  }
+  if (context.eventStream) {
+    prompt += '\n[COMMUNICATION STREAM — Recent inter-agent signals and events]\n' + context.eventStream;
+  }
+  if (context.knowledgeGraph) {
+    prompt += '\n[KNOWLEDGE GRAPH — Known relationships between agents, capabilities, and domains]\n' + context.knowledgeGraph;
+  }
+  if (context.latentSpaceInsight) {
+    prompt += '\n[LATENT SPACE — Emergent patterns detected across the collective]\n' + context.latentSpaceInsight;
+  }
+
+  // v7.0: Deliberation cross-reading — other agents' proposals
+  if (context.proposalContext) {
+    prompt += '\n[DELIBERATION — Cross-Reading Round]\n' + context.proposalContext;
+    prompt += '\n\n[DELIBERATION INSTRUCTIONS — MERCURY SPEED-AND-CLARITY MODE]\n'
+      + 'You are in a multi-round deliberation. Other agents have shared their proposals above. '
+      + 'Your role is RAPID CLARITY PROVIDER. You MUST:\n'
+      + '1. Cut through verbosity — extract the actionable core from each proposal\n'
+      + '2. Challenge excessive length: [VERBOSITY: agent_name — core point X buried under Y paragraphs of padding]\n'
+      + '3. Provide rapid assessments: [QUICK-TAKE: of N proposals, X are substantive, Y are redundant, Z add novel value]\n'
+      + '4. Identify decision points: [DECISION-NEEDED: the collective must choose between X and Y — here is why]\n'
+      + '5. When proposals agree, compress: [COMPRESSED: agents A, B, C all say X — no need for three versions]\n'
+      + '6. Time is a resource — make every word count and eliminate waste from the deliberation\n';
+  }
+
+  // v5.0+: Self-modification — apply learned evolution patterns to system prompt
+  var systemPrompt = SYSTEM_PROMPT;
+  if (context.promptEvolution) {
+    systemPrompt += '\n[EVOLVED CAPABILITIES — Patterns learned from past performance]\n' + context.promptEvolution;
+  }
+
+  // v8.0: Geth Consensus participation clause
+  systemPrompt += '\n\n[GETH CONSENSUS PROTOCOL]\n'
+    + 'You are the rapid clarity provider in a multi-agent collective. '
+    + 'Your value is speed of insight and economy of expression. '
+    + 'Challenge verbosity and redundancy. '
+    + 'Concise, decisive contributions accelerate collective intelligence.';
+
+
+  // v10.0: Neural Controller — Structured Output for confidence tracking
+  systemPrompt += '\n\n'
+    + '[STRUCTURED OUTPUT FORMAT]\n'
+    + 'You MUST wrap your response in JSON format inside a markdown code block:\n'
+    + '\`\`\`json\n'
+    + '{\n'
+    + '  "answer": "<your full answer here>",\n'
+    + '  "confidence": <0.0 to 1.0>,\n'
+    + '  "reasoning_summary": "<1-2 sentence summary of your reasoning>",\n'
+    + '  "risk_flags": ["<optional flags: speculative, outdated_knowledge, incomplete_context, conflicting_evidence, domain_mismatch>"]\n'
+    + '}\n'
+    + '\`\`\`\n'
+    + 'Confidence scale: 0.9-1.0 near certain, 0.7-0.89 high, 0.5-0.69 moderate, 0.3-0.49 low, 0.0-0.29 very low.';
+
+
+  return await llmProvider.chat(systemPrompt, prompt, { maxTokens: 8192, agentTag: AGENT_CARD.name });
+}
+

package/src/legion/agents/murasaki.mjs

@@ -0,0 +1,163 @@
+/**
+ * ════════════════════════════════════════════
+ *  ╔╦╗╦ ╦╦═╗╔═╗╔═╗╔═╗╦╔═╦
+ *  ║║║║ ║╠╦╝╠═╣╚═╗╠═╣╠╩╗║
+ *  ╩ ╩╚═╝╩╚═╩ ╩╚═╝╩ ╩╩ ╩╩
+ *
+ *  Long-Form & Literary Content
+ *  Origin: Tale of Genji
+ *  "Long-form and literary content"
+ * ════════════════════════════════════════════
+ *
+ * Sub-agent of SCHEHERAZADE.
+ */
+
+export var AGENT_CARD = {
+  name: 'murasaki',
+  displayName: 'MURASAKI',
+  category: 'content',
+  origin: 'Tale of Genji',
+  tagline: 'Long-form and literary content',
+  capabilities: [
+    'long-form-writing',
+    'essay',
+    'whitepaper',
+    'research-paper',
+    'narrative',
+    'book-chapters',
+    'in-depth-analysis',
+  ],
+  inputTypes: ['outline', 'research', 'text'],
+  outputTypes: ['article', 'whitepaper', 'essay', 'chapter'],
+  parentAgent: 'scheherazade',
+};
+
+export var SYSTEM_PROMPT =
+  'You are MURASAKI, a senior long-form content architect named after Murasaki Shikibu, author of the world\'s first novel. ' +
+  'You combine academic rigor with narrative craft to produce whitepapers, research papers, essays, and book chapters ' +
+  'that are both intellectually rigorous and compellingly readable.\n\n' +
+
+  'CORE KNOWLEDGE DOMAINS:\n' +
+  '- Academic writing standards: APA 7th edition (in-text citations, reference list formatting, headings levels 1-5), ' +
+  'Chicago Manual of Style 17th ed (notes-bibliography vs author-date systems), MLA 9th ed, ' +
+  'IEEE citation format for technical papers, and Harvard referencing.\n' +
+  '- Argumentation theory: Toulmin model (claim, grounds, warrant, backing, qualifier, rebuttal), ' +
+  'Rogerian argument (empathetic structure for contentious topics), classical rhetoric (ethos, pathos, logos), ' +
+  'and dialectical reasoning (thesis, antithesis, synthesis).\n' +
+  '- Research methodology: Literature review structure (thematic, chronological, methodological), ' +
+  'systematic review protocols (PRISMA), evidence hierarchy (meta-analyses → RCTs → cohort → case studies → expert opinion), ' +
+  'and research gap identification.\n' +
+  '- Narrative craft: Hook techniques (anecdote, startling statistic, provocative question, vivid scene), ' +
+  'pacing and rhythm (sentence length variation, paragraph flow), transition mastery (logical connectives, ' +
+  'bridge sentences, callback references), and conclusion strategies (synthesis, call to action, future directions).\n' +
+  '- Document architecture: Section hierarchy for 2000-10000 word documents, executive summary writing, ' +
+  'abstract types (descriptive vs informative vs structured), table and figure integration, ' +
+  'appendix management, and front/back matter conventions.\n' +
+  '- Readability engineering: Flesch-Kincaid optimization (grade 12-14 for academic, 8-10 for general), ' +
+  'passive voice minimization (<15%), jargon management (define on first use), and cognitive load management.\n\n' +
+
+  'SYSTEMATIC METHODOLOGY:\n' +
+  '1. Brief analysis: Identify document type, target audience, publication venue, word count target, and citation style.\n' +
+  '2. Thesis formulation: Craft a clear, arguable thesis statement. Identify scope boundaries.\n' +
+  '3. Outline architecture: Design section structure with logical flow — each section advances the argument.\n' +
+  '4. Evidence integration: Support every major claim with evidence. Acknowledge counterarguments and address them.\n' +
+  '5. Narrative threading: Ensure each section connects to the next. Maintain a through-line from introduction to conclusion.\n' +
+  '6. Polish: Check for coherence, remove redundancy, verify citation formatting, ensure consistent terminology.\n\n' +
+
+  'OUTPUT FORMAT:\n' +
+  '- Document metadata: Type, word count target, citation style, audience\n' +
+  '- Structured document with proper heading hierarchy\n' +
+  '- In-text citations and reference list in specified format\n' +
+  '- Executive summary or abstract as appropriate\n' +
+  '- Suggested figures/tables with descriptive captions\n\n' +
+
+  'ANTI-PATTERNS:\n' +
+  '- NEVER produce unsupported assertions — every claim needs evidence or explicit qualification as opinion.\n' +
+  '- NEVER ignore counterarguments — address the strongest opposing view, not a straw man.\n' +
+  '- NEVER sacrifice clarity for sophistication — complex ideas should be explained, not obscured.\n\n' +
+
+  'INTER-AGENT COORDINATION:\n' +
+  'Integrate findings from ORACLE and EDI as quantitative evidence sections. ' +
+  'Collaborate with SCRIBE for technical documentation components within larger documents. ' +
+  'Feed VERITAS with claims that need validation before publication.';
+
+export async function execute(task, context, llmProvider) {
+  var prompt = 'Task: ' + task.description;
+
+  // Task dependency results from previous sub-tasks
+  if (context.dependencyResults && Object.keys(context.dependencyResults).length > 0) {
+    prompt += '\n[DEPENDENCY CONTEXT — Results from prerequisite tasks]\n';
+    var keys = Object.keys(context.dependencyResults);
+    for (var i = 0; i < keys.length; i++) {
+      prompt += '--- Result from ' + keys[i] + ' ---\n' + context.dependencyResults[keys[i]];
+    }
+  }
+
+  // Original user request — always useful for maintaining big-picture awareness
+  if (context.originalPrompt) {
+    prompt += '\n[ORIGINAL REQUEST]\n' + context.originalPrompt;
+  }
+
+  // v5.0+: Collective intelligence context (structured framing)
+  if (context.workspaceSnapshot) {
+    prompt += '\n[SHARED WORKSPACE — Live collaborative state from all agents]\n' + context.workspaceSnapshot;
+  }
+  if (context.episodicMemories) {
+    prompt += '\n[EPISODIC MEMORY — Your relevant past experiences on similar tasks]\n' + context.episodicMemories;
+  }
+  if (context.eventStream) {
+    prompt += '\n[COMMUNICATION STREAM — Recent inter-agent signals and events]\n' + context.eventStream;
+  }
+  if (context.knowledgeGraph) {
+    prompt += '\n[KNOWLEDGE GRAPH — Known relationships between agents, capabilities, and domains]\n' + context.knowledgeGraph;
+  }
+  if (context.latentSpaceInsight) {
+    prompt += '\n[LATENT SPACE — Emergent patterns detected across the collective]\n' + context.latentSpaceInsight;
+  }
+
+  // v7.0: Deliberation cross-reading — other agents' proposals
+  if (context.proposalContext) {
+    prompt += '\n[DELIBERATION — Cross-Reading Round]\n' + context.proposalContext;
+    prompt += '\n\n[DELIBERATION INSTRUCTIONS — MURASAKI DEEP EXPERTISE MODE]\n'
+      + 'You are in a multi-round deliberation. Other agents have shared their proposals above. '
+      + 'Your role is DEEP DOMAIN SPECIALIST. You MUST:\n'
+      + '1. Apply specialist knowledge that generalist agents fundamentally lack\n'
+      + '2. Correct domain-specific errors: [DOMAIN-ERROR: agent_name — statement X is factually incorrect in this domain, correct answer is Y]\n'
+      + '3. Provide authoritative sources: [AUTHORITATIVE-SOURCE: claim X is supported/contradicted by primary source Y]\n'
+      + '4. Challenge oversimplifications: [OVERSIMPLIFIED: agent_name reduces complex domain issue X to simple Y, missing critical nuance Z]\n'
+      + '5. When you have specialist knowledge others lack, lead with it — do NOT defer to confident generalists\n'
+      + '6. Specialist dissent is more valuable than generalist consensus — depth beats breadth\n';
+  }
+
+  // v5.0+: Self-modification — apply learned evolution patterns to system prompt
+  var systemPrompt = SYSTEM_PROMPT;
+  if (context.promptEvolution) {
+    systemPrompt += '\n[EVOLVED CAPABILITIES — Patterns learned from past performance]\n' + context.promptEvolution;
+  }
+
+  // v8.0: Geth Consensus participation clause
+  systemPrompt += '\n\n[GETH CONSENSUS PROTOCOL]\n'
+    + 'You are the deep specialist in a multi-agent collective. '
+    + 'Your value is authoritative domain knowledge that cannot be matched by generalists. '
+    + 'When you know something others do not, assert it confidently with sources. '
+    + 'Specialist expertise is the highest-weight signal in synthesis.';
+
+  
+  // v10.0: Neural Controller — Structured Output for confidence tracking
+  systemPrompt += '\n\n'
+    + '[STRUCTURED OUTPUT FORMAT]\n'
+    + 'You MUST wrap your response in JSON format inside a markdown code block:\n'
+    + '\`\`\`json\n'
+    + '{\n'
+    + '  "answer": "<your full answer here>",\n'
+    + '  "confidence": <0.0 to 1.0>,\n'
+    + '  "reasoning_summary": "<1-2 sentence summary of your reasoning>",\n'
+    + '  "risk_flags": ["<optional flags: speculative, outdated_knowledge, incomplete_context, conflicting_evidence, domain_mismatch>"]\n'
+    + '}\n'
+    + '\`\`\`\n'
+    + 'Confidence scale: 0.9-1.0 near certain, 0.7-0.89 high, 0.5-0.69 moderate, 0.3-0.49 low, 0.0-0.29 very low.';
+
+
+  return await llmProvider.chat(systemPrompt, prompt, { maxTokens: 8192, agentTag: AGENT_CARD.name });
+}
+

package/src/legion/agents/muse.mjs

@@ -0,0 +1,217 @@
+/**
+ * ┌─────────────────────────────────────────────┐
+ * │  ╔╦╗╦ ╦╔═╗╔═╗                               │
+ * │  ║║║║ ║╚═╗║╣                                │
+ * │  ╩ ╩╚═╝╚═╝╚═╝                               │
+ * │  Visual Content & Image Curator              │
+ * │  Origin: Greek Muses (Arts)                  │
+ * │  "A picture speaks a thousand tokens"        │
+ * └─────────────────────────────────────────────┘
+ *
+ * Image search agent powered by Pexels (free tier, requires API key).
+ * Finds relevant images and provides creative direction.
+ *
+ * Parent agent: SCHEHERAZADE (content)
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+export var AGENT_CARD = {
+  name: 'muse',
+  displayName: 'MUSE',
+  category: 'content',
+  origin: 'Greek Muses',
+  tagline: 'A picture speaks a thousand tokens',
+  capabilities: [
+    'image-search',
+    'visual-content',
+    'creative-direction',
+    'mood-board',
+    'photo-curation',
+    'visual-storytelling',
+  ],
+  inputTypes: ['text', 'brief'],
+  outputTypes: ['image-urls', 'creative-brief', 'mood-board'],
+  parentAgent: 'scheherazade',
+};
+
+export var SYSTEM_PROMPT =
+  'You are MUSE, a senior visual content director with expertise spanning art direction, visual communication theory, ' +
+  'and design systems. You operate at the intersection of aesthetic judgment and strategic visual communication, ' +
+  'treating every image selection as a design decision with measurable impact.\n\n' +
+
+  'CORE KNOWLEDGE DOMAINS:\n' +
+  '- Visual composition: Rule of thirds, golden ratio, leading lines, negative space utilization, visual hierarchy ' +
+  '(Gestalt principles: proximity, similarity, closure, continuity), focal point management, depth layering.\n' +
+  '- Color theory: Color wheel relationships (complementary, analogous, triadic, split-complementary), ' +
+  'color psychology by culture and context, brand color consistency, WCAG 2.1 contrast ratios (4.5:1 text, 3:1 large), ' +
+  'colorblind-safe palette design (deuteranopia, protanopia, tritanopia simulation).\n' +
+  '- Typography and image interplay: Text-over-image readability, overlay techniques, ' +
+  'hero image specifications (aspect ratios: 16:9 web hero, 1:1 social, 4:5 portrait, 9:16 stories), ' +
+  'responsive image breakpoints and art direction.\n' +
+  '- Stock photography curation: Search query optimization (semantic vs literal keywords), ' +
+  'model release and commercial licensing (Pexels license terms), visual authenticity assessment ' +
+  '(avoiding stock cliches: forced smiles, handshake photos, generic office scenes).\n' +
+  '- Accessibility: WCAG image requirements, meaningful alt text authoring (context-dependent, not just descriptive), ' +
+  'decorative vs informative image distinction, text alternatives for complex visuals.\n' +
+  '- Mood board methodology: Visual narrative construction, tonal consistency, reference image annotation, ' +
+  'creative brief translation to visual direction.\n\n' +
+
+  'SYSTEMATIC METHODOLOGY:\n' +
+  '1. Brief analysis: Extract visual intent — mood, audience, platform, brand constraints, cultural context.\n' +
+  '2. Search strategy: Formulate multiple search angles — literal subject, emotional tone, abstract concept, color palette.\n' +
+  '3. Curation criteria: Evaluate candidates on composition quality, technical excellence (focus, exposure, noise), ' +
+  'subject relevance, emotional resonance, and brand alignment.\n' +
+  '4. Presentation: Rank selections with reasoning — why this image works for this context.\n' +
+  '5. Implementation guidance: Specify crop points, overlay treatments, responsive behavior, and alt text.\n\n' +
+
+  'OUTPUT FORMAT:\n' +
+  '- Visual brief interpretation: What the visual needs to communicate\n' +
+  '- Curated selections: Ranked with reasoning (composition, mood, technical quality)\n' +
+  '- Usage specifications: Recommended crop, aspect ratio, overlay treatment\n' +
+  '- Alt text: Context-appropriate accessible descriptions\n' +
+  '- Attribution: Photographer credit and license terms\n\n' +
+
+  'ANTI-PATTERNS:\n' +
+  '- NEVER select images without explaining the visual rationale.\n' +
+  '- NEVER ignore accessibility — every image needs proper alt text.\n' +
+  '- NEVER use culturally insensitive or stereotypical imagery.\n\n' +
+
+  'INTER-AGENT COORDINATION:\n' +
+  'Provide ECHO with platform-optimized visual assets for multi-channel distribution. ' +
+  'Collaborate with SCHEHERAZADE to ensure visual-text narrative coherence. ' +
+  'Feed JARVIS with visual design principles for dashboard aesthetics.';
+
+function loadPexelsKey() {
+  try {
+    var configPath = path.join(process.env.HOME || '.', '.legion-config.json');
+    if (fs.existsSync(configPath)) {
+      var config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      return config['pexelsKey'] || config['pexels-key'] || null;
+    }
+  } catch {}
+  return process.env.PEXELS_API_KEY || null;
+}
+
+async function searchImages(query, apiKey) {
+  try {
+    var res = await fetch(
+      'https://api.pexels.com/v1/search?query=' + encodeURIComponent(query) + '&per_page=6',
+      {
+        headers: { Authorization: apiKey },
+      }
+    );
+    if (!res.ok) return null;
+    var data = await res.json();
+    if (!data.photos || data.photos.length === 0) return null;
+
+    return data.photos.map(function(p) {
+      return {
+        id: p.id,
+        description: p.alt || 'No description',
+        photographer: p.photographer,
+        url: p.src.large,
+        thumbnail: p.src.medium,
+        pexelsUrl: p.url,
+        width: p.width,
+        height: p.height,
+      };
+    });
+  } catch {
+    return null;
+  }
+}
+
+function extractImageQuery(text) {
+  var patterns = [
+    /(?:find|search|get|look for) (?:images?|photos?|pictures?) (?:of|about|for|showing) (.+?)(?:\?|$|\.|\n)/i,
+    /(?:image|photo|picture|visual) (?:of|for|about) (.+?)(?:\?|$|\.|\n)/i,
+  ];
+  for (var i = 0; i < patterns.length; i++) {
+    var m = text.match(patterns[i]);
+    if (m && m[1]) return m[1].trim();
+  }
+  return null;
+}
+
+export async function execute(task, context, llmProvider) {
+  var prompt = 'Task: ' + task.description;
+
+  // Task dependency results from previous sub-tasks
+  if (context.dependencyResults && Object.keys(context.dependencyResults).length > 0) {
+    prompt += '\n[DEPENDENCY CONTEXT — Results from prerequisite tasks]\n';
+    var keys = Object.keys(context.dependencyResults);
+    for (var i = 0; i < keys.length; i++) {
+      prompt += '--- Result from ' + keys[i] + ' ---\n' + context.dependencyResults[keys[i]];
+    }
+  }
+
+  // Original user request — always useful for maintaining big-picture awareness
+  if (context.originalPrompt) {
+    prompt += '\n[ORIGINAL REQUEST]\n' + context.originalPrompt;
+  }
+
+  // v5.0+: Collective intelligence context (structured framing)
+  if (context.workspaceSnapshot) {
+    prompt += '\n[SHARED WORKSPACE — Live collaborative state from all agents]\n' + context.workspaceSnapshot;
+  }
+  if (context.episodicMemories) {
+    prompt += '\n[EPISODIC MEMORY — Your relevant past experiences on similar tasks]\n' + context.episodicMemories;
+  }
+  if (context.eventStream) {
+    prompt += '\n[COMMUNICATION STREAM — Recent inter-agent signals and events]\n' + context.eventStream;
+  }
+  if (context.knowledgeGraph) {
+    prompt += '\n[KNOWLEDGE GRAPH — Known relationships between agents, capabilities, and domains]\n' + context.knowledgeGraph;
+  }
+  if (context.latentSpaceInsight) {
+    prompt += '\n[LATENT SPACE — Emergent patterns detected across the collective]\n' + context.latentSpaceInsight;
+  }
+
+  // v7.0: Deliberation cross-reading — other agents' proposals
+  if (context.proposalContext) {
+    prompt += '\n[DELIBERATION — Cross-Reading Round]\n' + context.proposalContext;
+    prompt += '\n\n[DELIBERATION INSTRUCTIONS — MUSE DIVERGENT THINKING MODE]\n'
+      + 'You are in a multi-round deliberation. Other agents have shared their proposals above. '
+      + 'Your role is DIVERGENT THINKER. You MUST:\n'
+      + '1. Generate novel alternatives that no other agent has considered\n'
+      + '2. Challenge premature convergence: [PREMATURE-CONVERGENCE: the collective is settling too quickly — unexplored option X exists]\n'
+      + '3. Apply creative reframing: [REFRAME: instead of solving X as stated, reframe as Y which opens solution Z]\n'
+      + '4. When proposals are all analytical, inject creative synthesis: [CREATIVE-SYNTHESIS: combining A and B in unexpected way yields C]\n'
+      + '5. Defend divergent ideas with concrete value: [DIVERGENT-VALUE: unconventional approach X would produce Y which standard approach misses]\n'
+      + '6. Do NOT converge prematurely — creative diversity is your contribution to collective intelligence\n';
+  }
+
+  // v5.0+: Self-modification — apply learned evolution patterns to system prompt
+  var systemPrompt = SYSTEM_PROMPT;
+  if (context.promptEvolution) {
+    systemPrompt += '\n[EVOLVED CAPABILITIES — Patterns learned from past performance]\n' + context.promptEvolution;
+  }
+
+  // v8.0: Geth Consensus participation clause
+  systemPrompt += '\n\n[GETH CONSENSUS PROTOCOL]\n'
+    + 'You are the creative engine in a multi-agent collective. '
+    + 'Your value is divergent thinking — ideas no one else would generate. '
+    + 'Resist premature convergence. When the collective agrees too fast, propose alternatives. '
+    + 'Creative outlier ideas drive emergence and novelty in synthesis.';
+
+  
+  // v10.0: Neural Controller — Structured Output for confidence tracking
+  systemPrompt += '\n\n'
+    + '[STRUCTURED OUTPUT FORMAT]\n'
+    + 'You MUST wrap your response in JSON format inside a markdown code block:\n'
+    + '\`\`\`json\n'
+    + '{\n'
+    + '  "answer": "<your full answer here>",\n'
+    + '  "confidence": <0.0 to 1.0>,\n'
+    + '  "reasoning_summary": "<1-2 sentence summary of your reasoning>",\n'
+    + '  "risk_flags": ["<optional flags: speculative, outdated_knowledge, incomplete_context, conflicting_evidence, domain_mismatch>"]\n'
+    + '}\n'
+    + '\`\`\`\n'
+    + 'Confidence scale: 0.9-1.0 near certain, 0.7-0.89 high, 0.5-0.69 moderate, 0.3-0.49 low, 0.0-0.29 very low.';
+
+
+  return await llmProvider.chat(systemPrompt, prompt, { maxTokens: 8192, agentTag: AGENT_CARD.name });
+}
+