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

package/dist/{chunk-KM6F5QJH.js → chunk-EGQ7Q3Y3.js}

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
 
 // src/tools/post-mapping.ts
+import {
+  decodeAwsJson
+} from "ampless";
 var POST_FIELDS = (
   /* GraphQL */
   `
@@ -15,22 +18,12 @@ var POST_FIELDS = (
     status
     publishedAt
     tags
+    metadata
   }
 `
 );
-function decodeBody(value) {
-  if (typeof value !== "string") return value;
-  try {
-    return JSON.parse(value);
-  } catch {
-    return value;
-  }
-}
-function encodeBody(value) {
-  if (typeof value === "string") return value;
-  return JSON.stringify(value ?? null);
-}
 function toCorePost(p) {
+  const metadata = decodeAwsJson(p.metadata);
   return {
     siteId: p.siteId,
     postId: p.postId,
@@ -38,10 +31,11 @@ function toCorePost(p) {
     title: p.title,
     excerpt: p.excerpt ?? void 0,
     format: p.format ?? "markdown",
-    body: decodeBody(p.body),
+    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
   };
 }
 
@@ -135,7 +129,11 @@ async function getPost(client, defaultSiteId, args) {
 }
 
 // src/tools/create-post.ts
-import { composeSiteIdStatus, composeSiteIdSlug } from "ampless";
+import {
+  composeSiteIdStatus,
+  composeSiteIdSlug,
+  encodeAwsJson
+} from "ampless";
 
 // src/posttag.ts
 function entries(post) {
@@ -247,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) {
@@ -270,10 +283,11 @@ async function createPost(client, defaultSiteId, args) {
       title: args.title,
       excerpt: args.excerpt,
       format: args.format,
-      body: encodeBody(args.body),
+      body: encodeAwsJson(args.body),
       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)
@@ -285,7 +299,11 @@ async function createPost(client, defaultSiteId, args) {
 }
 
 // src/tools/update-post.ts
-import { composeSiteIdStatus as composeSiteIdStatus2, composeSiteIdSlug as composeSiteIdSlug2 } from "ampless";
+import {
+  composeSiteIdStatus as composeSiteIdStatus2,
+  composeSiteIdSlug as composeSiteIdSlug2,
+  encodeAwsJson as encodeAwsJson2
+} from "ampless";
 var MUTATION2 = (
   /* GraphQL */
   `
@@ -306,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) {
@@ -321,10 +354,11 @@ async function updatePost(client, defaultSiteId, args) {
   if (args.title !== void 0) input.title = args.title;
   if (args.excerpt !== void 0) input.excerpt = args.excerpt;
   if (args.format !== void 0) input.format = args.format;
-  if (args.body !== void 0) input.body = encodeBody(args.body);
+  if (args.body !== void 0) input.body = encodeAwsJson2(args.body);
   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);
   }
@@ -453,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."
+          }
         }
       },
       {
@@ -486,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."
     }
   };
 }
@@ -507,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-KM6F5QJH.js";
+} from "./chunk-EGQ7Q3Y3.js";
 import {
   AwsCrc32,
   __awaiter,

package/dist/tools/index.d.ts

@@ -40,10 +40,6 @@ declare const tools: ToolDefinition[];
  * Look up a tool definition by name and invoke its handler. Returns
  * `null` when no tool with that name is registered — callers should
  * surface that as a JSON-RPC "method not found" error.
- *
- * Shared between the stdio CLI (`src/index.ts`) and the HTTP transport
- * factory (`@ampless/admin/api/mcp` → `createMcpRoute`) so both routes
- * dispatch through the same code path.
  */
 declare function dispatchToolCall(name: string, args: Record<string, unknown>, ctx: ToolContext): Promise<unknown>;
 /**

package/dist/tools/index.js

@@ -3,7 +3,7 @@ import {
   dispatchToolCall,
   getTools,
   tools
-} from "../chunk-KM6F5QJH.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.6",
+  "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",
@@ -35,7 +35,7 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@aws-sdk/client-s3": "^3.1048.0",
     "amazon-cognito-identity-js": "^6.3.12",
-    "ampless": "0.2.0-alpha.6"
+    "ampless": "0.2.0-alpha.7"
   },
   "keywords": [
     "ampless",