@adia-ai/a2ui-mcp 0.5.18 → 0.5.20

package/CHANGELOG.md

@@ -10,6 +10,14 @@ zettel strategies.
 
 _No pending changes._
 
+## [0.5.20] - 2026-05-18
+
+_Lockstep ride-along (no source change in this package; companion to web-components v0.5.20 — see root CHANGELOG)._
+
+## [0.5.19] - 2026-05-17
+
+_Lockstep ride-along (no source change in this package; companion to web-components v0.5.19 — see root CHANGELOG)._
+
 ## [0.5.18] - 2026-05-16
 
 _Lockstep ride-along (no source change in this package; companion to web-components v0.5.18 — see root CHANGELOG)._

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-mcp",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "description": "AdiaUI A2UI MCP server. Exposes the compose engine over MCP with an engine selector for monolithic + zettel strategies.",
   "type": "module",
   "bin": {

package/server.js

@@ -96,6 +96,76 @@ const server = new McpServer({
   version: '0.1.0',
 });
 
+server.tool(
+  'plan_app_state',
+  `Analyze a natural language prompt and extract the top-level Generative UI Ontology structures (Intent, Domain, Tasks, Experience).
+  
+Use this tool BEFORE generating UI to ensure you have walked the Reasoning Ladder and properly modeled the nouns and verbs of the feature. This bounds hallucination and forces a focus on tasks over raw layouts.`,
+  {
+    prompt: z.string().describe('The natural language request (e.g., "Build a dashboard for incoming sales leads")'),
+  },
+  async ({ prompt }) => {
+    // We utilize the LLM directly here to act as the reasoning gate.
+    // This is a minimal, fast call designed to output structured JSON.
+    const { createAdapter } = await import('../../llm/llm-bridge.js');
+    const llm = await createAdapter();
+    
+    const systemPrompt = `You are the A2UI Ontology Planner.
+Given a user prompt, you must extract the Core App State using the 5-Gate Reasoning Ladder.
+
+Output ONLY a JSON object matching this schema, nothing else:
+{
+  "intent": {
+    "user_goal": "string",
+    "product_goal": "string"
+  },
+  "domain": {
+    "entities": ["string"],
+    "metrics": ["string"]
+  },
+  "tasks": {
+    "primary": ["string"],
+    "inspection": ["string"]
+  },
+  "experience": {
+    "mode": "workspace | dashboard | wizard | chat",
+    "shell": "admin-shell | chat-shell | a2ui-root"
+  }
+}`;
+
+    try {
+      const response = await llm.complete({
+        messages: [{ role: 'user', content: prompt }],
+        system: systemPrompt,
+        temperature: 0.2
+      });
+
+      let jsonMatch = response.text.match(/\{[\s\S]*\}/);
+      if (!jsonMatch) {
+         throw new Error("LLM failed to output valid JSON for the ontology plan.");
+      }
+      
+      const plan = JSON.parse(jsonMatch[0]);
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify(plan, null, 2),
+          },
+        ],
+      };
+    } catch (e) {
+      return {
+        content: [
+          { type: 'text', text: `Failed to plan app state: ${e.message}` }
+        ],
+        isError: true,
+      }
+    }
+  }
+);
+
 server.tool(
   'generate_ui',
   `Generate A2UI components from a natural language description.
@@ -115,8 +185,18 @@ The generator knows 96+ UI patterns across 5 domains: forms, data, layout, agent
     engine: z.enum(['monolithic', 'zettel']).optional().describe('Generation engine. "monolithic" (default) is pattern-match + adapt. "zettel" is fragment-graph composition.'),
     mode: z.enum(['instant', 'pro', 'thinking']).optional().describe('Generation mode (monolithic). "pro" (default) uses LLM with pattern adaptation. "thinking" uses full LLM generation. "instant" uses fast pattern matching.'),
     sessionId: z.string().optional().describe('Opaque session identifier for multi-turn iteration (zettel only). When provided, follow-up calls with the same sessionId modify the prior turn\'s canvas instead of regenerating from scratch. Omit for stateless generation.'),
+    context: z.object({
+      domain: z.object({
+        entities: z.array(z.string()).optional(),
+        metrics: z.array(z.string()).optional()
+      }).optional(),
+      tasks: z.object({
+        primary: z.array(z.string()).optional(),
+        inspection: z.array(z.string()).optional()
+      }).optional()
+    }).optional().describe('Ontology context parsed by plan_app_state. If provided, the generator uses these constraints to bound hallucinations and strictly align components with domain tasks.')
   },
-  async ({ intent, engine, mode, sessionId }) => {
+  async ({ intent, engine, mode, sessionId, context }) => {
     try {
       const selectedEngine = engine || 'monolithic';
       const effectiveMode = selectedEngine === 'zettel' ? 'instant' : (mode || 'pro');
@@ -125,6 +205,7 @@ The generator knows 96+ UI patterns across 5 domains: forms, data, layout, agent
         engine: selectedEngine,
         mode: effectiveMode,
         sessionId,
+        context, // Pass the ontology context down to the composer
       });
       return {
         content: [{