@5ss/ai-tools 2.11.1

package/dist/mastra-vector-Dhc6XZ8l.js

@@ -0,0 +1,234 @@
+import { t as ToolError } from "./errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "./define-CvpJ_pNP.js";
+import { n as requireAuth } from "./provider-CgDAlg6K.js";
+import { S as requireCollection, _ as parseMetadata, a as deleteVectorsOutputSchema, c as upsertVectorsInputSchema, g as mergeVectorFilter, i as deleteVectorsInputSchema, l as upsertVectorsOutputSchema, o as queryVectorsInputSchema, s as queryVectorsOutputSchema, u as vectorDefaultFilterSchema, w as stampDefaultFilterMetadata } from "./schemas-ChOAhdo9.js";
+import { isNumber, isPlainObject, isString } from "es-toolkit";
+import { z } from "zod";
+import { PgVector } from "@mastra/pg";
+//#region src/vendors/mastra-vector/contracts.ts
+/**
+* Mastra PgVector auth (`@mastra/pg`).
+* Host owns Postgres connection + schema; package does not invent org policy.
+*/
+const mastraVectorAuthSchema = z.object({
+	connection_string: z.string().min(1).describe("Postgres connection string for Mastra PgVector (e.g. Supabase DB URL)"),
+	id: z.string().min(1).describe("Mastra vector store id (stable string for this store instance)"),
+	schema_name: z.string().min(1).optional().describe("Postgres schema for vector tables (e.g. agent); omit for package default"),
+	default_index: z.string().min(1).optional().describe("Default index name when tool input omits collection"),
+	dimension: z.number().int().positive().optional().describe("Embedding dimension; required when auto_create_index is true"),
+	auto_create_index: z.boolean().optional().describe("When true, create the index on upsert if missing (needs dimension)"),
+	disable_init: z.boolean().optional().describe("Pass disableInit to PgVector (host manages migration/init)"),
+	default_filter: vectorDefaultFilterSchema.optional().describe("Host-bound metadata filter always applied on query (Mongo-style / Mastra PG filter); flat keys stamped on upsert")
+});
+//#endregion
+//#region src/vendors/mastra-vector/client.ts
+/**
+* Mastra PgVector vendor client (`@mastra/pg`).
+* Host: `new MastraVectorClient(auth)`. Agent tools: `fromContext(ctx)`.
+* Runtime: node (Postgres). Optional peer: `@mastra/pg`.
+*/
+/** Narrow a built arg bag to PgVector query params (Mongo-style filter is structural). */
+function isPgQueryArgs(value) {
+	return isPlainObject(value) && isString(value["indexName"]) && value["indexName"].length > 0 && Array.isArray(value["queryVector"]);
+}
+var MastraVectorClient = class MastraVectorClient {
+	#store;
+	#defaultIndex;
+	#defaultFilter;
+	#dimension;
+	#autoCreateIndex;
+	#ownsStore;
+	constructor(auth, options = {}) {
+		const parsed = mastraVectorAuthSchema.safeParse(auth);
+		if (!parsed.success) throw new ToolError("Invalid Mastra vector auth credentials", {
+			code: "bad_auth",
+			details: { issues: parsed.error.issues.map((issue) => issue.message) }
+		});
+		const data = parsed.data;
+		this.#defaultIndex = data.default_index;
+		this.#defaultFilter = data.default_filter;
+		this.#dimension = data.dimension;
+		this.#autoCreateIndex = data.auto_create_index === true;
+		if (options.store) {
+			this.#store = options.store;
+			this.#ownsStore = false;
+			return;
+		}
+		const config = {
+			connectionString: data.connection_string,
+			id: data.id
+		};
+		if (data.schema_name) config.schemaName = data.schema_name;
+		if (data.disable_init === true) config.disableInit = true;
+		const pg = new PgVector(config);
+		this.#store = {
+			upsert: (input) => pg.upsert({
+				indexName: input.indexName,
+				ids: input.ids,
+				vectors: input.vectors,
+				metadata: input.metadata
+			}),
+			query: (input) => {
+				const args = {
+					indexName: input.indexName,
+					queryVector: input.queryVector,
+					...input.topK !== void 0 && { topK: input.topK },
+					...input.includeVector !== void 0 && { includeVector: input.includeVector },
+					...input.filter !== void 0 && { filter: input.filter }
+				};
+				if (!isPgQueryArgs(args)) throw new ToolError("Invalid Mastra vector query args", { code: "internal" });
+				return pg.query(args);
+			},
+			deleteVectors: (input) => pg.deleteVectors({
+				indexName: input.indexName,
+				ids: input.ids
+			}),
+			createIndex: (input) => pg.createIndex({
+				indexName: input.indexName,
+				dimension: input.dimension
+			}),
+			disconnect: () => pg.disconnect()
+		};
+		this.#ownsStore = true;
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, mastraVectorAuthSchema);
+		return new MastraVectorClient(auth);
+	}
+	async upsert(input) {
+		const indexName = requireCollection(input.collection, this.#defaultIndex, "Mastra vector upsert");
+		await this.#ensureIndex(indexName, input.vectors[0]?.values.length);
+		await this.#store.upsert({
+			indexName,
+			ids: input.vectors.map((point) => point.id),
+			vectors: input.vectors.map((point) => point.values),
+			metadata: input.vectors.map((point) => stampDefaultFilterMetadata(point.metadata, this.#defaultFilter) ?? {})
+		});
+		return {
+			upserted: input.vectors.length,
+			collection: indexName
+		};
+	}
+	async query(input) {
+		const indexName = requireCollection(input.collection, this.#defaultIndex, "Mastra vector query");
+		const topK = input.top_k ?? 8;
+		const includeVector = input.include_values === true;
+		const filter = mergeVectorFilter(this.#defaultFilter, input.filter);
+		const rows = await this.#store.query({
+			indexName,
+			queryVector: input.vector,
+			topK,
+			includeVector,
+			...filter && { filter }
+		});
+		const includeMetadata = input.include_metadata !== false;
+		const matches = [];
+		for (const row of rows) {
+			if (!isString(row.id) || row.id.length === 0) continue;
+			const score = isNumber(row.score) ? row.score : 0;
+			const match = {
+				id: row.id,
+				score
+			};
+			if (includeMetadata && row.metadata !== void 0) {
+				const meta = parseMetadata(row.metadata);
+				if (meta) match.metadata = meta;
+			}
+			if (includeVector && Array.isArray(row.vector)) {
+				const values = row.vector.filter((n) => isNumber(n) && Number.isFinite(n));
+				if (values.length === row.vector.length) match.values = values;
+			}
+			matches.push(match);
+		}
+		return {
+			matches,
+			collection: indexName
+		};
+	}
+	async delete(input) {
+		const indexName = requireCollection(input.collection, this.#defaultIndex, "Mastra vector delete");
+		await this.#store.deleteVectors({
+			indexName,
+			ids: input.ids
+		});
+		return {
+			deleted: input.ids.length,
+			collection: indexName
+		};
+	}
+	async disconnect() {
+		if (this.#ownsStore && this.#store.disconnect) await this.#store.disconnect();
+	}
+	async #ensureIndex(indexName, inferredDimension) {
+		if (!this.#autoCreateIndex) return;
+		const dimension = this.#dimension ?? inferredDimension;
+		if (dimension === void 0) throw new ToolError("Mastra auto_create_index requires dimension on auth or non-empty vectors", { code: "bad_input" });
+		try {
+			await this.#store.createIndex({
+				indexName,
+				dimension
+			});
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			if (/already exists|duplicate|exist/i.test(message)) return;
+			throw new ToolError(`Mastra createIndex failed: ${message}`, {
+				code: "upstream",
+				cause: error
+			});
+		}
+	}
+};
+//#endregion
+//#region src/vendors/mastra-vector/module.ts
+const mastraVectorUpsertTool = defineTool({
+	id: "mastra-vector-upsert",
+	name: "mastraVectorUpsert",
+	description: "Upsert vectors into a Mastra PgVector index. collection maps to indexName.",
+	inputSchema: upsertVectorsInputSchema,
+	outputSchema: upsertVectorsOutputSchema,
+	sideEffect: "write",
+	runtime: "node",
+	execute: async (input, ctx) => MastraVectorClient.fromContext(ctx).upsert(input)
+});
+const mastraVectorQueryTool = defineTool({
+	id: "mastra-vector-query",
+	name: "mastraVectorQuery",
+	description: "Nearest-neighbor query against a Mastra PgVector index.",
+	inputSchema: queryVectorsInputSchema,
+	outputSchema: queryVectorsOutputSchema,
+	sideEffect: "read",
+	runtime: "node",
+	execute: async (input, ctx) => MastraVectorClient.fromContext(ctx).query(input)
+});
+const mastraVectorDeleteTool = defineTool({
+	id: "mastra-vector-delete",
+	name: "mastraVectorDelete",
+	description: "Delete vectors by id from a Mastra PgVector index.",
+	inputSchema: deleteVectorsInputSchema,
+	outputSchema: deleteVectorsOutputSchema,
+	sideEffect: "delete",
+	runtime: "node",
+	execute: async (input, ctx) => MastraVectorClient.fromContext(ctx).delete(input)
+});
+const mastraVectorModule = defineModule({
+	id: "mastra-vector",
+	title: "Mastra Vector",
+	description: "Mastra PgVector over Postgres: upsert, query, and delete vectors. Index names map from collection. Node runtime.",
+	runtime: "node",
+	auth: {
+		type: "custom",
+		schema: mastraVectorAuthSchema
+	},
+	categories: ["ai", "vector"],
+	classification: "pii",
+	tags: ["pgvector", "mastra"],
+	tools: [
+		mastraVectorUpsertTool,
+		mastraVectorQueryTool,
+		mastraVectorDeleteTool
+	]
+});
+//#endregion
+export { MastraVectorClient as a, mastraVectorUpsertTool as i, mastraVectorModule as n, mastraVectorAuthSchema as o, mastraVectorQueryTool as r, mastraVectorDeleteTool as t };
+
+//# sourceMappingURL=mastra-vector-Dhc6XZ8l.js.map

