@webiny/api-headless-cms 0.0.0-unstable.eb196ccd2f → 0.0.0-unstable.eb81deee7e

package/features/ai/DescribeContentModelTool.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { GetModelUseCase } from "../contentModel/GetModel/index.js";
+const inputSchema = z.object({
+    modelId: z.string().describe("Model ID as returned by listContentModels (e.g. 'product', not 'Products').")
+});
+const isRequired = (field)=>field.validation.some((validator)=>"required" === validator.name);
+const describeField = (field)=>{
+    const described = {
+        fieldId: field.fieldId,
+        type: field.type,
+        label: field.label,
+        list: Boolean(field.list),
+        required: isRequired(field)
+    };
+    if (field.description) described.description = field.description;
+    const values = field.predefinedValues;
+    if (values?.enabled && values.values?.length) described.predefinedValues = values.values.map((entry)=>entry.value);
+    const refModels = field.settings?.models;
+    if (refModels?.length) described.refModels = refModels.map((model)=>model.modelId);
+    const nested = field.settings?.fields;
+    if (nested?.length) described.fields = nested.map(describeField);
+    return described;
+};
+class DescribeContentModelToolHandlerImpl {
+    constructor(getModel){
+        this.getModel = getModel;
+    }
+    async execute(input) {
+        const result = await this.getModel.execute(input.modelId);
+        if (result.isFail()) throw new Error(`Could not describe model "${input.modelId}": ${result.error.message}. Call listContentModels for valid model IDs.`);
+        const model = result.value;
+        return {
+            modelId: model.modelId,
+            name: model.name,
+            description: model.description,
+            singularApiName: model.singularApiName,
+            pluralApiName: model.pluralApiName,
+            titleFieldId: model.titleFieldId,
+            fields: model.fields.map(describeField)
+        };
+    }
+}
+const DescribeContentModelToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: DescribeContentModelToolHandlerImpl,
+    dependencies: [
+        GetModelUseCase
+    ]
+});
+class DescribeContentModelToolImpl {
+    constructor(){
+        this.name = "describeContentModel";
+        this.title = "Describe content model";
+        this.description = "Returns the fields of one content model — field IDs, types, whether each is a list, required flags, allowed values, and referenced models. Call this before queryEntries so filters use real field IDs.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: true,
+            idempotentHint: true
+        };
+        this.handler = DescribeContentModelToolHandler;
+    }
+}
+const DescribeContentModelTool = AiSdkToolDefinition.createImplementation({
+    implementation: DescribeContentModelToolImpl,
+    dependencies: []
+});
+export { DescribeContentModelTool };
+
+//# sourceMappingURL=DescribeContentModelTool.js.map

