@ampless/mcp-server 0.2.0-alpha.3 → 0.2.0-alpha.5

package/dist/chunk-KM6F5QJH.js

@@ -0,0 +1,552 @@
+#!/usr/bin/env node
+
+// src/tools/post-mapping.ts
+var POST_FIELDS = (
+  /* GraphQL */
+  `
+  fragment PostFields on Post {
+    siteId
+    postId
+    slug
+    title
+    excerpt
+    format
+    body
+    status
+    publishedAt
+    tags
+  }
+`
+);
+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) {
+  return {
+    siteId: p.siteId,
+    postId: p.postId,
+    slug: p.slug,
+    title: p.title,
+    excerpt: p.excerpt ?? void 0,
+    format: p.format ?? "markdown",
+    body: decodeBody(p.body),
+    status: p.status ?? "draft",
+    publishedAt: p.publishedAt ?? void 0,
+    tags: (p.tags ?? []).filter((t) => typeof t === "string")
+  };
+}
+
+// src/tools/list-posts.ts
+var QUERY = (
+  /* GraphQL */
+  `
+  ${POST_FIELDS}
+  query ListPosts($filter: ModelPostFilterInput, $limit: Int, $nextToken: String) {
+    listPosts(filter: $filter, limit: $limit, nextToken: $nextToken) {
+      items {
+        ...PostFields
+      }
+      nextToken
+    }
+  }
+`
+);
+var listPostsSchema = {
+  type: "object",
+  properties: {
+    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
+    status: {
+      type: "string",
+      enum: ["draft", "published", "all"],
+      description: 'Filter by status (default "all")'
+    },
+    limit: { type: "integer", minimum: 1, maximum: 100, description: "Max results (default 20)" },
+    nextToken: { type: "string", description: "Pagination cursor from a previous call" }
+  }
+};
+async function listPosts(client, defaultSiteId, args = {}) {
+  const siteId = args.siteId ?? defaultSiteId;
+  const status = args.status ?? "all";
+  const filter = { siteId: { eq: siteId } };
+  if (status !== "all") filter.status = { eq: status };
+  const data = await client.query(QUERY, { filter, limit: args.limit ?? 20, nextToken: args.nextToken });
+  return {
+    posts: data.listPosts.items.map(toCorePost),
+    nextToken: data.listPosts.nextToken
+  };
+}
+
+// src/tools/get-post.ts
+var GET_BY_ID = (
+  /* GraphQL */
+  `
+  ${POST_FIELDS}
+  query GetPost($siteId: String!, $postId: ID!) {
+    getPost(siteId: $siteId, postId: $postId) {
+      ...PostFields
+    }
+  }
+`
+);
+var LIST_BY_SLUG = (
+  /* GraphQL */
+  `
+  ${POST_FIELDS}
+  query GetPostBySlug($filter: ModelPostFilterInput!) {
+    listPosts(filter: $filter, limit: 1) {
+      items {
+        ...PostFields
+      }
+    }
+  }
+`
+);
+var getPostSchema = {
+  type: "object",
+  properties: {
+    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
+    slug: { type: "string", description: "Post slug" },
+    postId: { type: "string", description: "Post id (used when slug is omitted)" }
+  }
+};
+async function getPost(client, defaultSiteId, args) {
+  if (!args.slug && !args.postId) {
+    throw new Error("get_post requires either `slug` or `postId`");
+  }
+  const siteId = args.siteId ?? defaultSiteId;
+  if (args.postId) {
+    const data2 = await client.query(GET_BY_ID, { siteId, postId: args.postId });
+    return data2.getPost ? toCorePost(data2.getPost) : null;
+  }
+  const data = await client.query(LIST_BY_SLUG, {
+    filter: { siteId: { eq: siteId }, slug: { eq: args.slug } }
+  });
+  const item = data.listPosts.items[0];
+  return item ? toCorePost(item) : null;
+}
+
+// src/tools/create-post.ts
+import { composeSiteIdStatus, composeSiteIdSlug } from "ampless";
+
+// src/posttag.ts
+function entries(post) {
+  if (post.status !== "published" || !post.publishedAt || !post.tags?.length) return [];
+  return post.tags.map((tag) => ({
+    siteIdTag: `${post.siteId}#${tag}`,
+    publishedAtPostId: `${post.publishedAt}#${post.postId}`
+  }));
+}
+function entryKey(e) {
+  return `${e.siteIdTag}|${e.publishedAtPostId}`;
+}
+var CREATE_POST_TAG = (
+  /* GraphQL */
+  `
+  mutation CreatePostTag($input: CreatePostTagInput!) {
+    createPostTag(input: $input) {
+      siteIdTag
+      publishedAtPostId
+    }
+  }
+`
+);
+var UPDATE_POST_TAG = (
+  /* GraphQL */
+  `
+  mutation UpdatePostTag($input: UpdatePostTagInput!) {
+    updatePostTag(input: $input) {
+      siteIdTag
+      publishedAtPostId
+    }
+  }
+`
+);
+var DELETE_POST_TAG = (
+  /* GraphQL */
+  `
+  mutation DeletePostTag($input: DeletePostTagInput!) {
+    deletePostTag(input: $input) {
+      siteIdTag
+      publishedAtPostId
+    }
+  }
+`
+);
+async function syncPostTags(client, post, oldPost) {
+  const oldEntries = oldPost ? entries(oldPost) : [];
+  const newEntries = entries(post);
+  const oldKeys = new Set(oldEntries.map(entryKey));
+  const newKeys = new Set(newEntries.map(entryKey));
+  await Promise.all(
+    oldEntries.filter((e) => !newKeys.has(entryKey(e))).map(
+      (e) => client.query(DELETE_POST_TAG, {
+        input: { siteIdTag: e.siteIdTag, publishedAtPostId: e.publishedAtPostId }
+      })
+    )
+  );
+  await Promise.all(
+    newEntries.filter((e) => !oldKeys.has(entryKey(e))).map(
+      (e) => client.query(CREATE_POST_TAG, {
+        input: {
+          siteIdTag: e.siteIdTag,
+          publishedAtPostId: e.publishedAtPostId,
+          siteId: post.siteId,
+          tag: e.siteIdTag.slice(post.siteId.length + 1),
+          postId: post.postId,
+          publishedAt: post.publishedAt,
+          slug: post.slug,
+          title: post.title,
+          excerpt: post.excerpt,
+          tags: post.tags ?? []
+        }
+      })
+    )
+  );
+  await Promise.all(
+    newEntries.filter((e) => oldKeys.has(entryKey(e))).map(
+      (e) => client.query(UPDATE_POST_TAG, {
+        input: {
+          siteIdTag: e.siteIdTag,
+          publishedAtPostId: e.publishedAtPostId,
+          slug: post.slug,
+          title: post.title,
+          excerpt: post.excerpt,
+          tags: post.tags ?? []
+        }
+      })
+    )
+  );
+}
+
+// src/tools/create-post.ts
+var MUTATION = (
+  /* GraphQL */
+  `
+  ${POST_FIELDS}
+  mutation CreatePost($input: CreatePostInput!) {
+    createPost(input: $input) {
+      ...PostFields
+    }
+  }
+`
+);
+var createPostSchema = {
+  type: "object",
+  required: ["slug", "title", "format", "body"],
+  properties: {
+    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
+    postId: { type: "string", description: "Optional explicit id; auto-generated if omitted" },
+    slug: { type: "string" },
+    title: { type: "string" },
+    format: { type: "string", enum: ["tiptap", "markdown", "html"] },
+    body: {
+      description: "tiptap JSON (when format=tiptap), markdown source string, or raw HTML string"
+    },
+    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" } }
+  }
+};
+async function createPost(client, defaultSiteId, args) {
+  const siteId = args.siteId ?? defaultSiteId;
+  const postId = args.postId ?? `post-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  const status = args.status ?? "draft";
+  const publishedAt = args.publishedAt ?? (status === "published" ? (/* @__PURE__ */ new Date()).toISOString() : void 0);
+  const data = await client.query(MUTATION, {
+    input: {
+      siteId,
+      postId,
+      slug: args.slug,
+      title: args.title,
+      excerpt: args.excerpt,
+      format: args.format,
+      body: encodeBody(args.body),
+      status,
+      publishedAt,
+      tags: args.tags,
+      // Denormalized GSI keys.
+      siteIdStatus: composeSiteIdStatus(siteId, status),
+      siteIdSlug: composeSiteIdSlug(siteId, args.slug)
+    }
+  });
+  const created = toCorePost(data.createPost);
+  await syncPostTags(client, created, null);
+  return created;
+}
+
+// src/tools/update-post.ts
+import { composeSiteIdStatus as composeSiteIdStatus2, composeSiteIdSlug as composeSiteIdSlug2 } from "ampless";
+var MUTATION2 = (
+  /* GraphQL */
+  `
+  ${POST_FIELDS}
+  mutation UpdatePost($input: UpdatePostInput!) {
+    updatePost(input: $input) {
+      ...PostFields
+    }
+  }
+`
+);
+var updatePostSchema = {
+  type: "object",
+  required: ["postId"],
+  properties: {
+    postId: { type: "string" },
+    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
+    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" },
+    status: { type: "string", enum: ["draft", "published"] },
+    publishedAt: { type: "string", description: "ISO 8601 timestamp" },
+    tags: { type: "array", items: { type: "string" } }
+  }
+};
+async function updatePost(client, defaultSiteId, args) {
+  const siteId = args.siteId ?? defaultSiteId;
+  const oldPost = await getPost(client, defaultSiteId, { postId: args.postId, siteId });
+  const input = { siteId, postId: args.postId };
+  if (args.slug !== void 0) input.slug = args.slug;
+  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.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.status !== void 0) {
+    input.siteIdStatus = composeSiteIdStatus2(siteId, args.status);
+  }
+  if (args.slug !== void 0) {
+    input.siteIdSlug = composeSiteIdSlug2(siteId, args.slug);
+  }
+  const data = await client.query(MUTATION2, { input });
+  const updated = toCorePost(data.updatePost);
+  await syncPostTags(client, updated, oldPost);
+  return updated;
+}
+
+// src/tools/delete-post.ts
+var MUTATION3 = (
+  /* GraphQL */
+  `
+  mutation DeletePost($input: DeletePostInput!) {
+    deletePost(input: $input) {
+      siteId
+      postId
+    }
+  }
+`
+);
+var deletePostSchema = {
+  type: "object",
+  required: ["postId"],
+  properties: {
+    postId: { type: "string" },
+    siteId: { type: "string", description: 'Site identifier (defaults to "default")' }
+  }
+};
+async function deletePost(client, defaultSiteId, args) {
+  const siteId = args.siteId ?? defaultSiteId;
+  const oldPost = await getPost(client, defaultSiteId, { postId: args.postId, siteId });
+  if (oldPost) {
+    await syncPostTags(client, { ...oldPost, status: "draft" }, oldPost);
+  }
+  const data = await client.query(MUTATION3, { input: { siteId, postId: args.postId } });
+  return { deleted: data.deletePost };
+}
+
+// src/tools/media-key.ts
+function sanitizeName(name) {
+  return name.replace(/[\x00-\x1f\x7f]/g, "").replace(/[\\/:*?"<>|]/g, "_").replace(/\s+/g, "_").replace(/^\.+/, "_").slice(0, 200) || "upload";
+}
+function buildMediaKey(filename, now = /* @__PURE__ */ new Date()) {
+  const safe = sanitizeName(filename);
+  const yyyy = now.getFullYear();
+  const mm = String(now.getMonth() + 1).padStart(2, "0");
+  return `public/media/${yyyy}/${mm}/${now.getTime()}-${safe}`;
+}
+
+// src/tools/upload-media.ts
+var MUTATION4 = (
+  /* GraphQL */
+  `
+  mutation CreateMedia($input: CreateMediaInput!) {
+    createMedia(input: $input) {
+      siteId
+      mediaId
+      src
+      mimeType
+      size
+      delivery
+    }
+  }
+`
+);
+var uploadMediaSchema = {
+  type: "object",
+  required: ["filename", "mimeType", "base64Data"],
+  properties: {
+    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
+    filename: { type: "string", description: "Original filename; sanitized server-side" },
+    mimeType: {
+      type: "string",
+      description: "IANA media type (e.g. image/webp, image/jpeg). The MCP server does not transcode \u2014 pass the MIME of the bytes you actually send."
+    },
+    base64Data: {
+      type: "string",
+      description: "Base64-encoded file contents. NO data:URL prefix. The MCP server uploads bytes verbatim \u2014 resize/encode client-side first if needed."
+    }
+  }
+};
+async function uploadMedia(graphql, storage, defaultSiteId, args) {
+  const siteId = args.siteId ?? defaultSiteId;
+  const body = Buffer.from(args.base64Data, "base64");
+  const key = buildMediaKey(args.filename);
+  const url = await storage.putObject(key, body, args.mimeType);
+  const mediaId = `media-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  const data = await graphql.query(MUTATION4, {
+    input: {
+      siteId,
+      mediaId,
+      src: key,
+      mimeType: args.mimeType,
+      size: body.length,
+      delivery: "nextjs"
+    }
+  });
+  return { media: data.createMedia, url };
+}
+
+// src/tools/get-schema.ts
+var getSchemaSchema = {
+  type: "object",
+  properties: {}
+};
+function getSchema() {
+  return {
+    contentTypes: [
+      {
+        name: "post",
+        identifier: ["siteId", "postId"],
+        fields: {
+          siteId: { type: "string", required: true },
+          postId: { type: "string", required: true, description: "auto-generated if omitted on create" },
+          slug: { type: "string", required: true, description: "URL slug, unique per site" },
+          title: { type: "string", required: true },
+          excerpt: { type: "string" },
+          format: { type: "enum", values: ["tiptap", "markdown", "html"], required: true },
+          body: {
+            type: "json",
+            description: "tiptap node JSON when format=tiptap; markdown source string when format=markdown; raw HTML string when format=html"
+          },
+          status: { type: "enum", values: ["draft", "published"], default: "draft" },
+          publishedAt: { type: "datetime", description: "ISO 8601" },
+          tags: { type: "string[]" }
+        }
+      },
+      {
+        name: "page",
+        identifier: ["siteId", "pageId"],
+        fields: {
+          siteId: { type: "string", required: true },
+          pageId: { type: "string", required: true },
+          slug: { type: "string", required: true },
+          title: { type: "string", required: true },
+          format: { type: "enum", values: ["tiptap", "markdown", "html"], required: true },
+          body: { type: "json" },
+          status: { type: "enum", values: ["draft", "published"] },
+          publishedAt: { type: "datetime" }
+        }
+      },
+      {
+        name: "media",
+        identifier: ["siteId", "mediaId"],
+        fields: {
+          siteId: { type: "string", required: true },
+          mediaId: { type: "string", required: true },
+          src: { type: "string", required: true, description: "S3 key" },
+          mimeType: { type: "string", required: true },
+          size: { type: "integer" },
+          delivery: { type: "string" }
+        }
+      }
+    ],
+    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.'
+    }
+  };
+}
+
+// src/tools/index.ts
+var tools = [
+  {
+    name: "list_posts",
+    description: "List posts in the CMS with optional filters by status. Returns up to `limit` posts (default 20) plus a `nextToken` cursor for pagination.",
+    inputSchema: listPostsSchema,
+    handler: (args, ctx) => listPosts(ctx.graphql, ctx.defaultSiteId, args)
+  },
+  {
+    name: "get_post",
+    description: "Fetch a single post by slug or postId. Returns null if not found.",
+    inputSchema: getPostSchema,
+    handler: (args, ctx) => getPost(ctx.graphql, ctx.defaultSiteId, args)
+  },
+  {
+    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.",
+    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.",
+    inputSchema: updatePostSchema,
+    handler: (args, ctx) => updatePost(ctx.graphql, ctx.defaultSiteId, args)
+  },
+  {
+    name: "delete_post",
+    description: "Delete a post by postId. Also drops associated PostTag index entries.",
+    inputSchema: deletePostSchema,
+    handler: (args, ctx) => deletePost(ctx.graphql, ctx.defaultSiteId, args)
+  },
+  {
+    name: "upload_media",
+    description: "Upload a file to the site's media S3 bucket. Pass base64-encoded bytes; the server stores them verbatim under public/media/YYYY/MM/. Returns the public URL and Media record. The server does not transcode \u2014 pre-process (e.g. resize/webp) on the client.",
+    inputSchema: uploadMediaSchema,
+    handler: (args, ctx) => uploadMedia(ctx.graphql, ctx.storage(), ctx.defaultSiteId, args)
+  },
+  {
+    name: "get_schema",
+    description: "Returns the CMS content schema (Post/Page/Media field shapes, format enum, notes). Useful as the first call to understand what fields are available.",
+    inputSchema: getSchemaSchema,
+    handler: async () => getSchema()
+  }
+];
+async function dispatchToolCall(name, args, ctx) {
+  const tool = tools.find((t) => t.name === name);
+  if (!tool) return null;
+  return tool.handler(args, ctx);
+}
+function getTools() {
+  return tools;
+}
+
+export {
+  tools,
+  dispatchToolCall,
+  getTools
+};

