strapi-plugin-ai-sdk 0.7.7 → 0.8.0

package/dist/server/src/content-types/index.d.ts

@@ -168,5 +168,51 @@ declare const _default: {
             };
         };
     };
+    note: {
+        schema: {
+            kind: string;
+            collectionName: string;
+            info: {
+                singularName: string;
+                pluralName: string;
+                displayName: string;
+            };
+            options: {
+                draftAndPublish: boolean;
+            };
+            pluginOptions: {
+                "content-manager": {
+                    visible: boolean;
+                };
+                "content-type-builder": {
+                    visible: boolean;
+                };
+            };
+            attributes: {
+                title: {
+                    type: string;
+                };
+                content: {
+                    type: string;
+                    required: boolean;
+                };
+                category: {
+                    type: string;
+                    enum: string[];
+                    default: string;
+                };
+                tags: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                };
+                adminUserId: {
+                    type: string;
+                    required: boolean;
+                };
+            };
+        };
+    };
 };
 export default _default;

package/dist/server/src/content-types/note/index.d.ts

@@ -0,0 +1,47 @@
+declare const _default: {
+    schema: {
+        kind: string;
+        collectionName: string;
+        info: {
+            singularName: string;
+            pluralName: string;
+            displayName: string;
+        };
+        options: {
+            draftAndPublish: boolean;
+        };
+        pluginOptions: {
+            "content-manager": {
+                visible: boolean;
+            };
+            "content-type-builder": {
+                visible: boolean;
+            };
+        };
+        attributes: {
+            title: {
+                type: string;
+            };
+            content: {
+                type: string;
+                required: boolean;
+            };
+            category: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            tags: {
+                type: string;
+            };
+            source: {
+                type: string;
+            };
+            adminUserId: {
+                type: string;
+                required: boolean;
+            };
+        };
+    };
+};
+export default _default;

package/dist/server/src/controllers/index.d.ts

@@ -48,5 +48,14 @@ declare const _default: {
         update(ctx: import("koa").Context): Promise<void>;
         delete(ctx: import("koa").Context): Promise<void>;
     };
+    note: ({ strapi }: {
+        strapi: import("@strapi/types/dist/core").Strapi;
+    }) => {
+        find(ctx: import("koa").Context): Promise<void>;
+        create(ctx: import("koa").Context): Promise<void>;
+        update(ctx: import("koa").Context): Promise<void>;
+        delete(ctx: import("koa").Context): Promise<void>;
+        clearAll(ctx: import("koa").Context): Promise<void>;
+    };
 };
 export default _default;

package/dist/server/src/controllers/note.d.ts

@@ -0,0 +1,12 @@
+import type { Core } from '@strapi/strapi';
+import type { Context } from 'koa';
+declare const noteController: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => {
+    find(ctx: Context): Promise<void>;
+    create(ctx: Context): Promise<void>;
+    update(ctx: Context): Promise<void>;
+    delete(ctx: Context): Promise<void>;
+    clearAll(ctx: Context): Promise<void>;
+};
+export default noteController;

package/dist/server/src/index.d.ts

@@ -86,6 +86,15 @@ declare const _default: {
             update(ctx: import("koa").Context): Promise<void>;
             delete(ctx: import("koa").Context): Promise<void>;
         };
+        note: ({ strapi }: {
+            strapi: import("@strapi/types/dist/core").Strapi;
+        }) => {
+            find(ctx: import("koa").Context): Promise<void>;
+            create(ctx: import("koa").Context): Promise<void>;
+            update(ctx: import("koa").Context): Promise<void>;
+            delete(ctx: import("koa").Context): Promise<void>;
+            clearAll(ctx: import("koa").Context): Promise<void>;
+        };
     };
     routes: {
         'content-api': {
@@ -323,6 +332,52 @@ declare const _default: {
                 };
             };
         };