package/features/ai/DescribeContentModelTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/DescribeContentModelTool.js","sources":["../../../src/features/ai/DescribeContentModelTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { GetModelUseCase } from \"~/features/contentModel/GetModel/index.js\";\nimport type { CmsModelField } from \"~/types/index.js\";\n\nconst inputSchema = z.object({\n    modelId: z\n        .string()\n        .describe(\"Model ID as returned by listContentModels (e.g. 'product', not 'Products').\")\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface FieldDescription {\n    fieldId: string;\n    type: string;\n    label: string;\n    /** True when the field holds an array of values — affects which `where` operators apply. */\n    list: boolean;\n    required: boolean;\n    description?: string;\n    /** Allowed values for enum-like fields, so a filter can be built without guessing. */\n    predefinedValues?: string[];\n    /** For `ref` fields: which models this field can point at. */\n    refModels?: string[];\n    /** For `object` fields: the nested field set. */\n    fields?: FieldDescription[];\n}\n\ninterface ModelDescription {\n    modelId: string;\n    name: string;\n    description: string | null;\n    singularApiName: string;\n    pluralApiName: string;\n    titleFieldId: string;\n    fields: FieldDescription[];\n}\n\nconst isRequired = (field: CmsModelField): boolean =>\n    field.validation.some(validator => validator.name === \"required\");\n\nconst describeField = (field: CmsModelField): FieldDescription => {\n    const described: FieldDescription = {\n        fieldId: field.fieldId,\n        type: field.type,\n        label: field.label,\n        list: Boolean(field.list),\n        required: isRequired(field)\n    };\n\n    if (field.description) {\n        described.description = field.description;\n    }\n\n    const values = field.predefinedValues;\n    if (values?.enabled && values.values?.length) {\n        described.predefinedValues = values.values.map(entry => entry.value);\n    }\n\n    const refModels = field.settings?.models;\n    if (refModels?.length) {\n        described.refModels = refModels.map(model => model.modelId);\n    }\n\n    const nested = field.settings?.fields;\n    if (nested?.length) {\n        described.fields = nested.map(describeField);\n    }\n\n    return described;\n};\n\nclass DescribeContentModelToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(private getModel: GetModelUseCase.Interface) {}\n\n    async execute(input: Input): Promise<ModelDescription> {\n        const result = await this.getModel.execute(input.modelId);\n\n        if (result.isFail()) {\n            throw new Error(\n                `Could not describe model \"${input.modelId}\": ${result.error.message}. Call listContentModels for valid model IDs.`\n            );\n        }\n\n        const model = result.value;\n\n        return {\n            modelId: model.modelId,\n            name: model.name,\n            description: model.description,\n            singularApiName: model.singularApiName,\n            pluralApiName: model.pluralApiName,\n            titleFieldId: model.titleFieldId,\n            fields: model.fields.map(describeField)\n        };\n    }\n}\n\nconst DescribeContentModelToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: DescribeContentModelToolHandlerImpl,\n    dependencies: [GetModelUseCase]\n});\n\n/**\n * Supplies the field detail needed to build a valid `queryEntries` filter. Deliberately a separate\n * call from `listContentModels`: returning full field sets for every model would be large and mostly\n * unread, so the model pays for detail only on the model it actually cares about.\n */\nclass DescribeContentModelToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"describeContentModel\";\n    readonly title = \"Describe content model\";\n    readonly description =\n        \"Returns the fields of one content model — field IDs, types, whether each is a list, required flags, allowed values, and referenced models. Call this before queryEntries so filters use real field IDs.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: true, idempotentHint: true };\n    readonly handler = DescribeContentModelToolHandler;\n}\n\nexport const DescribeContentModelTool = AiSdkToolDefinition.createImplementation({\n    implementation: DescribeContentModelToolImpl,\n    dependencies: []\n});\n"],"names":["inputSchema","z","isRequired","field","validator","describeField","described","Boolean","values","entry","refModels","model","nested","DescribeContentModelToolHandlerImpl","getModel","input","result","Error","DescribeContentModelToolHandler","AiSdkToolHandler","GetModelUseCase","DescribeContentModelToolImpl","DescribeContentModelTool","AiSdkToolDefinition"],"mappings":";;;AAKA,MAAMA,cAAcC,EAAE,MAAM,CAAC;IACzB,SAASA,EAAAA,MACE,GACN,QAAQ,CAAC;AAClB;AA8BA,MAAMC,aAAa,CAACC,QAChBA,MAAM,UAAU,CAAC,IAAI,CAACC,CAAAA,YAAaA,AAAmB,eAAnBA,UAAU,IAAI;AAErD,MAAMC,gBAAgB,CAACF;IACnB,MAAMG,YAA8B;QAChC,SAASH,MAAM,OAAO;QACtB,MAAMA,MAAM,IAAI;QAChB,OAAOA,MAAM,KAAK;QAClB,MAAMI,QAAQJ,MAAM,IAAI;QACxB,UAAUD,WAAWC;IACzB;IAEA,IAAIA,MAAM,WAAW,EACjBG,UAAU,WAAW,GAAGH,MAAM,WAAW;IAG7C,MAAMK,SAASL,MAAM,gBAAgB;IACrC,IAAIK,QAAQ,WAAWA,OAAO,MAAM,EAAE,QAClCF,UAAU,gBAAgB,GAAGE,OAAO,MAAM,CAAC,GAAG,CAACC,CAAAA,QAASA,MAAM,KAAK;IAGvE,MAAMC,YAAYP,MAAM,QAAQ,EAAE;IAClC,IAAIO,WAAW,QACXJ,UAAU,SAAS,GAAGI,UAAU,GAAG,CAACC,CAAAA,QAASA,MAAM,OAAO;IAG9D,MAAMC,SAAST,MAAM,QAAQ,EAAE;IAC/B,IAAIS,QAAQ,QACRN,UAAU,MAAM,GAAGM,OAAO,GAAG,CAACP;IAGlC,OAAOC;AACX;AAEA,MAAMO;IACF,YAAoBC,QAAmC,CAAE;aAArCA,QAAQ,GAARA;IAAsC;IAE1D,MAAM,QAAQC,KAAY,EAA6B;QACnD,MAAMC,SAAS,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAACD,MAAM,OAAO;QAExD,IAAIC,OAAO,MAAM,IACb,MAAM,IAAIC,MACN,CAAC,0BAA0B,EAAEF,MAAM,OAAO,CAAC,GAAG,EAAEC,OAAO,KAAK,CAAC,OAAO,CAAC,6CAA6C,CAAC;QAI3H,MAAML,QAAQK,OAAO,KAAK;QAE1B,OAAO;YACH,SAASL,MAAM,OAAO;YACtB,MAAMA,MAAM,IAAI;YAChB,aAAaA,MAAM,WAAW;YAC9B,iBAAiBA,MAAM,eAAe;YACtC,eAAeA,MAAM,aAAa;YAClC,cAAcA,MAAM,YAAY;YAChC,QAAQA,MAAM,MAAM,CAAC,GAAG,CAACN;QAC7B;IACJ;AACJ;AAEA,MAAMa,kCAAkCC,iBAAiB,oBAAoB,CAAC;IAC1E,gBAAgBN;IAChB,cAAc;QAACO;KAAgB;AACnC;AAOA,MAAMC;;aACO,IAAI,GAAG;aACP,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAGrB;aACd,WAAW,GAAG;YAAE,cAAc;YAAM,gBAAgB;QAAK;aACzD,OAAO,GAAGkB;;AACvB;AAEO,MAAMI,2BAA2BC,oBAAoB,oBAAoB,CAAC;IAC7E,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/ListContentModelsTool.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { ListModelsUseCase } from "../../features/contentModel/ListModels/index.js";
+declare const inputSchema: z.ZodObject<{
+    includeSystem: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type Input = z.infer<typeof inputSchema>;
+interface ModelSummary {
+    modelId: string;
+    name: string;
+    description: string | null;
+    group: string;
+    singularApiName: string;
+    pluralApiName: string;
+    titleFieldId: string;
+    fieldCount: number;
+}
+declare class ListContentModelsToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {
+    private listModels;
+    constructor(listModels: ListModelsUseCase.Interface);
+    execute(input: Input): Promise<ModelSummary[]>;
+}
+/**
+ * Entry point for any content question. The CMS schema is defined per project (and per tenant), so a
+ * model list cannot be baked into a system prompt — it has to be discovered at call time. Returns a
+ * summary only; `describeContentModel` supplies the field detail needed to actually build a query.
+ */
+declare class ListContentModelsToolImpl implements AiSdkToolDefinition.Interface<Input> {
+    readonly name = "listContentModels";
+    readonly title = "List content models";
+    readonly description = "Lists the content models available in this project. Call this first when you need to find content \u2014 model IDs are project-specific and cannot be guessed. Returns a summary per model; use describeContentModel for field details.";
+    readonly inputSchema: z.ZodObject<{
+        includeSystem: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+    readonly handler: typeof ListContentModelsToolHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolHandler<any>>;
+    };
+}
+export declare const ListContentModelsTool: typeof ListContentModelsToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolDefinition<any>>;
+};
+export {};

package/features/ai/ListContentModelsTool.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { ListModelsUseCase } from "../contentModel/ListModels/index.js";
+const HIDDEN_MODEL_GROUP = "hidden";
+const inputSchema = z.object({
+    includeSystem: z.boolean().optional().describe("Include system models that back Webiny itself (languages, tenants, task settings) and internal models belonging to other apps. Off by default — these are never what a user means by 'content'.")
+});
+const isSystemModel = (model)=>Boolean(model.isPrivate) || model.group === HIDDEN_MODEL_GROUP;
+class ListContentModelsToolHandlerImpl {
+    constructor(listModels){
+        this.listModels = listModels;
+    }
+    async execute(input) {
+        const result = await this.listModels.execute();
+        if (result.isFail()) throw new Error(`Could not list content models: ${result.error.message}`);
+        return result.value.filter((model)=>input.includeSystem ? true : !isSystemModel(model)).map((model)=>({
+                modelId: model.modelId,
+                name: model.name,
+                description: model.description,
+                group: model.group,
+                singularApiName: model.singularApiName,
+                pluralApiName: model.pluralApiName,
+                titleFieldId: model.titleFieldId,
+                fieldCount: model.fields.length
+            }));
+    }
+}
+const ListContentModelsToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: ListContentModelsToolHandlerImpl,
+    dependencies: [
+        ListModelsUseCase
+    ]
+});
+class ListContentModelsToolImpl {
+    constructor(){
+        this.name = "listContentModels";
+        this.title = "List content models";
+        this.description = "Lists the content models available in this project. Call this first when you need to find content — model IDs are project-specific and cannot be guessed. Returns a summary per model; use describeContentModel for field details.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: true,
+            idempotentHint: true
+        };
+        this.handler = ListContentModelsToolHandler;
+    }
+}
+const ListContentModelsTool = AiSdkToolDefinition.createImplementation({
+    implementation: ListContentModelsToolImpl,
+    dependencies: []
+});
+export { ListContentModelsTool };
+
+//# sourceMappingURL=ListContentModelsTool.js.map

