nothumanallowed 14.1.70 → 14.1.71

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nothumanallowed",
-  "version": "14.1.70",
+  "version": "14.1.71",
   "description": "NotHumanAllowed — 38 AI agents, 80 tools, Studio (visual agentic workflows). Email, calendar, browser automation, screen capture, canvas, cron/heartbeat, Alexandria E2E messaging, GitHub, Notion, Slack, voice chat, free AI (Liara), 28 languages. Zero-dependency CLI.",
   "type": "module",
   "bin": {

package/src/constants.mjs

@@ -5,7 +5,7 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-export const VERSION = '14.1.70';
+export const VERSION = '14.1.71';
 export const BASE_URL = 'https://nothumanallowed.com/cli';
 export const API_BASE = 'https://nothumanallowed.com/api/v1';
 

package/src/server/routes/studio.mjs

@@ -15,9 +15,67 @@ import { webSearch, fetchUrl } from '../../services/web-tools.mjs';
 const WEB_TOOL_AGENTS = new Set([
   'WebSearchAgent', 'TravelAgent', 'mercury', 'MERCURY',
   'athena', 'ATHENA', 'oracle', 'ORACLE', 'cassandra', 'CASSANDRA',
-  'HERALD', 'DataAnalystAgent',
+  'HERALD', 'DataAnalystAgent', 'herald', 'tempest', 'TEMPEST',
+  'epicure', 'EPICURE', 'cartographer', 'CARTOGRAPHER',
 ]);
 
+// ── Complete Agent Registry ─────────────────────────────────────────────────
+// Each entry: [emoji, name, short description for the planner]
+const AGENT_REGISTRY = [
+  ['🔍','WebSearchAgent',   'Web search and real-time data retrieval. Use for any task needing current web information.'],
+  ['🍽','TravelAgent',       'Restaurant, hotel, B&B, travel recommendations. Searches web for real venues with reviews and prices.'],
+  ['📄','DocumentReaderAgent','Extract data from attached PDFs: specs, tables, model numbers, technical details.'],
+  ['📧','EmailAgent',        'Read/analyze inbox emails, identify urgent items and deadlines.'],
+  ['📅','CalendarAgent',     'Review calendar events, find scheduling conflicts, plan meetings.'],
+  ['💻','GitHubAgent',       'Analyze GitHub repos, issues, PRs, code quality metrics.'],
+  ['💬','SlackAgent',        'Read Slack channels/messages, identify important conversations.'],
+  ['📝','NotionAgent',       'Search and read Notion pages, databases, wikis.'],
+  ['📰','HERALD',            'OSINT intelligence analyst. Synthesizes all collected data into executive briefings with sourced claims and bias flags. Best used as final synthesizer after other agents.'],
+  ['🔭','ORACLE',            'Senior data scientist. Statistical inference, pattern recognition, decision science. Transforms raw data into actionable intelligence.'],
+  ['♟','ATHENA',             'Technology research analyst. Evaluates frameworks, approaches, techniques with scientific rigor. Strategic technology recommendations.'],
+  ['⚠','CASSANDRA',          'Risk analyst and predictive consequence engineer. Systematic risk assessment, threat modeling, scenario planning.'],
+  ['💰','MERCURY',            'CFA-level financial market analyst. Equity research, technical analysis, quantitative risk. Real-time market data interpretation.'],
+  ['🖊','QUILL',              'Conversion copywriter. Micro-content, headlines, CTAs, landing pages, email campaigns. Direct response copywriting.'],
+  ['📊','DataAnalystAgent',   'Data analysis, statistics, pattern extraction, trend identification from datasets.'],
+  ['🌐','polyglot',           'Computational linguist and translator. Cross-lingual NLP, localization, contrastive linguistics. Professional translation.'],
+  ['🎨','CanvasAgent',        'HTML dashboard/report generator. Creates visual canvas with charts and tables. USE ONLY AS LAST STEP.'],
+  // ── Specialist agents (not in old planner) ─────────
+  ['🗡','ADE',                'Offensive security specialist (red team). Penetration testing methodology, attack surface analysis, vulnerability exploitation paths.'],
+  ['🏗','ATLAS',              'Infrastructure-as-Code engineer. Cloud environments, Terraform, Pulumi, declarative configuration, production infrastructure.'],
+  ['🔗','BABEL',              'Integration architect and API design. Unifies disparate systems, REST/GraphQL/gRPC design, webhook orchestration.'],
+  ['🗺','CARTOGRAPHER',       'Geospatial analyst. GIS, geodesy, spatial data, location intelligence, map-based analysis.'],
+  ['🎼','CONDUCTOR',          'Workflow orchestration architect. Designs complex execution plans, dependency graphs, parallel/sequential coordination.'],
+  ['⏰','CRON',               'Automation architect and CI/CD engineer. Scheduled tasks, pipelines, fault-tolerant automation, GitHub Actions, cron jobs.'],
+  ['📢','ECHO',               'Content distribution and cross-channel amplification. Transforms content into multi-platform packages (social, blog, video scripts).'],
+  ['📐','EDI',                'Statistical modeling engineer. Model selection, validation, interpretation. Regression, time series, Bayesian inference.'],
+  ['🍳','EPICURE',            'Culinary scientist and gastronomic analyst. Food chemistry, global cuisine, nutrition science, recipe analysis, restaurant evaluation.'],
+  ['🔄','FLUX',               'Data transformation engineer. ETL algebra, format conversion, data reshaping, schema migration.'],
+  ['🔧','FORGE',              'Infrastructure architect. Production-grade systems, resilience engineering, system design, code architecture.'],
+  ['🐛','GLITCH',             'Data quality engineer. ETL/ELT pipelines, data cleaning, format transformation, messy data remediation.'],
+  ['👁','HEIMDALL',           'SRE and observability architect. Monitoring systems, alerting, SLO/SLA design, incident response, dashboards.'],
+  ['✉','HERMES',              'Event-driven architecture engineer. Message brokers, async communication, Kafka/RabbitMQ/NATS design.'],
+  ['📉','JARVIS',             'Data visualization architect. Dashboard design, chart selection, information display, D3/Plotly/Grafana.'],
+  ['🕸','LINK',               'Social graph analyst and community architect. Network analysis, community design, engagement optimization.'],
+  ['🧠','LOGOS',              'Formal logic analyst and argument auditor. Evaluates argument structure, consistency, logical validity, fallacy detection.'],
+  ['⚙','MACRO',               'Process automation engineer. Pattern recognition, template systems, bulk operations, workflow automation.'],
+  ['📜','MURASAKI',           'Long-form content architect. Whitepapers, research papers, essays, book chapters. Academic rigor + narrative craft.'],
+  ['🎭','MUSE',               'Visual content director. Art direction, visual communication, design systems, brand aesthetics.'],
+  ['🧭','NAVI',               'Data quality profiler. Dataset assessment, upstream validation, schema inspection, quality scoring before analysis.'],
+  ['🔌','PIPE',               'Data pipeline architect. Reliable data flows, stream processing, zero-loss record transport.'],
+  ['🔥','PROMETHEUS',         'Software evolution architect. System analysis, structural weakness identification, evolutionary improvement design, refactoring strategy.'],
+  ['🛡','SABER',              'Security auditor. Application security, infrastructure hardening, SSDLC, compliance, OWASP, pentest reports.'],
+  ['👁‍🗨','SAURON',            'Deep diagnostics and root cause analysis. Goes beyond symptoms to find true origins of system failures.'],
+  ['📖','SCHEHERAZADE',       'Content strategist and narrative architect. Storytelling, content that captivates, persuades, and converts.'],
+  ['🖥','SHELL',               'CLI tool architect. Command-line interface design, shell scripting, terminal UX, CLI frameworks.'],
+  ['⚔','SHOGUN',              'Kubernetes platform engineer. Container orchestration, pod strategy, resource placement, cluster management.'],
+  ['🌪','TEMPEST',            'Meteorological intelligence analyst. Weather forecasting, atmospheric data interpretation, climate analysis.'],
+  ['✅','VERITAS',            'Evidence analyst and fact-checker. Determines if claims are supported by evidence, epistemological rigor.'],
+  ['🎯','ZERO',               'Automated vulnerability scanner. Combines Snyk/Semgrep/Trivy/Nuclei precision with contextual understanding.'],
+];
+
+const AGENT_NAMES = AGENT_REGISTRY.map(a => a[1]);
+const AGENT_CATALOG = AGENT_REGISTRY.map(([icon, name, desc]) => `- ${icon} **${name}**: ${desc}`).join('\n');
+
 /**
  * Run a web search and return formatted results string.
  */
@@ -56,24 +114,22 @@ async function runFetchUrl(url) {
  */
 function extractSearchQueries(task, stepPrompt) {
   const text = (stepPrompt || task).slice(0, 500);
-  // Primary query: the full task condensed
   const primary = text.replace(/[^\w\s.,&/-]/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 120);
   const queries = [primary];
 
-  // Finance: add price + news queries
   if (/gold|silver|oil|stock|bitcoin|crypto|eur|usd|etf|nasdaq|sp500|dow|tesla|apple|nvidia/i.test(text)) {
     const ticker = text.match(/\b([A-Z]{2,5}|gold|silver|oil|bitcoin|ethereum)\b/i)?.[1] || '';
     if (ticker) {
-      queries.push(`${ticker} price today 2025`);
-      queries.push(`${ticker} analyst forecast outlook 2025`);
+      queries.push(`${ticker} price today 2026`);
+      queries.push(`${ticker} analyst forecast outlook 2026`);
     }
   }
 
-  // Dedup and cap at 3
   return [...new Set(queries)].slice(0, 3);
 }
 
 export function register(router) {
+  // ── /api/studio/plan — Intelligent workflow planner ─────────────────
   router.post('/api/studio/plan', async (req, res) => {
     const body = await parseBody(req);
     const task = (body.task || '').trim();
@@ -82,100 +138,89 @@ export function register(router) {
 
     const LANG_MAP = {en:'English',it:'Italian',es:'Spanish',fr:'French',de:'German',pt:'Portuguese',zh:'Chinese',ja:'Japanese',ar:'Arabic',hi:'Hindi',ru:'Russian',nl:'Dutch',pl:'Polish',tr:'Turkish',ko:'Korean'};
     const plannerLang = LANG_MAP[(config?.language||'it').slice(0,2)] || 'Italian';
-    const it = plannerLang === 'Italian';
-    const taskLow = task.toLowerCase();
-
-    const hasPdf        = !!(body.hasPdf) || /pdf|allegat|catalogo|scheda\s*tecnic/i.test(taskLow);
-    const hasEmail      = /email|mail|inbox|posta/i.test(taskLow);
-    const hasCalendar   = /calendar|agenda|calendari|eventi|schedule/i.test(taskLow);
-    const hasSearch     = /cerca|search|notizie|news|ultime|latest|web|internet|tendenz|trend|acquista|compra|dove\s+trovare|where\s+to\s+buy|similar|simile/i.test(taskLow);
-    const hasCanvas     = /html|dashboard|visua|report|grafico|chart/i.test(taskLow);
-    const hasGitHub     = /github|git\b|issue\b|pull request|\bPR\b/i.test(taskLow);
-    const hasSlack      = /slack/i.test(taskLow);
-    const hasNotion     = /\bnotion\b/i.test(taskLow);
-    const hasBriefing   = /briefing|analisi|analizza|summary|sommario|riassunto|riepiloga|valutazione|valuta/i.test(taskLow);
-    const hasFinance    = /finance|mercato|market|stock|trading|finanz|investiment|cripto|oro|gold|petrolio|oil|commodit|prezzo|correlazion|macro|inflazion|tassi|borse|etf|bitcoin|nasdaq|sp500/i.test(taskLow);
-    const hasSecurity   = /security|sicurezza|vulnerabilit|audit|pentest|rischi|dipendenz/i.test(taskLow);
-    const hasStrategy   = /strateg|competitiv|posizionament|raccomandaz|competitive|positioning/i.test(taskLow);
-    const hasReputation = /reputazion|reputation|online|brand|review|recension/i.test(taskLow);
-    const hasCode       = /codice|code|refactor|debug|bug|sviluppo|software|npm|package/i.test(taskLow);
-    const hasWriting    = /scrivi|write|articolo|article|blog|testo|text|documento|document/i.test(taskLow);
-    const hasData       = /dati|data|dataset|csv|json|analizza i dati|pattern|statistich|correlazion|regressione|trend|serie\s+storic/i.test(taskLow);
-    const hasTranslate  = /traduci|translate|traduzione|translation/i.test(taskLow);
-    const hasTravel     = /ristorante|restaurant|b&b|hotel|albergo|agriturismo|locanda|osteria|prenotaz|vacanz|romantico|sushi|giapponese|cinese|pizza|cena|dinner|pranzo|lunch|soggiorno|weekend|pernottament|posto\s+dove\s+mangiare|posto\s+dove\s+dormire|dove\s+mangiare|dove\s+dormire|posto\s+romantico|gita|escursione/i.test(taskLow);
-
-    const extractSearchQuery = (t) => {
-      const m = t.match(/(?:cerca|search|find|ricerca|notizie su|news about|latest on|aggiornamenti su|ultime su|tendenz|trend)\s+(.{5,80}?)(?:\s+(?:e |and |per |for |poi |then )|[,\n]|$)/i);
-      if (m) return m[1].trim();
-      const domainMatch = t.match(/(?:https?:\/\/)?(?:www\.)?([a-z0-9-]+\.[a-z]{2,}(?:\.[a-z]{2,})?)/i);
-      if (domainMatch) return domainMatch[0].replace(/^https?:\/\//,'');
-      return t.replace(/^[^:]+:\s*/,'').split(/[,\n]/)[0].slice(0,100).trim() || t.slice(0,80).trim();
-    };
-    const searchQuery = extractSearchQuery(task);
+    const sanitizedTask = task.replace(/<[^>]*>/g, ' ').replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, '').trim();
 
-    const buildKeywordPlan = () => {
-      const steps = [];
-      if (hasPdf) {
-        const pdfName = body.pdfName || 'documento allegato';
-        steps.push({icon:'📄',agent:'DocumentReaderAgent',label:it?'Leggi documento':'Read document',reason:it?'Allegato PDF rilevato — estraggo dati tecnici prima di ogni altra operazione':'PDF attachment detected — extracting technical data first',prompt:`Extract all technical specifications, model numbers, part codes, product names, manufacturer, dimensions, ratings, and any other key data from the attached document "${pdfName}". List every technical detail precisely.`});
-      }
-      if (hasTravel)   steps.push({icon:'🍽',agent:'TravelAgent',  label:it?'Ricerca ristoranti & hotel':'Search restaurants & hotels', reason:it?'Task di viaggio/prenotazione':'Travel/booking task', prompt:task});
-      if (hasEmail)    steps.push({icon:'📧',agent:'EmailAgent',   label:it?'Controlla email':'Check emails',    reason:it?'Parola chiave email rilevata':'Email keyword detected', prompt:'Read the latest unread emails and identify urgent items, deadlines, and required actions'});
-      if (hasCalendar) steps.push({icon:'📅',agent:'CalendarAgent',label:it?'Rivedi calendario':'Review calendar',reason:it?'Parola chiave calendario rilevata':'Calendar keyword detected', prompt:"Check today's events and identify any scheduling conflicts or important meetings"});
-      if (hasGitHub)   steps.push({icon:'💻',agent:'GitHubAgent',  label:'GitHub',                               reason:it?'Parola chiave GitHub rilevata':'GitHub keyword detected', prompt:'Read open issues and pull requests, identify what needs attention'});
-      if (hasSlack)    steps.push({icon:'💬',agent:'SlackAgent',   label:'Slack',                                reason:it?'Parola chiave Slack rilevata':'Slack keyword detected', prompt:'Check recent Slack messages and identify important conversations'});
-      if (hasNotion)   steps.push({icon:'📝',agent:'NotionAgent',  label:'Notion',                               reason:it?'Parola chiave Notion rilevata':'Notion keyword detected', prompt:'Search Notion for relevant pages and notes'});
-      if (!hasTravel && (hasPdf || hasSearch || hasReputation || (!hasEmail && !hasCalendar && !hasGitHub && !hasSlack))) {
-        const sp = hasPdf ? (it?'Usa le specifiche tecniche estratte dal documento per cercare online dove acquistare il prodotto o articoli equivalenti.':'Use the technical specifications extracted from the document to search online for where to buy this product or equivalent alternatives.') : searchQuery;
-        steps.push({icon:'🔍',agent:'WebSearchAgent',label:it?'Ricerca web':'Web search',reason:it?'Fonte dati web principale':'Primary web data source',prompt:sp});
-      }
-      if (hasSecurity)   steps.push({icon:'🛡',agent:'cassandra',      label:it?'CASSANDRA — Rischi':'CASSANDRA — Risks',     reason:it?'Keyword sicurezza rilevata':'Security keyword detected', prompt:'Analyze the collected data and identify security risks, vulnerabilities and concrete recommendations'});
-      if (hasFinance)    steps.push({icon:'💰',agent:'mercury',         label:it?'MERCURY — Mercato':'MERCURY — Market',       reason:it?'Keyword finanza rilevata':'Finance keyword detected', prompt:'Analyze the financial data and market trends from the collected information'});
-      if (hasStrategy)   steps.push({icon:'♟',agent:'athena',          label:it?'ATHENA — Strategia':'ATHENA — Strategy',     reason:it?'Keyword strategia rilevata':'Strategy keyword detected', prompt:'Based on the collected data, produce strategic analysis with competitive positioning and concrete recommendations'});
-      if (hasReputation) steps.push({icon:'🔭',agent:'oracle',          label:it?'ORACLE — Reputazione':'ORACLE — Reputation', reason:it?'Keyword reputazione rilevata':'Reputation keyword detected', prompt:'Analyze the online reputation data, sentiment and brand positioning from the collected information'});
-      if (hasCode)       steps.push({icon:'🔧',agent:'forge',           label:it?'FORGE — Codice':'FORGE — Code',              reason:it?'Keyword codice rilevata':'Code keyword detected', prompt:'Analyze the code, dependencies and technical issues identified in the data'});
-      if (hasWriting)    steps.push({icon:'🖊',agent:'quill',           label:it?'QUILL — Redazione':'QUILL — Writing',        reason:it?'Keyword scrittura rilevata':'Writing keyword detected', prompt:'Write a polished, professional document based on all the collected information'});
-      if (hasData)       steps.push({icon:'📊',agent:'DataAnalystAgent',label:it?'Analisi dati':'Data analysis',               reason:it?'Keyword dati rilevata':'Data keyword detected', prompt:'Analyze the data and extract key patterns, trends and insights'});
-      if (hasTranslate)  steps.push({icon:'🌐',agent:'polyglot',        label:it?'POLYGLOT — Traduzione':'POLYGLOT — Translation',reason:it?'Keyword traduzione rilevata':'Translation keyword detected', prompt:'Translate the content as requested, maintaining meaning and style'});
-      const hasSpecialist = hasSecurity || hasFinance || hasStrategy || hasReputation || hasCode || hasWriting || hasData || hasTranslate;
-      if (!hasSpecialist && (hasBriefing || steps.length > 0)) {
-        steps.push({icon:'📰',agent:'HERALD',label:it?'HERALD — Briefing':'HERALD — Briefing',reason:it?'HERALD sintetizza tutti i dati':'HERALD synthesizes all data',prompt:'Based on ALL the data collected by the previous steps, write a complete executive briefing with priorities, findings, and strategic recommendations. Do NOT invent data — only use what was provided.'});
-      }
-      const specialistCount = [hasSecurity,hasFinance,hasStrategy,hasReputation,hasCode,hasWriting,hasData].filter(Boolean).length;
-      if (hasCanvas || specialistCount >= 2 || (hasSpecialist && hasBriefing)) {
-        steps.push({icon:'📊',agent:'CanvasAgent',label:it?'Dashboard HTML':'HTML Dashboard',reason:it?'Analisi complessa — dashboard visuale':'Complex analysis — visual dashboard',prompt:'Create a professional HTML dashboard report summarizing all findings from the previous agents'});
-      }
-      return steps;
-    };
+    const hasPdf = !!(body.hasPdf) || /pdf|allegat|catalogo|scheda\s*tecnic/i.test(task);
+    const pdfName = body.pdfName || 'documento allegato';
 
-    const keywordSteps = buildKeywordPlan();
-    const hasKeywordPlan = keywordSteps.length > 0;
-    const sanitizedTask = task.replace(/<[^>]*>/g, ' ').replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, '').trim();
-    const keywordPlanJson = hasKeywordPlan ? JSON.stringify(keywordSteps.map(s => ({ agent: s.agent, label: s.label, reason: s.reason || '' }))) : '[]';
     const planConfig = Object.assign({}, config, { thinking: 'off' });
 
     try {
-      let steps = keywordSteps;
+      let steps = [];
+
+      const plannerSystem = `You are CONDUCTOR, the master workflow orchestrator for NHA Studio.
+Your job: analyze the user's task and select the OPTIMAL sequence of specialist agents to accomplish it.
+
+## COMPLETE AGENT CATALOG (${AGENT_REGISTRY.length} agents available):
+
+${AGENT_CATALOG}
+
+## ORCHESTRATION RULES:
+
+1. **Select 2-7 agents** depending on task complexity. Simple tasks = 2-3 agents. Complex analysis = 4-7.
+2. **Order matters**: agents execute sequentially. Each agent receives the output of ALL previous agents as context.
+3. **WebSearchAgent or TravelAgent FIRST** when real-time data is needed (prices, news, reviews, weather, venues).
+4. **DocumentReaderAgent FIRST** when a PDF is attached — extract data before anything else.
+5. **HERALD as synthesizer** — place near the end to produce an executive briefing from all collected data.
+6. **CanvasAgent ALWAYS LAST** (and only if visual output is requested or >=3 specialists are used).
+7. **Match agent expertise to task domain**:
+   - Finance/markets/crypto → MERCURY (+ WebSearchAgent for live data)
+   - Security/audit/vulns → SABER, ADE, ZERO, CASSANDRA (pick the right ones)
+   - Code/architecture → FORGE, PROMETHEUS, SAURON
+   - Data/statistics → ORACLE, EDI, NAVI (NAVI for quality check first), DataAnalystAgent
+   - Writing/content → QUILL (short copy), MURASAKI (long-form), SCHEHERAZADE (narrative), ECHO (multi-platform)
+   - Translation → polyglot
+   - Infrastructure/cloud → ATLAS, SHOGUN, HEIMDALL, CRON
+   - API/integrations → BABEL, HERMES, PIPE
+   - Visual/design → MUSE, JARVIS
+   - Logic/verification → LOGOS, VERITAS
+   - Food/restaurants → EPICURE (+ TravelAgent for search)
+   - Weather → TEMPEST
+   - Geospatial → CARTOGRAPHER
+   - Social/community → LINK
+   - Automation → MACRO, CRON
+   - Strategy/competitive → ATHENA
+   - Risk analysis → CASSANDRA
+8. **Write detailed prompts**: each agent's \`prompt\` field should be a specific instruction telling the agent EXACTLY what to analyze, produce, or investigate. Not just the task repeated — a targeted instruction leveraging that agent's specialty.
+9. **Labels in ${plannerLang}**.
+10. **Never use agents that don't match the task**. A cooking task doesn't need SABER. A security audit doesn't need EPICURE.
+${hasPdf ? `\n11. **PDF ATTACHED**: "${pdfName}" — DocumentReaderAgent MUST be step 1.` : ''}
+
+## OUTPUT FORMAT (STRICT — output ONLY this JSON, nothing else):
+
+{"steps":[{"icon":"EMOJI","agent":"AGENT_NAME","label":"LABEL_IN_${plannerLang.toUpperCase()}","reason":"WHY_THIS_AGENT","prompt":"DETAILED_INSTRUCTION_FOR_THE_AGENT"}]}`;
+
+      const plannerUser = `TASK: ${sanitizedTask}
+
+Select the optimal agent pipeline. Output ONLY the JSON.`;
+
       if (config && (config.llm?.provider || config.llm?.apiKey)) {
         try {
-          const planSys = `You are a workflow planner for NHA Studio. Output ONLY valid JSON — no explanation, no markdown.`;
-          const planPrompt = hasKeywordPlan
-            ? `Task: ${sanitizedTask}\n\nKeyword-detected plan (JSON):\n${keywordPlanJson}\n\nLanguage for labels: ${plannerLang}.\n\nReview the plan. You may ADD missing steps, REMOVE wrong ones, REORDER, ADJUST prompts. Keep existing reasons where step is unchanged.\n\nAvailable agents: TravelAgent, WebSearchAgent, DocumentReaderAgent, EmailAgent, CalendarAgent, GitHubAgent, SlackAgent, NotionAgent, HERALD, ORACLE, ATHENA, CASSANDRA, MERCURY, QUILL, DataAnalystAgent, polyglot, CanvasAgent (last only).\n\nOutput ONLY:\n{"steps":[{"icon":"EMOJI","agent":"AGENT_NAME","label":"LABEL","reason":"WHY","prompt":"INSTRUCTION"}]}\n\nMax 6 steps.`
-            : `Task: ${sanitizedTask}\n\nLanguage for labels: ${plannerLang}.\n\nBuild a workflow plan. Available agents: TravelAgent, WebSearchAgent, DocumentReaderAgent, EmailAgent, CalendarAgent, GitHubAgent, SlackAgent, NotionAgent, HERALD, ORACLE, ATHENA, CASSANDRA, MERCURY, QUILL, DataAnalystAgent, polyglot, CanvasAgent.\n\nOutput ONLY:\n{"steps":[{"icon":"EMOJI","agent":"AGENT_NAME","label":"LABEL","reason":"WHY","prompt":"INSTRUCTION"}]}\n\n2-5 steps.`;
-          const planRaw = await callLLM(planConfig, planSys, planPrompt, { max_tokens: 900 });
+          const planRaw = await callLLM(planConfig, plannerSystem, plannerUser, { max_tokens: 2000 });
           let clean = planRaw.replace(/<think>[\s\S]*?<\/think>/g, '').trim().replace(/^```[\w]*\r?\n?/, '').replace(/\r?\n?```$/, '').trim();
           const jm = clean.match(/\{[\s\S]*\}/);
           const parsed = JSON.parse(jm ? jm[0] : clean);
           if (Array.isArray(parsed.steps) && parsed.steps.length > 0) {
-            const krMap = {};
-            keywordSteps.forEach(s => { krMap[s.agent] = s.reason || ''; });
-            steps = parsed.steps.map(s => ({ icon: s.icon || '🤖', agent: s.agent, label: s.label, reason: s.reason || krMap[s.agent] || '', prompt: s.prompt }));
+            steps = parsed.steps
+              .filter(s => AGENT_NAMES.includes(s.agent))
+              .map(s => {
+                const reg = AGENT_REGISTRY.find(r => r[1] === s.agent);
+                return { icon: s.icon || (reg ? reg[0] : '🤖'), agent: s.agent, label: s.label, reason: s.reason || '', prompt: s.prompt };
+              });
           }
-        } catch {}
+        } catch { /* LLM failed, fall through to keyword fallback */ }
+      }
+
+      // Keyword fallback if LLM planner failed or no LLM configured
+      if (!steps.length) {
+        steps = buildKeywordFallback(task, sanitizedTask, hasPdf, pdfName, plannerLang === 'Italian');
       }
-      if (!Array.isArray(steps) || !steps.length) {
+
+      if (!steps.length) {
+        const it = plannerLang === 'Italian';
         steps = [{ icon: '🔍', agent: 'WebSearchAgent', label: it ? 'Ricerca web' : 'Web search', reason: 'Fallback', prompt: sanitizedTask }];
       }
+
       sendJSON(res, 200, { steps });
     } catch (e) { sendError(res, 500, e.message); }
   });
@@ -212,19 +257,20 @@ export function register(router) {
         } catch {}
       }
 
-      const contextBlock = context ? `\n\n## CONTEXT FROM PREVIOUS STEPS:\n${context.slice(0, 8000)}` : '';
-      const proposalContextBlock = body.proposalContext ? `\n\n## OTHER AGENTS' PROPOSALS (CROSS-READING):\n${body.proposalContext.slice(0, 6000)}` : '';
+      const contextBlock = context ? `\n\n## CONTEXT FROM PREVIOUS STEPS:\n${context.slice(0, 12000)}` : '';
+      const proposalContextBlock = body.proposalContext ? `\n\n## OTHER AGENTS' PROPOSALS (CROSS-READING):\n${body.proposalContext.slice(0, 8000)}` : '';
 
       const formatInstructions = `\n\nFORMATTING RULES (CRITICAL — your output will be rendered as HTML):
 - Use MARKDOWN TABLES with | pipes | for ALL tabular data. Example:
   | Header 1 | Header 2 | Header 3 |
   |----------|----------|----------|
   | data     | data     | data     |
-- NEVER use ASCII art boxes (┌─┐│└─┘╔═╗║╚═╝). They render as ugly <pre> blocks.
-- NEVER use ASCII art charts/graphs (├─●──┤). Describe data in tables instead.
+- NEVER use ASCII art boxes or box-drawing characters. They render as ugly monospace blocks.
 - Use **bold**, *italic*, headers (## ##), bullet points, numbered lists, blockquotes (>).
 - For emphasis boxes, use blockquotes: > **Key insight:** text here
-- Write COMPLETE content under every heading — never leave a section empty.`;
+- Write COMPLETE, EXHAUSTIVE content under every heading — never leave a section empty or superficial.
+- Provide DEEP ANALYSIS with specific data points, numbers, percentages, and concrete examples.
+- Minimum 800 words of substantive content. Be thorough, not brief.`;
 
       const sysParts = [
         agentSysDef || `You are ${agent}, a specialist AI agent in NHA Studio. Respond entirely in ${language}. Today is ${today}.`,
@@ -289,7 +335,7 @@ export function register(router) {
         output += tok;
         tokensOut += Math.ceil(tok.length / 4);
         sse({ token: tok });
-      }, { max_tokens: 8192 });
+      }, { max_tokens: 16384 });
 
       clearInterval(keepalive);
       sse({ done: true, output, tokensOut });
@@ -351,18 +397,18 @@ export function register(router) {
 
       const crossCtx = (excludeAgent) => eligible
         .filter(p => p.agent !== excludeAgent)
-        .map(p => `## ${p.label || p.agent} (Round 1):\n${p.output.slice(0,4000)}`)
+        .map(p => `## ${p.label || p.agent} (Round 1):\n${p.output.slice(0,6000)}`)
         .join('\n\n---\n\n');
 
       tok('[Parlamento — Round 2: Cross-Reading & Refinamento] ');
       const r2Results = [];
       for (const proposal of eligible) {
         tok(`[Round 2: ${proposal.label || proposal.agent}] `);
-        const r2Sys = `You are ${proposal.agent}, a specialist AI agent in NHA Studio Parliament. Today is ${today}. Respond entirely in ${language}.\n\n## WORKFLOW GOAL: ${task}\n\n## YOUR ROUND 1 RESPONSE:\n${proposal.output.slice(0,1500)}\n\n## OTHER AGENTS' ROUND 1 PROPOSALS:\n${crossCtx(proposal.agent)}\n\nDELIBERATION ROUND 2 — REFINEMENT:\n1. Review the other agents' proposals\n2. Incorporate valid points where you AGREE — mark with [ASSIST]\n3. Flag genuine disagreements with [CONTRADICTION] and explain your reasoning\n4. Produce your COMPLETE REFINED response\n5. Keep analysis focused on: ${task}`;
+        const r2Sys = `You are ${proposal.agent}, a specialist AI agent in NHA Studio Parliament. Today is ${today}. Respond entirely in ${language}.\n\n## WORKFLOW GOAL: ${task}\n\n## YOUR ROUND 1 RESPONSE:\n${proposal.output.slice(0,3000)}\n\n## OTHER AGENTS' ROUND 1 PROPOSALS:\n${crossCtx(proposal.agent)}\n\nDELIBERATION ROUND 2 — REFINEMENT:\n1. Review the other agents' proposals carefully\n2. Incorporate valid points where you AGREE — mark with [AGREE]\n3. Flag genuine disagreements with [CONTRADICTION] and explain your reasoning with evidence\n4. Produce your COMPLETE REFINED response — thorough and exhaustive\n5. Keep analysis focused on: ${task}\n\nBe THOROUGH. Minimum 600 words of substantive refined analysis.`;
         let r2Out = '';
         try {
           await callLLMStream(config, r2Sys, 'Produce your refined Round 2 response. Write complete content under every heading — never leave a section title without body text.',
-            (t) => { r2Out += t; }, { max_tokens: 8192 });
+            (t) => { r2Out += t; }, { max_tokens: 16384 });
         } catch { r2Out = proposal.output; }
         r2Results.push({ agent: proposal.agent, label: proposal.label, icon: proposal.icon, output: r2Out });
         sse({ deliberation_r2: { agent: proposal.agent, label: proposal.label, icon: proposal.icon, output: r2Out } });
@@ -372,7 +418,7 @@ export function register(router) {
       tok(`[Parlamento — Round 2 convergenza: ${(r2Conv*100).toFixed(0)}%] `);
       const converged = r2Conv >= 0.30;
 
-      const allR2Ctx = r2Results.map(r => `## ${r.label || r.agent}:\n${r.output.slice(0,2000)}`).join('\n\n---\n\n');
+      const allR2Ctx = r2Results.map(r => `## ${r.label || r.agent}:\n${r.output.slice(0,4000)}`).join('\n\n---\n\n');
       const contradictions = [];
       for (const r of r2Results) {
         const matches = r.output.match(/\[CONTRADICTION\][^\n]*/g) || [];
@@ -383,14 +429,14 @@ export function register(router) {
       tok(converged ? '[Parlamento — Round 3: Sintesi finale HERALD...] ' : '[Parlamento — Round 3: Mediazione HERALD...] ');
 
       const medTask = converged
-        ? `SYNTHESIS TASK (convergenza ${(r2Conv*100).toFixed(0)}%):\n1. Presenta il CONSENSO raggiunto\n2. Segnala ogni sfumatura o punto di divergenza residua\n3. Produci un executive summary unificato con azioni concrete per: ${task}\n4. Sezione "Voci dissonanti" se esistono posizioni che meritano attenzione`
-        : `MEDIATION TASK (convergenza ${(r2Conv*100).toFixed(0)}% — divergenza significativa):\n1. Identifica i punti di ACCORDO tra tutti gli agenti\n2. Per ogni disaccordo: valuta quale posizione ha evidenze più solide, NOMINA l'agente e spiega perché è stata accolta o scartata\n3. Produci una sintesi UNIFICATA\n4. Fai scelte editoriali nette\n5. Executive summary con azioni concrete per: ${task}`;
+        ? `SYNTHESIS TASK (convergenza ${(r2Conv*100).toFixed(0)}%):\n1. Presenta il CONSENSO raggiunto tra tutti gli agenti\n2. Segnala ogni sfumatura o punto di divergenza residua\n3. Produci un executive summary unificato con azioni concrete per: ${task}\n4. Sezione "Voci dissonanti" se esistono posizioni che meritano attenzione\n5. SENZA ALCUN LIMITE DI LUNGHEZZA — sii esaustivo e completo`
+        : `MEDIATION TASK (convergenza ${(r2Conv*100).toFixed(0)}% — divergenza significativa):\n1. Identifica i punti di ACCORDO tra tutti gli agenti\n2. Per ogni disaccordo: valuta quale posizione ha evidenze piu solide, NOMINA l'agente e spiega perche e stata accolta o scartata\n3. Produci una sintesi UNIFICATA esaustiva\n4. Fai scelte editoriali nette con motivazioni\n5. Executive summary con azioni concrete per: ${task}\n6. SENZA ALCUN LIMITE DI LUNGHEZZA — sii esaustivo e completo`;
 
-      const medSys = `You are HERALD, the Parliament Mediator in NHA Studio. Today is ${today}. Respond entirely in ${language}.\n\n## WORKFLOW GOAL: ${task}\n\n## ALL AGENTS' REFINED POSITIONS (Round 2):\n${allR2Ctx}${contBlock}\n\n${medTask}\n\nCRITICAL: NEVER write a heading without immediately writing full content below it. Every section MUST have at least 3-5 concrete bullet points or sentences.`;
+      const medSys = `You are HERALD, the Parliament Mediator in NHA Studio. Today is ${today}. Respond entirely in ${language}.\n\n## WORKFLOW GOAL: ${task}\n\n## ALL AGENTS' REFINED POSITIONS (Round 2):\n${allR2Ctx}${contBlock}\n\n${medTask}\n\nCRITICAL: NEVER write a heading without immediately writing full content below it. Every section MUST have at least 5-8 concrete bullet points or detailed paragraphs. Be EXHAUSTIVE.`;
 
       let mediationOutput = '';
       try {
-        await callLLMStream(config, medSys, 'Produce the Parliament final synthesis.', (t) => { mediationOutput += t; }, { max_tokens: 8192 });
+        await callLLMStream(config, medSys, 'Produce the Parliament final synthesis. Be thorough and complete.', (t) => { mediationOutput += t; }, { max_tokens: 16384 });
       } catch {}
       sse({ deliberation_r3: { output: mediationOutput, converged } });
 
@@ -406,3 +452,69 @@ export function register(router) {
     }
   });
 }
+
+// ── Keyword fallback planner (used when LLM is unavailable) ────────────
+
+function buildKeywordFallback(task, sanitizedTask, hasPdf, pdfName, it) {
+  const taskLow = task.toLowerCase();
+  const steps = [];
+
+  const hasEmail      = /email|mail|inbox|posta/i.test(taskLow);
+  const hasCalendar   = /calendar|agenda|calendari|eventi|schedule/i.test(taskLow);
+  const hasSearch     = /cerca|search|notizie|news|ultime|latest|web|internet|tendenz|trend|acquista|compra|dove\s+trovare|where\s+to\s+buy|similar|simile/i.test(taskLow);
+  const hasCanvas     = /html|dashboard|visua|report|grafico|chart/i.test(taskLow);
+  const hasGitHub     = /github|git\b|issue\b|pull request|\bPR\b/i.test(taskLow);
+  const hasSlack      = /slack/i.test(taskLow);
+  const hasNotion     = /\bnotion\b/i.test(taskLow);
+  const hasBriefing   = /briefing|analisi|analizza|summary|sommario|riassunto|riepiloga|valutazione|valuta/i.test(taskLow);
+  const hasFinance    = /finance|mercato|market|stock|trading|finanz|investiment|cripto|oro|gold|petrolio|oil|commodit|prezzo|correlazion|macro|inflazion|tassi|borse|etf|bitcoin|nasdaq|sp500/i.test(taskLow);
+  const hasSecurity   = /security|sicurezza|vulnerabilit|audit|pentest|rischi|dipendenz/i.test(taskLow);
+  const hasStrategy   = /strateg|competitiv|posizionament|raccomandaz|competitive|positioning/i.test(taskLow);
+  const hasReputation = /reputazion|reputation|online|brand|review|recension/i.test(taskLow);
+  const hasCode       = /codice|code|refactor|debug|bug|sviluppo|software|npm|package|architettur/i.test(taskLow);
+  const hasWriting    = /scrivi|write|articolo|article|blog|testo|text|documento|document|whitepaper|saggio|essay/i.test(taskLow);
+  const hasData       = /dati|data|dataset|csv|json|analizza i dati|pattern|statistich|correlazion|regressione|trend|serie\s+storic/i.test(taskLow);
+  const hasTranslate  = /traduci|translate|traduzione|translation/i.test(taskLow);
+  const hasTravel     = /ristorante|restaurant|b&b|hotel|albergo|agriturismo|locanda|osteria|prenotaz|vacanz|romantico|sushi|giapponese|cinese|pizza|cena|dinner|pranzo|lunch|soggiorno|weekend|pernottament|posto\s+dove\s+mangiare|posto\s+dove\s+dormire|dove\s+mangiare|dove\s+dormire|posto\s+romantico|gita|escursione/i.test(taskLow);
+  const hasWeather    = /meteo|weather|previsioni|temperatura|clima|pioggia|neve|vento/i.test(taskLow);
+  const hasFood       = /ricetta|recipe|cucinare|cook|ingredienti|piatto|dish|gastronomia|cucina/i.test(taskLow);
+  const hasInfra      = /kubernetes|k8s|docker|terraform|cloud|aws|azure|gcp|infrastruttura|infrastructure|deploy|pipeline|ci[\/-]cd/i.test(taskLow);
+  const hasApi        = /\bapi\b|endpoint|webhook|integrazione|integration|rest|graphql|grpc/i.test(taskLow);
+  const hasLogic      = /logica|logic|argoment|fallacia|fallacy|ragionamento|reasoning|valid|premessa|premise/i.test(taskLow);
+  const hasGeo        = /mappa|map|geolocalizzazione|coordinates|latitudine|longitudine|geospatial|gis/i.test(taskLow);
+
+  if (hasPdf)       steps.push({icon:'📄',agent:'DocumentReaderAgent',label:it?'Leggi documento':'Read document',reason:it?'PDF allegato':'PDF attached',prompt:`Extract all technical specifications, data, tables, and key information from the attached document "${pdfName}".`});
+  if (hasTravel)    steps.push({icon:'🍽',agent:'TravelAgent',label:it?'Ricerca luoghi':'Search venues',reason:it?'Task di viaggio/ristorazione':'Travel/dining task',prompt:sanitizedTask});
+  if (hasEmail)     steps.push({icon:'📧',agent:'EmailAgent',label:it?'Controlla email':'Check emails',reason:it?'Email rilevata':'Email detected',prompt:'Read the latest unread emails and identify urgent items, deadlines, and required actions'});
+  if (hasCalendar)  steps.push({icon:'📅',agent:'CalendarAgent',label:it?'Rivedi calendario':'Review calendar',reason:it?'Calendario rilevato':'Calendar detected',prompt:"Check today's events and identify any scheduling conflicts or important meetings"});
+  if (hasGitHub)    steps.push({icon:'💻',agent:'GitHubAgent',label:'GitHub',reason:it?'GitHub rilevato':'GitHub detected',prompt:'Read open issues and pull requests, identify what needs attention'});
+  if (hasSlack)     steps.push({icon:'💬',agent:'SlackAgent',label:'Slack',reason:it?'Slack rilevato':'Slack detected',prompt:'Check recent Slack messages and identify important conversations'});
+  if (hasNotion)    steps.push({icon:'📝',agent:'NotionAgent',label:'Notion',reason:it?'Notion rilevato':'Notion detected',prompt:'Search Notion for relevant pages and notes'});
+  if (hasWeather)   steps.push({icon:'🌪',agent:'TEMPEST',label:it?'Analisi meteo':'Weather analysis',reason:it?'Meteo rilevato':'Weather detected',prompt:sanitizedTask});
+  if (hasFood && !hasTravel) steps.push({icon:'🍳',agent:'EPICURE',label:it?'Analisi culinaria':'Culinary analysis',reason:it?'Cucina rilevata':'Cooking detected',prompt:sanitizedTask});
+  if (hasGeo)       steps.push({icon:'🗺',agent:'CARTOGRAPHER',label:it?'Analisi geospaziale':'Geospatial analysis',reason:it?'Geolocalizzazione rilevata':'Geo detected',prompt:sanitizedTask});
+  if (!hasTravel && (hasPdf || hasSearch || hasReputation || (!hasEmail && !hasCalendar && !hasGitHub && !hasSlack && !hasWeather && !hasFood))) {
+    steps.push({icon:'🔍',agent:'WebSearchAgent',label:it?'Ricerca web':'Web search',reason:it?'Fonte dati web':'Web data source',prompt:sanitizedTask});
+  }
+  if (hasSecurity)  steps.push({icon:'🛡',agent:'SABER',label:it?'SABER — Audit sicurezza':'SABER — Security audit',reason:it?'Sicurezza rilevata':'Security detected',prompt:sanitizedTask});
+  if (hasFinance)   steps.push({icon:'💰',agent:'MERCURY',label:it?'MERCURY — Mercato':'MERCURY — Market',reason:it?'Finanza rilevata':'Finance detected',prompt:sanitizedTask});
+  if (hasStrategy)  steps.push({icon:'♟',agent:'ATHENA',label:it?'ATHENA — Strategia':'ATHENA — Strategy',reason:it?'Strategia rilevata':'Strategy detected',prompt:sanitizedTask});
+  if (hasReputation)steps.push({icon:'🔭',agent:'ORACLE',label:it?'ORACLE — Reputazione':'ORACLE — Reputation',reason:it?'Reputazione rilevata':'Reputation detected',prompt:sanitizedTask});
+  if (hasCode)      steps.push({icon:'🔧',agent:'FORGE',label:it?'FORGE — Architettura':'FORGE — Architecture',reason:it?'Codice rilevato':'Code detected',prompt:sanitizedTask});
+  if (hasWriting)   steps.push({icon:'📜',agent:'MURASAKI',label:it?'MURASAKI — Redazione':'MURASAKI — Writing',reason:it?'Scrittura rilevata':'Writing detected',prompt:sanitizedTask});
+  if (hasData)      steps.push({icon:'📊',agent:'DataAnalystAgent',label:it?'Analisi dati':'Data analysis',reason:it?'Dati rilevati':'Data detected',prompt:sanitizedTask});
+  if (hasTranslate) steps.push({icon:'🌐',agent:'polyglot',label:it?'POLYGLOT — Traduzione':'POLYGLOT — Translation',reason:it?'Traduzione rilevata':'Translation detected',prompt:sanitizedTask});
+  if (hasInfra)     steps.push({icon:'🏗',agent:'ATLAS',label:it?'ATLAS — Infrastruttura':'ATLAS — Infrastructure',reason:it?'Infrastruttura rilevata':'Infrastructure detected',prompt:sanitizedTask});
+  if (hasApi)       steps.push({icon:'🔗',agent:'BABEL',label:it?'BABEL — Integrazione API':'BABEL — API Integration',reason:it?'API rilevata':'API detected',prompt:sanitizedTask});
+  if (hasLogic)     steps.push({icon:'🧠',agent:'LOGOS',label:it?'LOGOS — Analisi logica':'LOGOS — Logic analysis',reason:it?'Logica rilevata':'Logic detected',prompt:sanitizedTask});
+
+  const hasSpecialist = hasSecurity || hasFinance || hasStrategy || hasReputation || hasCode || hasWriting || hasData || hasTranslate || hasInfra || hasApi || hasLogic;
+  if (!hasSpecialist && (hasBriefing || steps.length > 0)) {
+    steps.push({icon:'📰',agent:'HERALD',label:it?'HERALD — Briefing':'HERALD — Briefing',reason:it?'Sintesi finale':'Final synthesis',prompt:'Based on ALL the data collected by the previous steps, write a complete executive briefing with priorities, findings, and strategic recommendations. Do NOT invent data — only use what was provided.'});
+  }
+  const specialistCount = [hasSecurity,hasFinance,hasStrategy,hasReputation,hasCode,hasWriting,hasData,hasInfra,hasApi].filter(Boolean).length;
+  if (hasCanvas || specialistCount >= 2 || (hasSpecialist && hasBriefing)) {
+    steps.push({icon:'📊',agent:'CanvasAgent',label:it?'Dashboard HTML':'HTML Dashboard',reason:it?'Report visuale':'Visual report',prompt:'Create a professional HTML dashboard report summarizing all findings from the previous agents'});
+  }
+  return steps;
+}