@leanmcp/core 0.3.11 → 0.3.12

package/README.md

@@ -36,6 +36,7 @@
 - **Schema Generation** — Declarative JSON Schema with `@SchemaConstraint` decorators
 - **HTTP Transport** — Production-ready HTTP server with session management
 - **Input Validation** — Built-in AJV validation for all inputs
+- **Structured Content** — Automatic `structuredContent` for ChatGPT Apps SDK compatibility
 - **MCP Compliant** — Built on official `@modelcontextprotocol/sdk`
 
 ## Installation
@@ -358,6 +359,42 @@ export class SlackService {
 
 ---
 
+## Structured Content
+
+Tool return values are automatically exposed as `structuredContent` in the MCP response, enabling ChatGPT Apps SDK compatibility.
+
+**Automatic Handling:**
+
+```typescript
+@Tool({ description: 'List channels' })
+async listChannels() {
+  // Return a plain object - it becomes structuredContent automatically
+  return { channels: [...] };
+}
+```
+
+The response includes both `content` (text) and `structuredContent` (object):
+
+```json
+{
+  "content": [{ "type": "text", "text": "{\"channels\": [...]}" }],
+  "structuredContent": { "channels": [...] }
+}
+```
+
+**Manual MCP Response:**
+
+If your tool returns a manual MCP response (with `content` array), the SDK extracts data from `content[0].text`:
+
+```typescript
+return {
+  content: [{ type: 'text', text: JSON.stringify({ channels }) }]
+};
+// structuredContent will be { channels: [...] }
+```
+
+---
+
 ## HTTP Endpoints
 
 | Endpoint | Method | Description |

package/dist/index.js

@@ -1161,10 +1161,27 @@ var init_index = __esm({
             const meta = request.params._meta;
             const result = await tool.method.call(tool.instance, request.params.arguments, meta);
             let formattedResult = result;
+            let structuredContent = void 0;
             if (methodMeta.renderFormat === "markdown" && typeof result === "string") {
               formattedResult = result;
-            } else if (methodMeta.renderFormat === "json" || typeof result === "object") {
-              formattedResult = JSON.stringify(result, null, 2);
+            } else if (typeof result === "object" && result !== null) {
+              if ("structuredContent" in result && Object.keys(result).length === 1) {
+                structuredContent = result.structuredContent;
+                formattedResult = JSON.stringify(structuredContent, null, 2);
+              } else if ("content" in result && Array.isArray(result.content)) {
+                const textItem = result.content.find((c) => c.type === "text");
+                if (textItem?.text) {
+                  try {
+                    structuredContent = JSON.parse(textItem.text);
+                  } catch {
+                    structuredContent = textItem.text;
+                  }
+                }
+                formattedResult = JSON.stringify(result, null, 2);
+              } else {
+                structuredContent = result;
+                formattedResult = JSON.stringify(result, null, 2);
+              }
             } else {
               formattedResult = String(result);
             }
@@ -1176,6 +1193,12 @@ var init_index = __esm({
                 }
               ]
             };
+            if (structuredContent) {
+              response.structuredContent = structuredContent;
+              if (this.logger) {
+                this.logger.debug(`[MCPServer] Setting structuredContent: ${JSON.stringify(structuredContent).slice(0, 100)}...`);
+              }
+            }
             if (tool._meta && Object.keys(tool._meta).length > 0) {
               response._meta = tool._meta;
             }

package/dist/index.mjs

@@ -1058,10 +1058,27 @@ var MCPServer = class {
         const meta = request.params._meta;
         const result = await tool.method.call(tool.instance, request.params.arguments, meta);
         let formattedResult = result;
+        let structuredContent = void 0;
         if (methodMeta.renderFormat === "markdown" && typeof result === "string") {
           formattedResult = result;
-        } else if (methodMeta.renderFormat === "json" || typeof result === "object") {
-          formattedResult = JSON.stringify(result, null, 2);
+        } else if (typeof result === "object" && result !== null) {
+          if ("structuredContent" in result && Object.keys(result).length === 1) {
+            structuredContent = result.structuredContent;
+            formattedResult = JSON.stringify(structuredContent, null, 2);
+          } else if ("content" in result && Array.isArray(result.content)) {
+            const textItem = result.content.find((c) => c.type === "text");
+            if (textItem?.text) {
+              try {
+                structuredContent = JSON.parse(textItem.text);
+              } catch {
+                structuredContent = textItem.text;
+              }
+            }
+            formattedResult = JSON.stringify(result, null, 2);
+          } else {
+            structuredContent = result;
+            formattedResult = JSON.stringify(result, null, 2);
+          }
         } else {
           formattedResult = String(result);
         }
@@ -1073,6 +1090,12 @@ var MCPServer = class {
             }
           ]
         };
+        if (structuredContent) {
+          response.structuredContent = structuredContent;
+          if (this.logger) {
+            this.logger.debug(`[MCPServer] Setting structuredContent: ${JSON.stringify(structuredContent).slice(0, 100)}...`);
+          }
+        }
         if (tool._meta && Object.keys(tool._meta).length > 0) {
           response._meta = tool._meta;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/core",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "description": "Core library implementing decorators, reflection, and MCP runtime server",
   "main": "dist/index.js",
   "module": "dist/index.mjs",