strapi-plugin-ai-sdk 0.7.7 → 0.8.0

package/dist/server/index.mjs

@@ -10,6 +10,90 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { randomUUID } from "node:crypto";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+function toSnakeCase$1(str) {
+  return str.replace(/:/g, "__").replace(/-/g, "_").replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+function extractType(field) {
+  const def = field?._zod?.def;
+  if (!def) return "unknown";
+  switch (def.type) {
+    case "string":
+      return "string";
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "enum":
+      return Object.keys(def.entries).join(" | ");
+    case "optional":
+      return extractType({ _zod: { def: def.innerType } });
+    case "default":
+      return extractType({ _zod: { def: def.innerType } });
+    case "record":
+      return "object";
+    case "array":
+      return "array";
+    case "union":
+      return "string | array | object";
+    default:
+      return def.type || "unknown";
+  }
+}
+function formatParams(schema2) {
+  const shape = schema2.shape;
+  if (!shape || Object.keys(shape).length === 0) {
+    return "_No parameters._\n";
+  }
+  const rows = [];
+  rows.push("| Parameter | Type | Required | Description |");
+  rows.push("|-----------|------|----------|-------------|");
+  for (const [name, field] of Object.entries(shape)) {
+    const required = !field.isOptional?.();
+    const type = extractType(field);
+    const desc = (field.description || "").replace(/\|/g, "\\|");
+    rows.push(`| ${name} | ${type} | ${required ? "Yes" : "No"} | ${desc} |`);
+  }
+  return rows.join("\n") + "\n";
+}
+function generateToolGuide(registry) {
+  const tools = registry.getPublic();
+  const sources = registry.getToolSources();
+  const sections = [];
+  sections.push("# Strapi AI Tools Guide\n");
+  sections.push("## Getting Started\n");
+  sections.push(
+    "Start with `list_content_types` to discover your content types and their fields, then use `search_content` to query them.\n"
+  );
+  for (const source of sources) {
+    const heading = source.id === "built-in" ? "Built-in Tools" : source.label;
+    sections.push(`## ${heading}
+`);
+    for (const toolName of source.tools) {
+      const def = tools.get(toolName);
+      if (!def) continue;
+      const mcpName = toSnakeCase$1(toolName);
+      sections.push(`### ${mcpName}
+`);
+      sections.push(`${def.description}
+`);
+      sections.push(formatParams(def.schema));
+    }
+  }
+  sections.push("## Common Workflows\n");
+  sections.push("### Create a blog post\n");
+  sections.push(
+    "1. Call `list_content_types` to discover the article/blog content type and its fields\n2. (Optional) Call `upload_media` with a URL to upload a cover image\n3. Call `create_content` with the content type UID and field data\n"
+  );
+  sections.push("### Find and update content\n");
+  sections.push(
+    "1. Call `search_content` with filters or a query to find the document\n2. Note the `documentId` from the results\n3. Call `update_content` with the content type, documentId, and fields to change\n"
+  );
+  sections.push("### Content analytics\n");
+  sections.push(
+    "1. Call `aggregate_content` with operation `count` for totals\n2. Use `countByField` with `groupByField` to see distribution (e.g. articles per category)\n3. Use `countByDateRange` with `granularity` to see trends over time\n"
+  );
+  return sections.join("\n");
+}
 function toSnakeCase(str) {
   return str.replace(/:/g, "__").replace(/-/g, "_").replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
 }
@@ -26,7 +110,8 @@ function createMcpServer(strapi) {
     },
     {
       capabilities: {
-        tools: {}
+        tools: {},
+        resources: {}
       }
     }
   );
@@ -54,6 +139,24 @@ function createMcpServer(strapi) {
       }
     );
   }
+  const guideMarkdown = generateToolGuide(registry);
+  server.registerResource(
+    "Tool Guide",
+    "strapi://tools/guide",
+    {
+      description: "Complete guide to all available Strapi AI tools with parameters and usage examples",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [
+        {
+          uri: "strapi://tools/guide",
+          mimeType: "text/markdown",
+          text: guideMarkdown
+        }
+      ]
+    })
+  );
   strapi.log.info("[ai-sdk:mcp] MCP server created with tools:", { tools: toolNames });
   return server;
 }
@@ -219,7 +322,7 @@ class ToolRegistry {
   }
 }
 const listContentTypesSchema = z.object({});
