@homespunapps/mcp 1.6.42 → 1.6.44

package/dist/guide.d.ts

@@ -5,8 +5,17 @@
  */
 export declare function extractCore(skillMarkdown: string): string;
 /**
- * Build the full MCP guide: the MCP invocation layer followed by the shared
- * conceptual core extracted from SKILL.md. `mcpInvocation` is the contents of
- * skills/homespun/MCP-INVOCATION.md; `skillMarkdown` is the contents of SKILL.md.
+ * Build the full MCP guide: the MCP invocation layer, the shared conceptual
+ * core extracted from SKILL.md, then every reference section appended in the
+ * order given. `mcpInvocation` is the contents of skills/homespun/MCP-INVOCATION.md;
+ * `skillMarkdown` is the contents of SKILL.md; `references` is the contents of
+ * skills/homespun/references/*.md.
+ *
+ * The references are INLINED here rather than left behind a pointer, because an
+ * MCP client has no filesystem to read them from and no `homespun skill show`
+ * to fetch them with: the guide is the whole of what it gets. A file-based
+ * agent reads SKILL.md's pointer and loads the same file on demand, so the two
+ * transports carry the same content by different routes. That asymmetry is the
+ * point: the pointer saves context only where the reader can act on it.
  */
-export declare function composeMcpGuide(mcpInvocation: string, skillMarkdown: string): string;
+export declare function composeMcpGuide(mcpInvocation: string, skillMarkdown: string, references?: readonly string[]): string;

package/dist/guide.js

@@ -40,11 +40,22 @@ export function extractCore(skillMarkdown) {
     return blocks.join("\n\n");
 }
 /**
- * Build the full MCP guide: the MCP invocation layer followed by the shared
- * conceptual core extracted from SKILL.md. `mcpInvocation` is the contents of
- * skills/homespun/MCP-INVOCATION.md; `skillMarkdown` is the contents of SKILL.md.
+ * Build the full MCP guide: the MCP invocation layer, the shared conceptual
+ * core extracted from SKILL.md, then every reference section appended in the
+ * order given. `mcpInvocation` is the contents of skills/homespun/MCP-INVOCATION.md;
+ * `skillMarkdown` is the contents of SKILL.md; `references` is the contents of
+ * skills/homespun/references/*.md.
+ *
+ * The references are INLINED here rather than left behind a pointer, because an
+ * MCP client has no filesystem to read them from and no `homespun skill show`
+ * to fetch them with: the guide is the whole of what it gets. A file-based
+ * agent reads SKILL.md's pointer and loads the same file on demand, so the two
+ * transports carry the same content by different routes. That asymmetry is the
+ * point: the pointer saves context only where the reader can act on it.
  */
-export function composeMcpGuide(mcpInvocation, skillMarkdown) {
+export function composeMcpGuide(mcpInvocation, skillMarkdown, references = []) {
     const core = extractCore(skillMarkdown);
-    return `${mcpInvocation.trim()}\n\n${core}\n`;
+    const refs = references.map((r) => r.trim()).filter((r) => r.length > 0);
+    const tail = refs.length > 0 ? `\n\n${refs.join("\n\n")}` : "";
+    return `${mcpInvocation.trim()}\n\n${core}${tail}\n`;
 }

package/dist/tools.js

@@ -715,7 +715,7 @@ const communityShape = {
     slug: z
         .string()
         .optional()
-        .describe("publish only. Optional per-publisher slug (lowercase, 3 to 48 chars, hyphens). Gives the template a namespaced id <your-handle>/<slug>; a republish reuses the slug and must bump the version."),
+        .describe("publish only. Optional per-publisher slug (lowercase, 3 to 48 chars, hyphens). Gives the template a namespaced id <your-handle>/<slug>; a republish reuses the slug and must bump the version. If omitted, a slug is derived from the title instead of leaving the template unnamed, so pass one only when you want a specific url. Slugs are immutable: renaming the template later does not move its url, so choose a slug you are willing to keep."),
     version: z
         .string()
         .optional()

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.6.42";
+export declare const VERSION = "1.6.44";

package/dist/version.js

@@ -1,3 +1,3 @@
 // Single source of the package version, reported in the MCP server's
 // serverInfo. Kept in sync with package.json by the release tooling.
-export const VERSION = "1.6.42";
+export const VERSION = "1.6.44";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@homespunapps/mcp",
   "mcpName": "dev.homespun/homespun",
-  "version": "1.6.42",
+  "version": "1.6.44",
   "description": "Model Context Protocol (stdio) server for Homespun: lets any MCP client (Claude Desktop, Cursor, …) deploy a multi-user web app with hosting, auth, a shared database and permissions included.",
   "license": "MIT",
   "type": "module",
@@ -46,7 +46,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@homespunapps/core": "^1.6.42",
+    "@homespunapps/core": "^1.6.44",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/server.json

@@ -3,14 +3,14 @@
   "name": "dev.homespun/homespun",
   "title": "Homespun",
   "description": "Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.",
-  "version": "1.6.42",
+  "version": "1.6.44",
   "websiteUrl": "https://docs.homespun.dev",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@homespunapps/mcp",
-      "version": "1.6.42",
+      "version": "1.6.44",
       "transport": {
         "type": "stdio"
       },