package/dist/{dist-es-ZP52SD4G.js → dist-es-J4X5E4TX.js}

@@ -400,7 +400,7 @@ var resolveProcessCredentials = async (options, profile) => import("./dist-es-OO
 
 // ../../node_modules/.pnpm/@aws-sdk+credential-provider-ini@3.972.41/node_modules/@aws-sdk/credential-provider-ini/dist-es/resolveSsoCredentials.js
 var resolveSsoCredentials = async (profile, profileData, options = {}, callerClientConfig) => {
-  const { fromSSO } = await import("./dist-es-NAMW5ZZ4.js");
+  const { fromSSO } = await import("./dist-es-OKPWYZO7.js");
   return fromSSO({
     profile,
     logger: options.logger,

package/dist/index.js

@@ -5,6 +5,9 @@ import {
   XmlShapeDeserializer,
   XmlText
 } from "./chunk-IW52OUIR.js";
+import {
+  tools
+} from "./chunk-KM6F5QJH.js";
 import {
   AwsCrc32,
   __awaiter,
@@ -11093,9 +11096,9 @@ function assertNever(_x2) {
 }
 function assert(_) {
 }
-function getEnumValues(entries2) {
-  const numericValues = Object.values(entries2).filter((v2) => typeof v2 === "number");
-  const values = Object.entries(entries2).filter(([k2, _]) => numericValues.indexOf(+k2) === -1).map(([_, v2]) => v2);
+function getEnumValues(entries) {
+  const numericValues = Object.values(entries).filter((v2) => typeof v2 === "number");
+  const values = Object.entries(entries).filter(([k2, _]) => numericValues.indexOf(+k2) === -1).map(([_, v2]) => v2);
   return values;
 }
 function joinValues(array2, separator = "|") {
@@ -15980,10 +15983,10 @@ var ZodEnum = /* @__PURE__ */ $constructor("ZodEnum", (inst, def) => {
   };
 });
 function _enum(values, params) {
-  const entries2 = Array.isArray(values) ? Object.fromEntries(values.map((v2) => [v2, v2])) : values;
+  const entries = Array.isArray(values) ? Object.fromEntries(values.map((v2) => [v2, v2])) : values;
   return new ZodEnum({
     type: "enum",
-    entries: entries2,
+    entries,
     ...util_exports.normalizeParams(params)
   });
 }
@@ -31745,12 +31748,12 @@ var defaultProvider = (init = {}) => memoizeChain([
     if (!ssoStartUrl && !ssoAccountId && !ssoRegion && !ssoRoleName && !ssoSession) {
       throw new CredentialsProviderError("Skipping SSO provider in default chain (inputs do not include SSO fields).", { logger: init.logger });
     }
-    const { fromSSO } = await import("./dist-es-NAMW5ZZ4.js");
+    const { fromSSO } = await import("./dist-es-OKPWYZO7.js");
     return fromSSO(init)(awsIdentityProperties);
   },
   async (awsIdentityProperties) => {
     init.logger?.debug("@aws-sdk/credential-provider-node - defaultProvider::fromIni");
-    const { fromIni } = await import("./dist-es-ZP52SD4G.js");
+    const { fromIni } = await import("./dist-es-J4X5E4TX.js");
     return fromIni(init)(awsIdentityProperties);
   },
   async (awsIdentityProperties) => {
@@ -32085,15 +32088,6 @@ var PutObjectCommand = class extends Command.classBuilder().ep({
 
 // src/s3.ts
 import { formatPublicAssetUrl } from "ampless";
-function sanitizeName(name) {
-  return name.replace(/[\x00-\x1f\x7f]/g, "").replace(/[\\/:*?"<>|]/g, "_").replace(/\s+/g, "_").replace(/^\.+/, "_").slice(0, 200) || "upload";
-}
-function buildMediaKey(filename, now = /* @__PURE__ */ new Date()) {
-  const safe = sanitizeName(filename);
-  const yyyy = now.getFullYear();
-  const mm = String(now.getMonth() + 1).padStart(2, "0");
-  return `public/media/${yyyy}/${mm}/${now.getTime()}-${safe}`;
-}
 var StorageClient = class {
   client;
   bucket;
@@ -32121,532 +32115,6 @@ var StorageClient = class {
   }
 };
 
-// src/tools/post-mapping.ts
-var POST_FIELDS = (
-  /* GraphQL */
-  `
-  fragment PostFields on Post {
-    siteId
-    postId
-    slug
-    title
-    excerpt
-    format
-    body
-    status
-    publishedAt
-    tags
-  }
-`
-);
-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(p2) {
-  return {
-    siteId: p2.siteId,
-    postId: p2.postId,
-    slug: p2.slug,
-    title: p2.title,
-    excerpt: p2.excerpt ?? void 0,
-    format: p2.format ?? "markdown",
-    body: decodeBody(p2.body),
-    status: p2.status ?? "draft",
-    publishedAt: p2.publishedAt ?? void 0,
-    tags: (p2.tags ?? []).filter((t8) => typeof t8 === "string")
-  };
-}
-
-// src/tools/list-posts.ts
-var QUERY = (
-  /* GraphQL */
-  `
-  ${POST_FIELDS}
-  query ListPosts($filter: ModelPostFilterInput, $limit: Int, $nextToken: String) {
-    listPosts(filter: $filter, limit: $limit, nextToken: $nextToken) {
-      items {
-        ...PostFields
-      }
-      nextToken
-    }
-  }
-`
-);
-var listPostsSchema = {
-  type: "object",
-  properties: {
-    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
-    status: {
-      type: "string",
-      enum: ["draft", "published", "all"],
-      description: 'Filter by status (default "all")'
-    },
-    limit: { type: "integer", minimum: 1, maximum: 100, description: "Max results (default 20)" },
-    nextToken: { type: "string", description: "Pagination cursor from a previous call" }
-  }
-};
-async function listPosts(client, defaultSiteId, args = {}) {
-  const siteId = args.siteId ?? defaultSiteId;
-  const status = args.status ?? "all";
-  const filter = { siteId: { eq: siteId } };
-  if (status !== "all") filter.status = { eq: status };
-  const data = await client.query(QUERY, { filter, limit: args.limit ?? 20, nextToken: args.nextToken });
-  return {
-    posts: data.listPosts.items.map(toCorePost),
-    nextToken: data.listPosts.nextToken
-  };
-}
-
-// src/tools/get-post.ts
-var GET_BY_ID = (
-  /* GraphQL */
-  `
-  ${POST_FIELDS}
-  query GetPost($siteId: String!, $postId: ID!) {
-    getPost(siteId: $siteId, postId: $postId) {
-      ...PostFields
-    }
-  }
-`
-);
-var LIST_BY_SLUG = (
-  /* GraphQL */
-  `
-  ${POST_FIELDS}
-  query GetPostBySlug($filter: ModelPostFilterInput!) {
-    listPosts(filter: $filter, limit: 1) {
-      items {
-        ...PostFields
-      }
-    }
-  }
-`
-);
-var getPostSchema = {
-  type: "object",
-  properties: {
-    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
-    slug: { type: "string", description: "Post slug" },
-    postId: { type: "string", description: "Post id (used when slug is omitted)" }
-  }
-};
-async function getPost(client, defaultSiteId, args) {
-  if (!args.slug && !args.postId) {
-    throw new Error("get_post requires either `slug` or `postId`");
-  }
-  const siteId = args.siteId ?? defaultSiteId;
-  if (args.postId) {
-    const data2 = await client.query(GET_BY_ID, { siteId, postId: args.postId });
-    return data2.getPost ? toCorePost(data2.getPost) : null;
-  }
-  const data = await client.query(LIST_BY_SLUG, {
-    filter: { siteId: { eq: siteId }, slug: { eq: args.slug } }
-  });
-  const item = data.listPosts.items[0];
-  return item ? toCorePost(item) : null;
-}
-
-// src/tools/create-post.ts
-import { composeSiteIdStatus, composeSiteIdSlug } from "ampless";
-
-// src/posttag.ts
-function entries(post) {
-  if (post.status !== "published" || !post.publishedAt || !post.tags?.length) return [];
-  return post.tags.map((tag) => ({
-    siteIdTag: `${post.siteId}#${tag}`,
-    publishedAtPostId: `${post.publishedAt}#${post.postId}`
-  }));
-}
-function entryKey(e2) {
-  return `${e2.siteIdTag}|${e2.publishedAtPostId}`;
-}
-var CREATE_POST_TAG = (
-  /* GraphQL */
-  `
-  mutation CreatePostTag($input: CreatePostTagInput!) {
-    createPostTag(input: $input) {
-      siteIdTag
-      publishedAtPostId
-    }
-  }
-`
-);
-var UPDATE_POST_TAG = (
-  /* GraphQL */
-  `
-  mutation UpdatePostTag($input: UpdatePostTagInput!) {
-    updatePostTag(input: $input) {
-      siteIdTag
-      publishedAtPostId
-    }
-  }
-`
-);
-var DELETE_POST_TAG = (
-  /* GraphQL */
-  `
-  mutation DeletePostTag($input: DeletePostTagInput!) {
-    deletePostTag(input: $input) {
-      siteIdTag
-      publishedAtPostId
-    }
-  }
-`
-);
-async function syncPostTags(client, post, oldPost) {
-  const oldEntries = oldPost ? entries(oldPost) : [];
-  const newEntries = entries(post);
-  const oldKeys = new Set(oldEntries.map(entryKey));
-  const newKeys = new Set(newEntries.map(entryKey));
-  await Promise.all(
-    oldEntries.filter((e2) => !newKeys.has(entryKey(e2))).map(
-      (e2) => client.query(DELETE_POST_TAG, {
-        input: { siteIdTag: e2.siteIdTag, publishedAtPostId: e2.publishedAtPostId }
-      })
-    )
-  );
-  await Promise.all(
-    newEntries.filter((e2) => !oldKeys.has(entryKey(e2))).map(
-      (e2) => client.query(CREATE_POST_TAG, {
-        input: {
-          siteIdTag: e2.siteIdTag,
-          publishedAtPostId: e2.publishedAtPostId,
-          siteId: post.siteId,
-          tag: e2.siteIdTag.slice(post.siteId.length + 1),
-          postId: post.postId,
-          publishedAt: post.publishedAt,
-          slug: post.slug,
-          title: post.title,
-          excerpt: post.excerpt,
-          tags: post.tags ?? []
-        }
-      })
-    )
-  );
-  await Promise.all(
-    newEntries.filter((e2) => oldKeys.has(entryKey(e2))).map(
-      (e2) => client.query(UPDATE_POST_TAG, {
-        input: {
-          siteIdTag: e2.siteIdTag,
-          publishedAtPostId: e2.publishedAtPostId,
-          slug: post.slug,
-          title: post.title,
-          excerpt: post.excerpt,
-          tags: post.tags ?? []
-        }
-      })
-    )
-  );
-}
-
-// src/tools/create-post.ts
-var MUTATION = (
-  /* GraphQL */
-  `
-  ${POST_FIELDS}
-  mutation CreatePost($input: CreatePostInput!) {
-    createPost(input: $input) {
-      ...PostFields
-    }
-  }
-`
-);
-var createPostSchema = {
-  type: "object",
-  required: ["slug", "title", "format", "body"],
-  properties: {
-    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
-    postId: { type: "string", description: "Optional explicit id; auto-generated if omitted" },
-    slug: { type: "string" },
-    title: { type: "string" },
-    format: { type: "string", enum: ["tiptap", "markdown", "html"] },
-    body: {
-      description: "tiptap JSON (when format=tiptap), markdown source string, or raw HTML string"
-    },
-    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" } }
-  }
-};
-async function createPost(client, defaultSiteId, args) {
-  const siteId = args.siteId ?? defaultSiteId;
-  const postId = args.postId ?? `post-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-  const status = args.status ?? "draft";
-  const publishedAt = args.publishedAt ?? (status === "published" ? (/* @__PURE__ */ new Date()).toISOString() : void 0);
-  const data = await client.query(MUTATION, {
-    input: {
-      siteId,
-      postId,
-      slug: args.slug,
-      title: args.title,
-      excerpt: args.excerpt,
-      format: args.format,
-      body: encodeBody(args.body),
-      status,
-      publishedAt,
-      tags: args.tags,
-      // Denormalized GSI keys.
-      siteIdStatus: composeSiteIdStatus(siteId, status),
-      siteIdSlug: composeSiteIdSlug(siteId, args.slug)
-    }
-  });
-  const created = toCorePost(data.createPost);
-  await syncPostTags(client, created, null);
-  return created;
-}
-
-// src/tools/update-post.ts
-import { composeSiteIdStatus as composeSiteIdStatus2, composeSiteIdSlug as composeSiteIdSlug2 } from "ampless";
-var MUTATION2 = (
-  /* GraphQL */
-  `
-  ${POST_FIELDS}
-  mutation UpdatePost($input: UpdatePostInput!) {
-    updatePost(input: $input) {
-      ...PostFields
-    }
-  }
-`
-);
-var updatePostSchema = {
-  type: "object",
-  required: ["postId"],
-  properties: {
-    postId: { type: "string" },
-    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
-    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" },
-    status: { type: "string", enum: ["draft", "published"] },
-    publishedAt: { type: "string", description: "ISO 8601 timestamp" },
-    tags: { type: "array", items: { type: "string" } }
-  }
-};
-async function updatePost(client, defaultSiteId, args) {
-  const siteId = args.siteId ?? defaultSiteId;
-  const oldPost = await getPost(client, defaultSiteId, { postId: args.postId, siteId });
-  const input = { siteId, postId: args.postId };
-  if (args.slug !== void 0) input.slug = args.slug;
-  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.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.status !== void 0) {
-    input.siteIdStatus = composeSiteIdStatus2(siteId, args.status);
-  }
-  if (args.slug !== void 0) {
-    input.siteIdSlug = composeSiteIdSlug2(siteId, args.slug);
-  }
-  const data = await client.query(MUTATION2, { input });
-  const updated = toCorePost(data.updatePost);
-  await syncPostTags(client, updated, oldPost);
-  return updated;
-}
-
-// src/tools/delete-post.ts
-var MUTATION3 = (
-  /* GraphQL */
-  `
-  mutation DeletePost($input: DeletePostInput!) {
-    deletePost(input: $input) {
-      siteId
-      postId
-    }
-  }
-`
-);
-var deletePostSchema = {
-  type: "object",
-  required: ["postId"],
-  properties: {
-    postId: { type: "string" },
-    siteId: { type: "string", description: 'Site identifier (defaults to "default")' }
-  }
-};
-async function deletePost(client, defaultSiteId, args) {
-  const siteId = args.siteId ?? defaultSiteId;
-  const oldPost = await getPost(client, defaultSiteId, { postId: args.postId, siteId });
-  if (oldPost) {
-    await syncPostTags(client, { ...oldPost, status: "draft" }, oldPost);
-  }
-  const data = await client.query(MUTATION3, { input: { siteId, postId: args.postId } });
-  return { deleted: data.deletePost };
-}
-
-// src/tools/upload-media.ts
-var MUTATION4 = (
-  /* GraphQL */
-  `
-  mutation CreateMedia($input: CreateMediaInput!) {
-    createMedia(input: $input) {
-      siteId
-      mediaId
-      src
-      mimeType
-      size
-      delivery
-    }
-  }
-`
-);
-var uploadMediaSchema = {
-  type: "object",
-  required: ["filename", "mimeType", "base64Data"],
-  properties: {
-    siteId: { type: "string", description: 'Site identifier (defaults to "default")' },
-    filename: { type: "string", description: "Original filename; sanitized server-side" },
-    mimeType: {
-      type: "string",
-      description: "IANA media type (e.g. image/webp, image/jpeg). The MCP server does not transcode \u2014 pass the MIME of the bytes you actually send."
-    },
-    base64Data: {
-      type: "string",
-      description: "Base64-encoded file contents. NO data:URL prefix. The MCP server uploads bytes verbatim \u2014 resize/encode client-side first if needed."
-    }
-  }
-};
-async function uploadMedia(graphql, storage, defaultSiteId, args) {
-  const siteId = args.siteId ?? defaultSiteId;
-  const body = Buffer.from(args.base64Data, "base64");
-  const key = buildMediaKey(args.filename);
-  const url = await storage.putObject(key, body, args.mimeType);
-  const mediaId = `media-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-  const data = await graphql.query(MUTATION4, {
-    input: {
-      siteId,
-      mediaId,
-      src: key,
-      mimeType: args.mimeType,
-      size: body.length,
-      delivery: "nextjs"
-    }
-  });
-  return { media: data.createMedia, url };
-}
-
-// src/tools/get-schema.ts
-var getSchemaSchema = {
-  type: "object",
-  properties: {}
-};
-function getSchema() {
-  return {
-    contentTypes: [
-      {
-        name: "post",
-        identifier: ["siteId", "postId"],
-        fields: {
-          siteId: { type: "string", required: true },
-          postId: { type: "string", required: true, description: "auto-generated if omitted on create" },
-          slug: { type: "string", required: true, description: "URL slug, unique per site" },
-          title: { type: "string", required: true },
-          excerpt: { type: "string" },
-          format: { type: "enum", values: ["tiptap", "markdown", "html"], required: true },
-          body: {
-            type: "json",
-            description: "tiptap node JSON when format=tiptap; markdown source string when format=markdown; raw HTML string when format=html"
-          },
-          status: { type: "enum", values: ["draft", "published"], default: "draft" },
-          publishedAt: { type: "datetime", description: "ISO 8601" },
-          tags: { type: "string[]" }
-        }
-      },
-      {
-        name: "page",
-        identifier: ["siteId", "pageId"],
-        fields: {
-          siteId: { type: "string", required: true },
-          pageId: { type: "string", required: true },
-          slug: { type: "string", required: true },
-          title: { type: "string", required: true },
-          format: { type: "enum", values: ["tiptap", "markdown", "html"], required: true },
-          body: { type: "json" },
-          status: { type: "enum", values: ["draft", "published"] },
-          publishedAt: { type: "datetime" }
-        }
-      },
-      {
-        name: "media",
-        identifier: ["siteId", "mediaId"],
-        fields: {
-          siteId: { type: "string", required: true },
-          mediaId: { type: "string", required: true },
-          src: { type: "string", required: true, description: "S3 key" },
-          mimeType: { type: "string", required: true },
-          size: { type: "integer" },
-          delivery: { type: "string" }
-        }
-      }
-    ],
-    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.'
-    }
-  };
-}
-
-// src/tools/index.ts
-var tools = [
-  {
-    name: "list_posts",
-    description: "List posts in the CMS with optional filters by status. Returns up to `limit` posts (default 20) plus a `nextToken` cursor for pagination.",
-    inputSchema: listPostsSchema,
-    handler: (args, ctx) => listPosts(ctx.graphql, ctx.defaultSiteId, args)
-  },
-  {
-    name: "get_post",
-    description: "Fetch a single post by slug or postId. Returns null if not found.",
-    inputSchema: getPostSchema,
-    handler: (args, ctx) => getPost(ctx.graphql, ctx.defaultSiteId, args)
-  },
-  {
-    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.",
-    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.",
-    inputSchema: updatePostSchema,
-    handler: (args, ctx) => updatePost(ctx.graphql, ctx.defaultSiteId, args)
-  },
-  {
-    name: "delete_post",
-    description: "Delete a post by postId. Also drops associated PostTag index entries.",
-    inputSchema: deletePostSchema,
-    handler: (args, ctx) => deletePost(ctx.graphql, ctx.defaultSiteId, args)
-  },
-  {
-    name: "upload_media",
-    description: "Upload a file to the site's media S3 bucket. Pass base64-encoded bytes; the server stores them verbatim under public/media/YYYY/MM/. Returns the public URL and Media record. The server does not transcode \u2014 pre-process (e.g. resize/webp) on the client.",
-    inputSchema: uploadMediaSchema,
-    handler: (args, ctx) => uploadMedia(ctx.graphql, ctx.storage(), ctx.defaultSiteId, args)
-  },
-  {
-    name: "get_schema",
-    description: "Returns the CMS content schema (Post/Page/Media field shapes, format enum, notes). Useful as the first call to understand what fields are available.",
-    inputSchema: getSchemaSchema,
-    handler: async () => getSchema()
-  }
-];
-
 // src/server.ts
 async function startServer(config2) {
   const auth = new CognitoAuth(config2);

package/dist/tools/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Abstract contracts each tool handler depends on. Concrete
+ * implementations live elsewhere:
+ *
+ *   - Stdio CLI: `src/appsync.ts` (Cognito-id-token bearer) and
+ *     `src/s3.ts` (default-credential-chain S3 client).
+ *   - HTTP transport: `@ampless/admin/api/mcp` wraps the consumer's
+ *     existing `generateClient<Schema>()` + S3 client.
+ *
+ * Both routes satisfy these interfaces structurally (no `implements`
+ * needed) — TypeScript's structural typing checks the shape on the
+ * call site. Tools never instantiate these themselves; the caller
+ * passes a ready `ToolContext` into `dispatchToolCall`.
+ */
+interface GraphqlClient {
+    query<T>(operation: string, variables?: Record<string, unknown>): Promise<T>;
+}
+interface StorageClient {
+    /**
+     * Upload `body` to the bucket at `key` with `contentType`. Returns
+     * the public URL of the stored object (same format both routes use:
+     * https://{bucket}.s3.{region}.amazonaws.com/{key}).
+     */
+    putObject(key: string, body: Uint8Array, contentType: string): Promise<string>;
+}
+interface ToolContext {
+    graphql: GraphqlClient;
+    storage: () => StorageClient;
+    defaultSiteId: string;
+}
+
+interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<unknown>;
+}
+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>;
+/**
+ * `tools` is the canonical registry; `getTools()` returns it for
+ * callers that prefer a function over a top-level constant (admin's
+ * HTTP factory exposes this through its options shape).
+ */
+declare function getTools(): readonly ToolDefinition[];
+
+export { type GraphqlClient, type StorageClient, type ToolContext, type ToolDefinition, dispatchToolCall, getTools, tools };

package/dist/tools/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  dispatchToolCall,
+  getTools,
+  tools
+} from "../chunk-KM6F5QJH.js";
+import "../chunk-LMMQX4CK.js";
+export {
+  dispatchToolCall,
+  getTools,
+  tools
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/mcp-server",
-  "version": "0.2.0-alpha.3",
+  "version": "0.2.0-alpha.5",
   "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",
@@ -11,6 +11,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./tools": {
+      "import": "./dist/tools/index.js",
+      "types": "./dist/tools/index.d.ts"
     }
   },
   "files": [
@@ -31,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.3"
+    "ampless": "0.2.0-alpha.5"
   },
   "keywords": [
     "ampless",