pangolint-mcp 0.7.20 → 0.7.28

package/README.md

@@ -31,7 +31,7 @@ which pangolint-mcp
 Or install the `pangolint-mcp` tarball attached to a GitHub Release:
 
 ```bash
-npm install -g ./pangolint-mcp-0.7.20.tgz
+npm install -g ./pangolint-mcp-0.7.28.tgz
 which pangolint-mcp
 ```
 
@@ -40,7 +40,7 @@ For local development, build the same tarball from a repository checkout:
 ```bash
 # from the repository root
 npm run package:mcp
-npm install -g ./mcp/pangolint-mcp-0.7.20.tgz
+npm install -g ./mcp/pangolint-mcp-0.7.28.tgz
 which pangolint-mcp
 ```
 
@@ -124,12 +124,12 @@ calling individual tools.
 | `PANGOLINT_MCP_BEYOND_TALK_TRANSPORT` | `auto` | `auto`, `tcp`, or `udp`. Auto tries Talk TCP first and only uses UDP when fallback is explicitly allowed. |
 | `PANGOLINT_MCP_BEYOND_TALK_TCP_HOST` | `127.0.0.1` | BEYOND Talk TCP host. |
 | `PANGOLINT_MCP_BEYOND_TALK_TCP_PORT` | `16063` | BEYOND Talk TCP port. |
-| `PANGOLINT_MCP_BEYOND_TALK_UDP_HOST` | legacy host or `127.0.0.1` | BEYOND Talk UDP fallback host. |
-| `PANGOLINT_MCP_BEYOND_TALK_UDP_PORT` | legacy port or `16062` | BEYOND Talk UDP fallback port. |
+| `PANGOLINT_MCP_BEYOND_TALK_UDP_HOST` | Talk host alias or `127.0.0.1` | BEYOND Talk UDP host. |
+| `PANGOLINT_MCP_BEYOND_TALK_UDP_PORT` | Talk port alias or `16062` | BEYOND Talk UDP port. |
 | `PANGOLINT_MCP_BEYOND_TALK_UDP_FALLBACK_ALLOWED` | (off) | Set to `enabled` (or `1` / `true`) to allow auto mode to use unauthenticated UDP when TCP is unavailable before authentication or command send begins. |
 | `PANGOLINT_MCP_BEYOND_TALK_TCP_PASSWORD` | (empty) | Optional BEYOND TCP Talk Server password. This value is redacted from runtime output. |
-| `PANGOLINT_MCP_BEYOND_TALK_HOST` | `127.0.0.1` | Legacy alias used as the UDP fallback host when `PANGOLINT_MCP_BEYOND_TALK_UDP_HOST` is unset. |
-| `PANGOLINT_MCP_BEYOND_TALK_PORT` | `16062` | Legacy alias used as the UDP fallback port when `PANGOLINT_MCP_BEYOND_TALK_UDP_PORT` is unset. |
+| `PANGOLINT_MCP_BEYOND_TALK_HOST` | `127.0.0.1` | UDP host alias used when `PANGOLINT_MCP_BEYOND_TALK_UDP_HOST` is unset. |
+| `PANGOLINT_MCP_BEYOND_TALK_PORT` | `16062` | UDP port alias used when `PANGOLINT_MCP_BEYOND_TALK_UDP_PORT` is unset. |
 | `PANGOLINT_MCP_BEYOND_OSC_LISTEN_HOST` | `0.0.0.0` | Local interface for OSC callbacks. |
 | `PANGOLINT_MCP_BEYOND_OSC_LISTEN_PORT` | `7000` | Local UDP port for OSC callbacks. |
 | `PANGOLINT_MCP_READBACK_TIMEOUT_MS` | `3000` | Readback timeout (ms). |

package/dist/server.js

@@ -21909,8 +21909,38 @@ function formatUnsupportedTalkControlFlowError(findings) {
   return `BEYOND Talk can only send straight-line command batches. This script contains ${first.construct} control flow at line ${first.lineNumber}: ${first.lineText}.${extra} Paste/run it directly in BEYOND's PangoScript editor to test full script control flow.`;
 }
 