-const listContentTypesDescription = "List all Strapi content types and components with their fields, relations, and structure.";
+const listContentTypesDescription = 'List all Strapi content types and components with their fields, relations, and structure. This is the starting point for any content operation — call it first to discover content type UIDs (e.g. "api::article.article"), field names, relation targets, and components. No parameters required. Results are cached.';
 const INTERNAL_FIELDS = /* @__PURE__ */ new Set([
   "createdAt",
   "updatedAt",
@@ -373,7 +476,7 @@ const createContentSchema = z.object({
   status: z.enum(["draft", "published"]).optional().describe("Document status. Defaults to draft."),
   locale: z.string().optional().describe('Locale code for i18n content, e.g. "en" or "fr"')
 });
-const createContentDescription = "Create a new document in any Strapi content type (articles, blog posts, pages, etc.). Use listContentTypes first to discover available content types and their fields.";
+const createContentDescription = "Create a new document in any Strapi content type. Requires contentType (UID) and data (field values). Call listContentTypes first to discover UIDs and required fields. To attach media, upload it first with uploadMedia, then pass the file ID in data. Returns the created document with all fields populated.";
 async function createContent(strapi, params) {
   const { contentType, data, status, locale } = params;
   if (!strapi.contentTypes[contentType]) {
@@ -395,7 +498,7 @@ const updateContentSchema = z.object({
   status: z.enum(["draft", "published"]).optional().describe("Document status. Defaults to draft."),
   locale: z.string().optional().describe('Locale code for i18n content, e.g. "en" or "fr"')
 });
-const updateContentDescription = "Update an existing document in any Strapi content type. Use searchContent to find the document ID first.";
+const updateContentDescription = "Update an existing document in any Strapi content type. Requires contentType, documentId, and data (fields to change — only include fields you want to modify). Typical workflow: searchContent to find the documentId, then updateContent to modify it. Returns the updated document.";
 async function updateContent(strapi, params) {
   const { contentType, documentId, data, status, locale } = params;
   if (!strapi.contentTypes[contentType]) {
@@ -468,7 +571,7 @@ async function sendEmail(strapi, params) {
     subject: params.subject
   };
 }
-const CONTENT_TYPE$7 = "plugin::ai-sdk.memory";
+const CONTENT_TYPE$a = "plugin::ai-sdk.memory";
 const saveMemorySchema = z.object({
   content: z.string().describe('A short, factual statement to remember about the user (e.g. "User prefers dark mode", "Company name is Acme Corp")'),
   category: z.string().optional().describe('Category for the memory (e.g. "preference", "project", "personal", "general"). Defaults to "general".')
@@ -479,7 +582,7 @@ async function saveMemory(strapi, params, context) {
     return { success: false, message: "Cannot save memory: user context not available." };
   }
   try {
-    await strapi.documents(CONTENT_TYPE$7).create({
+    await strapi.documents(CONTENT_TYPE$a).create({
       data: {
         content: params.content,
         category: params.category || "general",
@@ -492,7 +595,7 @@ async function saveMemory(strapi, params, context) {
     return { success: false, message: `Failed to save memory: ${detail}` };
   }
 }
-const CONTENT_TYPE$6 = "plugin::ai-sdk.memory";
+const CONTENT_TYPE$9 = "plugin::ai-sdk.memory";
 const recallMemoriesSchema = z.object({
   query: z.string().optional().describe("Optional search term to filter memories by content"),
   category: z.string().optional().describe('Optional category to filter by (e.g. "preference", "project", "personal")')
@@ -510,7 +613,7 @@ async function recallMemories(strapi, params, context) {
     if (params.query) {
       filters.content = { $containsi: params.query };
     }
-    const memories = await strapi.documents(CONTENT_TYPE$6).findMany({
+    const memories = await strapi.documents(CONTENT_TYPE$9).findMany({
       filters,
       fields: ["content", "category"],
       sort: { createdAt: "desc" }
@@ -536,7 +639,7 @@ const findOneContentSchema = z.object({
   status: z.enum(["draft", "published"]).optional().describe("Document status filter."),
   locale: z.string().optional().describe('Locale code for i18n content, e.g. "en" or "fr"')
 });
-const findOneContentDescription = "Fetch a single document by its documentId from any Strapi content type. Returns the full document with all fields and populated relations. Use searchContent first to discover document IDs.";
+const findOneContentDescription = "Fetch a single document by its exact documentId. Use this when you already have a documentId and need full details with populated relations. If you need to find documents by title, field values, or full-text search, use searchContent instead. Requires contentType and documentId.";
 async function findOneContent(strapi, params) {
   const { contentType, documentId, populate = "*", fields, status, locale } = params;
   if (!strapi.contentTypes[contentType]) {
@@ -562,7 +665,7 @@ const uploadMediaSchema = z.object({
   caption: z.string().optional().describe("Caption for the media file"),
   alternativeText: z.string().optional().describe("Alternative text for accessibility")
 });
-const uploadMediaDescription = "Upload a media file from a URL to the Strapi media library. Returns the uploaded file data. To link media to a content type field, use createContent or updateContent with the file ID.";
+const uploadMediaDescription = "Upload a media file from a URL to the Strapi media library. This is step 1 of a two-step process: (1) upload the file with this tool to get a file ID, then (2) link it to a content entry using createContent or updateContent with { fieldName: fileId }. Requires url. Optional: name, caption, alternativeText.";
 async function uploadMedia(strapi, params) {
   const { url, name, caption, alternativeText } = params;
   let parsedUrl;
@@ -633,7 +736,7 @@ async function uploadMedia(strapi, params) {
     usage: `To link this file to a content type field, use createContent or updateContent with: { "fieldName": ${uploadedFile.id} }`
   };
 }
-const CONTENT_TYPE$5 = "plugin::ai-sdk.public-memory";
+const CONTENT_TYPE$8 = "plugin::ai-sdk.public-memory";
 const recallPublicMemoriesSchema = z.object({
   query: z.string().optional().describe("Optional search term to filter public memories by content"),
   category: z.string().optional().describe('Optional category to filter by (e.g. "faq", "product", "policy")')
@@ -644,7 +747,7 @@ async function recallPublicMemories(strapi, params) {
     const filters = {};
     if (params.category) filters.category = params.category;
     if (params.query) filters.content = { $containsi: params.query };
-    const memories = await strapi.documents(CONTENT_TYPE$5).findMany({
+    const memories = await strapi.documents(CONTENT_TYPE$8).findMany({
       filters,
       fields: ["content", "category"],
       sort: { createdAt: "desc" }
@@ -726,7 +829,7 @@ const aggregateContentSchema = z.object({
   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.';
+const aggregateContentDescription = 'Count and group content entries for analytics. Answers questions like "how many articles?", "posts per category", "content published by month". Three operations: count (total), countByField (group by a field), countByDateRange (bucket by day/week/month). Prefer this over searchContent when you need counts or distributions, not the documents themselves.';
 function buildBaseQuery(params) {
   const { filters, status, locale, dateFrom, dateTo, dateField = "createdAt" } = params;
   const query = {};
@@ -878,7 +981,7 @@ async function aggregateContent(strapi, params) {
       throw new Error(`Unknown operation: ${operation}`);
   }
 }
-const CONTENT_TYPE$4 = "plugin::ai-sdk.task";
+const CONTENT_TYPE$7 = "plugin::ai-sdk.task";
 const manageTaskSchema = z.object({
   action: z.enum(["create", "update", "complete", "list", "summary"]).describe(
     "Action to perform: create a new task, update an existing task, complete (mark done), list open tasks, or get a summary."
@@ -894,14 +997,14 @@ const manageTaskSchema = z.object({
   done: z.boolean().optional().describe("Set done status explicitly (for update action)."),
   filters: z.record(z.string(), z.unknown()).optional().describe("Additional Strapi filters for list action.")
 });
-const manageTaskDescription = "Manage the user's task list. Create, update, complete, list, or summarize tasks. Tasks are scored by consequence × impact to help prioritize what matters most.";
+const manageTaskDescription = "Manage the user's task list. Actions: create (new task), update (modify fields), complete (mark done), list (open tasks sorted by priority score), summary (overview with overdue/urgent counts). Tasks are scored by consequence × impact to prioritize what matters most. For create: title is required; consequence and impact are collected via UI form if omitted.";
 async function resolveTask(strapi, adminUserId, documentId, title) {
   if (documentId) {
-    const task2 = await strapi.documents(CONTENT_TYPE$4).findOne({ documentId });
+    const task2 = await strapi.documents(CONTENT_TYPE$7).findOne({ documentId });
     if (task2 && task2.adminUserId === adminUserId) return task2;
   }
   if (title) {
-    const tasks = await strapi.documents(CONTENT_TYPE$4).findMany({
+    const tasks = await strapi.documents(CONTENT_TYPE$7).findMany({
       filters: {
         adminUserId,
         title: { $containsi: title }
@@ -954,7 +1057,7 @@ async function manageTask(strapi, params, context) {
           if (params.consequence !== void 0) data.consequence = params.consequence;
           if (params.impact !== void 0) data.impact = params.impact;
           if (params.dueDate !== void 0) data.dueDate = params.dueDate;
-          const updated = await strapi.documents(CONTENT_TYPE$4).update({
+          const updated = await strapi.documents(CONTENT_TYPE$7).update({
             documentId: duplicate.documentId,
             data
           });
@@ -965,7 +1068,7 @@ async function manageTask(strapi, params, context) {
             data: updated
           };
         }
-        const task2 = await strapi.documents(CONTENT_TYPE$4).create({
+        const task2 = await strapi.documents(CONTENT_TYPE$7).create({
           data: {
             title: params.title,
             description: params.description,
@@ -994,7 +1097,7 @@ async function manageTask(strapi, params, context) {
         for (const key of ["title", "description", "content", "priority", "consequence", "impact", "dueDate", "done"]) {
           if (params[key] !== void 0) data[key] = params[key];
         }
-        const updated = await strapi.documents(CONTENT_TYPE$4).update({
+        const updated = await strapi.documents(CONTENT_TYPE$7).update({
           documentId: existing.documentId,
           data
         });
@@ -1005,7 +1108,7 @@ async function manageTask(strapi, params, context) {
         if (!toComplete) {
           return { success: false, message: "Task not found. Provide a documentId or a title to search by." };
         }
-        await strapi.documents(CONTENT_TYPE$4).update({
+        await strapi.documents(CONTENT_TYPE$7).update({
           documentId: toComplete.documentId,
           data: { done: true }
         });
@@ -1017,7 +1120,7 @@ async function manageTask(strapi, params, context) {
           done: false,
           ...params.filters
         };
-        const tasks = await strapi.documents(CONTENT_TYPE$4).findMany({
+        const tasks = await strapi.documents(CONTENT_TYPE$7).findMany({
           filters
         });
         const sorted = tasks.sort((a, b) => {
@@ -1046,7 +1149,7 @@ async function manageTask(strapi, params, context) {
         };
       }
       case "summary": {
-        const allOpen = await strapi.documents(CONTENT_TYPE$4).findMany({
+        const allOpen = await strapi.documents(CONTENT_TYPE$7).findMany({
           filters: { adminUserId, done: false }
         });
         const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -1083,6 +1186,82 @@ async function manageTask(strapi, params, context) {
     return { success: false, message: `Task operation failed: ${detail}` };
   }
 }
+const CONTENT_TYPE$6 = "plugin::ai-sdk.note";
+const saveNoteSchema = z.object({
+  title: z.string().optional().describe("A short title or label for the note"),
+  content: z.string().describe("The note content in markdown format. Can include code blocks, lists, links, etc."),
+  category: z.string().optional().describe('Category for the note: "research", "snippet", "idea", or "reference". Defaults to "research".'),
+  tags: z.string().optional().describe('Comma-separated tags for filtering (e.g. "strapi, api, tutorial")'),
+  source: z.string().optional().describe('Where this note came from (e.g. "conversation", "web research", a URL)')
+});
+const saveNoteDescription = "Save a research note, code snippet, idea, or reference for the user. Use this when the user wants to save part of a conversation, research findings, code examples, or any content they may want to use later for writing blog posts or articles. Content is saved as markdown.";
+async function saveNote(strapi, params, context) {
+  if (!context?.adminUserId) {
+    return { success: false, message: "Cannot save note: user context not available." };
+  }
+  try {
+    await strapi.documents(CONTENT_TYPE$6).create({
+      data: {
+        title: params.title || "",
+        content: params.content,
+        category: params.category || "research",
+        tags: params.tags || "",
+        source: params.source || "conversation",
+        adminUserId: context.adminUserId
+      }
+    });
+    const label = params.title ? `"${params.title}"` : "Note";
+    return { success: true, message: `${label} saved to research notes.` };
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return { success: false, message: `Failed to save note: ${detail}` };
+  }
+}
+const CONTENT_TYPE$5 = "plugin::ai-sdk.note";
+const recallNotesSchema = z.object({
+  query: z.string().optional().describe("Optional search term to filter notes by title or content"),
+  category: z.string().optional().describe('Optional category to filter by: "research", "snippet", "idea", "reference"'),
+  tag: z.string().optional().describe("Optional tag to filter by (matches within comma-separated tags)")
+});
+const recallNotesDescription = "Recall saved research notes, snippets, ideas, and references. Use this to look up previously saved notes. Without parameters, returns all notes.";
+async function recallNotes(strapi, params, context) {
+  if (!context?.adminUserId) {
+    return { success: false, notes: [], count: 0 };
+  }
+  try {
+    const filters = { adminUserId: context.adminUserId };
+    if (params.category) {
+      filters.category = params.category;
+    }
+    if (params.query) {
+      filters.$or = [
+        { title: { $containsi: params.query } },
+        { content: { $containsi: params.query } }
+      ];
+    }
+    if (params.tag) {
+      filters.tags = { $containsi: params.tag };
+    }
+    const notes = await strapi.documents(CONTENT_TYPE$5).findMany({
+      filters,
+      fields: ["title", "content", "category", "tags", "source"],
+      sort: { createdAt: "desc" }
+    });
+    return {
+      success: true,
+      notes: notes.map((n) => ({
+        title: n.title || "",
+        content: n.content,
+        category: n.category,
+        tags: n.tags || "",
+        source: n.source || ""
+      })),
+      count: notes.length
+    };
+  } catch (error) {
+    return { success: false, notes: [], count: 0 };
+  }
+}
 const listContentTypesTool = {
   name: "listContentTypes",
   description: listContentTypesDescription,
@@ -1213,6 +1392,20 @@ const manageTaskTool = {
   execute: async (args, strapi, context) => manageTask(strapi, args, context),
   internal: true
 };
+const saveNoteTool = {
+  name: "saveNote",
+  description: saveNoteDescription,
+  schema: saveNoteSchema,
+  execute: async (args, strapi, context) => saveNote(strapi, args, context),
+  internal: true
+};
+const recallNotesTool = {
+  name: "recallNotes",
+  description: recallNotesDescription,
+  schema: recallNotesSchema,
+  execute: async (args, strapi, context) => recallNotes(strapi, args, context),
+  internal: true
+};
 const builtInTools = [
   listContentTypesTool,
   searchContentTool,
@@ -1225,7 +1418,9 @@ const builtInTools = [
   recallMemoriesTool,
   recallPublicMemoriesTool,
   aggregateContentTool,
-  manageTaskTool
+  manageTaskTool,
+  saveNoteTool,
+  recallNotesTool
 ];
 const PLUGIN_ID$2 = "ai-sdk";
 const bootstrap = ({ strapi }) => {
@@ -1396,17 +1591,17 @@ const config = {
     }
   }
 };
-const kind$3 = "collectionType";
-const collectionName$3 = "ai_sdk_conversations";
-const info$3 = {
+const kind$4 = "collectionType";
+const collectionName$4 = "ai_sdk_conversations";
+const info$4 = {
   singularName: "conversation",
   pluralName: "conversations",
   displayName: "AI Conversation"
 };
-const options$3 = {
+const options$4 = {
   draftAndPublish: false
 };
-const pluginOptions$3 = {
+const pluginOptions$4 = {
   "content-manager": {
     visible: false
   },
@@ -1414,7 +1609,7 @@ const pluginOptions$3 = {
     visible: false
   }
 };
-const attributes$3 = {
+const attributes$4 = {
   title: {
     type: "string",
     required: true,
@@ -1429,26 +1624,26 @@ const attributes$3 = {
     required: true
   }
 };
-const schema$3 = {
-  kind: kind$3,
-  collectionName: collectionName$3,
-  info: info$3,
-  options: options$3,
-  pluginOptions: pluginOptions$3,
-  attributes: attributes$3
+const schema$4 = {
+  kind: kind$4,
+  collectionName: collectionName$4,
+  info: info$4,
+  options: options$4,
+  pluginOptions: pluginOptions$4,
+  attributes: attributes$4
 };
-const conversation = { schema: schema$3 };
-const kind$2 = "collectionType";
-const collectionName$2 = "ai_sdk_memories";
-const info$2 = {
+const conversation = { schema: schema$4 };
+const kind$3 = "collectionType";
+const collectionName$3 = "ai_sdk_memories";
+const info$3 = {
   singularName: "memory",
   pluralName: "memories",
   displayName: "AI Memory"
 };
-const options$2 = {
+const options$3 = {
   draftAndPublish: false
 };
-const pluginOptions$2 = {
+const pluginOptions$3 = {
   "content-manager": {
     visible: false
   },
@@ -1456,9 +1651,9 @@ const pluginOptions$2 = {
     visible: false
   }
 };
-const attributes$2 = {
+const attributes$3 = {
   content: {
-    type: "text",
+    type: "richtext",
     required: true
   },
   category: {
@@ -1476,26 +1671,26 @@ const attributes$2 = {
     required: true
   }
 };
-const schema$2 = {
-  kind: kind$2,
-  collectionName: collectionName$2,
-  info: info$2,
-  options: options$2,
-  pluginOptions: pluginOptions$2,
-  attributes: attributes$2
+const schema$3 = {
+  kind: kind$3,
+  collectionName: collectionName$3,
+  info: info$3,
+  options: options$3,
+  pluginOptions: pluginOptions$3,
+  attributes: attributes$3
 };
-const memory = { schema: schema$2 };
-const kind$1 = "collectionType";
-const collectionName$1 = "ai_sdk_public_memories";
-const info$1 = {
+const memory = { schema: schema$3 };
+const kind$2 = "collectionType";
+const collectionName$2 = "ai_sdk_public_memories";
+const info$2 = {
   singularName: "public-memory",
   pluralName: "public-memories",
   displayName: "AI Public Memory"
 };
-const options$1 = {
+const options$2 = {
   draftAndPublish: false
 };
-const pluginOptions$1 = {
+const pluginOptions$2 = {
   "content-manager": {
     visible: false
   },
@@ -1503,7 +1698,7 @@ const pluginOptions$1 = {
     visible: false
   }
 };
-const attributes$1 = {
+const attributes$2 = {
   content: {
     type: "text",
     required: true
@@ -1519,26 +1714,26 @@ const attributes$1 = {
     "default": "general"
   }
 };
-const schema$1 = {
-  kind: kind$1,
-  collectionName: collectionName$1,
-  info: info$1,
-  options: options$1,
-  pluginOptions: pluginOptions$1,
-  attributes: attributes$1
+const schema$2 = {
+  kind: kind$2,
+  collectionName: collectionName$2,
+  info: info$2,
+  options: options$2,
+  pluginOptions: pluginOptions$2,
+  attributes: attributes$2
 };
-const publicMemory = { schema: schema$1 };
-const kind = "collectionType";
-const collectionName = "ai_sdk_tasks";
-const info = {
+const publicMemory = { schema: schema$2 };
+const kind$1 = "collectionType";
+const collectionName$1 = "ai_sdk_tasks";
+const info$1 = {
   singularName: "task",
   pluralName: "tasks",
   displayName: "AI Task"
 };
-const options = {
+const options$1 = {
   draftAndPublish: false
 };
-const pluginOptions = {
+const pluginOptions$1 = {
   "content-manager": {
     visible: true
   },
@@ -1546,7 +1741,7 @@ const pluginOptions = {
     visible: false
   }
 };
-const attributes = {
+const attributes$1 = {
   title: {
     type: "string",
     required: true
@@ -1591,6 +1786,62 @@ const attributes = {
     required: true
   }
 };
+const schema$1 = {
+  kind: kind$1,
+  collectionName: collectionName$1,
+  info: info$1,
+  options: options$1,
+  pluginOptions: pluginOptions$1,
+  attributes: attributes$1
+};
+const task = { schema: schema$1 };
+const kind = "collectionType";
+const collectionName = "ai_sdk_notes";
+const info = {
+  singularName: "note",
+  pluralName: "notes",
+  displayName: "AI Note"
+};
+const options = {
+  draftAndPublish: false
+};
+const pluginOptions = {
+  "content-manager": {
+    visible: false
+  },
+  "content-type-builder": {
+    visible: false
+  }
+};
+const attributes = {
+  title: {
+    type: "string"
+  },
+  content: {
+    type: "richtext",
+    required: true
+  },
+  category: {
+    type: "enumeration",
+    "enum": [
+      "research",
+      "snippet",
+      "idea",
+      "reference"
+    ],
+    "default": "research"
+  },
+  tags: {
+    type: "text"
+  },
+  source: {
+    type: "string"
+  },
+  adminUserId: {
+    type: "integer",
+    required: true
+  }
+};
 const schema = {
   kind,
   collectionName,
@@ -1599,8 +1850,8 @@ const schema = {
   pluginOptions,
   attributes
 };
-const task = { schema };
-const contentTypes = { conversation, memory, "public-memory": publicMemory, task };
+const note = { schema };
+const contentTypes = { conversation, memory, "public-memory": publicMemory, task, note };
 function getService(strapi, ctx) {
   const service2 = strapi.plugin("ai-sdk").service("service");
   if (!service2.isInitialized()) {
@@ -1916,20 +2167,20 @@ const mcpController = ({ strapi }) => {
     }
   };
 };
-const CONTENT_TYPE$3 = "plugin::ai-sdk.conversation";
-function getAdminUserId$2(ctx) {
+const CONTENT_TYPE$4 = "plugin::ai-sdk.conversation";
+function getAdminUserId$3(ctx) {
   const id = ctx.state?.user?.id;
   return typeof id === "number" ? id : null;
 }
 const conversationController = ({ strapi }) => ({
   async find(ctx) {
-    const adminUserId = getAdminUserId$2(ctx);
+    const adminUserId = getAdminUserId$3(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
-    const conversations = await strapi.documents(CONTENT_TYPE$3).findMany({
+    const conversations = await strapi.documents(CONTENT_TYPE$4).findMany({
       filters: { adminUserId },
       fields: ["title", "createdAt", "updatedAt"],
       sort: { updatedAt: "desc" }
@@ -1937,14 +2188,14 @@ const conversationController = ({ strapi }) => ({
     ctx.body = { data: conversations };
   },
   async findOne(ctx) {
-    const adminUserId = getAdminUserId$2(ctx);
+    const adminUserId = getAdminUserId$3(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const { id } = ctx.params;
-    const conversation2 = await strapi.documents(CONTENT_TYPE$3).findOne({
+    const conversation2 = await strapi.documents(CONTENT_TYPE$4).findOne({
       documentId: id
     });
     if (!conversation2 || conversation2.adminUserId !== adminUserId) {
@@ -1955,14 +2206,14 @@ const conversationController = ({ strapi }) => ({
     ctx.body = { data: conversation2 };
   },
   async create(ctx) {
-    const adminUserId = getAdminUserId$2(ctx);
+    const adminUserId = getAdminUserId$3(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const { title, messages } = ctx.request.body;
-    const conversation2 = await strapi.documents(CONTENT_TYPE$3).create({
+    const conversation2 = await strapi.documents(CONTENT_TYPE$4).create({
       data: {
         title: title || "New conversation",
         messages: messages || [],
@@ -1973,14 +2224,14 @@ const conversationController = ({ strapi }) => ({
     ctx.body = { data: conversation2 };
   },
   async update(ctx) {
-    const adminUserId = getAdminUserId$2(ctx);
+    const adminUserId = getAdminUserId$3(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const { id } = ctx.params;
-    const existing = await strapi.documents(CONTENT_TYPE$3).findOne({
+    const existing = await strapi.documents(CONTENT_TYPE$4).findOne({
       documentId: id
     });
     if (!existing || existing.adminUserId !== adminUserId) {
@@ -1992,21 +2243,21 @@ const conversationController = ({ strapi }) => ({
     const data = {};
     if (title !== void 0) data.title = title;
     if (messages !== void 0) data.messages = messages;
-    const conversation2 = await strapi.documents(CONTENT_TYPE$3).update({
+    const conversation2 = await strapi.documents(CONTENT_TYPE$4).update({
       documentId: id,
       data
     });
     ctx.body = { data: conversation2 };
   },
   async delete(ctx) {
-    const adminUserId = getAdminUserId$2(ctx);
+    const adminUserId = getAdminUserId$3(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const { id } = ctx.params;
-    const existing = await strapi.documents(CONTENT_TYPE$3).findOne({
+    const existing = await strapi.documents(CONTENT_TYPE$4).findOne({
       documentId: id
     });
     if (!existing || existing.adminUserId !== adminUserId) {
@@ -2014,25 +2265,25 @@ const conversationController = ({ strapi }) => ({
       ctx.body = { error: "Conversation not found" };
       return;
     }
-    await strapi.documents(CONTENT_TYPE$3).delete({ documentId: id });
+    await strapi.documents(CONTENT_TYPE$4).delete({ documentId: id });
     ctx.status = 200;
     ctx.body = { data: { documentId: id } };
   }
 });
-const CONTENT_TYPE$2 = "plugin::ai-sdk.memory";
-function getAdminUserId$1(ctx) {
+const CONTENT_TYPE$3 = "plugin::ai-sdk.memory";
+function getAdminUserId$2(ctx) {
   const id = ctx.state?.user?.id;
   return typeof id === "number" ? id : null;
 }
 const memoryController = ({ strapi }) => ({
   async find(ctx) {
-    const adminUserId = getAdminUserId$1(ctx);
+    const adminUserId = getAdminUserId$2(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
-    const memories = await strapi.documents(CONTENT_TYPE$2).findMany({
+    const memories = await strapi.documents(CONTENT_TYPE$3).findMany({
       filters: { adminUserId },
       fields: ["content", "category", "createdAt"],
       sort: { createdAt: "desc" }
@@ -2040,7 +2291,7 @@ const memoryController = ({ strapi }) => ({
     ctx.body = { data: memories };
   },
   async create(ctx) {
-    const adminUserId = getAdminUserId$1(ctx);
+    const adminUserId = getAdminUserId$2(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
@@ -2052,7 +2303,7 @@ const memoryController = ({ strapi }) => ({
       ctx.body = { error: "content is required" };
       return;
     }
-    const memory2 = await strapi.documents(CONTENT_TYPE$2).create({
+    const memory2 = await strapi.documents(CONTENT_TYPE$3).create({
       data: {
         content,
         category: category || "general",
@@ -2063,14 +2314,14 @@ const memoryController = ({ strapi }) => ({
     ctx.body = { data: memory2 };
   },
   async update(ctx) {
-    const adminUserId = getAdminUserId$1(ctx);
+    const adminUserId = getAdminUserId$2(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const { id } = ctx.params;
-    const existing = await strapi.documents(CONTENT_TYPE$2).findOne({
+    const existing = await strapi.documents(CONTENT_TYPE$3).findOne({
       documentId: id
     });
     if (!existing || existing.adminUserId !== adminUserId) {
@@ -2082,21 +2333,21 @@ const memoryController = ({ strapi }) => ({
     const data = {};
     if (content !== void 0) data.content = content;
     if (category !== void 0) data.category = category;
-    const memory2 = await strapi.documents(CONTENT_TYPE$2).update({
+    const memory2 = await strapi.documents(CONTENT_TYPE$3).update({
       documentId: id,
       data
     });
     ctx.body = { data: memory2 };
   },
   async delete(ctx) {
-    const adminUserId = getAdminUserId$1(ctx);
+    const adminUserId = getAdminUserId$2(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const { id } = ctx.params;
-    const existing = await strapi.documents(CONTENT_TYPE$2).findOne({
+    const existing = await strapi.documents(CONTENT_TYPE$3).findOne({
       documentId: id
     });
     if (!existing || existing.adminUserId !== adminUserId) {
@@ -2104,15 +2355,15 @@ const memoryController = ({ strapi }) => ({
       ctx.body = { error: "Memory not found" };
       return;
     }
-    await strapi.documents(CONTENT_TYPE$2).delete({ documentId: id });
+    await strapi.documents(CONTENT_TYPE$3).delete({ documentId: id });
     ctx.status = 200;
     ctx.body = { data: { documentId: id } };
   }
 });
-const CONTENT_TYPE$1 = "plugin::ai-sdk.public-memory";
+const CONTENT_TYPE$2 = "plugin::ai-sdk.public-memory";
 const publicMemoryController = ({ strapi }) => ({
   async find(ctx) {
-    const memories = await strapi.documents(CONTENT_TYPE$1).findMany({
+    const memories = await strapi.documents(CONTENT_TYPE$2).findMany({
       fields: ["content", "category", "createdAt"],
       sort: { createdAt: "desc" }
     });
@@ -2125,7 +2376,7 @@ const publicMemoryController = ({ strapi }) => ({
       ctx.body = { error: "content is required" };
       return;
     }
-    const memory2 = await strapi.documents(CONTENT_TYPE$1).create({
+    const memory2 = await strapi.documents(CONTENT_TYPE$2).create({
       data: { content, category: category || "general" }
     });
     ctx.status = 201;
@@ -2133,7 +2384,7 @@ const publicMemoryController = ({ strapi }) => ({
   },
   async update(ctx) {
     const { id } = ctx.params;
-    const existing = await strapi.documents(CONTENT_TYPE$1).findOne({ documentId: id });
+    const existing = await strapi.documents(CONTENT_TYPE$2).findOne({ documentId: id });
     if (!existing) {
       ctx.status = 404;
       ctx.body = { error: "Public memory not found" };
@@ -2143,7 +2394,7 @@ const publicMemoryController = ({ strapi }) => ({
     const data = {};
     if (content !== void 0) data.content = content;
     if (category !== void 0) data.category = category;
-    const memory2 = await strapi.documents(CONTENT_TYPE$1).update({
+    const memory2 = await strapi.documents(CONTENT_TYPE$2).update({
       documentId: id,
       data
     });
@@ -2151,45 +2402,45 @@ const publicMemoryController = ({ strapi }) => ({
   },
   async delete(ctx) {
     const { id } = ctx.params;
-    const existing = await strapi.documents(CONTENT_TYPE$1).findOne({ documentId: id });
+    const existing = await strapi.documents(CONTENT_TYPE$2).findOne({ documentId: id });
     if (!existing) {
       ctx.status = 404;
       ctx.body = { error: "Public memory not found" };
       return;
     }
-    await strapi.documents(CONTENT_TYPE$1).delete({ documentId: id });
+    await strapi.documents(CONTENT_TYPE$2).delete({ documentId: id });
     ctx.status = 200;
     ctx.body = { data: { documentId: id } };
   }
 });
-const CONTENT_TYPE = "plugin::ai-sdk.task";
-function getAdminUserId(ctx) {
+const CONTENT_TYPE$1 = "plugin::ai-sdk.task";
+function getAdminUserId$1(ctx) {
   const id = ctx.state?.user?.id;
   return typeof id === "number" ? id : null;
 }
 const taskController = ({ strapi }) => ({
   async find(ctx) {
-    const adminUserId = getAdminUserId(ctx);
+    const adminUserId = getAdminUserId$1(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
-    const tasks = await strapi.documents(CONTENT_TYPE).findMany({
+    const tasks = await strapi.documents(CONTENT_TYPE$1).findMany({
       filters: { adminUserId },
       sort: { createdAt: "desc" }
     });
     ctx.body = { data: tasks };
   },
   async create(ctx) {
-    const adminUserId = getAdminUserId(ctx);
+    const adminUserId = getAdminUserId$1(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const body = ctx.request.body;
-    const task2 = await strapi.documents(CONTENT_TYPE).create({
+    const task2 = await strapi.documents(CONTENT_TYPE$1).create({
       data: {
         title: body.title,
         description: body.description,
@@ -2206,14 +2457,14 @@ const taskController = ({ strapi }) => ({
     ctx.body = { data: task2 };
   },
   async update(ctx) {
-    const adminUserId = getAdminUserId(ctx);
+    const adminUserId = getAdminUserId$1(ctx);
     if (!adminUserId) {
       ctx.status = 401;
       ctx.body = { error: "Unauthorized" };
       return;
     }
     const { id } = ctx.params;
-    const existing = await strapi.documents(CONTENT_TYPE).findOne({
+    const existing = await strapi.documents(CONTENT_TYPE$1).findOne({
       documentId: id
     });
     if (!existing || existing.adminUserId !== adminUserId) {
@@ -2226,13 +2477,80 @@ const taskController = ({ strapi }) => ({
     for (const key of ["title", "description", "content", "done", "priority", "consequence", "impact", "dueDate"]) {
       if (body[key] !== void 0) data[key] = body[key];
     }
-    const task2 = await strapi.documents(CONTENT_TYPE).update({
+    const task2 = await strapi.documents(CONTENT_TYPE$1).update({
       documentId: id,
       data
     });
     ctx.body = { data: task2 };
   },
   async delete(ctx) {
+    const adminUserId = getAdminUserId$1(ctx);
+    if (!adminUserId) {
+      ctx.status = 401;
+      ctx.body = { error: "Unauthorized" };
+      return;
+    }
+    const { id } = ctx.params;
+    const existing = await strapi.documents(CONTENT_TYPE$1).findOne({
+      documentId: id
+    });
+    if (!existing || existing.adminUserId !== adminUserId) {
+      ctx.status = 404;
+      ctx.body = { error: "Task not found" };
+      return;
+    }
+    await strapi.documents(CONTENT_TYPE$1).delete({ documentId: id });
+    ctx.status = 200;
+    ctx.body = { data: { documentId: id } };
+  }
+});
+const CONTENT_TYPE = "plugin::ai-sdk.note";
+function getAdminUserId(ctx) {
+  const id = ctx.state?.user?.id;
+  return typeof id === "number" ? id : null;
+}
+const noteController = ({ strapi }) => ({
+  async find(ctx) {
+    const adminUserId = getAdminUserId(ctx);
+    if (!adminUserId) {
+      ctx.status = 401;
+      ctx.body = { error: "Unauthorized" };
+      return;
+    }
+    const notes = await strapi.documents(CONTENT_TYPE).findMany({
+      filters: { adminUserId },
+      fields: ["title", "content", "category", "tags", "source", "createdAt"],
+      sort: { createdAt: "desc" }
+    });
+    ctx.body = { data: notes };
+  },
+  async create(ctx) {
+    const adminUserId = getAdminUserId(ctx);
+    if (!adminUserId) {
+      ctx.status = 401;
+      ctx.body = { error: "Unauthorized" };
+      return;
+    }
+    const { title, content, category, tags, source } = ctx.request.body;
+    if (!content || typeof content !== "string") {
+      ctx.status = 400;
+      ctx.body = { error: "content is required" };
+      return;
+    }
+    const note2 = await strapi.documents(CONTENT_TYPE).create({
+      data: {
+        title: title || "",
+        content,
+        category: category || "research",
+        tags: tags || "",
+        source: source || "",
+        adminUserId
+      }
+    });
+    ctx.status = 201;
+    ctx.body = { data: note2 };
+  },
+  async update(ctx) {
     const adminUserId = getAdminUserId(ctx);
     if (!adminUserId) {
       ctx.status = 401;
@@ -2245,12 +2563,58 @@ const taskController = ({ strapi }) => ({
     });
     if (!existing || existing.adminUserId !== adminUserId) {
       ctx.status = 404;
-      ctx.body = { error: "Task not found" };
+      ctx.body = { error: "Note not found" };
+      return;
+    }
+    const { title, content, category, tags, source } = ctx.request.body;
+    const data = {};
+    if (title !== void 0) data.title = title;
+    if (content !== void 0) data.content = content;
+    if (category !== void 0) data.category = category;
+    if (tags !== void 0) data.tags = tags;
+    if (source !== void 0) data.source = source;
+    const note2 = await strapi.documents(CONTENT_TYPE).update({
+      documentId: id,
+      data
+    });
+    ctx.body = { data: note2 };
+  },
+  async delete(ctx) {
+    const adminUserId = getAdminUserId(ctx);
+    if (!adminUserId) {
+      ctx.status = 401;
+      ctx.body = { error: "Unauthorized" };
+      return;
+    }
+    const { id } = ctx.params;
+    const existing = await strapi.documents(CONTENT_TYPE).findOne({
+      documentId: id
+    });
+    if (!existing || existing.adminUserId !== adminUserId) {
+      ctx.status = 404;
+      ctx.body = { error: "Note not found" };
       return;
     }
     await strapi.documents(CONTENT_TYPE).delete({ documentId: id });
     ctx.status = 200;
     ctx.body = { data: { documentId: id } };
+  },
+  async clearAll(ctx) {
+    const adminUserId = getAdminUserId(ctx);
+    if (!adminUserId) {
+      ctx.status = 401;
+      ctx.body = { error: "Unauthorized" };
+      return;
+    }
+    const notes = await strapi.documents(CONTENT_TYPE).findMany({
+      filters: { adminUserId },
+      fields: ["documentId"]
+    });
+    for (const note2 of notes) {
+      await strapi.documents(CONTENT_TYPE).delete({ documentId: note2.documentId });
+    }
+    ctx.status = 200;
+    ctx.body = { data: { deleted: notes.length } };
   }
 });
 const controllers = {
@@ -2259,7 +2623,8 @@ const controllers = {
   conversation: conversationController,
   memory: memoryController,
   "public-memory": publicMemoryController,
-  task: taskController
+  task: taskController,
+  note: noteController
 };
 const promptInjection = [
   "ignore (all |any )?(previous|prior|above) (instructions|prompts|rules)",
@@ -2629,6 +2994,36 @@ const adminAPIRoutes = {
       path: "/tasks/:id",
       handler: "task.delete",
       config: { policies: [] }
+    },
+    {
+      method: "GET",
+      path: "/notes",
+      handler: "note.find",
+      config: { policies: [] }
+    },
+    {
+      method: "POST",
+      path: "/notes",
+      handler: "note.create",
+      config: { policies: [] }
+    },
+    {
+      method: "PUT",
+      path: "/notes/:id",
+      handler: "note.update",
+      config: { policies: [] }
+    },
+    {
+      method: "DELETE",
+      path: "/notes/clear",
+      handler: "note.clearAll",
+      config: { policies: [] }
+    },
+    {
+      method: "DELETE",
+      path: "/notes/:id",
+      handler: "note.delete",
+      config: { policies: [] }
     }
   ]
 };
@@ -2716,6 +3111,26 @@ function describeTools(tools) {
   return `Available tools:
 ${lines.join("\n")}`;
 }
+function trimMessages(messages, max) {
+  if (messages.length <= max) return messages;
+  const sliced = messages.slice(-max);
+  while (sliced.length > 0 && hasOrphanedToolCalls(sliced[0])) {
+    sliced.shift();
+  }
+  return sliced;
+}
+function hasOrphanedToolCalls(message) {
+  if (message.role !== "assistant") return false;
+  if (message.parts) {
+    return message.parts.some(
+      (part) => part.type === "tool-invocation"
+    );
+  }
+  if (message.toolInvocations?.length) {
+    return true;
+  }
+  return false;
+}
 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.
 
 For 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.
@@ -2779,7 +3194,7 @@ const service = ({ strapi }) => {
       const maxMessages = config2?.maxConversationMessages ?? DEFAULT_MAX_CONVERSATION_MESSAGES;
       const maxOutputTokens = config2?.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS;
       const maxSteps = config2?.maxSteps ?? DEFAULT_MAX_STEPS;
-      const trimmedMessages = messages.length > maxMessages ? messages.slice(-maxMessages) : messages;
+      const trimmedMessages = trimMessages(messages, maxMessages);
       const modelMessages = await convertToModelMessages(trimmedMessages);
       const tools = createTools(strapi, { adminUserId: options2?.adminUserId, enabledToolSources: options2?.enabledToolSources });
       const toolsDescription = describeTools(tools);
@@ -2824,7 +3239,7 @@ ${lines.join("\n")}`;
       const publicModel = publicConfig?.chatModel ?? DEFAULT_PUBLIC_CHAT_MODEL;
       const allowedContentTypes = publicConfig?.allowedContentTypes ?? [];
       const publicToolSources = publicConfig?.publicToolSources;
-      const trimmedMessages = messages.length > maxMessages ? messages.slice(-maxMessages) : messages;
+      const trimmedMessages = trimMessages(messages, maxMessages);
       const modelMessages = await convertToModelMessages(trimmedMessages);
       const tools = createPublicTools(strapi, allowedContentTypes, publicToolSources);
       const toolsDescription = describeTools(tools);