@contentrain/mcp 1.9.0 → 1.10.1

package/dist/{server-B6_fzRmK.mjs → server-BkDuFvVt.mjs}

@@ -5,19 +5,19 @@ import { n as readVocabulary, t as readConfig } from "./config-DlFcTxFG.mjs";
 import { S as writeContent, _ as resolveMdFilePath, a as fieldDefZodSchema, c as validateModelDefinition, d as listContent, g as resolveLocaleStrategy, h as resolveJsonFilePath, l as writeModel, m as resolveContentDir, n as checkReferences, o as listModels, r as countEntries, s as readModel, u as deleteContent } from "./model-manager-BhLsUgaB.mjs";
 import { n as readMeta, r as writeMeta } from "./meta-manager-C900rEyG.mjs";
 import { n as readContext } from "./context-CYN__o3Q.mjs";
-import { a as deleteRemoteBranch, c as pruneMergedRemoteBranches, i as cleanupMergedBranches, n as checkBranchHealth, s as listRemoteCrBranches } from "./branch-lifecycle-D7tXOE4f.mjs";
-import { i as mergeBranch, n as createTransaction, r as ensureContentBranch, t as buildBranchName } from "./transaction-qliKvBRL.mjs";
-import { n as isMerged, t as LocalProvider } from "./local-BZEUWBoC.mjs";
-import { n as isToolAvailable, t as TOOL_REQUIREMENTS } from "./availability-Bj9zOfEn.mjs";
+import { a as deleteRemoteBranch, c as pruneMergedRemoteBranches, i as cleanupMergedBranches, n as checkBranchHealth, s as listRemoteCrBranches } from "./branch-lifecycle-Dd84lx37.mjs";
+import { i as mergeBranch, n as createTransaction, r as ensureContentBranch, t as buildBranchName } from "./transaction-DhVoGigz.mjs";
+import { n as isMerged, t as LocalProvider } from "./local-BIE23GuI.mjs";
+import { n as isToolAvailable, t as TOOL_REQUIREMENTS } from "./availability-sWWRz2W0.mjs";
 import { t as detectStack } from "./detect-wVSI9VuY.mjs";
-import { t as TOOL_ANNOTATIONS } from "./annotations-DSzewhL4.mjs";
+import { t as TOOL_ANNOTATIONS } from "./annotations-D3tlsF38.mjs";
 import { n as listTemplates, t as getTemplate } from "./templates-D6EllixQ.mjs";
 import { t as validateProject } from "./validator-8vaPxSba.mjs";
 import { t as OverlayReader } from "./overlay-reader-BOb105gS.mjs";
 import { t as buildGraph } from "./graph-builder-CRUX_8mA.mjs";
 import { n as scanSummary, t as scanCandidates } from "./scanner-VOwrKLGC.mjs";
-import { n as applyExtract, r as applyReuse } from "./apply-manager-BnPbPXFG.mjs";
-import { t as runDoctor } from "./doctor-BTToHt0y.mjs";
+import { n as applyExtract, r as applyReuse } from "./apply-manager-UXUTYFZn.mjs";
+import { t as runDoctor } from "./doctor-BwSJW1sS.mjs";
 import { join } from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { CONTENTRAIN_BRANCH } from "@contentrain/types";
@@ -2368,8 +2368,137 @@ function registerDoctorTools(server, _provider, projectRoot) {
 	});
 }
 //#endregion
