drupal-mcp-connector 2.15.2 → 2.17.0

package/src/tools/taxonomy.js

@@ -12,6 +12,7 @@ import {
   resolveSecurityConfig, redactCanonicalEntity,
   assertReadAllowed, assertWriteAllowed, assertDeleteAllowed,
 } from "../lib/security.js";
+import { assertDraftLangcode } from "../lib/draft-write.js";
 
 // ---------------------------------------------------------------------------
 // Implementations
@@ -58,12 +59,15 @@ async function getTaxonomyTerms({ site: siteName, vocabulary, limit = 50, offset
  * @param {object} args - { site?, vocabulary, id }.
  * @returns {Promise<object|null>} The redacted term, or null if not found.
  */
-async function getTaxonomyTerm({ site: siteName, vocabulary, id }) {
+async function getTaxonomyTerm({ site: siteName, vocabulary, id, langcode }) {
   const site = getSiteConfig(siteName);
   const sec = resolveSecurityConfig(site);
   assertReadAllowed(sec, "taxonomy_term", vocabulary);
   const backend = await resolveBackend(site);
-  const entity = await backend.getEntity({ entityType: "taxonomy_term", bundle: vocabulary, id });
+  const entity = await backend.getEntity({
+    entityType: "taxonomy_term", bundle: vocabulary, id,
+    ...(langcode ? { langcode: assertDraftLangcode(langcode) } : {}),
+  });
   return entity ? redactCanonicalEntity(entity, sec, "taxonomy_term") : null;
 }
 
@@ -93,7 +97,7 @@ async function createTaxonomyTerm({ site: siteName, vocabulary, name, descriptio
  * @param {object} args - { site?, vocabulary, id, name?, description?, weight? }.
  * @returns {Promise<object>} The updated term descriptor.
  */
-async function updateTaxonomyTerm({ site: siteName, vocabulary, id, name, description, weight }) {
+async function updateTaxonomyTerm({ site: siteName, vocabulary, id, name, description, weight, langcode }) {
   const site = getSiteConfig(siteName);
   assertWriteAllowed(resolveSecurityConfig(site), "update", "taxonomy_term", vocabulary);
   const backend = await resolveBackend(site);
@@ -101,7 +105,10 @@ async function updateTaxonomyTerm({ site: siteName, vocabulary, id, name, descri
   if (name !== undefined) attributes.name = name;
   if (weight !== undefined) attributes.weight = weight;
   if (description !== undefined) attributes.description = { value: description, format: "plain_text" };
-  return backend.updateEntity({ entityType: "taxonomy_term", bundle: vocabulary, id, attributes });
+  return backend.updateEntity({
+    entityType: "taxonomy_term", bundle: vocabulary, id, attributes,
+    ...(langcode ? { langcode: assertDraftLangcode(langcode) } : {}),
+  });
 }
 
 /**
@@ -147,13 +154,14 @@ export const definitions = [
   },
   {
     name: "drupal_get_taxonomy_term",
-    description: "Fetch a single taxonomy term by UUID.",
+    description: "Fetch a single taxonomy term by UUID. Pass langcode to request that translation; omit for the default language. JSON:API must negotiate language or the tool errors if a different language is served.",
     inputSchema: {
       type: "object", required: ["vocabulary", "id"],
       properties: {
         site:       { type: "string" },
         vocabulary: { type: "string" },
         id:         { type: "string", description: "Term UUID" },
+        langcode:   { type: "string", description: "Translation language (e.g. 'es'). Omit for the default language." },
       },
     },
   },
@@ -174,7 +182,7 @@ export const definitions = [
   },
   {
     name: "drupal_update_taxonomy_term",
-    description: "Update an existing taxonomy term's name, description, or weight.",
+    description: "Update an existing taxonomy term's name, description, or weight. Pass langcode to update an existing translation; this does not create a missing translation.",
     inputSchema: {
       type: "object", required: ["vocabulary", "id"],
       properties: {
@@ -184,6 +192,7 @@ export const definitions = [
         name:        { type: "string" },
         description: { type: "string" },
         weight:      { type: "number" },
+        langcode:    { type: "string", description: "Existing translation to update (e.g. 'es'). Omit for the default language." },
       },
     },
   },

package/src/tools/translations.js

@@ -9,12 +9,15 @@
  *   - drupal_create_translation — add a language as an unpublished forward draft
  *
  * Continuation of an existing unpublished translation is drupal_update_node
- * with `langcode`. Reads of that draft are drupal_get_node / drupal_get_revision
+ * with `langcode` (media: drupal_update_media; paragraph: drupal_update_paragraph).
+ * Reads of that draft are drupal_get_node / drupal_get_media / drupal_get_paragraph
  * with `langcode`.
  *
  * Paragraph field-value translation uses the same surface with
- * entityType "paragraph" and the pinned paragraph revision. Image alt is a
- * node relationship (`meta.alt`) with the shared file target unchanged.
+ * entityType "paragraph" and the pinned paragraph revision. Media uses the
+ * node live/working pair (`entityType: "media"`). Image alt on a media entity
+ * is the file relationship (`field_media_image` + `meta.alt`) with the shared
+ * file target unchanged.
  */
 
 import { getSiteConfig } from "../lib/config.js";
@@ -34,6 +37,7 @@ import {
   readTranslationInventory,
   resolveNodeTranslationPair,
 } from "../lib/draft-write.js";
+import { mapTranslationRow } from "../lib/translation-rows.js";
 
 const LIST_NOTE =
   "Live languages are those on the default revision. Working languages are the " +
@@ -61,7 +65,8 @@ async function listTranslations({ site: siteName, entityType = "node", type, id
   assertReadAllowed(sec, entityType, type);
 
   const backend = await resolveBackend(site);
-  if ((entityType === "node" || entityType === "paragraph") && typeof backend.rawQuery === "function") {
+  if ((entityType === "node" || entityType === "paragraph" || entityType === "media")
+    && typeof backend.rawQuery === "function") {
     try {
       const meta = await readTranslationInventory(backend, { entityType, bundle: type, id });
       const liveLangs = (meta.live?.translations ?? []).map((row) => row.langcode);
@@ -75,13 +80,7 @@ async function listTranslations({ site: siteName, entityType = "node", type, id
         langcodes,
         live: meta.live ?? null,
         working: meta.working ?? null,
-        translations: (meta.working?.translations ?? meta.live?.translations ?? []).map((row) => ({
-          langcode: row.langcode,
-          default: Boolean(row.default),
-          status: row.status,
-          title: row.title,
-          moderation_state: row.moderation_state,
-        })),
+        translations: (meta.working?.translations ?? meta.live?.translations ?? []).map(mapTranslationRow),
         note: LIST_NOTE,
       };
     } catch (error) {
@@ -132,8 +131,8 @@ async function createTranslation({
   const sec = resolveSecurityConfig(site);
   assertWriteAllowed(sec, "update", entityType, type);
 
-  if (entityType !== "node" && entityType !== "paragraph") {
-    throw new Error("Governed translation create is implemented for nodes and paragraphs.");
+  if (entityType !== "node" && entityType !== "paragraph" && entityType !== "media") {
+    throw new Error("Governed translation create is implemented for nodes, paragraphs, and media.");
   }
 
   const backend = await resolveBackend(site);
@@ -156,12 +155,14 @@ async function createTranslation({
     draftRevision = await resolveNodeTranslationPair(backend, {
       entityType, bundle: type, id, existing,
     });
-    if (drafted.status === undefined && drafted.moderation_state === undefined) {
-      drafted.moderation_state = "draft";
+    if (entityType === "node") {
+      if (drafted.status === undefined && drafted.moderation_state === undefined) {
+        drafted.moderation_state = "draft";
+      }
+      drafted = await applySafeDraftDefault({
+        backend, entityType, bundle: type, id, attributes: drafted, existingEntity: existing,
+      });
     }
-    drafted = await applySafeDraftDefault({
-      backend, entityType, bundle: type, id, attributes: drafted, existingEntity: existing,
-    });
     assertPublishAllowed(sec, drafted);
   }
 
@@ -179,7 +180,7 @@ async function createTranslation({
     entityType, bundle: type, id, langcode: targetLang, attributes: drafted, relationships, draftRevision,
   });
   const redacted = omitLiveComputedMetatag(redactCanonicalEntity(created, sec, entityType));
-  if (entityType !== "node") return redacted;
+  if (entityType === "paragraph") return redacted;
   const workingVid = entityRevisionId(created) ?? draftRevision.workingVid;
   const liveVid = draftRevision.liveVid;
   if (liveVid === undefined || liveVid === null) {
@@ -198,15 +199,16 @@ export const definitions = [
   {
     name: "drupal_list_translations",
     description:
-      "List live and working translation langcodes for a Drupal node or paragraph. Uses Sentinel's " +
+      "List live and working translation langcodes for a Drupal node, paragraph, or media entity. Uses Sentinel's " +
       "translation inventory when available (live default revision vs unpublished working " +
-      "draft). Core JSON:API alone serves one language and cannot prove others are absent. " +
+      "draft), including core content_translation_outdated and source when the server sends them. " +
+      "Core JSON:API alone serves one language and cannot prove others are absent. " +
       "Defaults to node.",
     inputSchema: {
       type: "object", required: ["type", "id"],
       properties: {
         site:       { type: "string", description: "Named site (omit for default)" },
-        entityType: { type: "string", description: "Entity type machine name. Default: 'node'." },
+        entityType: { type: "string", description: "Entity type machine name. Default: 'node'. Use 'paragraph' or 'media' when listing those." },
         type:       { type: "string", description: "Bundle machine name, e.g. 'basic_page'" },
         id:         { type: "string", description: "Entity UUID" },
       },
@@ -223,15 +225,17 @@ export const definitions = [
       "paragraph ERR pins stay unchanged. An existing translation is a conflict, not an overwrite. " +
       "The response includes `_revisions.live` / `_revisions.working` when known. " +
       "Computed `metatag` is omitted on the draft body because JSON:API resolves it from the live default (#283); use field_metatags. " +
-      "Continue a node draft with drupal_update_node and langcode; continue a paragraph with " +
-      "drupal_update_paragraph and langcode. Image alt is a relationship (same file UUID, " +
-      "meta.alt). For paragraphs pass revisionId as the host pin. Requires Sentinel's " +
-      "draft-translation endpoint. Publication stays denied for content-tier callers.",
+      "Continue a node draft with drupal_update_node and langcode; a paragraph with " +
+      "drupal_update_paragraph and langcode; media with drupal_update_media and langcode. " +
+      "Image alt is a relationship (same file UUID, meta.alt) — on media that is " +
+      "field_media_image, not a node image field. For paragraphs pass revisionId as the " +
+      "host pin. Requires Sentinel's draft-translation endpoint. Publication stays denied " +
+      "for content-tier callers.",
     inputSchema: {
       type: "object", required: ["type", "id", "langcode"],
       properties: {
         site:          { type: "string" },
-        entityType:    { type: "string", description: "Entity type machine name. Default: 'node'. Use 'paragraph' for paragraph field values." },
+        entityType:    { type: "string", description: "Entity type machine name. Default: 'node'. Use 'paragraph' for paragraph field values, 'media' for media (name, caption, image alt)." },
         type:          { type: "string", description: "Bundle machine name, e.g. 'basic_page' or 'p_hero'" },
         id:            { type: "string", description: "Entity UUID" },
         langcode:      { type: "string", description: "Target language code, e.g. 'es', 'de', 'pt-br'" },