strapi-plugin-ai-sdk 0.6.6 → 0.6.7

package/dist/_chunks/{App-Dg01IPnx.js → App-31DoeBYs.js}

@@ -6,12 +6,14 @@ const reactRouterDom = require("react-router-dom");
 const designSystem = require("@strapi/design-system");
 const react = require("react");
 const styled = require("styled-components");
-const index = require("./index-CZYebcrb.js");
+const index = require("./index-tCUlQhF4.js");
 const icons = require("@strapi/icons");
 const Markdown = require("react-markdown");
+const remarkGfm = require("remark-gfm");
 const _interopDefault = (e) => e && e.__esModule ? e : { default: e };
 const styled__default = /* @__PURE__ */ _interopDefault(styled);
 const Markdown__default = /* @__PURE__ */ _interopDefault(Markdown);
+const remarkGfm__default = /* @__PURE__ */ _interopDefault(remarkGfm);
 const COOKIE_REGEX = /(?:^|;\s*)jwtToken=([^;]*)/;
 function getCookieValue() {
   const match = COOKIE_REGEX.exec(document.cookie);
@@ -813,8 +815,9 @@ const MarkdownBody = styled__default.default.div`
     opacity: 0.85;
   }
   a { color: ${({ $isUser }) => $isUser ? "#c0cfff" : "#4945ff"}; }
-  table { border-collapse: collapse; margin: 8px 0; font-size: 0.9em; }
-  th, td { border: 1px solid ${({ $isUser }) => $isUser ? "rgba(255,255,255,0.2)" : "#dcdce4"}; padding: 4px 8px; }
+  table { border-collapse: collapse; margin: 8px 0; font-size: 0.9em; width: 100%; overflow-x: auto; display: block; }
+  th, td { border: 1px solid ${({ $isUser }) => $isUser ? "rgba(255,255,255,0.2)" : "#dcdce4"}; padding: 4px 8px; text-align: left; white-space: nowrap; }
+  th { background: ${({ $isUser }) => $isUser ? "rgba(255,255,255,0.1)" : "rgba(0,0,0,0.03)"}; font-weight: 600; }
 `;
 const MessageRole = styled__default.default.div`
   font-size: 11px;
@@ -888,7 +891,7 @@ const MessageList = react.forwardRef(
           /* @__PURE__ */ jsxRuntime.jsxs(MessageBubble, { $isUser: message.role === "user", children: [
             /* @__PURE__ */ jsxRuntime.jsx(MessageRole, { $isUser: message.role === "user", children: message.role === "user" ? "You" : "Assistant" }),
             message.role === "user" && message.content,
-            message.role === "assistant" && displayContent && /* @__PURE__ */ jsxRuntime.jsx(MarkdownBody, { $isUser: false, children: /* @__PURE__ */ jsxRuntime.jsx(Markdown__default.default, { components: markdownComponents, children: displayContent }) }),
+            message.role === "assistant" && displayContent && /* @__PURE__ */ jsxRuntime.jsx(MarkdownBody, { $isUser: false, children: /* @__PURE__ */ jsxRuntime.jsx(Markdown__default.default, { remarkPlugins: [remarkGfm__default.default], components: markdownComponents, children: displayContent }) }),
             message.role === "assistant" && !displayContent && isLoading && /* @__PURE__ */ jsxRuntime.jsxs(TypingDots, { children: [
               /* @__PURE__ */ jsxRuntime.jsx("span", {}),
               /* @__PURE__ */ jsxRuntime.jsx("span", {}),

package/dist/_chunks/{App-T05Erwmh.mjs → App-k5doNU8o.mjs}

@@ -4,9 +4,10 @@ import { Link, useNavigate, Routes, Route } from "react-router-dom";
 import { Box, Typography, TextInput, Button, Main, SearchForm, Searchbar, Table, Thead, Tr, Th, Tbody, Td, Flex, Pagination, Modal, Field, Textarea, SingleSelect, SingleSelectOption } from "@strapi/design-system";
 import { useState, useEffect, useCallback, forwardRef, useRef, useMemo } from "react";
 import styled from "styled-components";
-import { P as PLUGIN_ID } from "./index-DzpIKOjG.mjs";
+import { P as PLUGIN_ID } from "./index-C6UZ9D-c.mjs";
 import { Plus, Trash, Sparkle, ArrowLeft, Pencil } from "@strapi/icons";
 import Markdown from "react-markdown";
+import remarkGfm from "remark-gfm";
 const COOKIE_REGEX = /(?:^|;\s*)jwtToken=([^;]*)/;
 function getCookieValue() {
   const match = COOKIE_REGEX.exec(document.cookie);
@@ -808,8 +809,9 @@ const MarkdownBody = styled.div`
     opacity: 0.85;
   }
   a { color: ${({ $isUser }) => $isUser ? "#c0cfff" : "#4945ff"}; }
