@spilno/herald-mcp 1.0.0 → 1.1.1

package/dist/index.js

@@ -85,7 +85,7 @@ const tools = [
     },
     {
         name: "herald_predict",
-        description: "Generate non-deterministic structure prediction from signal",
+        description: "Generate non-deterministic structure prediction from signal. Returns sessionId for multi-turn conversations.",
         inputSchema: {
             type: "object",
             properties: {
@@ -93,26 +93,62 @@ const tools = [
                     type: "string",
                     description: "Natural language input (e.g., 'create safety assessment module')",
                 },
-                context_id: {
-                    type: "string",
-                    description: "Context identifier (user/company)",
-                },
                 context: {
                     type: "string",
                     description: "Additional context for better prediction",
                 },
                 session_id: {
                     type: "string",
-                    description: "Optional session for continuity",
+                    description: "Session ID for multi-turn conversations (returned from previous predict/refine)",
                 },
-                domain: {
+                participant: {
                     type: "string",
-                    description: "Optional domain filter (e.g., 'hse')",
+                    description: "Participant name (e.g., 'user', 'architect', 'compliance')",
                 },
             },
             required: ["signal"],
         },
     },
+    {
+        name: "herald_refine",
+        description: "Refine an existing prediction with additional requirements. Use session_id from previous predict call.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Session ID from previous predict or refine call",
+                },
+                refinement: {
+                    type: "string",
+                    description: "Refinement instruction (e.g., 'make it OSHA compliant', 'add corrective actions section')",
+                },
+                context: {
+                    type: "string",
+                    description: "Additional context for refinement",
+                },
+                participant: {
+                    type: "string",
+                    description: "Participant name (e.g., 'user', 'architect', 'compliance')",
+                },
+            },
+            required: ["session_id", "refinement"],
+        },
+    },
+    {
+        name: "herald_session",
+        description: "Get session information including history of all predictions and refinements",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Session ID to retrieve",
+                },
+            },
+            required: ["session_id"],
+        },
+    },
     {
         name: "herald_observe",
         description: "Record prediction outcome for learning",
@@ -180,8 +216,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }
             ] : [];
             const result = await callCedaAPI("/api/predict", "POST", {
-                input: params.signal, // CEDA uses 'input' not 'signal'
+                input: params.signal,
                 context,
+                sessionId: params.session_id,
+                participant: params.participant,
                 config: {
                     enableAutoFix: true,
                     maxAutoFixAttempts: 3,
@@ -196,6 +234,45 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 ],
             };
         }
+        case "herald_refine": {
+            // Maps to: POST /api/refine
+            const params = args;
+            // Build context array if additional context provided
+            const context = params.context ? [
+                {
+                    type: "refinement_context",
+                    value: params.context,
+                    source: "herald_mcp",
+                }
+            ] : [];
+            const result = await callCedaAPI("/api/refine", "POST", {
+                sessionId: params.session_id,
+                refinement: params.refinement,
+                context,
+                participant: params.participant,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        case "herald_session": {
+            // Maps to: GET /api/session/:id
+            const params = args;
+            const result = await callCedaAPI(`/api/session/${params.session_id}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
         case "herald_observe": {
             // Maps to: POST /api/feedback
             const params = args;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spilno/herald-mcp",
-  "version": "1.0.0",
-  "description": "Herald MCP - Diplomatic interface to CEDA (Cognitive Event-Driven Architecture)",
+  "version": "1.1.1",
+  "description": "Herald MCP - AI-native interface to CEDA (Cognitive Event-Driven Architecture) for structure prediction, multi-turn refinement, and learning feedback",
   "main": "dist/index.js",
   "type": "module",
   "bin": "./dist/index.js",