mcp-grampsweb 1.0.2 → 1.2.0

package/dist/utils/response.js

@@ -0,0 +1,71 @@
+/**
+ * Structured response formatting for LLM consumption
+ */
+/**
+ * Format a tool response with consistent structure for LLM parsing.
+ *
+ * Output format:
+ * **Status:** success|empty|error
+ * **Summary:** Brief description of what happened
+ *
+ * **Data:**
+ * ```json
+ * { ... structured data ... }
+ * ```
+ *
+ * **Details:**
+ * Additional context or next steps
+ */
+export function formatToolResponse(opts) {
+    const lines = [
+        `**Status:** ${opts.status}`,
+        `**Summary:** ${opts.summary}`,
+    ];
+    if (opts.data && Object.keys(opts.data).length > 0) {
+        lines.push("", "**Data:**", "```json", JSON.stringify(opts.data, null, 2), "```");
+    }
+    if (opts.details) {
+        lines.push("", "**Details:**", opts.details);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a list of entities for LLM consumption
+ */
+export function formatEntityList(entityType, entities, totalCount) {
+    if (entities.length === 0) {
+        return formatToolResponse({
+            status: "empty",
+            summary: `No ${entityType} found`,
+            details: "Try broadening your search query or checking for typos.",
+        });
+    }
+    const data = {
+        count: entities.length,
+        results: entities,
+    };
+    if (totalCount !== undefined && totalCount > entities.length) {
+        data.total_count = totalCount;
+        data.has_more = true;
+    }
+    return formatToolResponse({
+        status: "success",
+        summary: `Found ${entities.length} ${entityType}${entities.length !== 1 ? "s" : ""}`,
+        data,
+        details: totalCount && totalCount > entities.length
+            ? `Showing ${entities.length} of ${totalCount} results. Use page/pagesize params for more.`
+            : undefined,
+    });
+}
+/**
+ * Format a created entity response with actionable next steps
+ */
+export function formatCreatedEntity(entityType, displayName, entityData, nextSteps) {
+    return formatToolResponse({
+        status: "success",
+        summary: `Created ${entityType}: ${displayName}`,
+        data: entityData,
+        details: nextSteps,
+    });
+}
+//# sourceMappingURL=response.js.map

package/dist/utils/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAyB;IAC1D,MAAM,KAAK,GAAG;QACZ,eAAe,IAAI,CAAC,MAAM,EAAE;QAC5B,gBAAgB,IAAI,CAAC,OAAO,EAAE;KAC/B,CAAC;IAEF,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,QAAwC,EACxC,UAAmB;IAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,kBAAkB,CAAC;YACxB,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,MAAM,UAAU,QAAQ;YACjC,OAAO,EAAE,yDAAyD;SACnE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAA4B;QACpC,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,OAAO,EAAE,QAAQ;KAClB,CAAC;IAEF,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC7D,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,OAAO,kBAAkB,CAAC;QACxB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS,QAAQ,CAAC,MAAM,IAAI,UAAU,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpF,IAAI;QACJ,OAAO,EAAE,UAAU,IAAI,UAAU,GAAG,QAAQ,CAAC,MAAM;YACjD,CAAC,CAAC,WAAW,QAAQ,CAAC,MAAM,OAAO,UAAU,8CAA8C;YAC3F,CAAC,CAAC,SAAS;KACd,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,WAAmB,EACnB,UAAmC,EACnC,SAAkB;IAElB,OAAO,kBAAkB,CAAC;QACxB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,WAAW,UAAU,KAAK,WAAW,EAAE;QAChD,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-grampsweb",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "MCP server for Gramps Web genealogy API",
   "type": "module",
   "main": "./dist/index.js",