-  table { border-collapse: collapse; margin: 8px 0; font-size: 0.9em; }
-  th, td { border: 1px solid ${({ $isUser }) => $isUser ? "rgba(255,255,255,0.2)" : "#dcdce4"}; padding: 4px 8px; }
+  table { border-collapse: collapse; margin: 8px 0; font-size: 0.9em; width: 100%; overflow-x: auto; display: block; }
+  th, td { border: 1px solid ${({ $isUser }) => $isUser ? "rgba(255,255,255,0.2)" : "#dcdce4"}; padding: 4px 8px; text-align: left; white-space: nowrap; }
+  th { background: ${({ $isUser }) => $isUser ? "rgba(255,255,255,0.1)" : "rgba(0,0,0,0.03)"}; font-weight: 600; }
 `;
 const MessageRole = styled.div`
   font-size: 11px;
@@ -883,7 +885,7 @@ const MessageList = forwardRef(
           /* @__PURE__ */ jsxs(MessageBubble, { $isUser: message.role === "user", children: [
             /* @__PURE__ */ jsx(MessageRole, { $isUser: message.role === "user", children: message.role === "user" ? "You" : "Assistant" }),
             message.role === "user" && message.content,
-            message.role === "assistant" && displayContent && /* @__PURE__ */ jsx(MarkdownBody, { $isUser: false, children: /* @__PURE__ */ jsx(Markdown, { components: markdownComponents, children: displayContent }) }),
+            message.role === "assistant" && displayContent && /* @__PURE__ */ jsx(MarkdownBody, { $isUser: false, children: /* @__PURE__ */ jsx(Markdown, { remarkPlugins: [remarkGfm], components: markdownComponents, children: displayContent }) }),
             message.role === "assistant" && !displayContent && isLoading && /* @__PURE__ */ jsxs(TypingDots, { children: [
               /* @__PURE__ */ jsx("span", {}),
               /* @__PURE__ */ jsx("span", {}),

package/dist/_chunks/{index-DzpIKOjG.mjs → index-C6UZ9D-c.mjs}

@@ -36,7 +36,7 @@ const index = {
         defaultMessage: PLUGIN_ID
       },
       Component: async () => {
-        const { App } = await import("./App-T05Erwmh.mjs");
+        const { App } = await import("./App-k5doNU8o.mjs");
         return App;
       }
     });

package/dist/_chunks/{index-CZYebcrb.js → index-tCUlQhF4.js}

@@ -37,7 +37,7 @@ const index = {
         defaultMessage: PLUGIN_ID
       },
       Component: async () => {
-        const { App } = await Promise.resolve().then(() => require("./App-Dg01IPnx.js"));
+        const { App } = await Promise.resolve().then(() => require("./App-31DoeBYs.js"));
         return App;
       }
     });

package/dist/admin/index.js

@@ -1,3 +1,3 @@
 "use strict";
-const index = require("../_chunks/index-CZYebcrb.js");
+const index = require("../_chunks/index-tCUlQhF4.js");
 module.exports = index.index;

package/dist/admin/index.mjs

@@ -1,4 +1,4 @@
-import { i } from "../_chunks/index-DzpIKOjG.mjs";
+import { i } from "../_chunks/index-C6UZ9D-c.mjs";
 export {
   i as default
 };

package/dist/server/index.js

@@ -647,6 +647,187 @@ async function recallPublicMemories(strapi, params) {
     return { success: false, memories: [], count: 0 };
   }
 }
+const DISPLAY_CANDIDATES$1 = ["name", "title", "username", "label", "slug", "email"];
+function getSchema(strapi, contentType) {
+  return strapi.contentTypes[contentType];
+}
+function getAttribute(strapi, contentType, field) {
+  const schema2 = getSchema(strapi, contentType);
+  return schema2?.attributes?.[field];
+}
+function getDisplayField(strapi, contentType) {
+  const schema2 = getSchema(strapi, contentType);
+  if (!schema2?.attributes) return "id";
+  for (const candidate of DISPLAY_CANDIDATES$1) {
+    const attr = schema2.attributes[candidate];
+    if (attr && (attr.type === "string" || attr.type === "text" || attr.type === "email")) {
+      return candidate;
+    }
+  }
+  for (const [name, attr] of Object.entries(schema2.attributes)) {
+    if (attr.type === "string" || attr.type === "text") {
+      return name;
+    }
+  }
+  return "id";
+}
+function resolveFieldPath(strapi, contentType, fieldPath) {
+  const parts = fieldPath.split(".");
+  const topField = parts[0];
+  const attr = getAttribute(strapi, contentType, topField);
+  if (!attr) {
+    return { resolvedPath: fieldPath, populate: [] };
+  }
+  if (attr.type === "relation" && attr.target) {
+    if (parts.length === 1) {
+      const displayField = getDisplayField(strapi, attr.target);
+      return {
+        resolvedPath: `${topField}.${displayField}`,
+        populate: [topField]
+      };
+    }
+    return { resolvedPath: fieldPath, populate: [topField] };
+  }
+  return { resolvedPath: fieldPath, populate: [] };
+}
+const MAX_PAGINATE = 1e3;
+const PAGE_SIZE = 100;
+const aggregateContentSchema = zod.z.object({
+  contentType: zod.z.string().describe('The content type UID, e.g. "api::article.article"'),
+  operation: zod.z.enum(["count", "countByField", "countByDateRange"]).describe(
+    "count — total count; countByField — group by a field; countByDateRange — bucket by date"
+  ),
+  filters: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe('Strapi filter object, e.g. { category: { name: "tech" } }'),
+  groupByField: zod.z.string().optional().describe('Field to group by for countByField. Just use the field name — relation fields are auto-resolved to their display name (e.g. "author", "category"). You can also use dot paths like "author.email" for a specific sub-field.'),
+  dateField: zod.z.string().optional().default("createdAt").describe('Date field for countByDateRange (default: "createdAt")'),
+  granularity: zod.z.enum(["day", "week", "month"]).optional().default("month").describe("Bucket granularity for countByDateRange"),
+  dateFrom: zod.z.string().optional().describe("ISO date string lower bound (inclusive)"),
+  dateTo: zod.z.string().optional().describe("ISO date string upper bound (inclusive)"),
+  status: zod.z.enum(["draft", "published"]).optional().describe("Filter by document status"),
+  locale: zod.z.string().optional().describe("Locale code for i18n content")
+});
+const aggregateContentDescription = 'Aggregate and count content entries. Use for analytics questions like "how many articles per category", "content trends by month", or total counts with filters. Prefer this over searchContent for counting and grouping.';
+function buildBaseQuery(params) {
+  const { filters, status, locale, dateFrom, dateTo, dateField = "createdAt" } = params;
+  const query = {};
+  const mergedFilters = { ...filters };
+  if (dateFrom || dateTo) {
+    const dateFilter = {};
+    if (dateFrom) dateFilter.$gte = dateFrom;
+    if (dateTo) dateFilter.$lte = dateTo;
+    mergedFilters[dateField] = dateFilter;
+  }
+  if (Object.keys(mergedFilters).length > 0) query.filters = mergedFilters;
+  if (status) query.status = status;
+  if (locale) query.locale = locale;
+  return query;
+}
+function resolveField(doc, fieldPath) {
+  const parts = fieldPath.split(".");
+  let current = doc;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return current;
+}
+async function paginateAll(strapi, contentType, baseQuery) {
+  const docs = [];
+  let page = 1;
+  while (docs.length < MAX_PAGINATE) {
+    const results = await strapi.documents(contentType).findMany({
+      ...baseQuery,
+      populate: "*",
+      page,
+      pageSize: PAGE_SIZE
+    });
+    if (!results || results.length === 0) break;
+    docs.push(...results);
+    if (results.length < PAGE_SIZE) break;
+    page++;
+  }
+  return docs;
+}
+const DISPLAY_CANDIDATES = ["name", "title", "username", "label", "slug", "email"];
+function toDisplayValue(raw) {
+  if (raw == null) return "(empty)";
+  if (typeof raw !== "object") return String(raw);
+  if (Array.isArray(raw)) {
+    if (raw.length === 0) return "(empty)";
+    return raw.map((item) => toDisplayValue(item)).join(", ");
+  }
+  const obj = raw;
+  for (const key of DISPLAY_CANDIDATES) {
+    if (obj[key] != null) return String(obj[key]);
+  }
+  return obj.id != null ? String(obj.id) : "(empty)";
+}
+function groupDocs(docs, fieldPath) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const doc of docs) {
+    const raw = resolveField(doc, fieldPath);
+    const value = toDisplayValue(raw);
+    counts.set(value, (counts.get(value) ?? 0) + 1);
+  }
+  return Array.from(counts.entries()).map(([value, count]) => ({ value, count })).sort((a, b) => b.count - a.count);
+}
+function getWeekKey(date) {
+  const d = new Date(date);
+  const day = d.getDay();
+  const diff = d.getDate() - day + (day === 0 ? -6 : 1);
+  d.setDate(diff);
+  return d.toISOString().slice(0, 10);
+}
+function getBucketKey(dateStr, granularity) {
+  const date = new Date(dateStr);
+  if (isNaN(date.getTime())) return "unknown";
+  switch (granularity) {
+    case "day":
+      return date.toISOString().slice(0, 10);
+    case "week":
+      return getWeekKey(date);
+    case "month":
+      return date.toISOString().slice(0, 7);
+  }
+}
+async function aggregateContent(strapi, params) {
+  const { contentType, operation } = params;
+  if (!strapi.contentTypes[contentType]) {
+    throw new Error(`Content type "${contentType}" does not exist.`);
+  }
+  const baseQuery = buildBaseQuery(params);
+  switch (operation) {
+    case "count": {
+      const total = await strapi.documents(contentType).count(baseQuery);
+      return { total };
+    }
+    case "countByField": {
+      const { groupByField } = params;
+      if (!groupByField) {
+        throw new Error("groupByField is required for countByField operation");
+      }
+      const { resolvedPath } = resolveFieldPath(strapi, contentType, groupByField);
+      const docs = await paginateAll(strapi, contentType, baseQuery);
+      const groups = groupDocs(docs, resolvedPath);
+      return { total: docs.length, groups, resolvedField: resolvedPath };
+    }
+    case "countByDateRange": {
+      const { dateField = "createdAt", granularity = "month" } = params;
+      const docs = await paginateAll(strapi, contentType, baseQuery);
+      const counts = /* @__PURE__ */ new Map();
+      for (const doc of docs) {
+        const raw = resolveField(doc, dateField);
+        if (!raw) continue;
+        const key = getBucketKey(String(raw), granularity);
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+      }
+      const buckets = Array.from(counts.entries()).map(([period, count]) => ({ period, count })).sort((a, b) => a.period.localeCompare(b.period));
+      return { total: docs.length, buckets };
+    }
+    default:
+      throw new Error(`Unknown operation: ${operation}`);
+  }
+}
 const listContentTypesTool = {
   name: "listContentTypes",
   description: listContentTypesDescription,
@@ -752,6 +933,13 @@ const uploadMediaTool = {
   schema: uploadMediaSchema,
   execute: async (args, strapi) => uploadMedia(strapi, args)
 };
+const aggregateContentTool = {
+  name: "aggregateContent",
+  description: aggregateContentDescription,
+  schema: aggregateContentSchema,
+  execute: async (args, strapi) => aggregateContent(strapi, args),
+  publicSafe: true
+};
 const builtInTools = [
   listContentTypesTool,
   searchContentTool,
@@ -761,7 +949,8 @@ const builtInTools = [
   sendEmailTool,
   saveMemoryTool,
   recallMemoriesTool,
-  recallPublicMemoriesTool
+  recallPublicMemoriesTool,
+  aggregateContentTool
 ];
 const PLUGIN_ID$2 = "ai-sdk";
 const bootstrap = ({ strapi }) => {
@@ -1915,7 +2104,7 @@ function createTools(strapi, context) {
   }
   return tools;
 }
-const CONTENT_TOOLS = /* @__PURE__ */ new Set(["searchContent", "findOneContent"]);
+const CONTENT_TOOLS = /* @__PURE__ */ new Set(["searchContent", "findOneContent", "aggregateContent"]);
 function createPublicTools(strapi, allowedContentTypes) {
   const plugin = strapi.plugin("ai-sdk");
   const registry = plugin.toolRegistry;
@@ -1965,8 +2154,8 @@ function describeTools(tools) {
   return `Available tools:
 ${lines.join("\n")}`;
 }
-const DEFAULT_PREAMBLE = "You are a Strapi CMS assistant. Use your tools to fulfill user requests. When asked to create or update content, use the appropriate tool — do not tell the user you cannot. When performing bulk operations (e.g. publish multiple items), call multiple tools in parallel in a single step rather than one at a time.";
-const DEFAULT_PUBLIC_PREAMBLE = "You are a helpful public assistant for this website. Use your tools to answer questions about the site content. You cannot modify any content or perform administrative actions.";
+const DEFAULT_PREAMBLE = 'You are a Strapi CMS assistant. Use your tools to fulfill user requests. When asked to create or update content, use the appropriate tool — do not tell the user you cannot. When performing bulk operations (e.g. publish multiple items), call multiple tools in parallel in a single step rather than one at a time.\n\nFor analytics and counting questions (e.g. "how many", "count", "distribution", "trends", "breakdown"), use the aggregateContent tool instead of searchContent — it is faster and purpose-built for these queries. Present analytics results as markdown tables. After showing analytics results, suggest 2-3 follow-up questions the user might find useful under a "**You might also want to know:**" heading.';
+const DEFAULT_PUBLIC_PREAMBLE = 'You are a helpful public assistant for this website. Use your tools to answer questions about the site content. You cannot modify any content or perform administrative actions.\n\nFor analytics and counting questions (e.g. "how many", "count", "distribution", "trends", "breakdown"), use the aggregateContent tool instead of searchContent — it is faster and purpose-built for these queries. Present analytics results as markdown tables. After showing analytics results, suggest 2-3 follow-up questions the user might find useful under a "**You might also want to know:**" heading.';
 function composeSystemPrompt(config2, toolsDescription, override) {
   const base = override || config2?.systemPrompt || DEFAULT_PREAMBLE;
   if (base.includes("{tools}")) {

package/dist/server/index.mjs

@@ -627,6 +627,187 @@ async function recallPublicMemories(strapi, params) {
     return { success: false, memories: [], count: 0 };
   }
 }
+const DISPLAY_CANDIDATES$1 = ["name", "title", "username", "label", "slug", "email"];
+function getSchema(strapi, contentType) {
+  return strapi.contentTypes[contentType];
+}
+function getAttribute(strapi, contentType, field) {
+  const schema2 = getSchema(strapi, contentType);
+  return schema2?.attributes?.[field];
+}
+function getDisplayField(strapi, contentType) {
+  const schema2 = getSchema(strapi, contentType);
+  if (!schema2?.attributes) return "id";
+  for (const candidate of DISPLAY_CANDIDATES$1) {
+    const attr = schema2.attributes[candidate];
+    if (attr && (attr.type === "string" || attr.type === "text" || attr.type === "email")) {
+      return candidate;
+    }
+  }
+  for (const [name, attr] of Object.entries(schema2.attributes)) {
+    if (attr.type === "string" || attr.type === "text") {
+      return name;
+    }
+  }
+  return "id";
+}
+function resolveFieldPath(strapi, contentType, fieldPath) {
+  const parts = fieldPath.split(".");
+  const topField = parts[0];
+  const attr = getAttribute(strapi, contentType, topField);
+  if (!attr) {
+    return { resolvedPath: fieldPath, populate: [] };
+  }
+  if (attr.type === "relation" && attr.target) {
+    if (parts.length === 1) {
+      const displayField = getDisplayField(strapi, attr.target);
+      return {
+        resolvedPath: `${topField}.${displayField}`,
+        populate: [topField]
+      };
+    }
+    return { resolvedPath: fieldPath, populate: [topField] };
+  }
+  return { resolvedPath: fieldPath, populate: [] };
+}
+const MAX_PAGINATE = 1e3;
+const PAGE_SIZE = 100;
+const aggregateContentSchema = z.object({
+  contentType: z.string().describe('The content type UID, e.g. "api::article.article"'),
+  operation: z.enum(["count", "countByField", "countByDateRange"]).describe(
+    "count — total count; countByField — group by a field; countByDateRange — bucket by date"
+  ),
+  filters: z.record(z.string(), z.unknown()).optional().describe('Strapi filter object, e.g. { category: { name: "tech" } }'),
+  groupByField: z.string().optional().describe('Field to group by for countByField. Just use the field name — relation fields are auto-resolved to their display name (e.g. "author", "category"). You can also use dot paths like "author.email" for a specific sub-field.'),
+  dateField: z.string().optional().default("createdAt").describe('Date field for countByDateRange (default: "createdAt")'),
+  granularity: z.enum(["day", "week", "month"]).optional().default("month").describe("Bucket granularity for countByDateRange"),
+  dateFrom: z.string().optional().describe("ISO date string lower bound (inclusive)"),
+  dateTo: z.string().optional().describe("ISO date string upper bound (inclusive)"),
+  status: z.enum(["draft", "published"]).optional().describe("Filter by document status"),
+  locale: z.string().optional().describe("Locale code for i18n content")
+});
+const aggregateContentDescription = 'Aggregate and count content entries. Use for analytics questions like "how many articles per category", "content trends by month", or total counts with filters. Prefer this over searchContent for counting and grouping.';
+function buildBaseQuery(params) {
+  const { filters, status, locale, dateFrom, dateTo, dateField = "createdAt" } = params;
+  const query = {};
+  const mergedFilters = { ...filters };
+  if (dateFrom || dateTo) {
+    const dateFilter = {};
+    if (dateFrom) dateFilter.$gte = dateFrom;
+    if (dateTo) dateFilter.$lte = dateTo;
+    mergedFilters[dateField] = dateFilter;
+  }
+  if (Object.keys(mergedFilters).length > 0) query.filters = mergedFilters;
+  if (status) query.status = status;
+  if (locale) query.locale = locale;
+  return query;
+}
+function resolveField(doc, fieldPath) {
+  const parts = fieldPath.split(".");
+  let current = doc;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return current;
+}
+async function paginateAll(strapi, contentType, baseQuery) {
+  const docs = [];
+  let page = 1;
+  while (docs.length < MAX_PAGINATE) {
+    const results = await strapi.documents(contentType).findMany({
+      ...baseQuery,
+      populate: "*",
+      page,
+      pageSize: PAGE_SIZE
+    });
+    if (!results || results.length === 0) break;
+    docs.push(...results);
+    if (results.length < PAGE_SIZE) break;
+    page++;
+  }
+  return docs;
+}
+const DISPLAY_CANDIDATES = ["name", "title", "username", "label", "slug", "email"];
+function toDisplayValue(raw) {
+  if (raw == null) return "(empty)";
+  if (typeof raw !== "object") return String(raw);
+  if (Array.isArray(raw)) {
+    if (raw.length === 0) return "(empty)";
+    return raw.map((item) => toDisplayValue(item)).join(", ");
+  }
+  const obj = raw;
+  for (const key of DISPLAY_CANDIDATES) {
+    if (obj[key] != null) return String(obj[key]);
+  }
+  return obj.id != null ? String(obj.id) : "(empty)";
+}
+function groupDocs(docs, fieldPath) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const doc of docs) {
+    const raw = resolveField(doc, fieldPath);
+    const value = toDisplayValue(raw);
+    counts.set(value, (counts.get(value) ?? 0) + 1);
+  }
+  return Array.from(counts.entries()).map(([value, count]) => ({ value, count })).sort((a, b) => b.count - a.count);
+}
+function getWeekKey(date) {
+  const d = new Date(date);
+  const day = d.getDay();
+  const diff = d.getDate() - day + (day === 0 ? -6 : 1);
+  d.setDate(diff);
+  return d.toISOString().slice(0, 10);
+}
+function getBucketKey(dateStr, granularity) {
+  const date = new Date(dateStr);
+  if (isNaN(date.getTime())) return "unknown";
+  switch (granularity) {
+    case "day":
+      return date.toISOString().slice(0, 10);
+    case "week":
+      return getWeekKey(date);
+    case "month":
+      return date.toISOString().slice(0, 7);
+  }
+}
+async function aggregateContent(strapi, params) {
+  const { contentType, operation } = params;
+  if (!strapi.contentTypes[contentType]) {
+    throw new Error(`Content type "${contentType}" does not exist.`);
+  }
+  const baseQuery = buildBaseQuery(params);
+  switch (operation) {
+    case "count": {
+      const total = await strapi.documents(contentType).count(baseQuery);
+      return { total };
+    }
+    case "countByField": {
+      const { groupByField } = params;
+      if (!groupByField) {
+        throw new Error("groupByField is required for countByField operation");
+      }
+      const { resolvedPath } = resolveFieldPath(strapi, contentType, groupByField);
+      const docs = await paginateAll(strapi, contentType, baseQuery);
+      const groups = groupDocs(docs, resolvedPath);
+      return { total: docs.length, groups, resolvedField: resolvedPath };
+    }
+    case "countByDateRange": {
+      const { dateField = "createdAt", granularity = "month" } = params;
+      const docs = await paginateAll(strapi, contentType, baseQuery);
+      const counts = /* @__PURE__ */ new Map();
+      for (const doc of docs) {
+        const raw = resolveField(doc, dateField);
+        if (!raw) continue;
+        const key = getBucketKey(String(raw), granularity);
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+      }
+      const buckets = Array.from(counts.entries()).map(([period, count]) => ({ period, count })).sort((a, b) => a.period.localeCompare(b.period));
+      return { total: docs.length, buckets };
+    }
+    default:
+      throw new Error(`Unknown operation: ${operation}`);
+  }
+}
 const listContentTypesTool = {
   name: "listContentTypes",
   description: listContentTypesDescription,
@@ -732,6 +913,13 @@ const uploadMediaTool = {
   schema: uploadMediaSchema,
   execute: async (args, strapi) => uploadMedia(strapi, args)
 };
+const aggregateContentTool = {
+  name: "aggregateContent",
+  description: aggregateContentDescription,
+  schema: aggregateContentSchema,
+  execute: async (args, strapi) => aggregateContent(strapi, args),
+  publicSafe: true
+};
 const builtInTools = [
   listContentTypesTool,
   searchContentTool,
@@ -741,7 +929,8 @@ const builtInTools = [
   sendEmailTool,
   saveMemoryTool,
   recallMemoriesTool,
-  recallPublicMemoriesTool
+  recallPublicMemoriesTool,
+  aggregateContentTool
 ];
 const PLUGIN_ID$2 = "ai-sdk";
 const bootstrap = ({ strapi }) => {
@@ -1895,7 +2084,7 @@ function createTools(strapi, context) {
   }
   return tools;
 }
-const CONTENT_TOOLS = /* @__PURE__ */ new Set(["searchContent", "findOneContent"]);
+const CONTENT_TOOLS = /* @__PURE__ */ new Set(["searchContent", "findOneContent", "aggregateContent"]);
 function createPublicTools(strapi, allowedContentTypes) {
   const plugin = strapi.plugin("ai-sdk");
   const registry = plugin.toolRegistry;
@@ -1945,8 +2134,8 @@ function describeTools(tools) {
   return `Available tools:
 ${lines.join("\n")}`;
 }
-const DEFAULT_PREAMBLE = "You are a Strapi CMS assistant. Use your tools to fulfill user requests. When asked to create or update content, use the appropriate tool — do not tell the user you cannot. When performing bulk operations (e.g. publish multiple items), call multiple tools in parallel in a single step rather than one at a time.";
-const DEFAULT_PUBLIC_PREAMBLE = "You are a helpful public assistant for this website. Use your tools to answer questions about the site content. You cannot modify any content or perform administrative actions.";
+const DEFAULT_PREAMBLE = 'You are a Strapi CMS assistant. Use your tools to fulfill user requests. When asked to create or update content, use the appropriate tool — do not tell the user you cannot. When performing bulk operations (e.g. publish multiple items), call multiple tools in parallel in a single step rather than one at a time.\n\nFor analytics and counting questions (e.g. "how many", "count", "distribution", "trends", "breakdown"), use the aggregateContent tool instead of searchContent — it is faster and purpose-built for these queries. Present analytics results as markdown tables. After showing analytics results, suggest 2-3 follow-up questions the user might find useful under a "**You might also want to know:**" heading.';
+const DEFAULT_PUBLIC_PREAMBLE = 'You are a helpful public assistant for this website. Use your tools to answer questions about the site content. You cannot modify any content or perform administrative actions.\n\nFor analytics and counting questions (e.g. "how many", "count", "distribution", "trends", "breakdown"), use the aggregateContent tool instead of searchContent — it is faster and purpose-built for these queries. Present analytics results as markdown tables. After showing analytics results, suggest 2-3 follow-up questions the user might find useful under a "**You might also want to know:**" heading.';
 function composeSystemPrompt(config2, toolsDescription, override) {
   const base = override || config2?.systemPrompt || DEFAULT_PREAMBLE;
   if (base.includes("{tools}")) {

package/dist/server/src/tool-logic/aggregate-content.d.ts

@@ -0,0 +1,52 @@
+import type { Core } from '@strapi/strapi';
+import { z } from 'zod';
+export declare const aggregateContentSchema: z.ZodObject<{
+    contentType: z.ZodString;
+    operation: z.ZodEnum<{
+        count: "count";
+        countByField: "countByField";
+        countByDateRange: "countByDateRange";
+    }>;
+    filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    groupByField: z.ZodOptional<z.ZodString>;
+    dateField: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    granularity: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        day: "day";
+        week: "week";
+        month: "month";
+    }>>>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const aggregateContentDescription = "Aggregate and count content entries. Use for analytics questions like \"how many articles per category\", \"content trends by month\", or total counts with filters. Prefer this over searchContent for counting and grouping.";
+export interface AggregateContentParams {
+    contentType: string;
+    operation: 'count' | 'countByField' | 'countByDateRange';
+    filters?: Record<string, unknown>;
+    groupByField?: string;
+    dateField?: string;
+    granularity?: 'day' | 'week' | 'month';
+    dateFrom?: string;
+    dateTo?: string;
+    status?: 'draft' | 'published';
+    locale?: string;
+}
+export interface AggregateContentResult {
+    total?: number;
+    groups?: {
+        value: string;
+        count: number;
+    }[];
+    buckets?: {
+        period: string;
+        count: number;
+    }[];
+    /** The field path actually used (after schema auto-resolution) */
+    resolvedField?: string;
+}
+export declare function aggregateContent(strapi: Core.Strapi, params: AggregateContentParams): Promise<AggregateContentResult>;

package/dist/server/src/tool-logic/index.d.ts

@@ -16,3 +16,6 @@ export { uploadMedia, uploadMediaSchema, uploadMediaDescription } from './upload
 export type { UploadMediaParams, UploadMediaResult } from './upload-media';
 export { recallPublicMemories, recallPublicMemoriesSchema, recallPublicMemoriesDescription } from './recall-public-memories';
 export type { RecallPublicMemoriesParams, RecallPublicMemoriesResult } from './recall-public-memories';
+export { aggregateContent, aggregateContentSchema, aggregateContentDescription } from './aggregate-content';
+export type { AggregateContentParams, AggregateContentResult } from './aggregate-content';
+export { resolveFieldPath, getDisplayField, isRelation, getRelationTarget, getSchema } from './schema-utils';

package/dist/server/src/tool-logic/schema-utils.d.ts

@@ -0,0 +1,51 @@
+import type { Core } from '@strapi/strapi';
+interface AttributeDef {
+    type: string;
+    target?: string;
+    relation?: string;
+    component?: string;
+    components?: string[];
+    [key: string]: unknown;
+}
+interface ContentTypeSchema {
+    attributes?: Record<string, AttributeDef>;
+    info?: {
+        displayName?: string;
+    };
+}
+/**
+ * Look up the schema for a content type UID.
+ */
+export declare function getSchema(strapi: Core.Strapi, contentType: string): ContentTypeSchema | undefined;
+/**
+ * Get the attribute definition for a top-level field on a content type.
+ */
+export declare function getAttribute(strapi: Core.Strapi, contentType: string, field: string): AttributeDef | undefined;
+/**
+ * Check if a field is a relation on the given content type.
+ */
+export declare function isRelation(strapi: Core.Strapi, contentType: string, field: string): boolean;
+/**
+ * For a relation field, get the target content type UID.
+ */
+export declare function getRelationTarget(strapi: Core.Strapi, contentType: string, field: string): string | undefined;
+/**
+ * Determine the best human-readable display field for a content type.
+ * Checks common candidates (name, title, username, label, slug, email),
+ * then falls back to the first string/text field, then 'id'.
+ */
+export declare function getDisplayField(strapi: Core.Strapi, contentType: string): string;
+/**
+ * Given a field path that the AI provided (e.g. "author", "category", "author.name"),
+ * resolve it to the actual dot-path needed to extract a display value from a populated document.
+ *
+ * If the field is a relation with no sub-field specified, appends the best display field
+ * from the target schema (e.g. "author" → "author.name").
+ *
+ * Returns the resolved path and any top-level relations that need populating.
+ */
+export declare function resolveFieldPath(strapi: Core.Strapi, contentType: string, fieldPath: string): {
+    resolvedPath: string;
+    populate: string[];
+};
+export {};

package/dist/server/src/tools/definitions/aggregate-content.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '../../lib/tool-registry';
+export declare const aggregateContentTool: ToolDefinition;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.6.6",
+  "version": "0.6.7",
   "keywords": [
     "strapi",
     "strapi-plugin",