+        note: {
+            schema: {
+                kind: string;
+                collectionName: string;
+                info: {
+                    singularName: string;
+                    pluralName: string;
+                    displayName: string;
+                };
+                options: {
+                    draftAndPublish: boolean;
+                };
+                pluginOptions: {
+                    "content-manager": {
+                        visible: boolean;
+                    };
+                    "content-type-builder": {
+                        visible: boolean;
+                    };
+                };
+                attributes: {
+                    title: {
+                        type: string;
+                    };
+                    content: {
+                        type: string;
+                        required: boolean;
+                    };
+                    category: {
+                        type: string;
+                        enum: string[];
+                        default: string;
+                    };
+                    tags: {
+                        type: string;
+                    };
+                    source: {
+                        type: string;
+                    };
+                    adminUserId: {
+                        type: string;
+                        required: boolean;
+                    };
+                };
+            };
+        };
     };
     policies: {};
     middlewares: {

package/dist/server/src/lib/trim-messages.d.ts

@@ -0,0 +1,11 @@
+import type { UIMessage } from 'ai';
+/**
+ * Trim messages to a max count while keeping tool call/result pairs intact.
+ *
+ * When slicing from the end, the first remaining message might be an assistant
+ * message with tool invocations whose results lived in earlier (now-dropped)
+ * messages. The AI SDK throws MissingToolResultsError if it encounters an
+ * unmatched tool call. This function drops leading assistant messages that
+ * contain tool invocations to prevent that.
+ */
+export declare function trimMessages(messages: UIMessage[], max: number): UIMessage[];

package/dist/server/src/mcp/resources/tool-guide.d.ts

@@ -0,0 +1,5 @@
+import type { ToolRegistry } from '../../lib/tool-registry';
+/**
+ * Generate the complete tool guide markdown from the registry.
+ */
+export declare function generateToolGuide(registry: ToolRegistry): string;

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

@@ -23,7 +23,7 @@ export declare const aggregateContentSchema: z.ZodObject<{
     }>>;
     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 declare 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.";
 export interface AggregateContentParams {
     contentType: string;
     operation: 'count' | 'countByField' | 'countByDateRange';

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

@@ -9,7 +9,7 @@ export declare const createContentSchema: z.ZodObject<{
     }>>;
     locale: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare 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.";
+export declare 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.";
 export interface CreateContentParams {
     contentType: string;
     data: Record<string, unknown>;

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

@@ -11,7 +11,7 @@ export declare const findOneContentSchema: z.ZodObject<{
     }>>;
     locale: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare 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.";
+export declare 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.";
 export interface FindOneContentParams {
     contentType: string;
     documentId: string;

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

@@ -22,5 +22,9 @@ export { aggregateContent, aggregateContentSchema, aggregateContentDescription }
 export type { AggregateContentParams, AggregateContentResult } from './aggregate-content';
 export { manageTask, manageTaskSchema, manageTaskDescription } from './manage-task';
 export type { ManageTaskParams, ManageTaskResult } from './manage-task';
+export { saveNote, saveNoteSchema, saveNoteDescription } from './save-note';
+export type { SaveNoteParams, SaveNoteResult } from './save-note';
+export { recallNotes, recallNotesSchema, recallNotesDescription } from './recall-notes';
+export type { RecallNotesParams, RecallNotesResult } from './recall-notes';
 export { resolveFieldPath, getDisplayField, isRelation, getRelationTarget, getSchema } from './schema-utils';
 export type { ResolvedField } from './schema-utils';

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

@@ -1,7 +1,7 @@
 import type { Core } from '@strapi/strapi';
 import { z } from 'zod';
 export declare const listContentTypesSchema: z.ZodObject<{}, z.core.$strip>;
-export declare const listContentTypesDescription = "List all Strapi content types and components with their fields, relations, and structure.";
+export declare const listContentTypesDescription = "List all Strapi content types and components with their fields, relations, and structure. This is the starting point for any content operation \u2014 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.";
 export interface RelationSummary {
     field: string;
     type: string;

package/dist/server/src/tool-logic/manage-task.d.ts

@@ -25,7 +25,7 @@ export declare const manageTaskSchema: z.ZodObject<{
     done: z.ZodOptional<z.ZodBoolean>;
     filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-export declare const manageTaskDescription = "Manage the user's task list. Create, update, complete, list, or summarize tasks. Tasks are scored by consequence \u00D7 impact to help prioritize what matters most.";
+export declare 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 \u00D7 impact to prioritize what matters most. For create: title is required; consequence and impact are collected via UI form if omitted.";
 export type ManageTaskParams = z.infer<typeof manageTaskSchema>;
 export interface ManageTaskResult {
     success: boolean;

package/dist/server/src/tool-logic/recall-notes.d.ts

@@ -0,0 +1,22 @@
+import type { Core } from '@strapi/strapi';
+import { z } from 'zod';
+import type { ToolContext } from '../lib/tool-registry';
+export declare const recallNotesSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const recallNotesDescription = "Recall saved research notes, snippets, ideas, and references. Use this to look up previously saved notes. Without parameters, returns all notes.";
+export type RecallNotesParams = z.infer<typeof recallNotesSchema>;
+export interface RecallNotesResult {
+    success: boolean;
+    notes: {
+        title: string;
+        content: string;
+        category: string;
+        tags: string;
+        source: string;
+    }[];
+    count: number;
+}
+export declare function recallNotes(strapi: Core.Strapi, params: RecallNotesParams, context?: ToolContext): Promise<RecallNotesResult>;

package/dist/server/src/tool-logic/save-note.d.ts

@@ -0,0 +1,17 @@
+import type { Core } from '@strapi/strapi';
+import { z } from 'zod';
+import type { ToolContext } from '../lib/tool-registry';
+export declare const saveNoteSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare 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.";
+export type SaveNoteParams = z.infer<typeof saveNoteSchema>;
+export interface SaveNoteResult {
+    success: boolean;
+    message: string;
+}
+export declare function saveNote(strapi: Core.Strapi, params: SaveNoteParams, context?: ToolContext): Promise<SaveNoteResult>;

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

@@ -10,7 +10,7 @@ export declare const updateContentSchema: z.ZodObject<{
     }>>;
     locale: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare const updateContentDescription = "Update an existing document in any Strapi content type. Use searchContent to find the document ID first.";
+export declare const updateContentDescription = "Update an existing document in any Strapi content type. Requires contentType, documentId, and data (fields to change \u2014 only include fields you want to modify). Typical workflow: searchContent to find the documentId, then updateContent to modify it. Returns the updated document.";
 export interface UpdateContentParams {
     contentType: string;
     documentId: string;

package/dist/server/src/tool-logic/upload-media.d.ts

@@ -6,7 +6,7 @@ export declare const uploadMediaSchema: z.ZodObject<{
     caption: z.ZodOptional<z.ZodString>;
     alternativeText: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare 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.";
+export declare 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.";
 export interface UploadMediaParams {
     url: string;
     name?: string;

package/dist/server/src/tools/definitions/recall-notes.d.ts

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

package/dist/server/src/tools/definitions/save-note.d.ts

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

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.7.7",
+  "version": "0.8.0",
   "keywords": [
     "strapi",
     "strapi-plugin",