strapi-content-embeddings 0.2.0 → 0.2.1

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

@@ -133,6 +133,11 @@ declare const _default: {
             }>;
             recreateAllEmbeddings(): Promise<import("./services/sync").RecreateResult>;
         };
+        'ai-tools': ({ strapi }: {
+            strapi: import("@strapi/types/dist/core").Strapi;
+        }) => {
+            getTools(): import("./tools").ToolDefinition[];
+        };
     };
     contentTypes: {
         embedding: {

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

@@ -49,14 +49,17 @@ export declare const CreateEmbeddingSchema: z.ZodObject<{
     title: z.ZodString;
     content: z.ZodString;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    autoChunk: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     metadata?: Record<string, any>;
     content?: string;
     title?: string;
+    autoChunk?: boolean;
 }, {
     metadata?: Record<string, any>;
     content?: string;
     title?: string;
+    autoChunk?: boolean;
 }>;
 export declare const ToolSchemas: Record<string, z.ZodSchema>;
 /**

package/dist/server/src/mcp/tools/create-embedding.d.ts

@@ -1,11 +1,10 @@
 /**
- * Create Embedding Tool
+ * Create Embedding Tool — MCP Wrapper
  *
- * Creates a new embedding from text content.
- * Supports automatic chunking for large content.
+ * Thin MCP adapter that delegates to the canonical tool implementation.
  */
 import type { Core } from '@strapi/strapi';
-export declare const createEmbeddingTool: {
+export declare const createEmbeddingMcpTool: {
     name: string;
     description: string;
     inputSchema: {

package/dist/server/src/mcp/tools/get-embedding.d.ts

@@ -1,10 +1,10 @@
 /**
- * Get Embedding Tool
+ * Get Embedding Tool — MCP Wrapper
  *
- * Retrieves a single embedding by ID.
+ * Thin MCP adapter that delegates to the canonical tool implementation.
  */
 import type { Core } from '@strapi/strapi';
-export declare const getEmbeddingTool: {
+export declare const getEmbeddingMcpTool: {
     name: string;
     description: string;
     inputSchema: {

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

@@ -2,6 +2,7 @@
  * MCP Tools for Content Embeddings
  *
  * Exposes vector search, RAG queries, and embedding management tools.
+ * Each handler is a thin wrapper around canonical tool definitions in ../../tools.
  */
 import type { Core } from '@strapi/strapi';
 export declare const tools: ({

package/dist/server/src/mcp/tools/list-embeddings.d.ts

@@ -1,10 +1,10 @@
 /**
- * List Embeddings Tool
+ * List Embeddings Tool — MCP Wrapper
  *
- * Lists all embeddings stored in the database.
+ * Thin MCP adapter that delegates to the canonical tool implementation.
  */
 import type { Core } from '@strapi/strapi';
-export declare const listEmbeddingsTool: {
+export declare const listEmbeddingsMcpTool: {
     name: string;
     description: string;
     inputSchema: {

package/dist/server/src/mcp/tools/rag-query.d.ts

@@ -1,10 +1,10 @@
 /**
- * RAG Query Tool
+ * RAG Query Tool — MCP Wrapper
  *
- * Performs Retrieval-Augmented Generation to answer questions using embedded content.
+ * Thin MCP adapter that delegates to the canonical tool implementation.
  */
 import type { Core } from '@strapi/strapi';
-export declare const ragQueryTool: {
+export declare const ragQueryMcpTool: {
     name: string;
     description: string;
     inputSchema: {

package/dist/server/src/mcp/tools/semantic-search.d.ts

@@ -1,10 +1,10 @@
 /**
- * Semantic Search Tool
+ * Semantic Search Tool — MCP Wrapper
  *
- * Performs vector similarity search to find relevant content.
+ * Thin MCP adapter that delegates to the canonical tool implementation.
  */
 import type { Core } from '@strapi/strapi';
-export declare const semanticSearchTool: {
+export declare const semanticSearchMcpTool: {
     name: string;
     description: string;
     inputSchema: {

package/dist/server/src/services/ai-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AI Tools Service — Adapter for AI SDK Discovery
+ *
+ * Re-exports canonical tool definitions from ../tools for AI SDK registration.
+ * The AI SDK discovery loop calls getTools() to register these into its ToolRegistry.
+ */
+import type { Core } from '@strapi/strapi';
+declare const _default: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => {
+    getTools(): import("../tools").ToolDefinition[];
+};
+export default _default;

package/dist/server/src/services/embeddings.d.ts

@@ -64,8 +64,8 @@ declare const embeddings: ({ strapi }: {
      */
     deleteRelatedChunks(documentId: string): Promise<number>;
     /**
-     * Update a single chunk's content and embedding
-     * Updates only the specified chunk without affecting other chunks in the group
+     * Update embeddings with automatic chunking support
+     * Handles re-chunking when content changes and exceeds chunk size
      */
     updateChunkedEmbedding(id: string, data: UpdateEmbeddingData): Promise<ChunkedEmbeddingResult>;
     updateEmbedding(id: string, data: UpdateEmbeddingData): Promise<any>;

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

@@ -44,5 +44,10 @@ declare const _default: {
         }>;
         recreateAllEmbeddings(): Promise<import("./sync").RecreateResult>;
     };
+    'ai-tools': ({ strapi }: {
+        strapi: import("@strapi/types/dist/core").Strapi;
+    }) => {
+        getTools(): import("../tools").ToolDefinition[];
+    };
 };
 export default _default;

package/dist/server/src/tools/create-embedding.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Create Embedding — Canonical Tool Definition
+ *
+ * Creates a new embedding from text content.
+ * Supports automatic chunking for large content.
+ * Returns raw result objects (no MCP envelope).
+ */
+import type { ToolDefinition } from './types';
+export declare const createEmbeddingTool: ToolDefinition;

package/dist/server/src/tools/get-embedding.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get Embedding — Canonical Tool Definition
+ *
+ * Retrieves a single embedding by document ID.
+ * Returns raw result objects (no MCP envelope).
+ */
+import type { ToolDefinition } from './types';
+export declare const getEmbeddingTool: ToolDefinition;

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

@@ -0,0 +1,14 @@
+/**
+ * Canonical Tool Definitions for Content Embeddings
+ *
+ * These are the source-of-truth implementations.
+ * Both the AI SDK service (ai-tools.ts) and the MCP server consume these.
+ */
+export type { ToolDefinition } from './types';
+export { semanticSearchTool } from './semantic-search';
+export { ragQueryTool } from './rag-query';
+export { listEmbeddingsTool } from './list-embeddings';
+export { getEmbeddingTool } from './get-embedding';
+export { createEmbeddingTool } from './create-embedding';
+import type { ToolDefinition } from './types';
+export declare const tools: ToolDefinition[];

package/dist/server/src/tools/list-embeddings.d.ts

@@ -0,0 +1,8 @@
+/**
+ * List Embeddings — Canonical Tool Definition
+ *
+ * Lists all embeddings stored in the database with pagination.
+ * Returns raw result objects (no MCP envelope).
+ */
+import type { ToolDefinition } from './types';
+export declare const listEmbeddingsTool: ToolDefinition;

package/dist/server/src/tools/rag-query.d.ts

@@ -0,0 +1,8 @@
+/**
+ * RAG Query — Canonical Tool Definition
+ *
+ * Performs Retrieval-Augmented Generation to answer questions using embedded content.
+ * Returns raw result objects (no MCP envelope).
+ */
+import type { ToolDefinition } from './types';
+export declare const ragQueryTool: ToolDefinition;

package/dist/server/src/tools/semantic-search.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Semantic Search — Canonical Tool Definition
+ *
+ * Performs vector similarity search to find relevant content.
+ * Returns raw result objects (no MCP envelope).
+ */
+import type { ToolDefinition } from './types';
+export declare const semanticSearchTool: ToolDefinition;

package/dist/server/src/tools/types.d.ts

@@ -0,0 +1,14 @@
+import type { Core } from '@strapi/strapi';
+import type { z } from 'zod';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    schema: z.ZodObject<any>;
+    execute: (args: any, strapi: Core.Strapi, context?: {
+        adminUserId?: number;
+    }) => Promise<unknown>;
+    /** If true, tool is only available in AI SDK chat, not exposed via MCP */
+    internal?: boolean;
+    /** If true, tool is safe for unauthenticated public chat (read-only) */
+    publicSafe?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-content-embeddings",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Strapi v5 plugin for vector embeddings with OpenAI and Neon PostgreSQL. Enables semantic search, RAG chat, and MCP (Model Context Protocol) integration.",
   "keywords": [
     "strapi",