+//#region src/tools/media.ts
+/**
+* Media tools — a deterministic passthrough to the provider's optional
+* media facet (`RepoProvider.media`). Registration is capability-aware:
+* `createServer` skips all five tools when the provider has no media
+* stack, so the guard below is defense in depth only.
+*
+* The facet closes the discovery loop for external agents: list assets →
+* pick a `media/...` path → reference it via `contentrain_content_save`
+* (which normalizes it to an absolute delivery URL when `mediaBaseUrl`
+* is set). Ingest is URL-based — MCP has no binary channel — and the
+* provider implementation owns SSRF/MIME/size policy for the fetch.
+*/
+function mediaUnavailable(tool) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify({
+				error: `${tool} requires a provider with a media stack.`,
+				capability_required: "media",
+				hint: "Media tools are available when MCP is driven by a media-capable provider (e.g. Studio MCP Cloud). Local and plain git providers do not expose one."
+			})
+		}],
+		isError: true
+	};
+}
+function mediaError(error, stage) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify({ ...normalizeOperationError(error, stage) })
+		}],
+		isError: true
+	};
+}
+function ok(payload) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(payload)
+	}] };
+}
+function registerMediaTools(server, provider, _projectRoot) {
+	server.tool("contentrain_media_list", "List media assets from the provider media stack. Returns storage paths (media/...) usable in media/image/file fields via contentrain_content_save, plus delivery URLs when available. Supports search, tag filter, and cursor pagination.", {
+		search: z.string().optional().describe("Substring match on filename/path/alt"),
+		tag: z.string().optional().describe("Only assets carrying this tag"),
+		limit: z.number().int().min(1).max(100).optional().describe("Page size. Default: provider-defined"),
+		cursor: z.string().optional().describe("Opaque cursor from a previous response")
+	}, TOOL_ANNOTATIONS["contentrain_media_list"], async (input) => {
+		if (!provider.media) return mediaUnavailable("contentrain_media_list");
+		try {
+			const result = await provider.media.list(input);
+			return ok({
+				assets: result.assets,
+				next_cursor: result.nextCursor,
+				total: result.total
+			});
+		} catch (error) {
+			return mediaError(error, "media_list");
+		}
+	});
+	server.tool("contentrain_media_get", "Get a single media asset by id, including its storage path, delivery URL, and metadata.", { id: z.string().describe("Asset id (from contentrain_media_list)") }, TOOL_ANNOTATIONS["contentrain_media_get"], async (input) => {
+		if (!provider.media) return mediaUnavailable("contentrain_media_get");
+		try {
+			const asset = await provider.media.get(input.id);
+			if (!asset) return {
+				content: [{
+					type: "text",
+					text: JSON.stringify({
+						error: `Media asset not found: ${input.id}`,
+						hint: "Use contentrain_media_list to discover asset ids."
+					})
+				}],
+				isError: true
+			};
+			return ok({ asset });
+		} catch (error) {
+			return mediaError(error, "media_get");
+		}
+	});
+	server.tool("contentrain_media_ingest", "Ingest a media asset from a source URL. The provider fetches the URL server-side under its own SSRF/MIME/size policy and stores the asset in the media stack. Returns the stored asset with its media/... path.", {
+		url: z.string().url().describe("Source URL to fetch server-side"),
+		filename: z.string().optional().describe("Target filename override"),
+		alt: z.string().optional().describe("Alt text for the asset"),
+		tags: z.array(z.string()).max(20).optional().describe("Tags to attach")
+	}, TOOL_ANNOTATIONS["contentrain_media_ingest"], async (input) => {
+		if (!provider.media) return mediaUnavailable("contentrain_media_ingest");
+		try {
+			return ok({
+				status: "ingested",
+				asset: await provider.media.ingest(input)
+			});
+		} catch (error) {
+			return mediaError(error, "media_ingest");
+		}
+	});
+	server.tool("contentrain_media_update", "Update metadata (alt text, tags, filename) of an existing media asset. Does not touch the binary.", {
+		id: z.string().describe("Asset id to update"),
+		alt: z.string().optional().describe("New alt text"),
+		tags: z.array(z.string()).max(20).optional().describe("Replacement tag list"),
+		filename: z.string().optional().describe("New filename")
+	}, TOOL_ANNOTATIONS["contentrain_media_update"], async (input) => {
+		if (!provider.media) return mediaUnavailable("contentrain_media_update");
+		try {
+			const { id, ...patch } = input;
+			return ok({
+				status: "updated",
+				asset: await provider.media.update(id, patch)
+			});
+		} catch (error) {
+			return mediaError(error, "media_update");
+		}
+	});
+	server.tool("contentrain_media_delete", "Delete a media asset from the media stack. Content entries referencing its path are NOT rewritten — check references before deleting.", {
+		id: z.string().describe("Asset id to delete"),
+		confirm: z.literal(true).describe("Must be true to confirm deletion")
+	}, TOOL_ANNOTATIONS["contentrain_media_delete"], async (input) => {
+		if (!provider.media) return mediaUnavailable("contentrain_media_delete");
+		try {
+			await provider.media.delete(input.id);
+			return ok({
+				status: "deleted",
+				id: input.id
+			});
+		} catch (error) {
+			return mediaError(error, "media_delete");
+		}
+	});
+}
+//#endregion
 //#region package.json
-var version = "1.9.0";
+var version = "1.10.1";
 //#endregion
 //#region src/server.ts
 /**
@@ -2410,6 +2539,7 @@ function createServer(input) {
 	registerNormalizeTools(server, provider, projectRoot);
 	registerBulkTools(server, provider, projectRoot);
 	registerDoctorTools(server, provider, projectRoot);
+	registerMediaTools(server, provider, projectRoot);
 	return server;
 }
 function resolveServerContext(input) {
@@ -2438,4 +2568,4 @@ function resolveServerContext(input) {
 //#endregion
 export { createServer as n, DEFAULT_INSTRUCTIONS as t };
 
-//# sourceMappingURL=server-B6_fzRmK.mjs.map
+//# sourceMappingURL=server-BkDuFvVt.mjs.map