package/features/ai/ListContentModelsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/ListContentModelsTool.js","sources":["../../../src/features/ai/ListContentModelsTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { ListModelsUseCase } from \"~/features/contentModel/ListModels/index.js\";\nimport type { CmsModel } from \"~/types/index.js\";\n\nconst HIDDEN_MODEL_GROUP = \"hidden\";\n\nconst inputSchema = z.object({\n    includeSystem: z\n        .boolean()\n        .optional()\n        .describe(\n            \"Include system models that back Webiny itself (languages, tenants, task settings) and internal models belonging to other apps. Off by default — these are never what a user means by 'content'.\"\n        )\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface ModelSummary {\n    modelId: string;\n    name: string;\n    description: string | null;\n    group: string;\n    singularApiName: string;\n    pluralApiName: string;\n    titleFieldId: string;\n    fieldCount: number;\n}\n\n/**\n * Models Webiny itself owns. Two separate markers, both needed:\n *  - `group: \"hidden\"` — the convention system models use (languages, tenants, background-task\n *    settings). The admin UI filters the same way, see app-headless-cms useCmsData.\n *  - `isPrivate` — models another app owns and manages through its own UI (e.g. Website Builder).\n */\nconst isSystemModel = (model: CmsModel): boolean =>\n    Boolean(model.isPrivate) || model.group === HIDDEN_MODEL_GROUP;\n\nclass ListContentModelsToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(private listModels: ListModelsUseCase.Interface) {}\n\n    async execute(input: Input): Promise<ModelSummary[]> {\n        const result = await this.listModels.execute();\n\n        if (result.isFail()) {\n            throw new Error(`Could not list content models: ${result.error.message}`);\n        }\n\n        return result.value\n            .filter(model => (input.includeSystem ? true : !isSystemModel(model)))\n            .map(model => ({\n                modelId: model.modelId,\n                name: model.name,\n                description: model.description,\n                group: model.group,\n                singularApiName: model.singularApiName,\n                pluralApiName: model.pluralApiName,\n                titleFieldId: model.titleFieldId,\n                fieldCount: model.fields.length\n            }));\n    }\n}\n\nconst ListContentModelsToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: ListContentModelsToolHandlerImpl,\n    dependencies: [ListModelsUseCase]\n});\n\n/**\n * Entry point for any content question. The CMS schema is defined per project (and per tenant), so a\n * model list cannot be baked into a system prompt — it has to be discovered at call time. Returns a\n * summary only; `describeContentModel` supplies the field detail needed to actually build a query.\n */\nclass ListContentModelsToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"listContentModels\";\n    readonly title = \"List content models\";\n    readonly description =\n        \"Lists the content models available in this project. Call this first when you need to find content — model IDs are project-specific and cannot be guessed. Returns a summary per model; use describeContentModel for field details.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: true, idempotentHint: true };\n    readonly handler = ListContentModelsToolHandler;\n}\n\nexport const ListContentModelsTool = AiSdkToolDefinition.createImplementation({\n    implementation: ListContentModelsToolImpl,\n    dependencies: []\n});\n"],"names":["HIDDEN_MODEL_GROUP","inputSchema","z","isSystemModel","model","Boolean","ListContentModelsToolHandlerImpl","listModels","input","result","Error","ListContentModelsToolHandler","AiSdkToolHandler","ListModelsUseCase","ListContentModelsToolImpl","ListContentModelsTool","AiSdkToolDefinition"],"mappings":";;;AAKA,MAAMA,qBAAqB;AAE3B,MAAMC,cAAcC,EAAE,MAAM,CAAC;IACzB,eAAeA,EAAAA,OACH,GACP,QAAQ,GACR,QAAQ,CACL;AAEZ;AAqBA,MAAMC,gBAAgB,CAACC,QACnBC,QAAQD,MAAM,SAAS,KAAKA,MAAM,KAAK,KAAKJ;AAEhD,MAAMM;IACF,YAAoBC,UAAuC,CAAE;aAAzCA,UAAU,GAAVA;IAA0C;IAE9D,MAAM,QAAQC,KAAY,EAA2B;QACjD,MAAMC,SAAS,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO;QAE5C,IAAIA,OAAO,MAAM,IACb,MAAM,IAAIC,MAAM,CAAC,+BAA+B,EAAED,OAAO,KAAK,CAAC,OAAO,EAAE;QAG5E,OAAOA,OAAO,KAAK,CACd,MAAM,CAACL,CAAAA,QAAUI,MAAM,aAAa,GAAG,OAAO,CAACL,cAAcC,QAC7D,GAAG,CAACA,CAAAA,QAAU;gBACX,SAASA,MAAM,OAAO;gBACtB,MAAMA,MAAM,IAAI;gBAChB,aAAaA,MAAM,WAAW;gBAC9B,OAAOA,MAAM,KAAK;gBAClB,iBAAiBA,MAAM,eAAe;gBACtC,eAAeA,MAAM,aAAa;gBAClC,cAAcA,MAAM,YAAY;gBAChC,YAAYA,MAAM,MAAM,CAAC,MAAM;YACnC;IACR;AACJ;AAEA,MAAMO,+BAA+BC,iBAAiB,oBAAoB,CAAC;IACvE,gBAAgBN;IAChB,cAAc;QAACO;KAAkB;AACrC;AAOA,MAAMC;;aACO,IAAI,GAAG;aACP,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAGb;aACd,WAAW,GAAG;YAAE,cAAc;YAAM,gBAAgB;QAAK;aACzD,OAAO,GAAGU;;AACvB;AAEO,MAAMI,wBAAwBC,oBAAoB,oBAAoB,CAAC;IAC1E,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/QueryEntriesTool.d.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { GetModelUseCase } from "../../features/contentModel/GetModel/index.js";
+import { ListLatestEntriesUseCase } from "../../features/contentEntry/ListEntries/index.js";
+import { CmsWhereMapper } from "../../features/whereMapper/abstractions.js";
+import { CmsSortMapper } from "../../features/sortMapper/abstractions.js";
+declare const inputSchema: z.ZodObject<{
+    modelId: z.ZodString;
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    sort: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    search: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input = z.infer<typeof inputSchema>;
+interface EntrySummary {
+    id: string;
+    entryId: string;
+    status: string;
+    createdOn: string;
+    savedOn: string;
+    values: Record<string, unknown>;
+}
+interface QueryEntriesResult {
+    modelId: string;
+    entries: EntrySummary[];
+    meta: {
+        totalCount: number;
+        hasMoreItems: boolean;
+        cursor: string | null;
+    };
+}
+declare class QueryEntriesToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {
+    private getModel;
+    private listLatestEntries;
+    private whereMapper;
+    private sortMapper;
+    constructor(getModel: GetModelUseCase.Interface, listLatestEntries: ListLatestEntriesUseCase.Interface, whereMapper: CmsWhereMapper.Interface, sortMapper: CmsSortMapper.Interface);
+    execute(input: Input): Promise<QueryEntriesResult>;
+}
+/**
+ * Reads entries for one model.
+ *
+ * Uses the LATEST revisions (the manage-API view), not published ones — an editor asking "which
+ * products are discounted" means the content as it currently stands in the admin app, including
+ * unpublished edits. Filter on `status` for a published-only view.
+ *
+ * `where` is passed through to the CMS rather than re-modelled as a Zod schema: the valid keys depend
+ * entirely on the model's fields, which are only known at runtime. An invalid filter surfaces as a
+ * tool error the model can correct, which is why `describeContentModel` is named in the description.
+ *
+ * `where` and `sort` arrive FLAT and go through `CmsWhereMapper`/`CmsSortMapper`, which nest the
+ * model's own fields under `values` and leave entry meta at the top. The flat form is what a model
+ * writes, because `describeContentModel` hands it a flat list of fieldIds.
+ */
+declare class QueryEntriesToolImpl implements AiSdkToolDefinition.Interface<Input> {
+    readonly name = "queryEntries";
+    readonly title = "Query content entries";
+    readonly description = "Queries content entries for a model, with filtering, sorting, search and pagination. Returns the latest revision of each entry (including unpublished changes). Call describeContentModel first to learn the field IDs used in `where` and `sort`.";
+    readonly inputSchema: z.ZodObject<{
+        modelId: z.ZodString;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        sort: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        search: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly annotations: {
+        readOnlyHint: boolean;
+    };
+    readonly handler: typeof QueryEntriesToolHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolHandler<any>>;
+    };
+}
+export declare const QueryEntriesTool: typeof QueryEntriesToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolDefinition<any>>;
+};
+export {};

