strapi-content-embeddings 0.2.0 → 0.2.2

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/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.2",
   "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",
@@ -26,7 +26,7 @@
   },
   "type": "commonjs",
   "overrides": {
-    "@langchain/core": "1.1.9"
+    "@langchain/core": "^1.1.31"
   },
   "exports": {
     "./package.json": "./package.json",
@@ -59,7 +59,7 @@
   },
   "dependencies": {
     "@langchain/community": "^1.1.2",
-    "@langchain/core": "1.1.9",
+    "@langchain/core": "^1.1.31",
     "@langchain/openai": "^1.2.1",
     "@mdxeditor/editor": "^3.52.3",
     "@modelcontextprotocol/sdk": "^1.12.0",