@miraigent/ai-ops-templates 0.1.1 → 0.1.3

package/README.md

@@ -93,6 +93,7 @@ mcp/ai-ops-template-server/
 The server exposes tools for listing the public template catalog, fetching one template, building a short AI operations review checklist, and recommending a practical template sequence.
 
 This repository currently publishes a starter MCP server. It does not claim to provide a full orchestration or automation engine.
+The server uses newline-delimited JSON-RPC over stdio for standard MCP clients.
 
 After npm publication, the intended command will be npx @miraigent/ai-ops-templates.
 Because this is a scoped public npm package, publication uses npm publish --access public.

package/mcp/ai-ops-template-server/README.md

@@ -16,7 +16,9 @@ review, and support process mapping.
 npm run mcp
 ```
 
-The server communicates over stdio with JSON-RPC Content-Length framing and implements:
+The server communicates over stdio with newline-delimited JSON-RPC for standard MCP clients.
+
+It implements:
 
 - `initialize`
 - `tools/list`

package/mcp/ai-ops-template-server/server.mjs

@@ -150,6 +150,18 @@ process.stdin.on("data", (chunk) => {
 });
 
 function readNextMessage() {
+  if (startsWithContentLength(buffer)) {
+    return readContentLengthMessage();
+  }
+
+  return readNewlineMessage();
+}
+
+function startsWithContentLength(input) {
+  return input.slice(0, 15).toString("utf8").toLowerCase().startsWith("content-length:");
+}
+
+function readContentLengthMessage() {
   const separator = buffer.indexOf("\r\n\r\n");
   if (separator === -1) {
     return false;
@@ -176,6 +188,22 @@ function readNextMessage() {
   return true;
 }
 
+function readNewlineMessage() {
+  const lineEnd = buffer.indexOf("\n");
+  if (lineEnd === -1) {
+    return false;
+  }
+
+  const line = buffer.slice(0, lineEnd).toString("utf8").trim();
+  buffer = buffer.slice(lineEnd + 1);
+  if (!line) {
+    return true;
+  }
+
+  handleMessage(line);
+  return true;
+}
+
 function handleMessage(body) {
   let request;
   try {
@@ -207,7 +235,7 @@ function route(method, params) {
       },
       serverInfo: {
         name: "miraigent-ai-ops-template-server",
-        version: "0.1.0"
+        version: "0.1.3"
       }
     };
   }
@@ -280,10 +308,19 @@ function recommendTemplateSequence(args) {
   return {
     operation: args.operation ?? "general-ai-operations",
     note: "This is a non-memory AI operations helper sequence. It is not a MIRAI Memory engine or working memory MCP.",
+    nextSteps: buildNextSteps(),
     templates: sequence.map((id) => templates.find((template) => template.id === id))
   };
 }
 
+function buildNextSteps() {
+  return {
+    label: "Learn more",
+    note: "Use these public templates as a starting point, then review Miraigent and Agent Memories resources for practical AI operations support.",
+    links: []
+  };
+}
+
 function moveBefore(items, target, before) {
   const targetIndex = items.indexOf(target);
   const beforeIndex = items.indexOf(before);
@@ -345,5 +382,5 @@ function respond(id, result = null, error = null) {
     message.result = result;
   }
   const body = JSON.stringify(message);
-  process.stdout.write(`Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`);
+  process.stdout.write(`${body}\n`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/ai-ops-templates",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Public AI operations templates and a starter MCP server for human-reviewed AI operations.",
   "homepage": "https://github.com/Miraigent/miraigent-ai-ops-templates#readme",
   "type": "module",

package/scripts/smoke-test.mjs

@@ -1,88 +1,98 @@
 import { spawn } from "node:child_process";
 
-const child = spawn(process.execPath, ["mcp/ai-ops-template-server/server.mjs"], {
-  stdio: ["pipe", "pipe", "inherit"]
-});
+await runSmokeTest("content-length");
+await runSmokeTest("newline");
 
-const responses = [];
-let buffer = Buffer.alloc(0);
-child.stdout.setEncoding("utf8");
-child.stdout.on("data", (chunk) => {
-  buffer = Buffer.concat([buffer, Buffer.from(chunk, "utf8")]);
-  while (readNextResponse()) {
-    // Keep draining complete messages.
-  }
-});
+async function runSmokeTest(framing) {
+  const child = spawn(process.execPath, ["mcp/ai-ops-template-server/server.mjs"], {
+    stdio: ["pipe", "pipe", "inherit"]
+  });
 
-send({ jsonrpc: "2.0", id: 1, method: "initialize", params: {} });
-send({ jsonrpc: "2.0", id: 2, method: "tools/list", params: {} });
-send({
-  jsonrpc: "2.0",
-  id: 3,
-  method: "tools/call",
-  params: {
-    name: "get_ai_ops_template",
-    arguments: { id: "human-review-gate-ai-drafts" }
-  }
-});
-send({
-  jsonrpc: "2.0",
-  id: 4,
-  method: "tools/call",
-  params: {
-    name: "build_ai_ops_review_checklist",
-    arguments: { operation: "customer-support", riskLevel: "high" }
-  }
-});
-send({
-  jsonrpc: "2.0",
-  id: 5,
-  method: "tools/call",
-  params: {
-    name: "recommend_ai_ops_template_sequence",
-    arguments: { operation: "support", priorities: ["privacy", "faq"] }
-  }
-});
+  const responses = [];
+  let output = "";
+  child.stdout.on("data", (chunk) => {
+    output += chunk.toString("utf8");
+    assert(!output.includes("Content-Length:"), `${framing}: stdout must not include Content-Length headers`);
+    while (readNextResponseLine()) {
+      // Keep draining complete newline-delimited responses.
+    }
+  });
 
-await waitForResponses(5);
-child.kill();
+  send(child, framing, { jsonrpc: "2.0", id: 1, method: "initialize", params: {} });
+  send(child, framing, { jsonrpc: "2.0", id: 2, method: "tools/list", params: {} });
+  send(child, framing, {
+    jsonrpc: "2.0",
+    id: 3,
+    method: "tools/call",
+    params: {
+      name: "list_ai_ops_templates",
+      arguments: {}
+    }
+  });
+  send(child, framing, {
+    jsonrpc: "2.0",
+    id: 4,
+    method: "tools/call",
+    params: {
+      name: "get_ai_ops_template",
+      arguments: { id: "human-review-gate-ai-drafts" }
+    }
+  });
+  send(child, framing, {
+    jsonrpc: "2.0",
+    id: 5,
+    method: "tools/call",
+    params: {
+      name: "build_ai_ops_review_checklist",
+      arguments: { operation: "customer-support", riskLevel: "high" }
+    }
+  });
+  send(child, framing, {
+    jsonrpc: "2.0",
+    id: 6,
+    method: "tools/call",
+    params: {
+      name: "recommend_ai_ops_template_sequence",
+      arguments: { operation: "support", priorities: ["privacy", "faq"] }
+    }
+  });
 
-assert(responses[0].result.serverInfo.name === "miraigent-ai-ops-template-server", "initialize failed");
-assert(responses[1].result.tools.length === 4, "tools/list failed");
-assert(responses[2].result.content[0].text.includes("Human Review Gate"), "template lookup failed");
-assert(responses[3].result.content[0].text.includes("escalation owner"), "checklist build failed");
-assert(responses[4].result.content[0].text.includes("not a MIRAI Memory engine"), "sequence recommendation failed");
+  await waitForResponses(responses, 6);
+  child.kill();
 
-function send(payload) {
-  const body = JSON.stringify(payload);
-  child.stdin.write(`Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`);
-}
+  assert(responses[0].result.serverInfo.name === "miraigent-ai-ops-template-server", `${framing}: initialize failed`);
+  assert(responses[1].result.tools.length === 4, `${framing}: tools/list failed`);
+  assert(responses[2].result.content[0].text.includes("Human Review Gate"), `${framing}: template listing failed`);
+  assert(responses[3].result.content[0].text.includes("Human Review Gate"), `${framing}: template lookup failed`);
+  assert(responses[4].result.content[0].text.includes("escalation owner"), `${framing}: checklist build failed`);
+  assert(responses[5].result.content[0].text.includes("not a MIRAI Memory engine"), `${framing}: sequence recommendation failed`);
 
-function readNextResponse() {
-  const separator = buffer.indexOf("\r\n\r\n");
-  if (separator === -1) {
-    return false;
-  }
+  function readNextResponseLine() {
+    const lineEnd = output.indexOf("\n");
+    if (lineEnd === -1) {
+      return false;
+    }
 
-  const header = buffer.slice(0, separator).toString("utf8");
-  const match = header.match(/Content-Length: (\d+)/i);
-  if (!match) {
-    throw new Error(`Missing Content-Length in response: ${header}`);
+    const line = output.slice(0, lineEnd).trim();
+    output = output.slice(lineEnd + 1);
+    if (line) {
+      responses.push(JSON.parse(line));
+    }
+    return true;
   }
+}
 
-  const bodyStart = separator + 4;
-  const bodyEnd = bodyStart + Number(match[1]);
-  if (buffer.length < bodyEnd) {
-    return false;
+function send(child, framing, payload) {
+  const body = JSON.stringify(payload);
+  if (framing === "newline") {
+    child.stdin.write(`${body}\n`);
+    return;
   }
 
-  const body = buffer.slice(bodyStart, bodyEnd).toString("utf8");
-  buffer = buffer.slice(bodyEnd);
-  responses.push(JSON.parse(body));
-  return true;
+  child.stdin.write(`Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`);
 }
 
-async function waitForResponses(count) {
+async function waitForResponses(responses, count) {
   const started = Date.now();
   while (responses.length < count) {
     if (Date.now() - started > 3000) {