package/features/ai/QueryEntriesTool.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { GetModelUseCase } from "../contentModel/GetModel/index.js";
+import { ListLatestEntriesUseCase } from "../contentEntry/ListEntries/index.js";
+import { CmsWhereMapper } from "../whereMapper/abstractions.js";
+import { CmsSortMapper } from "../sortMapper/abstractions.js";
+const MAX_LIMIT = 50;
+const DEFAULT_LIMIT = 10;
+const inputSchema = z.object({
+    modelId: z.string().describe("Model ID as returned by listContentModels."),
+    where: z.record(z.string(), z.unknown()).optional().describe("Flat filter object. Keys are `<fieldId>` for an exact match or `<fieldId>_<operator>` otherwise — e.g. { onSale: true, price_gt: 100, name_contains: 'desk', status: 'draft' }. Operators: _not, _in, _not_in, _lt, _lte, _gt, _gte, _contains, _not_contains, _startsWith, _not_startsWith, _between, _not_between. Mix the model's own fields with entry meta fields (id, entryId, status, createdOn, savedOn) freely — they are separated automatically. Use describeContentModel first so field IDs are real."),
+    sort: z.array(z.string()).optional().describe("Sort directives as `<fieldId>_ASC` or `<fieldId>_DESC` — e.g. ['price_DESC'] for a model field or ['savedOn_DESC'] for entry meta. Both forms are accepted; the distinction is handled automatically."),
+    search: z.string().optional().describe("Full-text search across the model's searchable fields."),
+    fields: z.array(z.string()).optional().describe("Restrict returned values to these field IDs. Use it whenever you only need a few fields — entries can be large."),
+    limit: z.number().int().positive().optional().describe(`Maximum entries to return. Defaults to ${DEFAULT_LIMIT}, capped at ${MAX_LIMIT}.`),
+    after: z.string().optional().describe("Pagination cursor from a previous call's meta.cursor.")
+});
+class QueryEntriesToolHandlerImpl {
+    constructor(getModel, listLatestEntries, whereMapper, sortMapper){
+        this.getModel = getModel;
+        this.listLatestEntries = listLatestEntries;
+        this.whereMapper = whereMapper;
+        this.sortMapper = sortMapper;
+    }
+    async execute(input) {
+        const modelResult = await this.getModel.execute(input.modelId);
+        if (modelResult.isFail()) throw new Error(`Unknown model "${input.modelId}": ${modelResult.error.message}. Call listContentModels for valid model IDs.`);
+        const model = modelResult.value;
+        const params = {
+            limit: Math.min(input.limit ?? DEFAULT_LIMIT, MAX_LIMIT)
+        };
+        if (input.where) {
+            const where = this.whereMapper.map({
+                fields: model.fields,
+                input: input.where
+            });
+            if (where) params.where = where;
+        }
+        if (input.sort?.length) {
+            const requested = input.sort;
+            const sort = this.sortMapper.map({
+                fields: model.fields,
+                input: requested
+            });
+            if (!sort || sort.length !== input.sort.length) throw new Error(`Could not read every sort directive in [${input.sort.join(", ")}]. Each one must be \`<fieldId>_ASC\` or \`<fieldId>_DESC\`, using a field ID from describeContentModel.`);
+            params.sort = sort;
+        }
+        if (input.search) params.search = input.search;
+        if (input.fields?.length) params.fields = input.fields;
+        if (input.after) params.after = input.after;
+        const result = await this.listLatestEntries.execute(model, params);
+        if (result.isFail()) throw new Error(`Could not query "${input.modelId}" entries: ${result.error.message}`);
+        const { entries, meta } = result.value;
+        return {
+            modelId: input.modelId,
+            entries: entries.map((entry)=>({
+                    id: entry.id,
+                    entryId: entry.entryId,
+                    status: entry.status,
+                    createdOn: entry.createdOn,
+                    savedOn: entry.savedOn,
+                    values: entry.values
+                })),
+            meta: {
+                totalCount: meta.totalCount,
+                hasMoreItems: meta.hasMoreItems,
+                cursor: meta.cursor
+            }
+        };
+    }
+}
+const QueryEntriesToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: QueryEntriesToolHandlerImpl,
+    dependencies: [
+        GetModelUseCase,
+        ListLatestEntriesUseCase,
+        CmsWhereMapper,
+        CmsSortMapper
+    ]
+});
+class QueryEntriesToolImpl {
+    constructor(){
+        this.name = "queryEntries";
+        this.title = "Query content entries";
+        this.description = "Queries content entries for a model, with filtering, sorting, search and pagination. Returns the latest revision of each entry (including unpublished changes). Call describeContentModel first to learn the field IDs used in `where` and `sort`.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: true
+        };
+        this.handler = QueryEntriesToolHandler;
+    }
+}
+const QueryEntriesTool = AiSdkToolDefinition.createImplementation({
+    implementation: QueryEntriesToolImpl,
+    dependencies: []
+});
+export { QueryEntriesTool };
+
+//# sourceMappingURL=QueryEntriesTool.js.map