-// ../src/runtime/readback/beyondReadback.ts
-import { randomBytes } from "node:crypto";
+// ../src/runtime/osc/oscPortLock.ts
+var oscPortLocks = /* @__PURE__ */ new Map();
+async function acquireOscPortLock(options) {
+  const key = `${options.listenHost}:${options.listenPort}`;
+  const previous = oscPortLocks.get(key) ?? Promise.resolve();
+  let releaseTail;
+  const tail = new Promise((resolve) => {
+    releaseTail = resolve;
+  });
+  const next = previous.catch(() => void 0).then(() => tail);
+  oscPortLocks.set(key, next);
+  await previous.catch(() => void 0);
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    releaseTail();
+    if (oscPortLocks.get(key) === next) {
+      oscPortLocks.delete(key);
+    }
+  };
+}
+async function withOscPortLock(options, operation) {
+  const release = await acquireOscPortLock(options);
+  try {
+    return await operation();
+  } finally {
+    release();
+  }
+}
+
+// ../src/runtime/readback/nodeReadbackTransport.ts
 import dgram2 from "node:dgram";
 
 // ../src/runtime/osc/osc.ts
@@ -22003,45 +22033,146 @@ function requireBytes(payload, offset, length, message) {
   }
 }
 
-// ../src/runtime/osc/oscPortLock.ts
-var oscPortLocks = /* @__PURE__ */ new Map();
-async function acquireOscPortLock(options) {
-  const key = `${options.listenHost}:${options.listenPort}`;
-  const previous = oscPortLocks.get(key) ?? Promise.resolve();
-  let releaseTail;
-  const tail = new Promise((resolve) => {
-    releaseTail = resolve;
+// ../src/runtime/readback/nodeReadbackTransport.ts
+var nodeReadbackTransport = {
+  async sendTalk(host, port, payload) {
+    await sendTalkUdp(host, port, payload);
+  },
+  async sendTalkTcp(options) {
+    return sendTalkTcpCommands(options);
+  },
+  listenForOsc(host, port, predicate, timeoutMs) {
+    const socket = dgram2.createSocket("udp4");
+    const readyDeferred = createDeferred();
+    let settled = false;
+    let closeListener = () => {
+    };
+    const message = new Promise((resolve, reject) => {
+      const timer = setTimeout(
+        () => {
+          const timeoutError = new Error(`Timed out waiting for OSC callback after ${timeoutMs}ms.`);
+          readyDeferred.reject(timeoutError);
+          finish(() => reject(timeoutError));
+        },
+        Math.max(1, timeoutMs)
+      );
+      const finish = (settle) => {
+        if (settled) {
+          return;
+        }
+        settled = true;
+        clearTimeout(timer);
+        try {
+          socket.close();
+        } catch {
+        }
+        settle();
+      };
+      closeListener = () => {
+        const closeError = new Error("OSC listener closed before callback.");
+        readyDeferred.reject(closeError);
+        finish(() => reject(closeError));
+      };
+      socket.on("error", (error2) => {
+        const msg = error2 instanceof Error ? error2.message : String(error2);
+        const bindError = new Error(`OSC listener failed on ${host}:${port}: ${msg}`);
+        readyDeferred.reject(bindError);
+        finish(() => reject(bindError));
+      });
+      socket.on("listening", () => {
+        readyDeferred.resolve();
+      });
+      socket.on("message", (payload, rinfo) => {
+        let decoded;
+        try {
+          decoded = {
+            ...decodeOscPacket(payload),
+            sourceAddress: rinfo.address,
+            sourcePort: rinfo.port
+          };
+        } catch {
+          return;
+        }
+        if (predicate(decoded)) {
+          finish(() => resolve(decoded));
+        }
+      });
+    });
+    socket.bind(Number(port), host);
+    return { ready: readyDeferred.promise, message, close: closeListener };
+  }
+};
+function createDeferred() {
+  let resolve = () => {
+  };
+  let reject = () => {
+  };
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
   });
-  const next = previous.catch(() => void 0).then(() => tail);
-  oscPortLocks.set(key, next);
-  await previous.catch(() => void 0);
-  let released = false;
-  return () => {
-    if (released) return;
-    released = true;
-    releaseTail();
-    if (oscPortLocks.get(key) === next) {
-      oscPortLocks.delete(key);
+  let settled = false;
+  return {
+    promise,
+    resolve: (value) => {
+      if (settled) return;
+      settled = true;
+      resolve(value);
+    },
+    reject: (error2) => {
+      if (settled) return;
+      settled = true;
+      reject(error2);
     }
   };
 }
-async function withOscPortLock(options, operation) {
-  const release = await acquireOscPortLock(options);
-  try {
-    return await operation();
-  } finally {
-    release();
+
+// ../src/runtime/readback/readbackOscCallbacks.ts
+function expectedReadbackOscSourceHosts(options) {
+  const transport = options.talkTransport ?? "udp";
+  if (transport === "tcp") {
+    return [options.talkTcpHost ?? options.talkHost];
   }
+  if (transport === "auto") {
+    const tcpHost = options.talkTcpHost ?? options.talkHost;
+    const udpHost = options.talkUdpHost ?? options.talkHost;
+    return options.talkUdpFallbackAllowed ? uniqueDefinedHosts([tcpHost, udpHost]) : [tcpHost];
+  }
+  return [options.talkUdpHost ?? options.talkHost];
+}
+function isExpectedOscCallback(message, expected) {
+  if (message.address !== expected.address) return false;
+  if (message.typeTags !== expected.typeTags) return false;
+  if (!sourceMatchesAnyExpectedHost(message, expected.expectedSourceHosts)) return false;
+  if (expected.expectedArgs) {
+    if (message.args.length !== expected.expectedArgs.length) return false;
+    return expected.expectedArgs.every((arg, index) => message.args[index] === arg);
+  }
+  if (message.args.length !== expected.typeTags.length) return false;
+  return expected.typeTags.split("").every((tag, index) => argMatchesTypeTag(message.args[index], tag));
+}
+function assertExpectedOscCallback(message, expected) {
+  if (!isExpectedOscCallback(message, expected)) {
+    throw new Error(`Unexpected OSC callback for ${expected.address}.`);
+  }
+}
+function uniqueDefinedHosts(hosts) {
+  return [...new Set(hosts.filter((host) => host.trim().length > 0))];
+}
+function sourceMatchesAnyExpectedHost(message, expectedHosts) {
+  return expectedHosts.length === 0 || expectedHosts.some((host) => sourceMatchesExpectedHost(message, host));
+}
+function argMatchesTypeTag(arg, tag) {
+  if (tag === "s") return typeof arg === "string";
+  if (tag === "i") return typeof arg === "number" && Number.isInteger(arg);
+  if (tag === "f") return typeof arg === "number" && Number.isFinite(arg);
+  return false;
 }
 
-// ../src/runtime/readback/beyondReadback.ts
+// ../src/runtime/readback/readbackPropertyPath.ts
 var PROPERTY_ROOT2 = String.raw`(?:FB[34][-_][A-Za-z0-9]+|[A-Za-z_][A-Za-z0-9_]*|#[0-9]+)(?:\[[0-9]+\])*`;
 var PROPERTY_SEGMENT = String.raw`(?:[A-Za-z_][A-Za-z0-9_]*|[0-9]+)(?:\[[0-9]+\])*`;
 var PROPERTY_PATH_RE = new RegExp(`^${PROPERTY_ROOT2}(?:\\.${PROPERTY_SEGMENT})+$`);
-var REQUEST_ID_BYTES = 16;
-function createReadbackRequestId(prefix = "pangolint") {
-  return `${prefix}-${randomBytes(REQUEST_ID_BYTES).toString("hex")}`;
-}
 function validateReadbackPropertyPath(path10) {
   const trimmed = path10.trim();
   if (path10 !== trimmed || !PROPERTY_PATH_RE.test(trimmed)) {
@@ -22049,9 +22180,71 @@ function validateReadbackPropertyPath(path10) {
   }
   return void 0;
 }
+
+// ../src/runtime/readback/readbackRequestId.ts
+import { randomBytes } from "node:crypto";
+var REQUEST_ID_BYTES = 16;
+function createReadbackRequestId(prefix = "pangolint") {
+  return `${prefix}-${randomBytes(REQUEST_ID_BYTES).toString("hex")}`;
+}
+
+// ../src/runtime/readback/readbackScriptLines.ts
+function propertyReadbackScriptLines(address, typeTag, propertyPath, options) {
+  if (usesStatusProducingReadbackLine(options)) {
+    return [`OscOutTTS "${address}", "${typeTag}", ${propertyPath}`];
+  }
+  return ["var v", `v = ${propertyPath}`, `OscOutTTS "${address}", "${typeTag}", v`];
+}
+function usesStatusProducingReadbackLine(options) {
+  const transport = options.talkTransport ?? "udp";
+  return transport === "tcp" || transport === "auto";
+}
+
+// ../src/runtime/readback/readbackTalk.ts
+async function sendReadbackTalk(commands, options, transport) {
+  return runScript(commands.join("\n"), {
+    talkHost: options.talkHost,
+    talkPort: options.talkPort,
+    talkTransport: options.talkTransport ?? "udp",
+    talkTcpHost: options.talkTcpHost,
+    talkTcpPort: options.talkTcpPort,
+    talkUdpHost: options.talkUdpHost ?? options.talkHost,
+    talkUdpPort: options.talkUdpPort ?? options.talkPort,
+    talkUdpFallbackAllowed: options.talkUdpFallbackAllowed,
+    talkTcpPassword: options.talkTcpPassword,
+    commandTimeoutMs: options.commandTimeoutMs ?? options.timeoutMs,
+    send: transport.sendTalk,
+    sendTcp: transport.sendTalkTcp
+  });
+}
+function readbackTalkStatus(result) {
+  return {
+    transport: result.transport,
+    talkStatus: result.talkStatus,
+    talkGreeting: result.talkGreeting,
+    talkReplies: result.talkReplies,
+    beyondError: result.beyondError,
+    linesSent: result.linesSent,
+    payloadsSent: result.payloadsSent,
+    bytesSent: result.bytesSent
+  };
+}
+function udpPayloadPreflightError(commands, options) {
+  if (!readbackUdpMayBeUsed(options)) {
+    return void 0;
+  }
+  const payloads = buildTalkPayloads([...commands]);
+  return payloads.length > 1 ? "Script exceeded payload limit." : void 0;
+}
+function readbackUdpMayBeUsed(options) {
+  const transport = options.talkTransport ?? "udp";
+  return transport === "udp" || transport === "auto" && options.talkUdpFallbackAllowed === true;
+}
+
+// ../src/runtime/readback/beyondReadback.ts
 async function readBeyondProperty(options, transport = nodeReadbackTransport) {
   const { logger } = options;
-  const requestId = options.requestId ?? createRequestId();
+  const requestId = options.requestId ?? createReadbackRequestId();
   const typeTag = options.typeTag ?? "f";
   const address = `/pangolint/readback/${requestId}`;
   const pathError = validateReadbackPropertyPath(options.propertyPath);
@@ -22144,196 +22337,12 @@ async function readBeyondProperty(options, transport = nodeReadbackTransport) {
     return { ok: false, requestId, propertyPath: options.propertyPath, script, error: msg };
   }
 }
-function propertyReadbackScriptLines(address, typeTag, propertyPath, options) {
-  if (usesStatusProducingReadbackLine(options)) {
-    return [`OscOutTTS "${address}", "${typeTag}", ${propertyPath}`];
-  }
-  return ["var v", `v = ${propertyPath}`, `OscOutTTS "${address}", "${typeTag}", v`];
-}
-function usesStatusProducingReadbackLine(options) {
-  const transport = options.talkTransport ?? "udp";
-  return transport === "tcp" || transport === "auto";
-}
-async function sendReadbackTalk(commands, options, transport) {
-  return runScript(commands.join("\n"), {
-    talkHost: options.talkHost,
-    talkPort: options.talkPort,
-    talkTransport: options.talkTransport ?? "udp",
-    talkTcpHost: options.talkTcpHost,
-    talkTcpPort: options.talkTcpPort,
-    talkUdpHost: options.talkUdpHost ?? options.talkHost,
-    talkUdpPort: options.talkUdpPort ?? options.talkPort,
-    talkUdpFallbackAllowed: options.talkUdpFallbackAllowed,
-    talkTcpPassword: options.talkTcpPassword,
-    commandTimeoutMs: options.commandTimeoutMs ?? options.timeoutMs,
-    send: transport.sendTalk,
-    sendTcp: transport.sendTalkTcp
-  });
-}
-function readbackTalkStatus(result) {
-  return {
-    transport: result.transport,
-    talkStatus: result.talkStatus,
-    talkGreeting: result.talkGreeting,
-    talkReplies: result.talkReplies,
-    beyondError: result.beyondError,
-    linesSent: result.linesSent,
-    payloadsSent: result.payloadsSent,
-    bytesSent: result.bytesSent
-  };
-}
-function udpPayloadPreflightError(commands, options) {
-  if (!readbackUdpMayBeUsed(options)) {
-    return void 0;
-  }
-  const payloads = buildTalkPayloads([...commands]);
-  return payloads.length > 1 ? "Script exceeded payload limit." : void 0;
-}
-function readbackUdpMayBeUsed(options) {
-  const transport = options.talkTransport ?? "udp";
-  return transport === "udp" || transport === "auto" && options.talkUdpFallbackAllowed === true;
-}
-function expectedReadbackOscSourceHosts(options) {
-  const transport = options.talkTransport ?? "udp";
-  if (transport === "tcp") {
-    return [options.talkTcpHost ?? options.talkHost];
-  }
-  if (transport === "auto") {
-    const tcpHost = options.talkTcpHost ?? options.talkHost;
-    const udpHost = options.talkUdpHost ?? options.talkHost;
-    return options.talkUdpFallbackAllowed ? uniqueDefinedHosts([tcpHost, udpHost]) : [tcpHost];
-  }
-  return [options.talkUdpHost ?? options.talkHost];
-}
-function uniqueDefinedHosts(hosts) {
-  return [...new Set(hosts.filter((host) => host.trim().length > 0))];
-}
 function closeReadbackOscListener(listener) {
   try {
     listener.close?.();
   } catch {
   }
 }
-function isExpectedOscCallback(message, expected) {
-  if (message.address !== expected.address) return false;
-  if (message.typeTags !== expected.typeTags) return false;
-  if (!sourceMatchesAnyExpectedHost(message, expected.expectedSourceHosts)) return false;
-  if (expected.expectedArgs) {
-    if (message.args.length !== expected.expectedArgs.length) return false;
-    return expected.expectedArgs.every((arg, index) => message.args[index] === arg);
-  }
-  if (message.args.length !== expected.typeTags.length) return false;
-  return expected.typeTags.split("").every((tag, index) => argMatchesTypeTag(message.args[index], tag));
-}
-function sourceMatchesAnyExpectedHost(message, expectedHosts) {
-  return expectedHosts.length === 0 || expectedHosts.some((host) => sourceMatchesExpectedHost(message, host));
-}
-function assertExpectedOscCallback(message, expected) {
-  if (!isExpectedOscCallback(message, expected)) {
-    throw new Error(`Unexpected OSC callback for ${expected.address}.`);
-  }
-}
-function argMatchesTypeTag(arg, tag) {
-  if (tag === "s") return typeof arg === "string";
-  if (tag === "i") return typeof arg === "number" && Number.isInteger(arg);
-  if (tag === "f") return typeof arg === "number" && Number.isFinite(arg);
-  return false;
-}
-var nodeReadbackTransport = {
-  async sendTalk(host, port, payload) {
-    await sendTalkUdp(host, port, payload);
-  },
-  async sendTalkTcp(options) {
-    return sendTalkTcpCommands(options);
-  },
-  listenForOsc(host, port, predicate, timeoutMs) {
-    const socket = dgram2.createSocket("udp4");
-    const readyDeferred = createDeferred();
-    let settled = false;
-    let closeListener = () => {
-    };
-    const message = new Promise((resolve, reject) => {
-      const timer = setTimeout(
-        () => {
-          const timeoutError = new Error(`Timed out waiting for OSC callback after ${timeoutMs}ms.`);
-          readyDeferred.reject(timeoutError);
-          finish(() => reject(timeoutError));
-        },
-        Math.max(1, timeoutMs)
-      );
-      const finish = (settle) => {
-        if (settled) {
-          return;
-        }
-        settled = true;
-        clearTimeout(timer);
-        try {
-          socket.close();
-        } catch {
-        }
-        settle();
-      };
-      closeListener = () => {
-        const closeError = new Error("OSC listener closed before callback.");
-        readyDeferred.reject(closeError);
-        finish(() => reject(closeError));
-      };
-      socket.on("error", (error2) => {
-        const msg = error2 instanceof Error ? error2.message : String(error2);
-        const bindError = new Error(`OSC listener failed on ${host}:${port}: ${msg}`);
-        readyDeferred.reject(bindError);
-        finish(() => reject(bindError));
-      });
-      socket.on("listening", () => {
-        readyDeferred.resolve();
-      });
-      socket.on("message", (payload, rinfo) => {
-        let decoded;
-        try {
-          decoded = {
-            ...decodeOscPacket(payload),
-            sourceAddress: rinfo.address,
-            sourcePort: rinfo.port
-          };
-        } catch {
-          return;
-        }
-        if (predicate(decoded)) {
-          finish(() => resolve(decoded));
-        }
-      });
-    });
-    socket.bind(Number(port), host);
-    return { ready: readyDeferred.promise, message, close: closeListener };
-  }
-};
-function createRequestId() {
-  return createReadbackRequestId("pangolint");
-}
-function createDeferred() {
-  let resolve = () => {
-  };
-  let reject = () => {
-  };
-  const promise = new Promise((res, rej) => {
-    resolve = res;
-    reject = rej;
-  });
-  let settled = false;
-  return {
-    promise,
-    resolve: (value) => {
-      if (settled) return;
-      settled = true;
-      resolve(value);
-    },
-    reject: (error2) => {
-      if (settled) return;
-      settled = true;
-      reject(error2);
-    }
-  };
-}
 
 // ../src/extensionHost/extensionIds.ts
 var EXTENSION_CONFIG_SECTIONS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pangolint-mcp",
-  "version": "0.7.20",
+  "version": "0.7.28",
   "description": "MCP server exposing PangoLint's curated PangoScript knowledge to AI coding agents.",
   "license": "GPL-3.0-or-later",
   "repository": {