@modyo/mcp 0.1.0

package/build/tools/content/entries/UpdateOrCreate.d.ts

@@ -0,0 +1,193 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    spaceId: z.ZodNumber;
+    content_type_id: z.ZodNumber;
+    slug: z.ZodString;
+    name: z.ZodString;
+    excerpt: z.ZodOptional<z.ZodString>;
+    category_id: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    segments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    private: z.ZodDefault<z.ZodBoolean>;
+    field_values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"string">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"text">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"rich_text">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"dropdown">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"radio">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"checkbox">;
+        multi: z.ZodLiteral<true>;
+        value: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"multiple">;
+        multi: z.ZodLiteral<true>;
+        value: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"boolean">;
+        value: z.ZodBoolean;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"integer">;
+        value: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"decimal">;
+        value: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"date">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"locations">;
+        value: z.ZodArray<z.ZodObject<{
+            location_street: z.ZodString;
+            administrative_area_level_2: z.ZodString;
+            administrative_area_level_1: z.ZodString;
+            country: z.ZodString;
+            lat: z.ZodNumber;
+            lng: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"asset">;
+        value: z.ZodObject<{
+            id: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"assets">;
+        value: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"content_type">;
+        value: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"content_types">;
+        value: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodNullable<z.ZodNumber>;
+        field_id: z.ZodNumber;
+        type: z.ZodLiteral<"group">;
+        value: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"string">;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"text">;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"rich_text">;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"dropdown">;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"radio">;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"checkbox">;
+            multi: z.ZodLiteral<true>;
+            value: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"multiple">;
+            multi: z.ZodLiteral<true>;
+            value: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"boolean">;
+            value: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"integer">;
+            value: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"decimal">;
+            value: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"date">;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"locations">;
+            value: z.ZodArray<z.ZodObject<{
+                location_street: z.ZodString;
+                administrative_area_level_2: z.ZodString;
+                administrative_area_level_1: z.ZodString;
+                country: z.ZodString;
+                lat: z.ZodNumber;
+                lng: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"asset">;
+            value: z.ZodObject<{
+                id: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"assets">;
+            value: z.ZodArray<z.ZodObject<{
+                id: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"content_type">;
+            value: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            field_id: z.ZodNumber;
+            parent_id: z.ZodNullable<z.ZodNumber>;
+            type: z.ZodLiteral<"content_types">;
+            value: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>]>>>;
+    target_locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const UpdateOrCreate: Tool;
+export {};
+//# sourceMappingURL=UpdateOrCreate.d.ts.map

package/build/tools/content/entries/UpdateOrCreate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateOrCreate.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/entries/UpdateOrCreate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBhB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAgUxD,eAAO,MAAM,cAAc,EAAE,IAAoC,CAAC"}

package/build/tools/content/entries/UpdateOrCreate.js

@@ -0,0 +1,245 @@
+import { EntriesRepository } from "../../../repositories/content/entries/EntriesRepository.js";
+import { SpacesRepository } from "../../../repositories/content/spaces/SpacesRepository.js";
+import { TypesRepository } from "../../../repositories/content/types/TypesRepository.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+import { FieldsSchema } from "./FieldsSchema.js";
+import { resolveFieldIds } from "./resolveFieldIds.js";
+const paramsSchema = z.object({
+    spaceId: z.number().min(1).describe("The ID of the space"),
+    content_type_id: z.number().min(1).describe("Content type ID"),
+    slug: z
+        .string()
+        .refine((el) => /^[a-zA-Z0-9_-]+$/.test(el), {
+        message: "Slug must contain only letters, numbers, hyphens, underscores",
+    })
+        .describe("Slug (alphanumeric, hyphens, underscores)"),
+    name: z.string().min(1).describe("Entry name"),
+    excerpt: z.string().max(160).optional(),
+    category_id: z.number().min(0).optional().describe("Omit to leave unchanged"),
+    tags: z.array(z.string()).default([]),
+    segments: z.array(z.string()).optional(),
+    private: z.boolean().default(false),
+    field_values: z.array(FieldsSchema).optional(),
+    target_locale: z
+        .string()
+        .optional()
+        .describe("Secondary locale (e.g., 'es'). Omit for default."),
+});
+class UpdateOrCreateEntryTool extends ToolBase {
+    config = {
+        name: "content-entries-upsert",
+        description: `Idempotent entry create/update by slug. Auto-detects existence. 📚 modyo://docs/tools/content-entries-upsert`,
+        annotations: {
+            title: "Upsert Entry",
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { spaceId, slug, content_type_id, target_locale, ...entryData } = params;
+        const repository = await this.getRepository(EntriesRepository);
+        this.debug("Checking if entry exists", {
+            spaceId,
+            slug,
+        });
+        try {
+            // Resolve positional field_ids to real IDs before any create/update
+            if (entryData.field_values && entryData.field_values.length > 0) {
+                const typesRepo = await this.getRepository(TypesRepository);
+                entryData.field_values = await resolveFieldIds(typesRepo, spaceId, content_type_id, entryData.field_values, (msg, data) => this.debug(msg, data));
+            }
+            // Step 1: Try lightweight query search first (1 request vs full pagination)
+            let existingEntry = await this.findEntryByQuery(repository, spaceId, slug, content_type_id, target_locale);
+            // Step 2: If not found, fall back to full pagination (covers edge cases
+            // like entries not indexed by query, or entries in non-standard states)
+            if (!existingEntry) {
+                this.debug("Entry not found via query, falling back to pagination", {
+                    slug,
+                });
+                const allEntries = await repository.getAllEntries(spaceId, {
+                    type_id: content_type_id,
+                    ...(target_locale
+                        ? {
+                            target_locale,
+                        }
+                        : {}),
+                });
+                existingEntry = allEntries.find((entry) => entry.slug === slug);
+            }
+            if (existingEntry) {
+                // Entry exists - update it
+                this.debug("Entry found, updating", {
+                    entryId: existingEntry.id,
+                    slug,
+                });
+                const updatedEntry = await repository.updateEntry(spaceId, existingEntry.id, entryData, target_locale);
+                this.debug("Entry updated successfully", {
+                    entryId: updatedEntry.id,
+                });
+                return this.success({
+                    id: updatedEntry.id,
+                    uuid: updatedEntry.uuid,
+                    slug: updatedEntry.slug,
+                    action: "updated",
+                });
+            }
+            // Entry doesn't exist - create it
+            this.debug("Entry not found, creating new", {
+                slug,
+            });
+            try {
+                const newEntry = await repository.createEntry(spaceId, {
+                    slug,
+                    content_type_id,
+                    ...entryData,
+                }, target_locale);
+                this.debug("Entry created successfully", {
+                    entryId: newEntry.id,
+                });
+                return this.success({
+                    id: newEntry.id,
+                    uuid: newEntry.uuid,
+                    slug: newEntry.slug,
+                    action: "created",
+                });
+            }
+            catch (createError) {
+                // If create fails with 422 slug conflict, the entry exists but
+                // wasn't found by Admin API searches (published-only entry with
+                // no pending draft). Use the Content API to find it.
+                const err = createError;
+                if (err.statusCode === 422 &&
+                    err.message &&
+                    /slug/i.test(err.message)) {
+                    this.debug("Create failed with 422 slug conflict, searching via Content API", {
+                        slug,
+                    });
+                    // Last resort: search the public Content API for the published entry
+                    const entryId = await this.findPublishedEntryId(repository, spaceId, content_type_id, slug, target_locale);
+                    if (entryId) {
+                        this.debug("Found published entry via Content API, updating", {
+                            entryId,
+                            slug,
+                        });
+                        const updatedEntry = await repository.updateEntry(spaceId, entryId, entryData, target_locale);
+                        return this.success({
+                            id: updatedEntry.id,
+                            uuid: updatedEntry.uuid,
+                            slug: updatedEntry.slug,
+                            action: "updated",
+                        });
+                    }
+                    throw new Error(`Entry with slug "${slug}" already exists but could not be found for update. The entry may be in a state not accessible via the API.`);
+                }
+                throw createError;
+            }
+        }
+        catch (error) {
+            this.logError("Failed to update or create entry", {
+                spaceId,
+                slug,
+                error,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Searches for an entry by slug using the query text search parameter.
+     * Tries with type_id first, then without (slugs are unique across the space).
+     */
+    async findEntryByQuery(repository, spaceId, slug, typeId, targetLocale) {
+        const searchConfigs = typeId
+            ? [
+                {
+                    type_id: typeId,
+                },
+                {},
+            ]
+            : [
+                {},
+            ];
+        for (const filters of searchConfigs) {
+            const searchResult = await repository.getEntries(spaceId, {
+                query: slug,
+                ...filters,
+                per_page: 100,
+            }, targetLocale);
+            const matched = (searchResult.entries || []).find((entry) => entry.slug === slug);
+            if (matched)
+                return matched;
+        }
+        return undefined;
+    }
+    /**
+     * Finds the numeric entry ID of a published-only entry via the Content API.
+     *
+     * The Admin API list endpoint does not return entries that are published
+     * without a pending draft version. The public Content API always returns
+     * published entries and supports filtering by slug.
+     *
+     * Flow: Content API (slug → UUID) → Admin API (UUID → numeric ID)
+     */
+    async findPublishedEntryId(repository, spaceId, contentTypeId, slug, targetLocale) {
+        try {
+            // Get space UID and type UID needed for Content API
+            const spacesRepo = await this.getRepository(SpacesRepository);
+            const typesRepo = await this.getRepository(TypesRepository);
+            const [space, type] = await Promise.all([
+                spacesRepo.getSpace(spaceId),
+                typesRepo.getType(spaceId, contentTypeId),
+            ]);
+            if (!space?.uid || !type?.uid) {
+                this.debug("Could not resolve space/type UIDs", {
+                    spaceUid: space?.uid,
+                    typeUid: type?.uid,
+                });
+                return undefined;
+            }
+            // Search the public Content API by slug
+            const entryUuid = await repository.findPublishedEntryUuidBySlug(space.uid, type.uid, slug);
+            if (!entryUuid) {
+                this.debug("Entry not found in Content API", {
+                    slug,
+                });
+                return undefined;
+            }
+            this.debug("Found published entry UUID via Content API", {
+                uuid: entryUuid,
+                slug,
+            });
+            // Try to get the numeric ID via the Admin API's UID-based endpoint
+            const numericId = await repository.getPublishedEntryId(space.uid, type.uid, entryUuid);
+            if (numericId) {
+                this.debug("Resolved numeric entry ID", {
+                    entryId: numericId,
+                    uuid: entryUuid,
+                });
+                return numericId;
+            }
+            // If UID-based endpoint didn't return a numeric ID, try fetching
+            // the entry directly by ID. The Admin API's individual GET endpoint
+            // may still work for published-only entries if we can find the ID.
+            // As a last resort, search Admin API entries by UUID as query text.
+            const searchResult = await repository.getEntries(spaceId, {
+                query: entryUuid,
+                per_page: 10,
+            }, targetLocale);
+            const match = searchResult.entries?.find((e) => e.uuid === entryUuid);
+            return match?.id;
+        }
+        catch (error) {
+            this.debug("Content API fallback failed", {
+                error: error.message,
+            });
+            return undefined;
+        }
+    }
+}
+export const UpdateOrCreate = new UpdateOrCreateEntryTool();
+//# sourceMappingURL=UpdateOrCreate.js.map

package/build/tools/content/entries/UpdateOrCreate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateOrCreate.js","sourceRoot":"","sources":["../../../../src/tools/content/entries/UpdateOrCreate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC1D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC9D,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAC3C,OAAO,EAAE,+DAA+D;KACzE,CAAC;SACD,QAAQ,CAAC,2CAA2C,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC7E,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;IAC9C,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC,CAAC;AAIH,MAAM,uBAAwB,SAAQ,QAAsB;IAChD,MAAM,GAAG;QACjB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,8GAA8G;QAC3H,WAAW,EAAE;YACX,KAAK,EAAE,cAAc;YACrB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEQ,eAAe;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,MAAoB;QAC1C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,GACnE,MAAM,CAAC;QACT,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;QAE/D,IAAI,CAAC,KAAK,CAAC,0BAA0B,EAAE;YACrC,OAAO;YACP,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,oEAAoE;YACpE,IAAI,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;gBAC5D,SAAS,CAAC,YAAY,GAAG,MAAM,eAAe,CAC5C,SAAS,EACT,OAAO,EACP,eAAe,EACf,SAAS,CAAC,YAAY,EACtB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CACrC,CAAC;YACJ,CAAC;YAED,4EAA4E;YAC5E,IAAI,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC7C,UAAU,EACV,OAAO,EACP,IAAI,EACJ,eAAe,EACf,aAAa,CACd,CAAC;YAEF,wEAAwE;YACxE,wEAAwE;YACxE,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,CAAC,uDAAuD,EAAE;oBAClE,IAAI;iBACL,CAAC,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,OAAO,EAAE;oBACzD,OAAO,EAAE,eAAe;oBACxB,GAAG,CAAC,aAAa;wBACf,CAAC,CAAC;4BACE,aAAa;yBACd;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;gBACH,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,aAAa,EAAE,CAAC;gBAClB,2BAA2B;gBAC3B,IAAI,CAAC,KAAK,CAAC,uBAAuB,EAAE;oBAClC,OAAO,EAAE,aAAa,CAAC,EAAE;oBACzB,IAAI;iBACL,CAAC,CAAC;gBAEH,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,WAAW,CAC/C,OAAO,EACP,aAAa,CAAC,EAAE,EAChB,SAAS,EACT,aAAa,CACd,CAAC;gBAEF,IAAI,CAAC,KAAK,CAAC,4BAA4B,EAAE;oBACvC,OAAO,EAAE,YAAY,CAAC,EAAE;iBACzB,CAAC,CAAC;gBAEH,OAAO,IAAI,CAAC,OAAO,CAAC;oBAClB,EAAE,EAAE,YAAY,CAAC,EAAE;oBACnB,IAAI,EAAE,YAAY,CAAC,IAAI;oBACvB,IAAI,EAAE,YAAY,CAAC,IAAI;oBACvB,MAAM,EAAE,SAAS;iBAClB,CAAC,CAAC;YACL,CAAC;YAED,kCAAkC;YAClC,IAAI,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBAC1C,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,CAC3C,OAAO,EACP;oBACE,IAAI;oBACJ,eAAe;oBACf,GAAG,SAAS;iBACb,EACD,aAAa,CACd,CAAC;gBAEF,IAAI,CAAC,KAAK,CAAC,4BAA4B,EAAE;oBACvC,OAAO,EAAE,QAAQ,CAAC,EAAE;iBACrB,CAAC,CAAC;gBAEH,OAAO,IAAI,CAAC,OAAO,CAAC;oBAClB,EAAE,EAAE,QAAQ,CAAC,EAAE;oBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,MAAM,EAAE,SAAS;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,WAAoB,EAAE,CAAC;gBAC9B,+DAA+D;gBAC/D,gEAAgE;gBAChE,qDAAqD;gBACrD,MAAM,GAAG,GAAG,WAGX,CAAC;gBACF,IACE,GAAG,CAAC,UAAU,KAAK,GAAG;oBACtB,GAAG,CAAC,OAAO;oBACX,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EACzB,CAAC;oBACD,IAAI,CAAC,KAAK,CACR,iEAAiE,EACjE;wBACE,IAAI;qBACL,CACF,CAAC;oBAEF,qEAAqE;oBACrE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAC7C,UAAU,EACV,OAAO,EACP,eAAe,EACf,IAAI,EACJ,aAAa,CACd,CAAC;oBAEF,IAAI,OAAO,EAAE,CAAC;wBACZ,IAAI,CAAC,KAAK,CAAC,iDAAiD,EAAE;4BAC5D,OAAO;4BACP,IAAI;yBACL,CAAC,CAAC;wBAEH,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,WAAW,CAC/C,OAAO,EACP,OAAO,EACP,SAAS,EACT,aAAa,CACd,CAAC;wBAEF,OAAO,IAAI,CAAC,OAAO,CAAC;4BAClB,EAAE,EAAE,YAAY,CAAC,EAAE;4BACnB,IAAI,EAAE,YAAY,CAAC,IAAI;4BACvB,IAAI,EAAE,YAAY,CAAC,IAAI;4BACvB,MAAM,EAAE,SAAS;yBAClB,CAAC,CAAC;oBACL,CAAC;oBAED,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,6GAA6G,CACtI,CAAC;gBACJ,CAAC;gBAED,MAAM,WAAW,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,kCAAkC,EAAE;gBAChD,OAAO;gBACP,IAAI;gBACJ,KAAK;aACN,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB,CAC5B,UAA6B,EAC7B,OAAe,EACf,IAAY,EACZ,MAAe,EACf,YAAqB;QAErB,MAAM,aAAa,GAAG,MAAM;YAC1B,CAAC,CAAC;gBACE;oBACE,OAAO,EAAE,MAAM;iBAChB;gBACD,EAAE;aACH;YACH,CAAC,CAAC;gBACE,EAAE;aACH,CAAC;QAEN,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YACpC,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,UAAU,CAC9C,OAAO,EACP;gBACE,KAAK,EAAE,IAAI;gBACX,GAAG,OAAO;gBACV,QAAQ,EAAE,GAAG;aACd,EACD,YAAY,CACb,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAC/C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAC/B,CAAC;YACF,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,oBAAoB,CAChC,UAA6B,EAC7B,OAAe,EACf,aAAqB,EACrB,IAAY,EACZ,YAAqB;QAErB,IAAI,CAAC;YACH,oDAAoD;YACpD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;YAC9D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YAE5D,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACtC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC;aAC1C,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,mCAAmC,EAAE;oBAC9C,QAAQ,EAAE,KAAK,EAAE,GAAG;oBACpB,OAAO,EAAE,IAAI,EAAE,GAAG;iBACnB,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,wCAAwC;YACxC,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,4BAA4B,CAC7D,KAAK,CAAC,GAAG,EACT,IAAI,CAAC,GAAG,EACR,IAAI,CACL,CAAC;YAEF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,gCAAgC,EAAE;oBAC3C,IAAI;iBACL,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,4CAA4C,EAAE;gBACvD,IAAI,EAAE,SAAS;gBACf,IAAI;aACL,CAAC,CAAC;YAEH,mEAAmE;YACnE,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,mBAAmB,CACpD,KAAK,CAAC,GAAG,EACT,IAAI,CAAC,GAAG,EACR,SAAS,CACV,CAAC;YAEF,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,2BAA2B,EAAE;oBACtC,OAAO,EAAE,SAAS;oBAClB,IAAI,EAAE,SAAS;iBAChB,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,iEAAiE;YACjE,oEAAoE;YACpE,mEAAmE;YACnE,oEAAoE;YACpE,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,UAAU,CAC9C,OAAO,EACP;gBACE,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,EAAE;aACb,EACD,YAAY,CACb,CAAC;YACF,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YACtE,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,6BAA6B,EAAE;gBACxC,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAS,IAAI,uBAAuB,EAAE,CAAC"}

package/build/tools/content/entries/resolveFieldIds.d.ts

@@ -0,0 +1,17 @@
+import type { TypesRepository } from "../../../repositories/content/types/TypesRepository.js";
+/**
+ * Resolves positional field_ids (1, 2, 3...) to real Modyo field IDs.
+ *
+ * LLMs often use sequential positions instead of real IDs (e.g., 33215).
+ * The Modyo API accepts any field_id without error, but positional IDs
+ * cause published entries to have null values in json.fields.
+ *
+ * Resolution logic per field_value:
+ * - If field_id exists in the type's real field IDs → keep as-is
+ * - If field_id matches a field position → map to that field's real ID
+ * - Otherwise → keep as-is (let the API handle validation)
+ */
+export declare function resolveFieldIds<T extends {
+    field_id: number;
+}>(typesRepo: TypesRepository, spaceId: number, contentTypeId: number, fieldValues: T[], debug?: (msg: string, data?: Record<string, unknown>) => void): Promise<T[]>;
+//# sourceMappingURL=resolveFieldIds.d.ts.map

package/build/tools/content/entries/resolveFieldIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFieldIds.d.ts","sourceRoot":"","sources":["../../../../src/tools/content/entries/resolveFieldIds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAQtF;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,CAAC,SAAS;IACR,QAAQ,EAAE,MAAM,CAAC;CAClB,EAED,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,CAAC,EAAE,EAChB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,CAmEd"}

package/build/tools/content/entries/resolveFieldIds.js

@@ -0,0 +1,71 @@
+/**
+ * Resolves positional field_ids (1, 2, 3...) to real Modyo field IDs.
+ *
+ * LLMs often use sequential positions instead of real IDs (e.g., 33215).
+ * The Modyo API accepts any field_id without error, but positional IDs
+ * cause published entries to have null values in json.fields.
+ *
+ * Resolution logic per field_value:
+ * - If field_id exists in the type's real field IDs → keep as-is
+ * - If field_id matches a field position → map to that field's real ID
+ * - Otherwise → keep as-is (let the API handle validation)
+ */
+export async function resolveFieldIds(typesRepo, spaceId, contentTypeId, fieldValues, debug) {
+    if (!fieldValues || fieldValues.length === 0)
+        return fieldValues;
+    const typeSchema = await typesRepo.getType(spaceId, contentTypeId);
+    const fields = (typeSchema.fields || []);
+    if (fields.length === 0)
+        return fieldValues;
+    const realFieldIds = new Set(fields.map((f) => f.id));
+    const positionToId = new Map();
+    for (const f of fields) {
+        if (f.id && f.position) {
+            positionToId.set(f.position, f.id);
+        }
+    }
+    // Check if any field_ids need resolution
+    const needsResolution = fieldValues.some((fv) => !realFieldIds.has(fv.field_id));
+    if (!needsResolution)
+        return fieldValues;
+    // Pre-compute sorted fields by position for 1-based index fallback
+    const sortedFields = [
+        ...fields,
+    ].sort((a, b) => a.position - b.position);
+    debug?.("Resolving positional field_ids to real IDs", {
+        inputIds: fieldValues.map((fv) => fv.field_id),
+        realIds: [
+            ...realFieldIds,
+        ],
+    });
+    const resolved = fieldValues.map((fv) => {
+        // Already a real field ID
+        if (realFieldIds.has(fv.field_id))
+            return fv;
+        // Try mapping by position
+        const realId = positionToId.get(fv.field_id);
+        if (realId !== undefined) {
+            return {
+                ...fv,
+                field_id: realId,
+            };
+        }
+        // Fallback: treat as 1-based index into ordered fields
+        if (fv.field_id >= 1 && fv.field_id <= sortedFields.length) {
+            const fieldByIndex = sortedFields[fv.field_id - 1];
+            if (fieldByIndex) {
+                return {
+                    ...fv,
+                    field_id: fieldByIndex.id,
+                };
+            }
+        }
+        return fv;
+    });
+    debug?.("Field IDs resolved", {
+        before: fieldValues.map((fv) => fv.field_id),
+        after: resolved.map((fv) => fv.field_id),
+    });
+    return resolved;
+}
+//# sourceMappingURL=resolveFieldIds.js.map

package/build/tools/content/entries/resolveFieldIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFieldIds.js","sourceRoot":"","sources":["../../../../src/tools/content/entries/resolveFieldIds.ts"],"names":[],"mappings":"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"}