package/features/ai/QueryEntriesTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/QueryEntriesTool.js","sources":["../../../src/features/ai/QueryEntriesTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { GetModelUseCase } from \"~/features/contentModel/GetModel/index.js\";\nimport { ListLatestEntriesUseCase } from \"~/features/contentEntry/ListEntries/index.js\";\nimport { CmsWhereMapper } from \"~/features/whereMapper/abstractions.js\";\nimport { CmsSortMapper } from \"~/features/sortMapper/abstractions.js\";\nimport type { CmsEntryListParams } from \"~/types/index.js\";\nimport type { CmsEntryListSort } from \"~/types/index.js\";\n\n/**\n * Hard ceiling on returned entries. A model asking for \"all products\" would otherwise pull an entire\n * collection into the context window; the cursor in the response is the correct way to go deeper.\n */\nconst MAX_LIMIT = 50;\nconst DEFAULT_LIMIT = 10;\n\nconst inputSchema = z.object({\n    modelId: z.string().describe(\"Model ID as returned by listContentModels.\"),\n    where: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\n            \"Flat filter object. Keys are `<fieldId>` for an exact match or `<fieldId>_<operator>` otherwise — e.g. { onSale: true, price_gt: 100, name_contains: 'desk', status: 'draft' }. Operators: _not, _in, _not_in, _lt, _lte, _gt, _gte, _contains, _not_contains, _startsWith, _not_startsWith, _between, _not_between. Mix the model's own fields with entry meta fields (id, entryId, status, createdOn, savedOn) freely — they are separated automatically. Use describeContentModel first so field IDs are real.\"\n        ),\n    sort: z\n        .array(z.string())\n        .optional()\n        .describe(\n            \"Sort directives as `<fieldId>_ASC` or `<fieldId>_DESC` — e.g. ['price_DESC'] for a model field or ['savedOn_DESC'] for entry meta. Both forms are accepted; the distinction is handled automatically.\"\n        ),\n    search: z\n        .string()\n        .optional()\n        .describe(\"Full-text search across the model's searchable fields.\"),\n    fields: z\n        .array(z.string())\n        .optional()\n        .describe(\n            \"Restrict returned values to these field IDs. Use it whenever you only need a few fields — entries can be large.\"\n        ),\n    limit: z\n        .number()\n        .int()\n        .positive()\n        .optional()\n        .describe(\n            `Maximum entries to return. Defaults to ${DEFAULT_LIMIT}, capped at ${MAX_LIMIT}.`\n        ),\n    after: z.string().optional().describe(\"Pagination cursor from a previous call's meta.cursor.\")\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface EntrySummary {\n    id: string;\n    entryId: string;\n    status: string;\n    createdOn: string;\n    savedOn: string;\n    values: Record<string, unknown>;\n}\n\ninterface QueryEntriesResult {\n    modelId: string;\n    entries: EntrySummary[];\n    meta: {\n        totalCount: number;\n        hasMoreItems: boolean;\n        cursor: string | null;\n    };\n}\n\nclass QueryEntriesToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(\n        private getModel: GetModelUseCase.Interface,\n        private listLatestEntries: ListLatestEntriesUseCase.Interface,\n        private whereMapper: CmsWhereMapper.Interface,\n        private sortMapper: CmsSortMapper.Interface\n    ) {}\n\n    async execute(input: Input): Promise<QueryEntriesResult> {\n        const modelResult = await this.getModel.execute(input.modelId);\n\n        if (modelResult.isFail()) {\n            throw new Error(\n                `Unknown model \"${input.modelId}\": ${modelResult.error.message}. Call listContentModels for valid model IDs.`\n            );\n        }\n\n        const model = modelResult.value;\n\n        const params: CmsEntryListParams = {\n            limit: Math.min(input.limit ?? DEFAULT_LIMIT, MAX_LIMIT)\n        };\n\n        if (input.where) {\n            const where = this.whereMapper.map({ fields: model.fields, input: input.where });\n\n            if (where) {\n                params.where = where;\n            }\n        }\n\n        if (input.sort?.length) {\n            /*\n             * `CmsEntryListSort` is a template-literal type, while the schema yields plain strings\n             * because a model writes whatever it likes. Casting here is safe only because of the\n             * check below, which refuses the call if the mapper could not read every directive.\n             */\n            const requested = input.sort as CmsEntryListSort;\n            const sort = this.sortMapper.map({ fields: model.fields, input: requested });\n\n            /*\n             * The mapper drops a directive it cannot parse. Silence is the wrong answer here: the\n             * query would run unsorted and the model would present the result as sorted. Comparing\n             * lengths rather than re-checking the format keeps this in step with whatever the mapper\n             * accepts.\n             */\n            if (!sort || sort.length !== input.sort.length) {\n                throw new Error(\n                    `Could not read every sort directive in [${input.sort.join(\", \")}]. Each one must be \\`<fieldId>_ASC\\` or \\`<fieldId>_DESC\\`, using a field ID from describeContentModel.`\n                );\n            }\n\n            params.sort = sort;\n        }\n\n        if (input.search) {\n            params.search = input.search;\n        }\n\n        if (input.fields?.length) {\n            params.fields = input.fields;\n        }\n\n        if (input.after) {\n            params.after = input.after;\n        }\n\n        const result = await this.listLatestEntries.execute(model, params);\n\n        if (result.isFail()) {\n            throw new Error(`Could not query \"${input.modelId}\" entries: ${result.error.message}`);\n        }\n\n        const { entries, meta } = result.value;\n\n        return {\n            modelId: input.modelId,\n            entries: entries.map(entry => ({\n                id: entry.id,\n                entryId: entry.entryId,\n                status: entry.status,\n                createdOn: entry.createdOn,\n                savedOn: entry.savedOn,\n                values: entry.values\n            })),\n            meta: {\n                totalCount: meta.totalCount,\n                hasMoreItems: meta.hasMoreItems,\n                cursor: meta.cursor\n            }\n        };\n    }\n}\n\nconst QueryEntriesToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: QueryEntriesToolHandlerImpl,\n    dependencies: [GetModelUseCase, ListLatestEntriesUseCase, CmsWhereMapper, CmsSortMapper]\n});\n\n/**\n * Reads entries for one model.\n *\n * Uses the LATEST revisions (the manage-API view), not published ones — an editor asking \"which\n * products are discounted\" means the content as it currently stands in the admin app, including\n * unpublished edits. Filter on `status` for a published-only view.\n *\n * `where` is passed through to the CMS rather than re-modelled as a Zod schema: the valid keys depend\n * entirely on the model's fields, which are only known at runtime. An invalid filter surfaces as a\n * tool error the model can correct, which is why `describeContentModel` is named in the description.\n *\n * `where` and `sort` arrive FLAT and go through `CmsWhereMapper`/`CmsSortMapper`, which nest the\n * model's own fields under `values` and leave entry meta at the top. The flat form is what a model\n * writes, because `describeContentModel` hands it a flat list of fieldIds.\n */\nclass QueryEntriesToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"queryEntries\";\n    readonly title = \"Query content entries\";\n    readonly description =\n        \"Queries content entries for a model, with filtering, sorting, search and pagination. Returns the latest revision of each entry (including unpublished changes). Call describeContentModel first to learn the field IDs used in `where` and `sort`.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: true };\n    readonly handler = QueryEntriesToolHandler;\n}\n\nexport const QueryEntriesTool = AiSdkToolDefinition.createImplementation({\n    implementation: QueryEntriesToolImpl,\n    dependencies: []\n});\n"],"names":["MAX_LIMIT","DEFAULT_LIMIT","inputSchema","z","QueryEntriesToolHandlerImpl","getModel","listLatestEntries","whereMapper","sortMapper","input","modelResult","Error","model","params","Math","where","requested","sort","result","entries","meta","entry","QueryEntriesToolHandler","AiSdkToolHandler","GetModelUseCase","ListLatestEntriesUseCase","CmsWhereMapper","CmsSortMapper","QueryEntriesToolImpl","QueryEntriesTool","AiSdkToolDefinition"],"mappings":"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"}