package/dist/mastra-vector-Dhc6XZ8l.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mastra-vector-Dhc6XZ8l.js","names":["#store","#defaultIndex","#defaultFilter","#dimension","#autoCreateIndex","#ownsStore","#ensureIndex"],"sources":["../src/vendors/mastra-vector/contracts.ts","../src/vendors/mastra-vector/client.ts","../src/vendors/mastra-vector/module.ts"],"sourcesContent":["import { z } from 'zod'\n\nimport { vectorDefaultFilterSchema } from '../_vector'\n\nexport {\n\tMAX_TOP_K,\n\tMAX_VECTOR_BATCH,\n\tMAX_VECTOR_DIMENSIONS,\n\tdeleteVectorsInputSchema,\n\tdeleteVectorsOutputSchema,\n\tqueryVectorsInputSchema,\n\tqueryVectorsOutputSchema,\n\tupsertVectorsInputSchema,\n\tupsertVectorsOutputSchema,\n\tvectorMatchSchema,\n\tvectorMetadataSchema,\n\tvectorPointSchema\n} from '../_vector'\nexport type {\n\tDeleteVectorsInput,\n\tDeleteVectorsOutput,\n\tQueryVectorsInput,\n\tQueryVectorsOutput,\n\tUpsertVectorsInput,\n\tUpsertVectorsOutput,\n\tVectorMatch,\n\tVectorMetadata,\n\tVectorPoint\n} from '../_vector'\n\n/**\n * Mastra PgVector auth (`@mastra/pg`).\n * Host owns Postgres connection + schema; package does not invent org policy.\n */\nexport const mastraVectorAuthSchema = z.object({\n\tconnection_string: z\n\t\t.string()\n\t\t.min(1)\n\t\t.describe('Postgres connection string for Mastra PgVector (e.g. Supabase DB URL)'),\n\tid: z.string().min(1).describe('Mastra vector store id (stable string for this store instance)'),\n\tschema_name: z\n\t\t.string()\n\t\t.min(1)\n\t\t.optional()\n\t\t.describe('Postgres schema for vector tables (e.g. agent); omit for package default'),\n\tdefault_index: z.string().min(1).optional().describe('Default index name when tool input omits collection'),\n\tdimension: z\n\t\t.number()\n\t\t.int()\n\t\t.positive()\n\t\t.optional()\n\t\t.describe('Embedding dimension; required when auto_create_index is true'),\n\tauto_create_index: z\n\t\t.boolean()\n\t\t.optional()\n\t\t.describe('When true, create the index on upsert if missing (needs dimension)'),\n\tdisable_init: z.boolean().optional().describe('Pass disableInit to PgVector (host manages migration/init)'),\n\tdefault_filter: vectorDefaultFilterSchema\n\t\t.optional()\n\t\t.describe(\n\t\t\t'Host-bound metadata filter always applied on query (Mongo-style / Mastra PG filter); flat keys stamped on upsert'\n\t\t)\n})\n\nexport type MastraVectorAuth = z.infer<typeof mastraVectorAuthSchema>\n","/**\n * Mastra PgVector vendor client (`@mastra/pg`).\n * Host: `new MastraVectorClient(auth)`. Agent tools: `fromContext(ctx)`.\n * Runtime: node (Postgres). Optional peer: `@mastra/pg`.\n */\n\nimport { PgVector } from '@mastra/pg'\nimport { isNumber, isPlainObject, isString } from 'es-toolkit'\n\nimport { ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport { mergeVectorFilter, parseMetadata, requireCollection, stampDefaultFilterMetadata } from '../_vector/domain'\nimport type { VectorDefaultFilter } from '../_vector/domain'\nimport type {\n\tDeleteVectorsInput,\n\tDeleteVectorsOutput,\n\tMastraVectorAuth,\n\tQueryVectorsInput,\n\tQueryVectorsOutput,\n\tUpsertVectorsInput,\n\tUpsertVectorsOutput,\n\tVectorMatch\n} from './contracts'\nimport { mastraVectorAuthSchema } from './contracts'\n\n/** Injected / real store surface (filter is opaque Record for seam compatibility). */\ntype MastraStore = {\n\tupsert: (input: {\n\t\tindexName: string\n\t\tids: string[]\n\t\tvectors: number[][]\n\t\tmetadata: Array<Record<string, unknown>>\n\t}) => Promise<unknown>\n\tquery: (input: {\n\t\tindexName: string\n\t\tqueryVector: number[]\n\t\ttopK?: number\n\t\tincludeVector?: boolean\n\t\tfilter?: Record<string, unknown>\n\t}) => Promise<Array<{ id?: string; score?: number; metadata?: unknown; vector?: number[] }>>\n\tdeleteVectors: (input: { indexName: string; ids: string[] }) => Promise<unknown>\n\tcreateIndex: (input: { indexName: string; dimension: number }) => Promise<unknown>\n\tdisconnect?: () => Promise<void>\n}\n\ntype PgQueryArgs = Parameters<PgVector['query']>[0]\n\n/** Narrow a built arg bag to PgVector query params (Mongo-style filter is structural). */\nfunction isPgQueryArgs(value: unknown): value is PgQueryArgs {\n\treturn (\n\t\tisPlainObject(value) &&\n\t\tisString(value['indexName']) &&\n\t\tvalue['indexName'].length > 0 &&\n\t\tArray.isArray(value['queryVector'])\n\t)\n}\n\nexport type MastraVectorClientOptions = {\n\t/**\n\t * Test injection — production uses PgVector.\n\t * Must implement the same method names as PgVector for upsert/query/deleteVectors/createIndex.\n\t */\n\tstore?: MastraStore\n}\n\nexport class MastraVectorClient {\n\treadonly #store: MastraStore\n\treadonly #defaultIndex: string | undefined\n\treadonly #defaultFilter: VectorDefaultFilter | undefined\n\treadonly #dimension: number | undefined\n\treadonly #autoCreateIndex: boolean\n\treadonly #ownsStore: boolean\n\n\tconstructor(auth: MastraVectorAuth, options: MastraVectorClientOptions = {}) {\n\t\tconst parsed = mastraVectorAuthSchema.safeParse(auth)\n\t\tif (!parsed.success) {\n\t\t\tthrow new ToolError('Invalid Mastra vector auth credentials', {\n\t\t\t\tcode: 'bad_auth',\n\t\t\t\tdetails: { issues: parsed.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\t\tconst data = parsed.data\n\t\tthis.#defaultIndex = data.default_index\n\t\tthis.#defaultFilter = data.default_filter\n\t\tthis.#dimension = data.dimension\n\t\tthis.#autoCreateIndex = data.auto_create_index === true\n\n\t\tif (options.store) {\n\t\t\tthis.#store = options.store\n\t\t\tthis.#ownsStore = false\n\t\t\treturn\n\t\t}\n\n\t\tconst config: {\n\t\t\tconnectionString: string\n\t\t\tid: string\n\t\t\tschemaName?: string\n\t\t\tdisableInit?: boolean\n\t\t} = {\n\t\t\tconnectionString: data.connection_string,\n\t\t\tid: data.id\n\t\t}\n\t\tif (data.schema_name) config.schemaName = data.schema_name\n\t\tif (data.disable_init === true) config.disableInit = true\n\n\t\tconst pg = new PgVector(config)\n\t\t// Adapt PgVector to opaque Record filters (Mongo-style / flat equality is native).\n\t\tthis.#store = {\n\t\t\tupsert: (input) =>\n\t\t\t\tpg.upsert({\n\t\t\t\t\tindexName: input.indexName,\n\t\t\t\t\tids: input.ids,\n\t\t\t\t\tvectors: input.vectors,\n\t\t\t\t\tmetadata: input.metadata\n\t\t\t\t}),\n\t\t\tquery: (input) => {\n\t\t\t\tconst args: Record<string, unknown> = {\n\t\t\t\t\tindexName: input.indexName,\n\t\t\t\t\tqueryVector: input.queryVector,\n\t\t\t\t\t...(input.topK !== undefined && { topK: input.topK }),\n\t\t\t\t\t...(input.includeVector !== undefined && { includeVector: input.includeVector }),\n\t\t\t\t\t...(input.filter !== undefined && { filter: input.filter })\n\t\t\t\t}\n\t\t\t\tif (!isPgQueryArgs(args)) {\n\t\t\t\t\tthrow new ToolError('Invalid Mastra vector query args', { code: 'internal' })\n\t\t\t\t}\n\t\t\t\treturn pg.query(args)\n\t\t\t},\n\t\t\tdeleteVectors: (input) => pg.deleteVectors({ indexName: input.indexName, ids: input.ids }),\n\t\t\tcreateIndex: (input) => pg.createIndex({ indexName: input.indexName, dimension: input.dimension }),\n\t\t\tdisconnect: () => pg.disconnect()\n\t\t}\n\t\tthis.#ownsStore = true\n\t}\n\n\tstatic fromContext(ctx: ToolContext): MastraVectorClient {\n\t\tconst auth = requireAuth(ctx, mastraVectorAuthSchema)\n\t\treturn new MastraVectorClient(auth)\n\t}\n\n\tasync upsert(input: UpsertVectorsInput): Promise<UpsertVectorsOutput> {\n\t\tconst indexName = requireCollection(input.collection, this.#defaultIndex, 'Mastra vector upsert')\n\t\tawait this.#ensureIndex(indexName, input.vectors[0]?.values.length)\n\n\t\tawait this.#store.upsert({\n\t\t\tindexName,\n\t\t\tids: input.vectors.map((point) => point.id),\n\t\t\tvectors: input.vectors.map((point) => point.values),\n\t\t\tmetadata: input.vectors.map((point) => stampDefaultFilterMetadata(point.metadata, this.#defaultFilter) ?? {})\n\t\t})\n\t\treturn { upserted: input.vectors.length, collection: indexName }\n\t}\n\n\tasync query(input: QueryVectorsInput): Promise<QueryVectorsOutput> {\n\t\tconst indexName = requireCollection(input.collection, this.#defaultIndex, 'Mastra vector query')\n\t\tconst topK = input.top_k ?? 8\n\t\tconst includeVector = input.include_values === true\n\t\tconst filter = mergeVectorFilter(this.#defaultFilter, input.filter)\n\n\t\tconst rows = await this.#store.query({\n\t\t\tindexName,\n\t\t\tqueryVector: input.vector,\n\t\t\ttopK,\n\t\t\tincludeVector,\n\t\t\t...(filter && { filter })\n\t\t})\n\n\t\tconst includeMetadata = input.include_metadata !== false\n\t\tconst matches: VectorMatch[] = []\n\t\tfor (const row of rows) {\n\t\t\tif (!isString(row.id) || row.id.length === 0) continue\n\t\t\tconst score = isNumber(row.score) ? row.score : 0\n\t\t\tconst match: VectorMatch = { id: row.id, score }\n\t\t\tif (includeMetadata && row.metadata !== undefined) {\n\t\t\t\tconst meta = parseMetadata(row.metadata)\n\t\t\t\tif (meta) match.metadata = meta\n\t\t\t}\n\t\t\tif (includeVector && Array.isArray(row.vector)) {\n\t\t\t\tconst values = row.vector.filter((n): n is number => isNumber(n) && Number.isFinite(n))\n\t\t\t\tif (values.length === row.vector.length) match.values = values\n\t\t\t}\n\t\t\tmatches.push(match)\n\t\t}\n\t\treturn { matches, collection: indexName }\n\t}\n\n\tasync delete(input: DeleteVectorsInput): Promise<DeleteVectorsOutput> {\n\t\tconst indexName = requireCollection(input.collection, this.#defaultIndex, 'Mastra vector delete')\n\t\tawait this.#store.deleteVectors({ indexName, ids: input.ids })\n\t\treturn { deleted: input.ids.length, collection: indexName }\n\t}\n\n\tasync disconnect(): Promise<void> {\n\t\tif (this.#ownsStore && this.#store.disconnect) {\n\t\t\tawait this.#store.disconnect()\n\t\t}\n\t}\n\n\tasync #ensureIndex(indexName: string, inferredDimension: number | undefined): Promise<void> {\n\t\tif (!this.#autoCreateIndex) return\n\t\tconst dimension = this.#dimension ?? inferredDimension\n\t\tif (dimension === undefined) {\n\t\t\tthrow new ToolError('Mastra auto_create_index requires dimension on auth or non-empty vectors', {\n\t\t\t\tcode: 'bad_input'\n\t\t\t})\n\t\t}\n\t\ttry {\n\t\t\tawait this.#store.createIndex({ indexName, dimension })\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error)\n\t\t\tif (/already exists|duplicate|exist/i.test(message)) return\n\t\t\tthrow new ToolError(`Mastra createIndex failed: ${message}`, {\n\t\t\t\tcode: 'upstream',\n\t\t\t\tcause: error\n\t\t\t})\n\t\t}\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { MastraVectorClient } from './client'\nimport {\n\tdeleteVectorsInputSchema,\n\tdeleteVectorsOutputSchema,\n\tmastraVectorAuthSchema,\n\tqueryVectorsInputSchema,\n\tqueryVectorsOutputSchema,\n\tupsertVectorsInputSchema,\n\tupsertVectorsOutputSchema\n} from './contracts'\n\nexport const mastraVectorUpsertTool = defineTool({\n\tid: 'mastra-vector-upsert',\n\tname: 'mastraVectorUpsert',\n\tdescription: 'Upsert vectors into a Mastra PgVector index. collection maps to indexName.',\n\tinputSchema: upsertVectorsInputSchema,\n\toutputSchema: upsertVectorsOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'node',\n\texecute: async (input, ctx) => MastraVectorClient.fromContext(ctx).upsert(input)\n})\n\nexport const mastraVectorQueryTool = defineTool({\n\tid: 'mastra-vector-query',\n\tname: 'mastraVectorQuery',\n\tdescription: 'Nearest-neighbor query against a Mastra PgVector index.',\n\tinputSchema: queryVectorsInputSchema,\n\toutputSchema: queryVectorsOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'node',\n\texecute: async (input, ctx) => MastraVectorClient.fromContext(ctx).query(input)\n})\n\nexport const mastraVectorDeleteTool = defineTool({\n\tid: 'mastra-vector-delete',\n\tname: 'mastraVectorDelete',\n\tdescription: 'Delete vectors by id from a Mastra PgVector index.',\n\tinputSchema: deleteVectorsInputSchema,\n\toutputSchema: deleteVectorsOutputSchema,\n\tsideEffect: 'delete',\n\truntime: 'node',\n\texecute: async (input, ctx) => MastraVectorClient.fromContext(ctx).delete(input)\n})\n\nexport const mastraVectorModule = defineModule({\n\tid: 'mastra-vector',\n\ttitle: 'Mastra Vector',\n\tdescription:\n\t\t'Mastra PgVector over Postgres: upsert, query, and delete vectors. Index names map from collection. Node runtime.',\n\truntime: 'node',\n\tauth: { type: 'custom', schema: mastraVectorAuthSchema },\n\tcategories: ['ai', 'vector'],\n\tclassification: 'pii',\n\ttags: ['pgvector', 'mastra'],\n\ttools: [mastraVectorUpsertTool, mastraVectorQueryTool, mastraVectorDeleteTool]\n})\n"],"mappings":"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"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,80 @@
+import { g as ToolSource, o as ToolContext, s as ToolDefinition } from "../types-Ccb0DXY9.js";
+import { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+//#region src/adapters/mcp/create-mcp-tool.d.ts
+/**
+ * MCP tools/list item shape (JSON Schema input).
+ * @see https://modelcontextprotocol.io/specification/2025-03-26/server/tools
+ */
+type McpToolListItem = {
+  annotations?: McpToolAnnotations;
+  description: string;
+  inputSchema: Record<string, unknown>;
+  name: string;
+};
+type McpToolAnnotations = {
+  destructiveHint?: boolean;
+  idempotentHint?: boolean;
+  openWorldHint?: boolean;
+  readOnlyHint?: boolean;
+  title?: string;
+};
+/** Subset of MCP CallToolResult used by this projector. */
+type McpCallToolResult = {
+  content: Array<{
+    text: string;
+    type: 'text';
+  }>;
+  isError?: boolean;
+  structuredContent?: Record<string, unknown>;
+};
+type McpRequestExtra = Parameters<ToolCallback>[0];
+/**
+ * Minimal surface of `@modelcontextprotocol/sdk` `McpServer.registerTool`
+ * used by the optional MCP adapter peer.
+ */
+type McpServerLike = {
+  registerTool: (name: string, config: {
+    annotations?: McpToolAnnotations;
+    description?: string;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    title?: string;
+  }, cb: (args: unknown, extra: McpRequestExtra) => Promise<unknown>) => unknown;
+};
+type McpToolset = {
+  /** tools/list payload items */
+  list: McpToolListItem[];
+  /** tools/call by name */
+  call: (name: string, args: unknown, ctx?: ToolContext) => Promise<McpCallToolResult>;
+  /** raw executors (pre-MCP result wrapping) */
+  executors: Record<string, (args: unknown, ctx?: ToolContext) => Promise<unknown>>;
+};
+declare function createMcpToolListItem(tool: ToolDefinition): McpToolListItem;
+/**
+ * Project kernel tools into MCP list + call helpers (no SDK required).
+ * Hosts implement transport / McpServer themselves.
+ */
+declare function createMcpTools(source: ToolSource): McpToolset;
+type RegisterMcpToolsOptions = {
+  /**
+   * Static base context **or** async factory (back-compat with pre-H-02 `context: () => …`).
+   * Prefer `withAuth` / `bindModule` before projection when credentials are fixed or dynamic.
+   */
+  context?: ToolContext | (() => ToolContext | Promise<ToolContext>);
+  /**
+   * Map MCP request extras into ToolContext.
+   * Merged over framework defaults (`signal`) so cancel works unless explicitly overridden.
+   * Explicit `undefined` fields do not erase the framework signal.
+   */
+  createContext?: (extra: McpRequestExtra) => ToolContext | Promise<ToolContext>;
+  /** @deprecated Alias of factory form of `context`. */
+  contextFactory?: ToolContext | (() => ToolContext | Promise<ToolContext>);
+};
+/**
+ * Register kernel tools on an MCP `McpServer` (or compatible) via `registerTool`.
+ * Requires the host to construct the server from `@modelcontextprotocol/sdk`.
+ */
+declare function registerMcpTools(server: McpServerLike, source: ToolSource, options?: RegisterMcpToolsOptions): void;
+//#endregion
+export { type McpCallToolResult, type McpRequestExtra, type McpServerLike, type McpToolAnnotations, type McpToolListItem, type McpToolset, type RegisterMcpToolsOptions, createMcpToolListItem, createMcpTools, registerMcpTools };
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/adapters/mcp/create-mcp-tool.ts"],"mappings":";;;;;;;KAeY;EACX,cAAc;EACd;EACA,aAAa;EACb;;KAGW;EACX;EACA;EACA;EACA;EACA;;;KAIW;EACX,SAAS;IAAQ;IAAc;;EAC/B;EACA,oBAAoB;;KAGT,kBAAkB,WAAW;;;;;KAM7B;EACX,eACC,cACA;IACC,cAAc;IACd;IACA;IACA;IACA;KAED,KAAK,eAAe,OAAO,oBAAoB;;KAIrC;;EAEX,MAAM;;EAEN,OAAO,cAAc,eAAe,MAAM,gBAAgB,QAAQ;;EAElE,WAAW,gBAAgB,eAAe,MAAM,gBAAgB;;iBAejD,sBAAsB,MAAM,iBAAiB;;;;;iBAwB7C,eAAe,QAAQ,aAAa;KAuCxC;;;;;EAKX,UAAU,qBAAqB,cAAc,QAAQ;;;;;;EAMrD,iBAAiB,OAAO,oBAAoB,cAAc,QAAQ;;EAElE,iBAAiB,qBAAqB,cAAc,QAAQ;;;;;;iBAe7C,iBACf,QAAQ,eACR,QAAQ,YACR,UAAS"}

package/dist/mcp/index.js

@@ -0,0 +1,97 @@
+import { m as mergeToolContext, n as runTool, s as resolveTools } from "../with-auth-CpKqTrGK.js";
+import { t as assertUniqueBy } from "../unique-EwBH1JPB.js";
+import { t as mergeAdapterToolContext } from "../framework-context-DVIIY8ZO.js";
+import { isFunction, isPlainObject, isString, keyBy, mapValues } from "es-toolkit";
+import { toJSONSchema } from "zod";
+//#region src/adapters/mcp/create-mcp-tool.ts
+function annotationsForTool(tool) {
+	const sideEffect = tool.meta.sideEffect;
+	const readOnly = sideEffect === "read" || sideEffect === "none";
+	return {
+		readOnlyHint: readOnly,
+		destructiveHint: sideEffect === "delete",
+		idempotentHint: tool.meta.idempotent ?? readOnly,
+		openWorldHint: tool.meta.network ?? true
+	};
+}
+function createMcpToolListItem(tool) {
+	return {
+		name: tool.id,
+		description: tool.description,
+		inputSchema: toJSONSchema(tool.inputSchema),
+		annotations: annotationsForTool(tool)
+	};
+}
+function toCallResult(value) {
+	const result = { content: [{
+		type: "text",
+		text: isString(value) ? value : JSON.stringify(value)
+	}] };
+	if (isPlainObject(value)) result.structuredContent = value;
+	return result;
+}
+/**
+* Project kernel tools into MCP list + call helpers (no SDK required).
+* Hosts implement transport / McpServer themselves.
+*/
+function createMcpTools(source) {
+	const tools = resolveTools(source);
+	assertUniqueBy(tools, (t) => t.id, (id) => `Duplicate tool id when building MCP tools: ${id}`);
+	const executors = mapValues(keyBy(tools, (t) => t.id), (tool) => (args, ctx = {}) => runTool(tool, args, ctx));
+	return {
+		list: tools.map(createMcpToolListItem),
+		executors,
+		call: async (name, args, ctx = {}) => {
+			const run = executors[name];
+			if (!run) return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: `Unknown tool: ${name}`
+				}]
+			};
+			try {
+				return toCallResult(await run(args, ctx));
+			} catch (error) {
+				return {
+					isError: true,
+					content: [{
+						type: "text",
+						text: error instanceof Error ? error.message : "Tool execution failed"
+					}]
+				};
+			}
+		}
+	};
+}
+async function resolveMcpStaticContext(options) {
+	const fromDeprecated = options.contextFactory;
+	const deprecatedBase = isFunction(fromDeprecated) ? await fromDeprecated() : fromDeprecated ?? {};
+	const c = options.context;
+	return mergeToolContext(deprecatedBase, isFunction(c) ? await c() : c ?? {});
+}
+/**
+* Register kernel tools on an MCP `McpServer` (or compatible) via `registerTool`.
+* Requires the host to construct the server from `@modelcontextprotocol/sdk`.
+*/
+function registerMcpTools(server, source, options = {}) {
+	const tools = resolveTools(source);
+	assertUniqueBy(tools, (t) => t.id, (id) => `Duplicate tool id when registering MCP tools: ${id}`);
+	for (const tool of tools) server.registerTool(tool.id, {
+		title: tool.name,
+		description: tool.description,
+		inputSchema: tool.inputSchema,
+		outputSchema: tool.outputSchema,
+		annotations: annotationsForTool(tool)
+	}, async (args, extra) => {
+		const ctx = await mergeAdapterToolContext(extra, {
+			context: await resolveMcpStaticContext(options),
+			createContext: options.createContext
+		}, "signal");
+		return toCallResult(await runTool(tool, args, ctx));
+	});
+}
+//#endregion
+export { createMcpToolListItem, createMcpTools, registerMcpTools };
+
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/adapters/mcp/create-mcp-tool.ts"],"sourcesContent":["import { isFunction, isPlainObject, isString, keyBy, mapValues } from 'es-toolkit'\nimport type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { toJSONSchema } from 'zod'\n\nimport { mergeToolContext } from '../../core/context'\nimport { mergeAdapterToolContext } from '../framework-context'\nimport { resolveTools } from '../../core/resolve-tools'\nimport type { ToolContext, ToolDefinition, ToolSideEffect, ToolSource } from '../../core/types'\nimport { assertUniqueBy } from '../../core/unique'\nimport { runTool } from '../../core/with-auth'\n\n/**\n * MCP tools/list item shape (JSON Schema input).\n * @see https://modelcontextprotocol.io/specification/2025-03-26/server/tools\n */\nexport type McpToolListItem = {\n\tannotations?: McpToolAnnotations\n\tdescription: string\n\tinputSchema: Record<string, unknown>\n\tname: string\n}\n\nexport type McpToolAnnotations = {\n\tdestructiveHint?: boolean\n\tidempotentHint?: boolean\n\topenWorldHint?: boolean\n\treadOnlyHint?: boolean\n\ttitle?: string\n}\n\n/** Subset of MCP CallToolResult used by this projector. */\nexport type McpCallToolResult = {\n\tcontent: Array<{ text: string; type: 'text' }>\n\tisError?: boolean\n\tstructuredContent?: Record<string, unknown>\n}\n\nexport type McpRequestExtra = Parameters<ToolCallback>[0]\n\n/**\n * Minimal surface of `@modelcontextprotocol/sdk` `McpServer.registerTool`\n * used by the optional MCP adapter peer.\n */\nexport type McpServerLike = {\n\tregisterTool: (\n\t\tname: string,\n\t\tconfig: {\n\t\t\tannotations?: McpToolAnnotations\n\t\t\tdescription?: string\n\t\t\tinputSchema?: unknown\n\t\t\toutputSchema?: unknown\n\t\t\ttitle?: string\n\t\t},\n\t\tcb: (args: unknown, extra: McpRequestExtra) => Promise<unknown>\n\t) => unknown\n}\n\nexport type McpToolset = {\n\t/** tools/list payload items */\n\tlist: McpToolListItem[]\n\t/** tools/call by name */\n\tcall: (name: string, args: unknown, ctx?: ToolContext) => Promise<McpCallToolResult>\n\t/** raw executors (pre-MCP result wrapping) */\n\texecutors: Record<string, (args: unknown, ctx?: ToolContext) => Promise<unknown>>\n}\n\nfunction annotationsForTool(tool: ToolDefinition): McpToolAnnotations {\n\tconst sideEffect: ToolSideEffect = tool.meta.sideEffect\n\tconst readOnly = sideEffect === 'read' || sideEffect === 'none'\n\treturn {\n\t\treadOnlyHint: readOnly,\n\t\tdestructiveHint: sideEffect === 'delete',\n\t\tidempotentHint: tool.meta.idempotent ?? readOnly,\n\t\t// Most integrations touch external systems; hosts can override via register options later.\n\t\topenWorldHint: tool.meta.network ?? true\n\t}\n}\n\nexport function createMcpToolListItem(tool: ToolDefinition): McpToolListItem {\n\treturn {\n\t\tname: tool.id,\n\t\tdescription: tool.description,\n\t\tinputSchema: toJSONSchema(tool.inputSchema),\n\t\tannotations: annotationsForTool(tool)\n\t}\n}\n\nfunction toCallResult(value: unknown): McpCallToolResult {\n\tconst text = isString(value) ? value : JSON.stringify(value)\n\tconst result: McpCallToolResult = {\n\t\tcontent: [{ type: 'text', text }]\n\t}\n\tif (isPlainObject(value)) {\n\t\tresult.structuredContent = value\n\t}\n\treturn result\n}\n\n/**\n * Project kernel tools into MCP list + call helpers (no SDK required).\n * Hosts implement transport / McpServer themselves.\n */\nexport function createMcpTools(source: ToolSource): McpToolset {\n\tconst tools = resolveTools(source)\n\tassertUniqueBy(\n\t\ttools,\n\t\t(t) => t.id,\n\t\t(id) => `Duplicate tool id when building MCP tools: ${id}`\n\t)\n\tconst executors = mapValues(\n\t\tkeyBy(tools, (t) => t.id),\n\t\t(tool) =>\n\t\t\t(args: unknown, ctx: ToolContext = {}) =>\n\t\t\t\trunTool(tool, args, ctx)\n\t)\n\n\treturn {\n\t\tlist: tools.map(createMcpToolListItem),\n\t\texecutors,\n\t\tcall: async (name, args, ctx = {}) => {\n\t\t\tconst run = executors[name]\n\t\t\tif (!run) {\n\t\t\t\treturn {\n\t\t\t\t\tisError: true,\n\t\t\t\t\tcontent: [{ type: 'text', text: `Unknown tool: ${name}` }]\n\t\t\t\t}\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst value = await run(args, ctx)\n\t\t\t\treturn toCallResult(value)\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : 'Tool execution failed'\n\t\t\t\treturn {\n\t\t\t\t\tisError: true,\n\t\t\t\t\tcontent: [{ type: 'text', text: message }]\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport type RegisterMcpToolsOptions = {\n\t/**\n\t * Static base context **or** async factory (back-compat with pre-H-02 `context: () => …`).\n\t * Prefer `withAuth` / `bindModule` before projection when credentials are fixed or dynamic.\n\t */\n\tcontext?: ToolContext | (() => ToolContext | Promise<ToolContext>)\n\t/**\n\t * Map MCP request extras into ToolContext.\n\t * Merged over framework defaults (`signal`) so cancel works unless explicitly overridden.\n\t * Explicit `undefined` fields do not erase the framework signal.\n\t */\n\tcreateContext?: (extra: McpRequestExtra) => ToolContext | Promise<ToolContext>\n\t/** @deprecated Alias of factory form of `context`. */\n\tcontextFactory?: ToolContext | (() => ToolContext | Promise<ToolContext>)\n}\n\nasync function resolveMcpStaticContext(options: RegisterMcpToolsOptions): Promise<ToolContext> {\n\tconst fromDeprecated = options.contextFactory\n\tconst deprecatedBase: ToolContext = isFunction(fromDeprecated) ? await fromDeprecated() : (fromDeprecated ?? {})\n\tconst c = options.context\n\tconst fromContext: ToolContext = isFunction(c) ? await c() : (c ?? {})\n\treturn mergeToolContext(deprecatedBase, fromContext)\n}\n\n/**\n * Register kernel tools on an MCP `McpServer` (or compatible) via `registerTool`.\n * Requires the host to construct the server from `@modelcontextprotocol/sdk`.\n */\nexport function registerMcpTools(\n\tserver: McpServerLike,\n\tsource: ToolSource,\n\toptions: RegisterMcpToolsOptions = {}\n): void {\n\tconst tools = resolveTools(source)\n\tassertUniqueBy(\n\t\ttools,\n\t\t(t) => t.id,\n\t\t(id) => `Duplicate tool id when registering MCP tools: ${id}`\n\t)\n\n\tfor (const tool of tools) {\n\t\tserver.registerTool(\n\t\t\ttool.id,\n\t\t\t{\n\t\t\t\ttitle: tool.name,\n\t\t\t\tdescription: tool.description,\n\t\t\t\tinputSchema: tool.inputSchema,\n\t\t\t\toutputSchema: tool.outputSchema,\n\t\t\t\tannotations: annotationsForTool(tool)\n\t\t\t},\n\t\t\tasync (args, extra) => {\n\t\t\t\tconst staticCtx = await resolveMcpStaticContext(options)\n\t\t\t\tconst ctx = await mergeAdapterToolContext(\n\t\t\t\t\textra,\n\t\t\t\t\t{ context: staticCtx, createContext: options.createContext },\n\t\t\t\t\t'signal'\n\t\t\t\t)\n\t\t\t\tconst value = await runTool(tool, args, ctx)\n\t\t\t\treturn toCallResult(value)\n\t\t\t}\n\t\t)\n\t}\n}\n"],"mappings":";;;;;;AAkEA,SAAS,mBAAmB,MAA0C;CACrE,MAAM,aAA6B,KAAK,KAAK;CAC7C,MAAM,WAAW,eAAe,UAAU,eAAe;CACzD,OAAO;EACN,cAAc;EACd,iBAAiB,eAAe;EAChC,gBAAgB,KAAK,KAAK,cAAc;EAExC,eAAe,KAAK,KAAK,WAAW;CACrC;AACD;AAEA,SAAgB,sBAAsB,MAAuC;CAC5E,OAAO;EACN,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,aAAa,aAAa,KAAK,WAAW;EAC1C,aAAa,mBAAmB,IAAI;CACrC;AACD;AAEA,SAAS,aAAa,OAAmC;CAExD,MAAM,SAA4B,EACjC,SAAS,CAAC;EAAE,MAAM;EAAQ,MAFd,SAAS,KAAK,IAAI,QAAQ,KAAK,UAAU,KAAK;CAE3B,CAAC,EACjC;CACA,IAAI,cAAc,KAAK,GACtB,OAAO,oBAAoB;CAE5B,OAAO;AACR;;;;;AAMA,SAAgB,eAAe,QAAgC;CAC9D,MAAM,QAAQ,aAAa,MAAM;CACjC,eACC,QACC,MAAM,EAAE,KACR,OAAO,8CAA8C,IACvD;CACA,MAAM,YAAY,UACjB,MAAM,QAAQ,MAAM,EAAE,EAAE,IACvB,UACC,MAAe,MAAmB,CAAC,MACnC,QAAQ,MAAM,MAAM,GAAG,CAC1B;CAEA,OAAO;EACN,MAAM,MAAM,IAAI,qBAAqB;EACrC;EACA,MAAM,OAAO,MAAM,MAAM,MAAM,CAAC,MAAM;GACrC,MAAM,MAAM,UAAU;GACtB,IAAI,CAAC,KACJ,OAAO;IACN,SAAS;IACT,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,iBAAiB;IAAO,CAAC;GAC1D;GAED,IAAI;IAEH,OAAO,aAAa,MADA,IAAI,MAAM,GAAG,CACR;GAC1B,SAAS,OAAO;IAEf,OAAO;KACN,SAAS;KACT,SAAS,CAAC;MAAE,MAAM;MAAQ,MAHX,iBAAiB,QAAQ,MAAM,UAAU;KAGhB,CAAC;IAC1C;GACD;EACD;CACD;AACD;AAkBA,eAAe,wBAAwB,SAAwD;CAC9F,MAAM,iBAAiB,QAAQ;CAC/B,MAAM,iBAA8B,WAAW,cAAc,IAAI,MAAM,eAAe,IAAK,kBAAkB,CAAC;CAC9G,MAAM,IAAI,QAAQ;CAElB,OAAO,iBAAiB,gBADS,WAAW,CAAC,IAAI,MAAM,EAAE,IAAK,KAAK,CAAC,CACjB;AACpD;;;;;AAMA,SAAgB,iBACf,QACA,QACA,UAAmC,CAAC,GAC7B;CACP,MAAM,QAAQ,aAAa,MAAM;CACjC,eACC,QACC,MAAM,EAAE,KACR,OAAO,iDAAiD,IAC1D;CAEA,KAAK,MAAM,QAAQ,OAClB,OAAO,aACN,KAAK,IACL;EACC,OAAO,KAAK;EACZ,aAAa,KAAK;EAClB,aAAa,KAAK;EAClB,cAAc,KAAK;EACnB,aAAa,mBAAmB,IAAI;CACrC,GACA,OAAO,MAAM,UAAU;EAEtB,MAAM,MAAM,MAAM,wBACjB,OACA;GAAE,SAAS,MAHY,wBAAwB,OAAO;GAGhC,eAAe,QAAQ;EAAc,GAC3D,QACD;EAEA,OAAO,aAAa,MADA,QAAQ,MAAM,MAAM,GAAG,CAClB;CAC1B,CACD;AAEF"}