@neopress/mcp 0.1.0 → 0.2.0

package/dist/bin.cjs

@@ -30619,6 +30619,29 @@ var AnalyticsEndpoint = class {
   }
 };
 
+// ../sdk/dist/endpoints/templates.js
+var TemplatesEndpoint = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  get basePath() {
+    return `${this.client.siteBasePath}/template`;
+  }
+  async get() {
+    const res = await this.client.get(this.basePath);
+    return res.data;
+  }
+  async mark(data) {
+    const res = await this.client.post(this.basePath, data);
+    return res.data;
+  }
+  async delete() {
+    const res = await this.client.delete(this.basePath);
+    return res.data;
+  }
+};
+
 // ../sdk/dist/client.js
 var NeopressClient = class {
   baseUrl;
@@ -30635,6 +30658,7 @@ var NeopressClient = class {
   publish;
   entryReferences;
   analytics;
+  templates;
   constructor(options) {
     this.baseUrl = (options.baseUrl || "https://app.neopress.ai").replace(/\/$/, "");
     this.accessToken = options.accessToken || "";
@@ -30650,6 +30674,7 @@ var NeopressClient = class {
     this.publish = new PublishEndpoint(this);
     this.entryReferences = new EntryReferencesEndpoint(this);
     this.analytics = new AnalyticsEndpoint(this);
+    this.templates = new TemplatesEndpoint(this);
   }
   get siteBasePath() {
     return `/api/v1/sites/${this.siteId}`;
@@ -30680,7 +30705,13 @@ var NeopressClient = class {
       throw new NeopressApiError("CONNECTION_ERROR", `Cannot connect to ${this.baseUrl} \u2014 is the dev server running?`, 0);
     }
     clearTimeout(timeout);
-    const json2 = await response.json();
+    const responseText = await response.text();
+    let json2;
+    try {
+      json2 = responseText ? JSON.parse(responseText) : {};
+    } catch {
+      throw new NeopressApiError("NON_JSON_RESPONSE", `Expected JSON from ${method} ${url2} but received non-JSON response (${response.status} ${response.statusText})`, response.status, { body: responseText.slice(0, 500) });
+    }
     if (!response.ok) {
       const err = json2?.error || {};
       throw new NeopressApiError(err.code || "UNKNOWN", err.message || response.statusText, response.status, json2);
@@ -30871,6 +30902,16 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 - Generated page TSX is sandboxed. Do not import Supabase, create API clients, read env vars, use filesystem/process APIs, or assume arbitrary npm packages.
 - Use allowed runtime packages only: React/Next basics, shadcn UI imports, lucide-react, date-fns, framer-motion, @neopress/content, @neopress/routing, @neopress/i18n, and @neopress/forms.
 
+## Templates
+
+- Reusable templates are normal Neopress sites marked by a \`templates\` metadata row.
+- \`templates.id\` equals \`sites.id\`.
+- Build layout, pages, collections, entries, forms, assets, compile, publish, and verify before marking a finished template.
+- Use \`neopress_template_mark\` to create or update the metadata row with \`name\`, \`industry\`, required \`referenceUrl\`, optional \`description\`, and optional \`previewImgUrls\`.
+- \`referenceUrl\` is a single http(s) provenance URL. \`description\` is an optional summary of the template (max 150 characters).
+- Template metadata does not replace page TSX, CMS content, forms, or publish state.
+- Use \`neopress_template_delete\` only for explicit template-site hard deletion. It removes the metadata row and connected site.
+
 ## Dynamic pages and queryConfig
 
 - Dynamic pages require a collection, a page path like \`/blog/[slug]\`, a numeric \`collectionId\`, matching entries, entry publish, page compile, and site publish.
@@ -30904,6 +30945,7 @@ var SERVER_INSTRUCTIONS = `Use Neopress MCP tools to manage a selected Neopress
 
 Before generating TSX or schema-backed pages, call neopress_get_runtime_contract or read neopress://runtime-contract.
 Use numeric IDs returned by tools. Publish entries separately from site publish. Use read-only analytics tools before autopilot recommendations. Verify production URLs after production publish.
+For reusable templates, build and publish the real site resources first, then call neopress_template_mark with template metadata.
 For reference-page copy, do the reference crawling, screenshots, DOM/CSS/SVG/background-image analysis, and TSX generation in the host agent; MCP only writes and verifies Neopress resources.`;
 
 // src/result.ts
@@ -30950,6 +30992,10 @@ var optionalJsonSchema = external_exports.unknown().optional();
 var requiredJsonSchema = external_exports.unknown().refine((value) => value !== void 0, "Required JSON value is missing.");
 var analyticsParamSchema = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean()]);
 var analyticsParamsSchema = external_exports.record(external_exports.string(), analyticsParamSchema).optional();
+var httpUrlSchema = external_exports.string().url().refine((value) => {
+  const url2 = new URL(value);
+  return url2.protocol === "http:" || url2.protocol === "https:";
+}, "Must be an http(s) URL.");
 var analyticsDateShape = {
   dateFrom: external_exports.string().optional(),
   dateTo: external_exports.string().optional(),
@@ -30994,7 +31040,8 @@ var READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
   "neopress_search_console_query",
   "neopress_assets_list",
   "neopress_asset_get",
-  "neopress_publish_preview"
+  "neopress_publish_preview",
+  "neopress_template_get"
 ]);
 var DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
   "neopress_site_update",
@@ -31012,6 +31059,7 @@ var DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
   "neopress_form_publish",
   "neopress_form_delete",
   "neopress_asset_delete",
+  "neopress_template_mark",
   "neopress_publish_site"
 ]);
 var PUBLICATION_TOOLS = /* @__PURE__ */ new Set([
@@ -31186,6 +31234,49 @@ var toolDefinitions = [
       });
     }
   },
+  {
+    name: "neopress_template_get",
+    title: "Get Template Metadata",
+    description: "Get template metadata for the active or specified site.",
+    inputSchema: siteIdShape,
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.get();
+    }
+  },
+  {
+    name: "neopress_template_mark",
+    title: "Mark Site As Template",
+    description: "Create or update the template metadata row for a finished template site. The template id is the site id.",
+    inputSchema: {
+      ...siteIdShape,
+      name: external_exports.string(),
+      description: external_exports.string().max(150).optional(),
+      industry: external_exports.string(),
+      referenceUrl: httpUrlSchema,
+      previewImgUrls: external_exports.array(external_exports.string()).nullable().optional()
+    },
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.mark({
+        name: asString(input, "name"),
+        description: asOptionalString(input, "description"),
+        industry: asString(input, "industry"),
+        referenceUrl: asString(input, "referenceUrl"),
+        previewImgUrls: input.previewImgUrls
+      });
+    }
+  },
+  {
+    name: "neopress_template_delete",
+    title: "Delete Template Site",
+    description: "Delete the template metadata row for a finished template site and hard-delete the linked site.",
+    inputSchema: siteIdShape,
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.delete();
+    }
+  },
   {
     name: "neopress_layout_get",
     title: "Get Layout",

package/dist/http-bin.cjs

@@ -31857,6 +31857,29 @@ var AnalyticsEndpoint = class {
   }
 };
 
+// ../sdk/dist/endpoints/templates.js
+var TemplatesEndpoint = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  get basePath() {
+    return `${this.client.siteBasePath}/template`;
+  }
+  async get() {
+    const res = await this.client.get(this.basePath);
+    return res.data;
+  }
+  async mark(data) {
+    const res = await this.client.post(this.basePath, data);
+    return res.data;
+  }
+  async delete() {
+    const res = await this.client.delete(this.basePath);
+    return res.data;
+  }
+};
+
 // ../sdk/dist/client.js
 var NeopressClient = class {
   baseUrl;
@@ -31873,6 +31896,7 @@ var NeopressClient = class {
   publish;
   entryReferences;
   analytics;
+  templates;
   constructor(options) {
     this.baseUrl = (options.baseUrl || "https://app.neopress.ai").replace(/\/$/, "");
     this.accessToken = options.accessToken || "";
@@ -31888,6 +31912,7 @@ var NeopressClient = class {
     this.publish = new PublishEndpoint(this);
     this.entryReferences = new EntryReferencesEndpoint(this);
     this.analytics = new AnalyticsEndpoint(this);
+    this.templates = new TemplatesEndpoint(this);
   }
   get siteBasePath() {
     return `/api/v1/sites/${this.siteId}`;
@@ -31918,7 +31943,13 @@ var NeopressClient = class {
       throw new NeopressApiError("CONNECTION_ERROR", `Cannot connect to ${this.baseUrl} \u2014 is the dev server running?`, 0);
     }
     clearTimeout(timeout);
-    const json2 = await response.json();
+    const responseText = await response.text();
+    let json2;
+    try {
+      json2 = responseText ? JSON.parse(responseText) : {};
+    } catch {
+      throw new NeopressApiError("NON_JSON_RESPONSE", `Expected JSON from ${method} ${url2} but received non-JSON response (${response.status} ${response.statusText})`, response.status, { body: responseText.slice(0, 500) });
+    }
     if (!response.ok) {
       const err = json2?.error || {};
       throw new NeopressApiError(err.code || "UNKNOWN", err.message || response.statusText, response.status, json2);
@@ -32109,6 +32140,16 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 - Generated page TSX is sandboxed. Do not import Supabase, create API clients, read env vars, use filesystem/process APIs, or assume arbitrary npm packages.
 - Use allowed runtime packages only: React/Next basics, shadcn UI imports, lucide-react, date-fns, framer-motion, @neopress/content, @neopress/routing, @neopress/i18n, and @neopress/forms.
 
+## Templates
+
+- Reusable templates are normal Neopress sites marked by a \`templates\` metadata row.
+- \`templates.id\` equals \`sites.id\`.
+- Build layout, pages, collections, entries, forms, assets, compile, publish, and verify before marking a finished template.
+- Use \`neopress_template_mark\` to create or update the metadata row with \`name\`, \`industry\`, required \`referenceUrl\`, optional \`description\`, and optional \`previewImgUrls\`.
+- \`referenceUrl\` is a single http(s) provenance URL. \`description\` is an optional summary of the template (max 150 characters).
+- Template metadata does not replace page TSX, CMS content, forms, or publish state.
+- Use \`neopress_template_delete\` only for explicit template-site hard deletion. It removes the metadata row and connected site.
+
 ## Dynamic pages and queryConfig
 
 - Dynamic pages require a collection, a page path like \`/blog/[slug]\`, a numeric \`collectionId\`, matching entries, entry publish, page compile, and site publish.
@@ -32142,6 +32183,7 @@ var SERVER_INSTRUCTIONS = `Use Neopress MCP tools to manage a selected Neopress
 
 Before generating TSX or schema-backed pages, call neopress_get_runtime_contract or read neopress://runtime-contract.
 Use numeric IDs returned by tools. Publish entries separately from site publish. Use read-only analytics tools before autopilot recommendations. Verify production URLs after production publish.
+For reusable templates, build and publish the real site resources first, then call neopress_template_mark with template metadata.
 For reference-page copy, do the reference crawling, screenshots, DOM/CSS/SVG/background-image analysis, and TSX generation in the host agent; MCP only writes and verifies Neopress resources.`;
 
 // src/result.ts
@@ -32188,6 +32230,10 @@ var optionalJsonSchema = external_exports.unknown().optional();
 var requiredJsonSchema = external_exports.unknown().refine((value) => value !== void 0, "Required JSON value is missing.");
 var analyticsParamSchema = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean()]);
 var analyticsParamsSchema = external_exports.record(external_exports.string(), analyticsParamSchema).optional();
+var httpUrlSchema = external_exports.string().url().refine((value) => {
+  const url2 = new URL(value);
+  return url2.protocol === "http:" || url2.protocol === "https:";
+}, "Must be an http(s) URL.");
 var analyticsDateShape = {
   dateFrom: external_exports.string().optional(),
   dateTo: external_exports.string().optional(),
@@ -32232,7 +32278,8 @@ var READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
   "neopress_search_console_query",
   "neopress_assets_list",
   "neopress_asset_get",
-  "neopress_publish_preview"
+  "neopress_publish_preview",
+  "neopress_template_get"
 ]);
 var DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
   "neopress_site_update",
@@ -32250,6 +32297,7 @@ var DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
   "neopress_form_publish",
   "neopress_form_delete",
   "neopress_asset_delete",
+  "neopress_template_mark",
   "neopress_publish_site"
 ]);
 var PUBLICATION_TOOLS = /* @__PURE__ */ new Set([
@@ -32424,6 +32472,49 @@ var toolDefinitions = [
       });
     }
   },
+  {
+    name: "neopress_template_get",
+    title: "Get Template Metadata",
+    description: "Get template metadata for the active or specified site.",
+    inputSchema: siteIdShape,
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.get();
+    }
+  },
+  {
+    name: "neopress_template_mark",
+    title: "Mark Site As Template",
+    description: "Create or update the template metadata row for a finished template site. The template id is the site id.",
+    inputSchema: {
+      ...siteIdShape,
+      name: external_exports.string(),
+      description: external_exports.string().max(150).optional(),
+      industry: external_exports.string(),
+      referenceUrl: httpUrlSchema,
+      previewImgUrls: external_exports.array(external_exports.string()).nullable().optional()
+    },
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.mark({
+        name: asString(input, "name"),
+        description: asOptionalString(input, "description"),
+        industry: asString(input, "industry"),
+        referenceUrl: asString(input, "referenceUrl"),
+        previewImgUrls: input.previewImgUrls
+      });
+    }
+  },
+  {
+    name: "neopress_template_delete",
+    title: "Delete Template Site",
+    description: "Delete the template metadata row for a finished template site and hard-delete the linked site.",
+    inputSchema: siteIdShape,
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.delete();
+    }
+  },
   {
     name: "neopress_layout_get",
     title: "Get Layout",

package/dist/index.js

@@ -30527,6 +30527,29 @@ var AnalyticsEndpoint = class {
   }
 };
 
+// ../sdk/dist/endpoints/templates.js
+var TemplatesEndpoint = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  get basePath() {
+    return `${this.client.siteBasePath}/template`;
+  }
+  async get() {
+    const res = await this.client.get(this.basePath);
+    return res.data;
+  }
+  async mark(data) {
+    const res = await this.client.post(this.basePath, data);
+    return res.data;
+  }
+  async delete() {
+    const res = await this.client.delete(this.basePath);
+    return res.data;
+  }
+};
+
 // ../sdk/dist/client.js
 var NeopressClient = class {
   baseUrl;
@@ -30543,6 +30566,7 @@ var NeopressClient = class {
   publish;
   entryReferences;
   analytics;
+  templates;
   constructor(options) {
     this.baseUrl = (options.baseUrl || "https://app.neopress.ai").replace(/\/$/, "");
     this.accessToken = options.accessToken || "";
@@ -30558,6 +30582,7 @@ var NeopressClient = class {
     this.publish = new PublishEndpoint(this);
     this.entryReferences = new EntryReferencesEndpoint(this);
     this.analytics = new AnalyticsEndpoint(this);
+    this.templates = new TemplatesEndpoint(this);
   }
   get siteBasePath() {
     return `/api/v1/sites/${this.siteId}`;
@@ -30588,7 +30613,13 @@ var NeopressClient = class {
       throw new NeopressApiError("CONNECTION_ERROR", `Cannot connect to ${this.baseUrl} \u2014 is the dev server running?`, 0);
     }
     clearTimeout(timeout);
-    const json2 = await response.json();
+    const responseText = await response.text();
+    let json2;
+    try {
+      json2 = responseText ? JSON.parse(responseText) : {};
+    } catch {
+      throw new NeopressApiError("NON_JSON_RESPONSE", `Expected JSON from ${method} ${url2} but received non-JSON response (${response.status} ${response.statusText})`, response.status, { body: responseText.slice(0, 500) });
+    }
     if (!response.ok) {
       const err = json2?.error || {};
       throw new NeopressApiError(err.code || "UNKNOWN", err.message || response.statusText, response.status, json2);
@@ -30779,6 +30810,16 @@ Use these rules before generating pages, collection schemas, entries, forms, or
 - Generated page TSX is sandboxed. Do not import Supabase, create API clients, read env vars, use filesystem/process APIs, or assume arbitrary npm packages.
 - Use allowed runtime packages only: React/Next basics, shadcn UI imports, lucide-react, date-fns, framer-motion, @neopress/content, @neopress/routing, @neopress/i18n, and @neopress/forms.
 
+## Templates
+
+- Reusable templates are normal Neopress sites marked by a \`templates\` metadata row.
+- \`templates.id\` equals \`sites.id\`.
+- Build layout, pages, collections, entries, forms, assets, compile, publish, and verify before marking a finished template.
+- Use \`neopress_template_mark\` to create or update the metadata row with \`name\`, \`industry\`, required \`referenceUrl\`, optional \`description\`, and optional \`previewImgUrls\`.
+- \`referenceUrl\` is a single http(s) provenance URL. \`description\` is an optional summary of the template (max 150 characters).
+- Template metadata does not replace page TSX, CMS content, forms, or publish state.
+- Use \`neopress_template_delete\` only for explicit template-site hard deletion. It removes the metadata row and connected site.
+
 ## Dynamic pages and queryConfig
 
 - Dynamic pages require a collection, a page path like \`/blog/[slug]\`, a numeric \`collectionId\`, matching entries, entry publish, page compile, and site publish.
@@ -30812,6 +30853,7 @@ var SERVER_INSTRUCTIONS = `Use Neopress MCP tools to manage a selected Neopress
 
 Before generating TSX or schema-backed pages, call neopress_get_runtime_contract or read neopress://runtime-contract.
 Use numeric IDs returned by tools. Publish entries separately from site publish. Use read-only analytics tools before autopilot recommendations. Verify production URLs after production publish.
+For reusable templates, build and publish the real site resources first, then call neopress_template_mark with template metadata.
 For reference-page copy, do the reference crawling, screenshots, DOM/CSS/SVG/background-image analysis, and TSX generation in the host agent; MCP only writes and verifies Neopress resources.`;
 
 // src/result.ts
@@ -30858,6 +30900,10 @@ var optionalJsonSchema = external_exports3.unknown().optional();
 var requiredJsonSchema = external_exports3.unknown().refine((value) => value !== void 0, "Required JSON value is missing.");
 var analyticsParamSchema = external_exports3.union([external_exports3.string(), external_exports3.number(), external_exports3.boolean()]);
 var analyticsParamsSchema = external_exports3.record(external_exports3.string(), analyticsParamSchema).optional();
+var httpUrlSchema = external_exports3.string().url().refine((value) => {
+  const url2 = new URL(value);
+  return url2.protocol === "http:" || url2.protocol === "https:";
+}, "Must be an http(s) URL.");
 var analyticsDateShape = {
   dateFrom: external_exports3.string().optional(),
   dateTo: external_exports3.string().optional(),
@@ -30902,7 +30948,8 @@ var READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
   "neopress_search_console_query",
   "neopress_assets_list",
   "neopress_asset_get",
-  "neopress_publish_preview"
+  "neopress_publish_preview",
+  "neopress_template_get"
 ]);
 var DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
   "neopress_site_update",
@@ -30920,6 +30967,7 @@ var DESTRUCTIVE_TOOLS = /* @__PURE__ */ new Set([
   "neopress_form_publish",
   "neopress_form_delete",
   "neopress_asset_delete",
+  "neopress_template_mark",
   "neopress_publish_site"
 ]);
 var PUBLICATION_TOOLS = /* @__PURE__ */ new Set([
@@ -31094,6 +31142,49 @@ var toolDefinitions = [
       });
     }
   },
+  {
+    name: "neopress_template_get",
+    title: "Get Template Metadata",
+    description: "Get template metadata for the active or specified site.",
+    inputSchema: siteIdShape,
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.get();
+    }
+  },
+  {
+    name: "neopress_template_mark",
+    title: "Mark Site As Template",
+    description: "Create or update the template metadata row for a finished template site. The template id is the site id.",
+    inputSchema: {
+      ...siteIdShape,
+      name: external_exports3.string(),
+      description: external_exports3.string().max(150).optional(),
+      industry: external_exports3.string(),
+      referenceUrl: httpUrlSchema,
+      previewImgUrls: external_exports3.array(external_exports3.string()).nullable().optional()
+    },
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.mark({
+        name: asString(input, "name"),
+        description: asOptionalString(input, "description"),
+        industry: asString(input, "industry"),
+        referenceUrl: asString(input, "referenceUrl"),
+        previewImgUrls: input.previewImgUrls
+      });
+    }
+  },
+  {
+    name: "neopress_template_delete",
+    title: "Delete Template Site",
+    description: "Delete the template metadata row for a finished template site and hard-delete the linked site.",
+    inputSchema: siteIdShape,
+    handler: async (input, context, extra) => {
+      const client = await context.createClient({ siteId: siteId(input) }, extra);
+      return client.templates.delete();
+    }
+  },
   {
     name: "neopress_layout_get",
     title: "Get Layout",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neopress/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Neopress MCP server for first-party AI agents",
   "type": "module",
   "bin": {
@@ -33,7 +33,7 @@
     "tsup": "^8.5.1",
     "typescript": "^5.7.0",
     "vitest": "^4.1.5",
-    "@neopress/sdk": "0.1.0"
+    "@neopress/sdk": "0.3.1"
   },
   "scripts": {
     "build": "tsup",