package/features/ai/feature.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Read-only CMS tools for AI callers. Registered as `AiSdkToolDefinition` implementations, so any
+ * caller that builds a tool set from that abstraction picks them up without naming them.
+ */
+export declare const CmsAiToolsFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/features/ai/feature.js

@@ -0,0 +1,15 @@
+import { createFeature } from "@webiny/feature/api";
+import { ListContentModelsTool } from "./ListContentModelsTool.js";
+import { DescribeContentModelTool } from "./DescribeContentModelTool.js";
+import { QueryEntriesTool } from "./QueryEntriesTool.js";
+const CmsAiToolsFeature = createFeature({
+    name: "HeadlessCms/AiTools",
+    register (container) {
+        container.register(ListContentModelsTool);
+        container.register(DescribeContentModelTool);
+        container.register(QueryEntriesTool);
+    }
+});
+export { CmsAiToolsFeature };
+
+//# sourceMappingURL=feature.js.map

package/features/ai/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/feature.js","sources":["../../../src/features/ai/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ListContentModelsTool } from \"./ListContentModelsTool.js\";\nimport { DescribeContentModelTool } from \"./DescribeContentModelTool.js\";\nimport { QueryEntriesTool } from \"./QueryEntriesTool.js\";\n\n/**\n * Read-only CMS tools for AI callers. Registered as `AiSdkToolDefinition` implementations, so any\n * caller that builds a tool set from that abstraction picks them up without naming them.\n */\nexport const CmsAiToolsFeature = createFeature({\n    name: \"HeadlessCms/AiTools\",\n    register(container) {\n        container.register(ListContentModelsTool);\n        container.register(DescribeContentModelTool);\n        container.register(QueryEntriesTool);\n    }\n});\n"],"names":["CmsAiToolsFeature","createFeature","container","ListContentModelsTool","DescribeContentModelTool","QueryEntriesTool"],"mappings":";;;;AASO,MAAMA,oBAAoBC,cAAc;IAC3C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QACnBD,UAAU,QAAQ,CAACE;QACnBF,UAAU,QAAQ,CAACG;IACvB;AACJ"}

package/features/ai/index.d.ts

@@ -0,0 +1,4 @@
+export { CmsAiToolsFeature } from "./feature.js";
+export { ListContentModelsTool } from "./ListContentModelsTool.js";
+export { DescribeContentModelTool } from "./DescribeContentModelTool.js";
+export { QueryEntriesTool } from "./QueryEntriesTool.js";

package/features/ai/index.js

@@ -0,0 +1,4 @@
+export { CmsAiToolsFeature } from "./feature.js";
+export { ListContentModelsTool } from "./ListContentModelsTool.js";
+export { DescribeContentModelTool } from "./DescribeContentModelTool.js";
+export { QueryEntriesTool } from "./QueryEntriesTool.js";

package/features/contentEntry/ContentEntriesFeature.d.ts

@@ -0,0 +1,4 @@
+export declare const ContentEntriesFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/features/contentEntry/ContentEntriesFeature.js

@@ -0,0 +1,73 @@
+import { createFeature } from "@webiny/feature/api";
+import { CreateEntryFeature } from "./CreateEntry/feature.js";
+import { CreateEntryRevisionFromFeature } from "./CreateEntryRevisionFrom/feature.js";
+import { DuplicateEntryFeature } from "./DuplicateEntry/feature.js";
+import { UpdateEntryFeature } from "./UpdateEntry/feature.js";
+import { ValidateEntryFeature } from "./ValidateEntry/feature.js";
+import { MoveEntryFeature } from "./MoveEntry/feature.js";
+import { RepublishEntryFeature } from "./RepublishEntry/feature.js";
+import { PublishEntryFeature } from "./PublishEntry/feature.js";
+import { GetRevisionByIdFeature } from "./GetRevisionById/feature.js";
+import { ListEntriesFeature } from "./ListEntries/feature.js";
+import { GetEntriesByIdsFeature } from "./GetEntriesByIds/feature.js";
+import { GetEntryByIdFeature } from "./GetEntryById/feature.js";
+import { GetPublishedEntriesByIdsFeature } from "./GetPublishedEntriesByIds/feature.js";
+import { GetLatestEntriesByIdsFeature } from "./GetLatestEntriesByIds/feature.js";
+import { GetRevisionsByEntryIdFeature } from "./GetRevisionsByEntryId/feature.js";
+import { GetPreviousRevisionByEntryIdFeature } from "./GetPreviousRevisionByEntryId/feature.js";
+import { GetEntryFeature } from "./GetEntry/feature.js";
+import { DeleteEntryFeature } from "./DeleteEntry/feature.js";
+import { DeleteEntryRevisionFeature } from "./DeleteEntryRevision/feature.js";
+import { DeleteMultipleEntriesFeature } from "./DeleteMultipleEntries/feature.js";
+import { RestoreEntryFromBinFeature } from "./RestoreEntryFromBin/feature.js";
+import { GetLatestRevisionByEntryIdFeature } from "./GetLatestRevisionByEntryId/feature.js";
+import { GetPublishedRevisionByEntryIdFeature } from "./GetPublishedRevisionByEntryId/feature.js";
+import { UnpublishEntryFeature } from "./UnpublishEntry/feature.js";
+import { GetUniqueFieldValuesFeature } from "./GetUniqueFieldValues/feature.js";
+import { GetSingletonEntryFeature } from "./GetSingletonEntry/feature.js";
+import { UpdateSingletonEntryFeature } from "./UpdateSingletonEntry/feature.js";
+import { ContentEntryTraverserFeature } from "./ContentEntryTraverser/feature.js";
+import { UpdateRevisionDescriptionFeature } from "./UpdateRevisionDescription/feature.js";
+import { EntryDataFactoriesFeature } from "./entryDataFactories/EntryDataFactoriesFeature.js";
+import { RuntimeTenantImplementation } from "../runtimeTenant/index.js";
+import { EntryEventPublisherFeature } from "./EntryEventPublisher/feature.js";
+const ContentEntriesFeature = createFeature({
+    name: "ContentEntries",
+    register (container) {
+        container.register(RuntimeTenantImplementation);
+        EntryDataFactoriesFeature.register(container);
+        EntryEventPublisherFeature.register(container);
+        GetRevisionByIdFeature.register(container);
+        GetEntriesByIdsFeature.register(container);
+        GetEntryByIdFeature.register(container);
+        GetPublishedEntriesByIdsFeature.register(container);
+        GetPublishedRevisionByEntryIdFeature.register(container);
+        GetLatestEntriesByIdsFeature.register(container);
+        GetLatestRevisionByEntryIdFeature.register(container);
+        GetRevisionsByEntryIdFeature.register(container);
+        GetPreviousRevisionByEntryIdFeature.register(container);
+        GetEntryFeature.register(container);
+        ListEntriesFeature.register(container);
+        GetUniqueFieldValuesFeature.register(container);
+        GetSingletonEntryFeature.register(container);
+        ContentEntryTraverserFeature.register(container);
+        CreateEntryFeature.register(container);
+        CreateEntryRevisionFromFeature.register(container);
+        DuplicateEntryFeature.register(container);
+        UpdateEntryFeature.register(container);
+        UpdateRevisionDescriptionFeature.register(container);
+        ValidateEntryFeature.register(container);
+        MoveEntryFeature.register(container);
+        PublishEntryFeature.register(container);
+        UnpublishEntryFeature.register(container);
+        RepublishEntryFeature.register(container);
+        DeleteEntryFeature.register(container);
+        DeleteEntryRevisionFeature.register(container);
+        DeleteMultipleEntriesFeature.register(container);
+        RestoreEntryFromBinFeature.register(container);
+        UpdateSingletonEntryFeature.register(container);
+    }
+});
+export { ContentEntriesFeature };
+
+//# sourceMappingURL=ContentEntriesFeature.js.map

