@ampless/mcp-server 1.0.0-alpha.24 → 1.0.0-alpha.25

package/README.ja.md

@@ -68,6 +68,7 @@ import type { ToolDefinition, ToolContext, ResolvedSite } from '@ampless/mcp-ser
 | `update_post` | editor | 既存の投稿のフィールドをパッチ更新 |
 | `delete_post` | editor | 投稿を削除しタグインデックスをクリーンアップ |
 | `upload_media` | editor | Base64 エンコードされたバイト列を S3 にアップロードし Media レコードを作成 |
+| `delete_media` | editor | メディアファイルを削除（S3 オブジェクト + Media 行）。`mediaId` または `src` で指定 |
 | `get_schema` | reader | CMS コンテンツスキーマを返す |
 | `upload_static_bundle` | editor | ビルド済み静的バンドルを S3 にアップロード |
 | `list_static_files` | reader | 静的バンドルファイルを一覧表示 |

package/README.md

@@ -68,6 +68,7 @@ import type { ToolDefinition, ToolContext, ResolvedSite } from '@ampless/mcp-ser
 | `update_post` | editor | Patch fields on an existing post |
 | `delete_post` | editor | Delete a post and clean up its tag index |
 | `upload_media` | editor | Upload base64-encoded bytes to S3 and create a Media record |
+| `delete_media` | editor | Delete a media file (S3 object + Media row). Pass `mediaId` or `src` |
 | `get_schema` | reader | Return the CMS content schema |
 | `upload_static_bundle` | editor | Upload a pre-built static bundle to S3 |
 | `list_static_files` | reader | List static bundle files |

package/dist/index.js

@@ -353,6 +353,92 @@ async function uploadMedia(graphql, storage, args) {
   return { media: data.createMedia, url: putResult.url };
 }
 
+// src/tools/delete-media.ts
+var GET_BY_ID2 = (
+  /* GraphQL */
+  `
+  query GetMedia($mediaId: ID!) {
+    getMedia(mediaId: $mediaId) {
+      mediaId
+      src
+    }
+  }
+`
+);
+var GET_BY_SRC = (
+  /* GraphQL */
+  `
+  query GetMediaBySrc($src: String!) {
+    getMediaBySrc(src: $src) {
+      mediaId
+      src
+    }
+  }
+`
+);
+var DELETE = (
+  /* GraphQL */
+  `
+  mutation DeleteMedia($input: DeleteMediaInput!) {
+    deleteMedia(input: $input) {
+      mediaId
+    }
+  }
+`
+);
+var deleteMediaSchema = {
+  type: "object",
+  properties: {
+    mediaId: {
+      type: "string",
+      description: "Media row primary key (e.g. 'media-1714400000000-abc123' as returned by `upload_media`). Provide either `mediaId` or `src`; mediaId is the direct path."
+    },
+    src: {
+      type: "string",
+      description: "Full S3 key including `public/` (e.g. 'public/media/2026/05/1714400000000-photo.jpg'). Use when you only have the public URL \u2014 strip `/api/media/` and prepend `public/`. Provide either `mediaId` or `src`."
+    }
+  }
+};
+async function deleteMedia(graphql, storage, args) {
+  if (!args.mediaId && !args.src) {
+    throw new Error("delete_media: provide `mediaId` or `src`");
+  }
+  let mediaId;
+  let src;
+  if (args.mediaId) {
+    const data = await graphql.query(GET_BY_ID2, { mediaId: args.mediaId });
+    if (data.getMedia) {
+      mediaId = data.getMedia.mediaId;
+      src = data.getMedia.src;
+    }
+  } else {
+    const data = await graphql.query(GET_BY_SRC, { src: args.src });
+    if (data.getMediaBySrc) {
+      mediaId = data.getMediaBySrc.mediaId;
+      src = data.getMediaBySrc.src;
+    }
+  }
+  if (!mediaId) {
+    if (args.src) {
+      await storage.deleteObject(args.src);
+      return {
+        deleted: false,
+        reason: "media row not found; S3 object delete attempted (idempotent)",
+        src: args.src
+      };
+    }
+    return {
+      deleted: false,
+      reason: "media row not found for mediaId"
+    };
+  }
+  await storage.deleteObject(src);
+  await graphql.query(DELETE, {
+    input: { mediaId }
+  });
+  return { deleted: true, mediaId, src };
+}
+
 // src/tools/get-schema.ts
 var getSchemaSchema = {
   type: "object",
@@ -1309,6 +1395,17 @@ var tools = [
     inputSchema: uploadMediaSchema,
     handler: (args, ctx) => uploadMedia(ctx.graphql, ctx.storage(), args)
   },
+  {
+    name: "delete_media",
+    description: "Delete a media file: removes the S3 object and the Media row. Pass `mediaId` (from `upload_media`'s response) or `src` (full S3 key like `public/media/2026/05/...`). When only `src` is given, looks up the Media row via `getMediaBySrc`. S3 delete runs first, then the DDB row delete \u2014 both are idempotent so re-running converges on missing-key cases. Returns `{ deleted: false }` instead of throwing when no Media row matches; if `src` was supplied directly the S3 object is still removed (use this to sweep orphan files).",
+    inputSchema: deleteMediaSchema,
+    handler: (args, ctx) => deleteMedia(
+      ctx.graphql,
+      ctx.storage(),
+      args
+    ),
+    destructive: true
+  },
   {
     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.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/mcp-server",
-  "version": "1.0.0-alpha.24",
+  "version": "1.0.0-alpha.25",
   "description": "MCP tool registry shared by @ampless/backend mcp-handler Lambda. Installed transitively via @ampless/admin / @ampless/backend; no direct install needed.",
   "publishConfig": {
     "access": "public"