@ampless/mcp-server 0.2.0-alpha.7 → 0.2.0-alpha.8

package/dist/{chunk-6LH275IC.js → chunk-EGQ7Q3Y3.js}

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 
 // src/tools/post-mapping.ts
-import { decodeAwsJson } from "ampless";
+import {
+  decodeAwsJson
+} from "ampless";
 var POST_FIELDS = (
   /* GraphQL */
   `
@@ -16,10 +18,12 @@ var POST_FIELDS = (
     status
     publishedAt
     tags
+    metadata
   }
 `
 );
 function toCorePost(p) {
+  const metadata = decodeAwsJson(p.metadata);
   return {
     siteId: p.siteId,
     postId: p.postId,
@@ -30,7 +34,8 @@ function toCorePost(p) {
     body: decodeAwsJson(p.body),
     status: p.status ?? "draft",
     publishedAt: p.publishedAt ?? void 0,
-    tags: (p.tags ?? []).filter((t) => typeof t === "string")
+    tags: (p.tags ?? []).filter((t) => typeof t === "string"),
+    metadata: metadata && typeof metadata === "object" && !Array.isArray(metadata) ? metadata : void 0
   };
 }
 
@@ -124,7 +129,11 @@ async function getPost(client, defaultSiteId, args) {
 }
 
 // src/tools/create-post.ts
-import { composeSiteIdStatus, composeSiteIdSlug, encodeAwsJson } from "ampless";
+import {
+  composeSiteIdStatus,
+  composeSiteIdSlug,
+  encodeAwsJson
+} from "ampless";
 
 // src/posttag.ts
 function entries(post) {
@@ -236,14 +245,29 @@ var createPostSchema = {
     postId: { type: "string", description: "Optional explicit id; auto-generated if omitted" },
     slug: { type: "string" },
     title: { type: "string" },
-    format: { type: "string", enum: ["tiptap", "markdown", "html"] },
+    format: {
+      type: "string",
+      enum: ["tiptap", "markdown", "html"],
+      description: "tiptap = rich text JSON tree; markdown = source string (GFM extensions enabled); html = raw HTML string (rendered verbatim, no sanitization)."
+    },
     body: {
-      description: "tiptap JSON (when format=tiptap), markdown source string, or raw HTML string"
+      description: "tiptap JSON (when format=tiptap), markdown source string (format=markdown), or raw HTML string (format=html)."
     },
     status: { type: "string", enum: ["draft", "published"], default: "draft" },
     excerpt: { type: "string" },
     publishedAt: { type: "string", description: "ISO 8601 timestamp; required when status=published" },
-    tags: { type: "array", items: { type: "string" } }
+    tags: { type: "array", items: { type: "string" } },
+    metadata: {
+      type: "object",
+      description: "Free-form per-post metadata. Reserved well-known keys: `no_layout` (boolean) \u2014 when true, the public page is served as bare HTML with no theme chrome (the route redirects to /raw/<slug>); meaningful only with format=html. Other keys pass through unchanged for themes/plugins.",
+      properties: {
+        no_layout: {
+          type: "boolean",
+          description: "Serve the post as bare HTML with no theme chrome. Only meaningful when format=html; ignored otherwise."
+        }
+      },
+      additionalProperties: true
+    }
   }
 };
 async function createPost(client, defaultSiteId, args) {
@@ -263,6 +287,7 @@ async function createPost(client, defaultSiteId, args) {
       status,
       publishedAt,
       tags: args.tags,
+      metadata: args.metadata !== void 0 ? encodeAwsJson(args.metadata) : void 0,
       // Denormalized GSI keys.
       siteIdStatus: composeSiteIdStatus(siteId, status),
       siteIdSlug: composeSiteIdSlug(siteId, args.slug)
@@ -274,7 +299,11 @@ async function createPost(client, defaultSiteId, args) {
 }
 
 // src/tools/update-post.ts
-import { composeSiteIdStatus as composeSiteIdStatus2, composeSiteIdSlug as composeSiteIdSlug2, encodeAwsJson as encodeAwsJson2 } from "ampless";
+import {
+  composeSiteIdStatus as composeSiteIdStatus2,
+  composeSiteIdSlug as composeSiteIdSlug2,
+  encodeAwsJson as encodeAwsJson2
+} from "ampless";
 var MUTATION2 = (
   /* GraphQL */
   `
@@ -295,11 +324,26 @@ var updatePostSchema = {
     slug: { type: "string" },
     title: { type: "string" },
     excerpt: { type: "string" },
-    format: { type: "string", enum: ["tiptap", "markdown", "html"] },
-    body: { description: "tiptap JSON, markdown source, or raw HTML" },
+    format: {
+      type: "string",
+      enum: ["tiptap", "markdown", "html"],
+      description: "tiptap = rich text JSON tree; markdown = source string; html = raw HTML string (no sanitization)."
+    },
+    body: { description: "tiptap JSON, markdown source, or raw HTML string" },
     status: { type: "string", enum: ["draft", "published"] },
     publishedAt: { type: "string", description: "ISO 8601 timestamp" },
-    tags: { type: "array", items: { type: "string" } }
+    tags: { type: "array", items: { type: "string" } },
+    metadata: {
+      type: "object",
+      description: "Free-form per-post metadata. Reserved well-known keys: `no_layout` (boolean) \u2014 when true, the public page is served as bare HTML with no theme chrome (the route redirects to /raw/<slug>); meaningful only with format=html. Passing metadata replaces the existing metadata object \u2014 read the current post first if you only want to add a key.",
+      properties: {
+        no_layout: {
+          type: "boolean",
+          description: "Serve the post as bare HTML with no theme chrome. Only meaningful when format=html; ignored otherwise."
+        }
+      },
+      additionalProperties: true
+    }
   }
 };
 async function updatePost(client, defaultSiteId, args) {
@@ -314,6 +358,7 @@ async function updatePost(client, defaultSiteId, args) {
   if (args.status !== void 0) input.status = args.status;
   if (args.publishedAt !== void 0) input.publishedAt = args.publishedAt;
   if (args.tags !== void 0) input.tags = args.tags;
+  if (args.metadata !== void 0) input.metadata = encodeAwsJson2(args.metadata);
   if (args.status !== void 0) {
     input.siteIdStatus = composeSiteIdStatus2(siteId, args.status);
   }
@@ -442,7 +487,11 @@ function getSchema() {
           },
           status: { type: "enum", values: ["draft", "published"], default: "draft" },
           publishedAt: { type: "datetime", description: "ISO 8601" },
-          tags: { type: "string[]" }
+          tags: { type: "string[]" },
+          metadata: {
+            type: "json",
+            description: "Free-form per-post key/value bag. Reserved well-known keys (owned by ampless): `no_layout` (boolean). Other keys pass through unchanged for themes/plugins."
+          }
         }
       },
       {
@@ -475,7 +524,9 @@ function getSchema() {
     formats: ["tiptap", "markdown", "html"],
     notes: {
       editorTrust: 'editor stores arbitrary HTML/JS verbatim \u2014 same trust shape as WordPress unfiltered_html capability. See docs/architecture/04-access-layer-mcp.md \xA7"editor \u306E\u4FE1\u983C\u30E2\u30C7\u30EB".',
-      tiptapBody: 'When format=tiptap, body is the tiptap document JSON: { type: "doc", content: [...] }. The renderer expects this shape.'
+      tiptapBody: 'When format=tiptap, body is the tiptap document JSON: { type: "doc", content: [...] }. The renderer expects this shape.',
+      noLayout: "metadata.no_layout=true serves the post as bare HTML with no theme chrome \u2014 the public route at /<slug> 302-redirects to /raw/<slug>, and that route renders the body verbatim with no wrapping <html>/<head>/layout. Use this for landing pages, embeds, or any post whose body is a full HTML document. Only meaningful with format=html (the other formats need the theme renderer).",
+      staticFormat: "A fourth format value `static` exists on the underlying data model for posts whose body is a JSON manifest pointing to a pre-uploaded HTML/CSS/JS bundle in S3 at public/static/<siteId>/<slug>/. Static uploads currently only flow through the admin UI; the MCP `upload_media` tool writes to public/media/ and does not handle static bundles. Use the admin StaticUploader for now."
     }
   };
 }
@@ -496,13 +547,13 @@ var tools = [
   },
   {
     name: "create_post",
-    description: "Create a new post. Title and slug are required. Body shape depends on format: tiptap=JSON node tree, markdown=source string, html=raw HTML string. Defaults to status=draft.",
+    description: "Create a new post. Title and slug are required. Body shape depends on format: tiptap=JSON node tree, markdown=source string, html=raw HTML string. Defaults to status=draft. Pass `metadata: { no_layout: true }` alongside format=html to publish the body as a bare HTML page with no theme chrome (the public route redirects to /raw/<slug>).",
     inputSchema: createPostSchema,
     handler: (args, ctx) => createPost(ctx.graphql, ctx.defaultSiteId, args)
   },
   {
     name: "update_post",
-    description: "Update an existing post by postId. Only the fields you pass are changed. Tag list / publishedAt changes also update the PostTag denormalized index.",
+    description: "Update an existing post by postId. Only the fields you pass are changed. Tag list / publishedAt changes also update the PostTag denormalized index. Passing `metadata` REPLACES the existing object \u2014 call get_post first if you only want to add or change one key.",
     inputSchema: updatePostSchema,
     handler: (args, ctx) => updatePost(ctx.graphql, ctx.defaultSiteId, args)
   },

package/dist/index.js

@@ -7,7 +7,7 @@ import {
 } from "./chunk-IW52OUIR.js";
 import {
   tools
-} from "./chunk-6LH275IC.js";
+} from "./chunk-EGQ7Q3Y3.js";
 import {
   AwsCrc32,
   __awaiter,

package/dist/tools/index.js

@@ -3,7 +3,7 @@ import {
   dispatchToolCall,
   getTools,
   tools
-} from "../chunk-6LH275IC.js";
+} from "../chunk-EGQ7Q3Y3.js";
 import "../chunk-LMMQX4CK.js";
 export {
   dispatchToolCall,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/mcp-server",
-  "version": "0.2.0-alpha.7",
+  "version": "0.2.0-alpha.8",
   "description": "MCP server for ampless — lets AI agents (Claude Desktop, Cursor, Claude Code) read and write posts and media via AppSync",
   "license": "MIT",
   "type": "module",