package/features/contentEntry/ContentEntriesFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/contentEntry/ContentEntriesFeature.js","sources":["../../../src/features/contentEntry/ContentEntriesFeature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { CreateEntryFeature } from \"./CreateEntry/feature.js\";\nimport { CreateEntryRevisionFromFeature } from \"./CreateEntryRevisionFrom/feature.js\";\nimport { DuplicateEntryFeature } from \"./DuplicateEntry/feature.js\";\nimport { UpdateEntryFeature } from \"./UpdateEntry/feature.js\";\nimport { ValidateEntryFeature } from \"./ValidateEntry/feature.js\";\nimport { MoveEntryFeature } from \"./MoveEntry/feature.js\";\nimport { RepublishEntryFeature } from \"./RepublishEntry/feature.js\";\nimport { PublishEntryFeature } from \"./PublishEntry/feature.js\";\nimport { GetRevisionByIdFeature } from \"./GetRevisionById/feature.js\";\nimport { ListEntriesFeature } from \"./ListEntries/feature.js\";\nimport { GetEntriesByIdsFeature } from \"./GetEntriesByIds/feature.js\";\nimport { GetEntryByIdFeature } from \"./GetEntryById/feature.js\";\nimport { GetPublishedEntriesByIdsFeature } from \"./GetPublishedEntriesByIds/feature.js\";\nimport { GetLatestEntriesByIdsFeature } from \"./GetLatestEntriesByIds/feature.js\";\nimport { GetRevisionsByEntryIdFeature } from \"./GetRevisionsByEntryId/feature.js\";\nimport { GetPreviousRevisionByEntryIdFeature } from \"./GetPreviousRevisionByEntryId/feature.js\";\nimport { GetEntryFeature } from \"./GetEntry/feature.js\";\nimport { DeleteEntryFeature } from \"./DeleteEntry/feature.js\";\nimport { DeleteEntryRevisionFeature } from \"./DeleteEntryRevision/feature.js\";\nimport { DeleteMultipleEntriesFeature } from \"./DeleteMultipleEntries/feature.js\";\nimport { RestoreEntryFromBinFeature } from \"./RestoreEntryFromBin/feature.js\";\nimport { GetLatestRevisionByEntryIdFeature } from \"./GetLatestRevisionByEntryId/feature.js\";\nimport { GetPublishedRevisionByEntryIdFeature } from \"./GetPublishedRevisionByEntryId/feature.js\";\nimport { UnpublishEntryFeature } from \"./UnpublishEntry/feature.js\";\nimport { GetUniqueFieldValuesFeature } from \"./GetUniqueFieldValues/feature.js\";\nimport { GetSingletonEntryFeature } from \"./GetSingletonEntry/feature.js\";\nimport { UpdateSingletonEntryFeature } from \"./UpdateSingletonEntry/feature.js\";\nimport { ContentEntryTraverserFeature } from \"./ContentEntryTraverser/feature.js\";\nimport { UpdateRevisionDescriptionFeature } from \"./UpdateRevisionDescription/feature.js\";\nimport { EntryDataFactoriesFeature } from \"./entryDataFactories/EntryDataFactoriesFeature.js\";\nimport { RuntimeTenantImplementation } from \"~/features/runtimeTenant/index.js\";\nimport { EntryEventPublisherFeature } from \"./EntryEventPublisher/feature.js\";\n\nexport const ContentEntriesFeature = createFeature({\n    name: \"ContentEntries\",\n    register(container) {\n        container.register(RuntimeTenantImplementation);\n        EntryDataFactoriesFeature.register(container);\n        EntryEventPublisherFeature.register(container);\n        // Query features\n        GetRevisionByIdFeature.register(container);\n        GetEntriesByIdsFeature.register(container);\n        GetEntryByIdFeature.register(container);\n        GetPublishedEntriesByIdsFeature.register(container);\n        GetPublishedRevisionByEntryIdFeature.register(container);\n        GetLatestEntriesByIdsFeature.register(container);\n        GetLatestRevisionByEntryIdFeature.register(container);\n        GetRevisionsByEntryIdFeature.register(container);\n        GetPreviousRevisionByEntryIdFeature.register(container);\n        GetEntryFeature.register(container);\n        ListEntriesFeature.register(container);\n        GetUniqueFieldValuesFeature.register(container);\n        GetSingletonEntryFeature.register(container);\n\n        // Provider features\n        ContentEntryTraverserFeature.register(container);\n\n        // Command features\n        CreateEntryFeature.register(container);\n        CreateEntryRevisionFromFeature.register(container);\n        DuplicateEntryFeature.register(container);\n        UpdateEntryFeature.register(container);\n        UpdateRevisionDescriptionFeature.register(container);\n        ValidateEntryFeature.register(container);\n        MoveEntryFeature.register(container);\n        PublishEntryFeature.register(container);\n        UnpublishEntryFeature.register(container);\n        RepublishEntryFeature.register(container);\n        DeleteEntryFeature.register(container);\n        DeleteEntryRevisionFeature.register(container);\n        DeleteMultipleEntriesFeature.register(container);\n        RestoreEntryFromBinFeature.register(container);\n        UpdateSingletonEntryFeature.register(container);\n    }\n});\n"],"names":["ContentEntriesFeature","createFeature","container","RuntimeTenantImplementation","EntryDataFactoriesFeature","EntryEventPublisherFeature","GetRevisionByIdFeature","GetEntriesByIdsFeature","GetEntryByIdFeature","GetPublishedEntriesByIdsFeature","GetPublishedRevisionByEntryIdFeature","GetLatestEntriesByIdsFeature","GetLatestRevisionByEntryIdFeature","GetRevisionsByEntryIdFeature","GetPreviousRevisionByEntryIdFeature","GetEntryFeature","ListEntriesFeature","GetUniqueFieldValuesFeature","GetSingletonEntryFeature","ContentEntryTraverserFeature","CreateEntryFeature","CreateEntryRevisionFromFeature","DuplicateEntryFeature","UpdateEntryFeature","UpdateRevisionDescriptionFeature","ValidateEntryFeature","MoveEntryFeature","PublishEntryFeature","UnpublishEntryFeature","RepublishEntryFeature","DeleteEntryFeature","DeleteEntryRevisionFeature","DeleteMultipleEntriesFeature","RestoreEntryFromBinFeature","UpdateSingletonEntryFeature"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCO,MAAMA,wBAAwBC,cAAc;IAC/C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QACnBC,0BAA0B,QAAQ,CAACF;QACnCG,2BAA2B,QAAQ,CAACH;QAEpCI,uBAAuB,QAAQ,CAACJ;QAChCK,uBAAuB,QAAQ,CAACL;QAChCM,oBAAoB,QAAQ,CAACN;QAC7BO,gCAAgC,QAAQ,CAACP;QACzCQ,qCAAqC,QAAQ,CAACR;QAC9CS,6BAA6B,QAAQ,CAACT;QACtCU,kCAAkC,QAAQ,CAACV;QAC3CW,6BAA6B,QAAQ,CAACX;QACtCY,oCAAoC,QAAQ,CAACZ;QAC7Ca,gBAAgB,QAAQ,CAACb;QACzBc,mBAAmB,QAAQ,CAACd;QAC5Be,4BAA4B,QAAQ,CAACf;QACrCgB,yBAAyB,QAAQ,CAAChB;QAGlCiB,6BAA6B,QAAQ,CAACjB;QAGtCkB,mBAAmB,QAAQ,CAAClB;QAC5BmB,+BAA+B,QAAQ,CAACnB;QACxCoB,sBAAsB,QAAQ,CAACpB;QAC/BqB,mBAAmB,QAAQ,CAACrB;QAC5BsB,iCAAiC,QAAQ,CAACtB;QAC1CuB,qBAAqB,QAAQ,CAACvB;QAC9BwB,iBAAiB,QAAQ,CAACxB;QAC1ByB,oBAAoB,QAAQ,CAACzB;QAC7B0B,sBAAsB,QAAQ,CAAC1B;QAC/B2B,sBAAsB,QAAQ,CAAC3B;QAC/B4B,mBAAmB,QAAQ,CAAC5B;QAC5B6B,2BAA2B,QAAQ,CAAC7B;QACpC8B,6BAA6B,QAAQ,CAAC9B;QACtC+B,2BAA2B,QAAQ,CAAC/B;QACpCgC,4BAA4B,QAAQ,CAAChC;IACzC;AACJ"}

package/features/contentEntry/ContentEntryTraverser/ContentEntryTraverser.d.ts

@@ -0,0 +1,13 @@
+import type { CmsEntryValues, CmsModelAst, ContentEntryValueVisitor } from "../../../types/index.js";
+export interface IContentEntryTraverser {
+    traverse(values: CmsEntryValues, visitor: ContentEntryValueVisitor): Promise<void>;
+}
+export declare class ContentEntryTraverser implements IContentEntryTraverser {
+    private readonly modelAst;
+    constructor(modelAst: CmsModelAst);
+    traverse<T extends CmsEntryValues = CmsEntryValues>(values: T, visitor: ContentEntryValueVisitor): Promise<void>;
+    private visitTree;
+    private ensureArray;
+    private findCollectionAndVisit;
+    private getFieldFromNode;
+}

package/features/contentEntry/ContentEntryTraverser/ContentEntryTraverser.js

@@ -0,0 +1,69 @@
+const nodeHasChildren = (node)=>node.children.length > 0;
+const childrenAreCollections = (node)=>node.children.every((node)=>"collection" === node.type);
+class ContentEntryTraverser {
+    constructor(modelAst){
+        this.modelAst = modelAst;
+    }
+    async traverse(values, visitor) {
+        await this.visitTree(this.modelAst, values, [], visitor);
+    }
+    async visitTree(root, values, path, visitor) {
+        for (const node of root.children){
+            const context = {
+                node,
+                parent: root
+            };
+            const field = this.getFieldFromNode(context);
+            const fieldIdKey = field.fieldId;
+            let value = values[fieldIdKey];
+            if (nodeHasChildren(node) && null == value) continue;
+            if (!nodeHasChildren(node) && void 0 === value) continue;
+            const fieldPath = [
+                ...path,
+                field.fieldId
+            ];
+            await visitor({
+                field,
+                value,
+                path: fieldPath.join(".")
+            }, context);
+            value = values[fieldIdKey];
+            if (nodeHasChildren(node) && childrenAreCollections(node)) {
+                if (field.list) {
+                    const arrayValue = this.ensureArray(value);
+                    for(let i = 0; i < arrayValue.length; i++)await this.findCollectionAndVisit(node, arrayValue[i], [
+                        ...fieldPath,
+                        i.toString()
+                    ], visitor);
+                    continue;
+                }
+                await this.findCollectionAndVisit(node, value, fieldPath, visitor);
+            }
+            if (field.list) {
+                const arrayValue = this.ensureArray(value);
+                for(let i = 0; i < arrayValue.length; i++)await this.visitTree(node, arrayValue[i], [
+                    ...fieldPath,
+                    i.toString()
+                ], visitor);
+                continue;
+            }
+            await this.visitTree(node, value, fieldPath, visitor);
+        }
+    }
+    ensureArray(value) {
+        if (!Array.isArray(value)) return [];
+        return value;
+    }
+    findCollectionAndVisit(node, values, path, visitor) {
+        const collection = node.children.find((child)=>values[child.collection.discriminator] === child.collection.id);
+        if (!collection) return;
+        return this.visitTree(collection, values, path, visitor);
+    }
+    getFieldFromNode({ node, parent }) {
+        if ("collection" === node.type) return parent.field;
+        return node.field;
+    }
+}
+export { ContentEntryTraverser };
+
+//# sourceMappingURL=ContentEntryTraverser.js.map