kibi-mcp 3.7.0 → 3.8.0

package/dist/server/tools.js

@@ -57,6 +57,53 @@ function withAgentVisibleText(content, data) {
     const text = summary.length > 0 ? `${payload}\n${summary}` : payload;
     return [{ type: "text", text }, ...nonTextParts];
 }
+// implements REQ-mcp-structured-text-per-host
+const STRUCTURED_TEXT_ENV = "KIBI_MCP_STRUCTURED_TEXT";
+/**
+ * Hosts known to show `structuredContent` to the agent. Embedding the data
+ * JSON in the text part would hand them every discovery result twice.
+ */
+const HOSTS_READING_STRUCTURED_CONTENT = new Set([
+    "claude-code",
+]);
+/** `Claude Code`, `claude_code` and `claude-code` name the same host. */
+function hostKey(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+/** The client name the host sent on initialize, when the server has one. */
+function clientName(server) {
+    try {
+        const name = server?.server?.getClientVersion?.()?.name;
+        return typeof name === "string" ? hostKey(name) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// implements REQ-mcp-structured-text-per-host
+/**
+ * Whether an opted-in tool embeds its data JSON in the text part. The copy
+ * exists for hosts that hide `structuredContent`; a host that reads it gets
+ * the summary alone. `KIBI_MCP_STRUCTURED_TEXT=embed|omit` decides outright;
+ * otherwise the host named by `KIBI_MCP_HOST` (set by the host launchers) or
+ * by the client's initialize name decides, and an unknown host keeps the copy.
+ */
+export function embedsStructuredText(server, env = process.env) {
+    const explicit = env[STRUCTURED_TEXT_ENV]?.trim().toLowerCase();
+    if (explicit === "embed")
+        return true;
+    if (explicit === "omit")
+        return false;
+    const host = env.KIBI_MCP_HOST === undefined ? "" : hostKey(env.KIBI_MCP_HOST);
+    if (host !== "" && HOSTS_READING_STRUCTURED_CONTENT.has(host))
+        return false;
+    const client = clientName(server);
+    return !(client !== undefined && HOSTS_READING_STRUCTURED_CONTENT.has(client));
+}
 // implements REQ-002
 function debugLog(...args) {
     if (isMcpDebugEnabled()) {
@@ -331,7 +378,8 @@ runtime = DEFAULT_TOOLS_RUNTIME, spec, annotations, outputSchema) {
                     !Array.isArray(result) &&
                     "content" in result) {
                     const withContent = result;
-                    const content = operationSpec.agentVisibleStructuredData === true
+                    const content = operationSpec.agentVisibleStructuredData === true &&
+                        embedsStructuredText(server)
                         ? withAgentVisibleText(withContent.content, data)
                         : withContent.content;
                     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-mcp",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "mcpName": "io.github.Looted/kibi-mcp",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.1",
@@ -10,8 +10,8 @@
     "fast-glob": "^3.2.12",
     "gray-matter": "^4.0.3",
     "js-yaml": "^4.1.0",
-    "kibi-runtime": "^2.14.0",
-    "kibi-core": "^0.20.0",
+    "kibi-runtime": "^2.14.1",
+    "kibi-core": "^0.21.0",
     "zod": "^4.3.6"
   },
   "type": "module",