@mastra/server 1.60.0-alpha.5 → 1.60.0-alpha.7

package/dist/server/handlers/mcp-client-versions.cjs

@@ -3,8 +3,8 @@ const require_http_exception = require("../../http-exception-CKDHupKw.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
-const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 const require_mcp_client_versions = require("../../mcp-client-versions-CG7po4hq.cjs");
+const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 //#region src/server/handlers/mcp-client-versions.ts
 /**
 * GET /stored/mcp-clients/:mcpClientId/versions - List all versions for an MCP client

package/dist/server/handlers/mcp-client-versions.js

@@ -2,8 +2,8 @@ import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { i as getStoredResourceScope, n as assertStoredResourceScope } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
-import { MCP_CLIENT_SNAPSHOT_CONFIG_FIELDS, calculateChangedFields, computeVersionDiffs, createVersionWithRetry, enforceRetentionLimit, extractConfigFromVersion } from "./version-helpers.js";
 import { a as createMCPClientVersionResponseSchema, c as listMCPClientVersionsQuerySchema, d as mcpClientVersionPathParams, i as createMCPClientVersionBodySchema, l as listMCPClientVersionsResponseSchema, n as compareMCPClientVersionsQuerySchema, o as deleteMCPClientVersionResponseSchema, p as restoreMCPClientVersionResponseSchema, r as compareMCPClientVersionsResponseSchema, s as getMCPClientVersionResponseSchema, t as activateMCPClientVersionResponseSchema, u as mcpClientVersionIdPathParams } from "../../mcp-client-versions-Co8d39A6.js";
+import { MCP_CLIENT_SNAPSHOT_CONFIG_FIELDS, calculateChangedFields, computeVersionDiffs, createVersionWithRetry, enforceRetentionLimit, extractConfigFromVersion } from "./version-helpers.js";
 //#region src/server/handlers/mcp-client-versions.ts
 /**
 * GET /stored/mcp-clients/:mcpClientId/versions - List all versions for an MCP client

package/dist/server/handlers/prompt-block-versions.cjs

@@ -3,8 +3,8 @@ const require_http_exception = require("../../http-exception-CKDHupKw.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
-const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 const require_prompt_block_versions = require("../../prompt-block-versions-Cgt_Grk2.cjs");
+const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 //#region src/server/handlers/prompt-block-versions.ts
 const SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/prompt-block-versions.js

@@ -2,8 +2,8 @@ import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { i as getStoredResourceScope, n as assertStoredResourceScope } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
-import { calculateChangedFields, computeVersionDiffs, createVersionWithRetry, enforceRetentionLimit, extractConfigFromVersion } from "./version-helpers.js";
 import { a as createPromptBlockVersionResponseSchema, c as listPromptBlockVersionsQuerySchema, d as promptBlockVersionPathParams, i as createPromptBlockVersionBodySchema, l as listPromptBlockVersionsResponseSchema, n as comparePromptBlockVersionsQuerySchema, o as deletePromptBlockVersionResponseSchema, p as restorePromptBlockVersionResponseSchema, r as comparePromptBlockVersionsResponseSchema, s as getPromptBlockVersionResponseSchema, t as activatePromptBlockVersionResponseSchema, u as promptBlockVersionIdPathParams } from "../../prompt-block-versions-CBjHhMVK.js";
+import { calculateChangedFields, computeVersionDiffs, createVersionWithRetry, enforceRetentionLimit, extractConfigFromVersion } from "./version-helpers.js";
 //#region src/server/handlers/prompt-block-versions.ts
 const SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/scorer-versions.cjs

@@ -3,8 +3,8 @@ const require_http_exception = require("../../http-exception-CKDHupKw.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
-const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 const require_scorer_versions = require("../../scorer-versions-CYXtxMTU.cjs");
+const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 //#region src/server/handlers/scorer-versions.ts
 const SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/scorer-versions.js

@@ -2,8 +2,8 @@ import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { i as getStoredResourceScope, n as assertStoredResourceScope } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
-import { calculateChangedFields, computeVersionDiffs, createVersionWithRetry, enforceRetentionLimit, extractConfigFromVersion } from "./version-helpers.js";
 import { a as createScorerVersionResponseSchema, c as listScorerVersionsQuerySchema, d as scorerVersionIdPathParams, f as scorerVersionPathParams, i as createScorerVersionBodySchema, l as listScorerVersionsResponseSchema, n as compareScorerVersionsQuerySchema, o as deleteScorerVersionResponseSchema, r as compareScorerVersionsResponseSchema, s as getScorerVersionResponseSchema, t as activateScorerVersionResponseSchema, u as restoreScorerVersionResponseSchema } from "../../scorer-versions-CdVjOtQO.js";
+import { calculateChangedFields, computeVersionDiffs, createVersionWithRetry, enforceRetentionLimit, extractConfigFromVersion } from "./version-helpers.js";
 //#region src/server/handlers/scorer-versions.ts
 const SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/stored-mcp-clients.cjs

@@ -4,8 +4,8 @@ const require_common = require("../../common-DQn8jX5T.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
-const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 const require_stored_mcp_clients = require("../../stored-mcp-clients-CJJPe_09.cjs");
+const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 //#region src/server/handlers/stored-mcp-clients.ts
 /**
 * GET /stored/mcp-clients - List all stored MCP clients

package/dist/server/handlers/stored-mcp-clients.js

@@ -3,8 +3,8 @@ import { u as statusQuerySchema } from "../../common-5ZZuR6wj.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { c as toSlug, i as getStoredResourceScope, n as assertStoredResourceScope, s as scopeStoredResourceMetadata } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
-import { MCP_CLIENT_SNAPSHOT_CONFIG_FIELDS, handleAutoVersioning } from "./version-helpers.js";
 import { a as listStoredMCPClientsQuerySchema, i as getStoredMCPClientResponseSchema, l as updateStoredMCPClientBodySchema, n as createStoredMCPClientResponseSchema, o as listStoredMCPClientsResponseSchema, r as deleteStoredMCPClientResponseSchema, s as storedMCPClientIdPathParams, t as createStoredMCPClientBodySchema, u as updateStoredMCPClientResponseSchema } from "../../stored-mcp-clients-CoCfZRhw.js";
+import { MCP_CLIENT_SNAPSHOT_CONFIG_FIELDS, handleAutoVersioning } from "./version-helpers.js";
 //#region src/server/handlers/stored-mcp-clients.ts
 /**
 * GET /stored/mcp-clients - List all stored MCP clients

package/dist/server/handlers/stored-prompt-blocks.cjs

@@ -4,8 +4,8 @@ const require_common = require("../../common-DQn8jX5T.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
-const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 const require_stored_prompt_blocks = require("../../stored-prompt-blocks-XI4frgZv.cjs");
+const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 //#region src/server/handlers/stored-prompt-blocks.ts
 const PROMPT_BLOCK_SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/stored-prompt-blocks.js

@@ -3,8 +3,8 @@ import { u as statusQuerySchema } from "../../common-5ZZuR6wj.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { c as toSlug, i as getStoredResourceScope, n as assertStoredResourceScope, s as scopeStoredResourceMetadata } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
-import { handleAutoVersioning } from "./version-helpers.js";
 import { a as listStoredPromptBlocksQuerySchema, i as getStoredPromptBlockResponseSchema, l as updateStoredPromptBlockBodySchema, n as createStoredPromptBlockResponseSchema, o as listStoredPromptBlocksResponseSchema, r as deleteStoredPromptBlockResponseSchema, s as storedPromptBlockIdPathParams, t as createStoredPromptBlockBodySchema, u as updateStoredPromptBlockResponseSchema } from "../../stored-prompt-blocks-DcmkZaCm.js";
+import { handleAutoVersioning } from "./version-helpers.js";
 //#region src/server/handlers/stored-prompt-blocks.ts
 const PROMPT_BLOCK_SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/stored-scorers.cjs

@@ -4,8 +4,8 @@ const require_common = require("../../common-DQn8jX5T.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
-const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 const require_stored_scorers = require("../../stored-scorers-Cml7jPJv.cjs");
+const require_server_handlers_version_helpers = require("./version-helpers.cjs");
 //#region src/server/handlers/stored-scorers.ts
 const SCORER_SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/stored-scorers.js

@@ -3,8 +3,8 @@ import { u as statusQuerySchema } from "../../common-5ZZuR6wj.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { c as toSlug, i as getStoredResourceScope, n as assertStoredResourceScope, s as scopeStoredResourceMetadata } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
-import { handleAutoVersioning } from "./version-helpers.js";
 import { a as listStoredScorersQuerySchema, i as getStoredScorerResponseSchema, l as updateStoredScorerBodySchema, n as createStoredScorerResponseSchema, o as listStoredScorersResponseSchema, r as deleteStoredScorerResponseSchema, s as storedScorerIdPathParams, t as createStoredScorerBodySchema, u as updateStoredScorerResponseSchema } from "../../stored-scorers-B__LF0Cy.js";
+import { handleAutoVersioning } from "./version-helpers.js";
 //#region src/server/handlers/stored-scorers.ts
 const SCORER_SNAPSHOT_CONFIG_FIELDS = [
 	"name",

package/dist/server/handlers/stored-skill-favorites.cjs

@@ -3,10 +3,10 @@ const require_http_exception = require("../../http-exception-CKDHupKw.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
+const require_stored_skills = require("../../stored-skills-BqNK0ssS.cjs");
 const require_server_handlers_authorship = require("./authorship.cjs");
 const require_editor_builder = require("../../editor-builder-DT7ypWfa.cjs");
 const require_favorites = require("../../favorites-D1-AzGsK.cjs");
-const require_stored_skills = require("../../stored-skills-BqNK0ssS.cjs");
 //#region src/server/handlers/stored-skill-favorites.ts
 /**
 * Resolves the storage and favorites domains, throwing 500 if unavailable.

package/dist/server/handlers/stored-skill-favorites.js

@@ -2,10 +2,10 @@ import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { i as getStoredResourceScope, n as assertStoredResourceScope } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
+import { p as storedSkillIdPathParams } from "../../stored-skills-JTWbMybs.js";
 import { assertReadAccess, getCallerAuthorId } from "./authorship.js";
 import { a as requireBuilderFeature } from "../../editor-builder-Byg6wbi6.js";
 import { t as favoriteToggleResponseSchema } from "../../favorites-DWDyKxts.js";
-import { p as storedSkillIdPathParams } from "../../stored-skills-JTWbMybs.js";
 //#region src/server/handlers/stored-skill-favorites.ts
 /**
 * Resolves the storage and favorites domains, throwing 500 if unavailable.

package/dist/server/handlers/stored-skills.cjs

@@ -3,10 +3,10 @@ const require_http_exception = require("../../http-exception-CKDHupKw.cjs");
 const require_route_builder = require("../../route-builder-BAAedfru.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
+const require_stored_skills = require("../../stored-skills-BqNK0ssS.cjs");
 const require_server_handlers_authorship = require("./authorship.cjs");
 const require_editor_builder = require("../../editor-builder-DT7ypWfa.cjs");
 const require_server_handlers_favorites_enrichment = require("./favorites-enrichment.cjs");
-const require_stored_skills = require("../../stored-skills-BqNK0ssS.cjs");
 let _mastra_core_workspace = require("@mastra/core/workspace");
 //#region src/server/handlers/stored-skills.ts
 /**

package/dist/server/handlers/stored-skills.js

@@ -2,10 +2,10 @@ import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
 import { n as createRoute } from "../../route-builder-YQ_gLIvW.js";
 import { c as toSlug, i as getStoredResourceScope, n as assertStoredResourceScope, s as scopeStoredResourceMetadata } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
+import { a as deleteStoredSkillResponseSchema, c as listStoredSkillsResponseSchema, g as updateStoredSkillResponseSchema, h as updateStoredSkillBodySchema, i as createStoredSkillResponseSchema, l as publishStoredSkillBodySchema, o as getStoredSkillResponseSchema, p as storedSkillIdPathParams, r as createStoredSkillBodySchema, s as listStoredSkillsQuerySchema, u as publishStoredSkillResponseSchema } from "../../stored-skills-JTWbMybs.js";
 import { assertReadAccess, assertWriteAccess, getCallerAuthorId, matchesAuthorFilter, resolveAuthorFilter } from "./authorship.js";
 import { i as isBuilderFeatureEnabled } from "../../editor-builder-Byg6wbi6.js";
 import { enrichOrStripFavorites, prepareFavoritesEnrichment, stripFavoriteFields } from "./favorites-enrichment.js";
-import { a as deleteStoredSkillResponseSchema, c as listStoredSkillsResponseSchema, g as updateStoredSkillResponseSchema, h as updateStoredSkillBodySchema, i as createStoredSkillResponseSchema, l as publishStoredSkillBodySchema, o as getStoredSkillResponseSchema, p as storedSkillIdPathParams, r as createStoredSkillBodySchema, s as listStoredSkillsQuerySchema, u as publishStoredSkillResponseSchema } from "../../stored-skills-JTWbMybs.js";
 import { LocalSkillSource } from "@mastra/core/workspace";
 //#region src/server/handlers/stored-skills.ts
 /**

package/dist/server/handlers/tool-schema-overrides.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/server/handlers/tool-schema-overrides.ts
+/**
+* Core's `CoreToolBuilder` injects runtime-only override fields into tool input
+* schemas (`_background` for background execution, `suspendedToolRunId` /
+* `resumeData` for resumable tools). Those fields are meant for the LLM tool-call
+* protocol, not for humans filling in a tool-execution form, so we strip them
+* from serialized input schemas returned by the API.
+*
+* `suspendedToolRunId` / `resumeData` are only removed when their description
+* matches the exact injected shape, so a user-authored field with the same name
+* is preserved.
+*/
+const INJECTED_OVERRIDE_DESCRIPTIONS = {
+	suspendedToolRunId: "The runId of the suspended tool",
+	resumeData: "The resumeData object created from the resumeSchema of suspended tool"
+};
+function stripInjectedToolOverrideFields(jsonSchema) {
+	if (!jsonSchema || typeof jsonSchema !== "object" || Array.isArray(jsonSchema)) return jsonSchema;
+	const schema = jsonSchema;
+	if (!schema.properties || typeof schema.properties !== "object") return jsonSchema;
+	const properties = { ...schema.properties };
+	let changed = false;
+	if ("_background" in properties) {
+		delete properties._background;
+		changed = true;
+	}
+	for (const [key, description] of Object.entries(INJECTED_OVERRIDE_DESCRIPTIONS)) {
+		const prop = properties[key];
+		if (prop && typeof prop === "object" && prop.description === description) {
+			delete properties[key];
+			changed = true;
+		}
+	}
+	if (!changed) return jsonSchema;
+	const required = Array.isArray(schema.required) ? schema.required.filter((key) => key in properties) : schema.required;
+	return {
+		...jsonSchema,
+		properties,
+		...required !== void 0 ? { required } : {}
+	};
+}
+//#endregion
+exports.stripInjectedToolOverrideFields = stripInjectedToolOverrideFields;
+
+//# sourceMappingURL=tool-schema-overrides.cjs.map

package/dist/server/handlers/tool-schema-overrides.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-overrides.cjs","names":[],"sources":["../../../src/server/handlers/tool-schema-overrides.ts"],"sourcesContent":["/**\n * Core's `CoreToolBuilder` injects runtime-only override fields into tool input\n * schemas (`_background` for background execution, `suspendedToolRunId` /\n * `resumeData` for resumable tools). Those fields are meant for the LLM tool-call\n * protocol, not for humans filling in a tool-execution form, so we strip them\n * from serialized input schemas returned by the API.\n *\n * `suspendedToolRunId` / `resumeData` are only removed when their description\n * matches the exact injected shape, so a user-authored field with the same name\n * is preserved.\n */\n\nconst INJECTED_OVERRIDE_DESCRIPTIONS: Record<string, string> = {\n  suspendedToolRunId: 'The runId of the suspended tool',\n  resumeData: 'The resumeData object created from the resumeSchema of suspended tool',\n};\n\nexport function stripInjectedToolOverrideFields<T>(jsonSchema: T): T {\n  if (!jsonSchema || typeof jsonSchema !== 'object' || Array.isArray(jsonSchema)) return jsonSchema;\n  const schema = jsonSchema as { properties?: Record<string, unknown>; required?: unknown };\n  if (!schema.properties || typeof schema.properties !== 'object') return jsonSchema;\n\n  const properties = { ...schema.properties };\n  let changed = false;\n\n  if ('_background' in properties) {\n    delete properties._background;\n    changed = true;\n  }\n\n  for (const [key, description] of Object.entries(INJECTED_OVERRIDE_DESCRIPTIONS)) {\n    const prop = properties[key];\n    if (prop && typeof prop === 'object' && (prop as { description?: string }).description === description) {\n      delete properties[key];\n      changed = true;\n    }\n  }\n\n  if (!changed) return jsonSchema;\n\n  const required = Array.isArray(schema.required) ? schema.required.filter(key => key in properties) : schema.required;\n\n  return { ...jsonSchema, properties, ...(required !== undefined ? { required } : {}) };\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAM,iCAAyD;CAC7D,oBAAoB;CACpB,YAAY;AACd;AAEA,SAAgB,gCAAmC,YAAkB;CACnE,IAAI,CAAC,cAAc,OAAO,eAAe,YAAY,MAAM,QAAQ,UAAU,GAAG,OAAO;CACvF,MAAM,SAAS;CACf,IAAI,CAAC,OAAO,cAAc,OAAO,OAAO,eAAe,UAAU,OAAO;CAExE,MAAM,aAAa,EAAE,GAAG,OAAO,WAAW;CAC1C,IAAI,UAAU;CAEd,IAAI,iBAAiB,YAAY;EAC/B,OAAO,WAAW;EAClB,UAAU;CACZ;CAEA,KAAK,MAAM,CAAC,KAAK,gBAAgB,OAAO,QAAQ,8BAA8B,GAAG;EAC/E,MAAM,OAAO,WAAW;EACxB,IAAI,QAAQ,OAAO,SAAS,YAAa,KAAkC,gBAAgB,aAAa;GACtG,OAAO,WAAW;GAClB,UAAU;EACZ;CACF;CAEA,IAAI,CAAC,SAAS,OAAO;CAErB,MAAM,WAAW,MAAM,QAAQ,OAAO,QAAQ,IAAI,OAAO,SAAS,QAAO,QAAO,OAAO,UAAU,IAAI,OAAO;CAE5G,OAAO;EAAE,GAAG;EAAY;EAAY,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;CAAG;AACtF"}

package/dist/server/handlers/tool-schema-overrides.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Core's `CoreToolBuilder` injects runtime-only override fields into tool input
+ * schemas (`_background` for background execution, `suspendedToolRunId` /
+ * `resumeData` for resumable tools). Those fields are meant for the LLM tool-call
+ * protocol, not for humans filling in a tool-execution form, so we strip them
+ * from serialized input schemas returned by the API.
+ *
+ * `suspendedToolRunId` / `resumeData` are only removed when their description
+ * matches the exact injected shape, so a user-authored field with the same name
+ * is preserved.
+ */
+export declare function stripInjectedToolOverrideFields<T>(jsonSchema: T): T;
+//# sourceMappingURL=tool-schema-overrides.d.ts.map

package/dist/server/handlers/tool-schema-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-overrides.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/tool-schema-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,wBAAgB,+BAA+B,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CA0BnE"}

package/dist/server/handlers/tool-schema-overrides.js

@@ -0,0 +1,45 @@
+//#region src/server/handlers/tool-schema-overrides.ts
+/**
+* Core's `CoreToolBuilder` injects runtime-only override fields into tool input
+* schemas (`_background` for background execution, `suspendedToolRunId` /
+* `resumeData` for resumable tools). Those fields are meant for the LLM tool-call
+* protocol, not for humans filling in a tool-execution form, so we strip them
+* from serialized input schemas returned by the API.
+*
+* `suspendedToolRunId` / `resumeData` are only removed when their description
+* matches the exact injected shape, so a user-authored field with the same name
+* is preserved.
+*/
+const INJECTED_OVERRIDE_DESCRIPTIONS = {
+	suspendedToolRunId: "The runId of the suspended tool",
+	resumeData: "The resumeData object created from the resumeSchema of suspended tool"
+};
+function stripInjectedToolOverrideFields(jsonSchema) {
+	if (!jsonSchema || typeof jsonSchema !== "object" || Array.isArray(jsonSchema)) return jsonSchema;
+	const schema = jsonSchema;
+	if (!schema.properties || typeof schema.properties !== "object") return jsonSchema;
+	const properties = { ...schema.properties };
+	let changed = false;
+	if ("_background" in properties) {
+		delete properties._background;
+		changed = true;
+	}
+	for (const [key, description] of Object.entries(INJECTED_OVERRIDE_DESCRIPTIONS)) {
+		const prop = properties[key];
+		if (prop && typeof prop === "object" && prop.description === description) {
+			delete properties[key];
+			changed = true;
+		}
+	}
+	if (!changed) return jsonSchema;
+	const required = Array.isArray(schema.required) ? schema.required.filter((key) => key in properties) : schema.required;
+	return {
+		...jsonSchema,
+		properties,
+		...required !== void 0 ? { required } : {}
+	};
+}
+//#endregion
+export { stripInjectedToolOverrideFields };
+
+//# sourceMappingURL=tool-schema-overrides.js.map

package/dist/server/handlers/tool-schema-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-overrides.js","names":[],"sources":["../../../src/server/handlers/tool-schema-overrides.ts"],"sourcesContent":["/**\n * Core's `CoreToolBuilder` injects runtime-only override fields into tool input\n * schemas (`_background` for background execution, `suspendedToolRunId` /\n * `resumeData` for resumable tools). Those fields are meant for the LLM tool-call\n * protocol, not for humans filling in a tool-execution form, so we strip them\n * from serialized input schemas returned by the API.\n *\n * `suspendedToolRunId` / `resumeData` are only removed when their description\n * matches the exact injected shape, so a user-authored field with the same name\n * is preserved.\n */\n\nconst INJECTED_OVERRIDE_DESCRIPTIONS: Record<string, string> = {\n  suspendedToolRunId: 'The runId of the suspended tool',\n  resumeData: 'The resumeData object created from the resumeSchema of suspended tool',\n};\n\nexport function stripInjectedToolOverrideFields<T>(jsonSchema: T): T {\n  if (!jsonSchema || typeof jsonSchema !== 'object' || Array.isArray(jsonSchema)) return jsonSchema;\n  const schema = jsonSchema as { properties?: Record<string, unknown>; required?: unknown };\n  if (!schema.properties || typeof schema.properties !== 'object') return jsonSchema;\n\n  const properties = { ...schema.properties };\n  let changed = false;\n\n  if ('_background' in properties) {\n    delete properties._background;\n    changed = true;\n  }\n\n  for (const [key, description] of Object.entries(INJECTED_OVERRIDE_DESCRIPTIONS)) {\n    const prop = properties[key];\n    if (prop && typeof prop === 'object' && (prop as { description?: string }).description === description) {\n      delete properties[key];\n      changed = true;\n    }\n  }\n\n  if (!changed) return jsonSchema;\n\n  const required = Array.isArray(schema.required) ? schema.required.filter(key => key in properties) : schema.required;\n\n  return { ...jsonSchema, properties, ...(required !== undefined ? { required } : {}) };\n}\n"],"mappings":";;;;;;;;;;;;AAYA,MAAM,iCAAyD;CAC7D,oBAAoB;CACpB,YAAY;AACd;AAEA,SAAgB,gCAAmC,YAAkB;CACnE,IAAI,CAAC,cAAc,OAAO,eAAe,YAAY,MAAM,QAAQ,UAAU,GAAG,OAAO;CACvF,MAAM,SAAS;CACf,IAAI,CAAC,OAAO,cAAc,OAAO,OAAO,eAAe,UAAU,OAAO;CAExE,MAAM,aAAa,EAAE,GAAG,OAAO,WAAW;CAC1C,IAAI,UAAU;CAEd,IAAI,iBAAiB,YAAY;EAC/B,OAAO,WAAW;EAClB,UAAU;CACZ;CAEA,KAAK,MAAM,CAAC,KAAK,gBAAgB,OAAO,QAAQ,8BAA8B,GAAG;EAC/E,MAAM,OAAO,WAAW;EACxB,IAAI,QAAQ,OAAO,SAAS,YAAa,KAAkC,gBAAgB,aAAa;GACtG,OAAO,WAAW;GAClB,UAAU;EACZ;CACF;CAEA,IAAI,CAAC,SAAS,OAAO;CAErB,MAAM,WAAW,MAAM,QAAQ,OAAO,QAAQ,IAAI,OAAO,SAAS,QAAO,QAAO,OAAO,UAAU,IAAI,OAAO;CAE5G,OAAO;EAAE,GAAG;EAAY;EAAY,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;CAAG;AACtF"}

package/dist/server/handlers/tools.cjs

@@ -9,6 +9,7 @@ require("../../schema-DkBbires.cjs");
 const require_utils = require("../../utils-Bna_JCkb.cjs");
 const require_server_handlers_error = require("./error.cjs");
 const require_utils$1 = require("../../utils-wTwyTjg3.cjs");
+const require_server_handlers_tool_schema_overrides = require("./tool-schema-overrides.cjs");
 const require_server_handlers_agents = require("./agents.cjs");
 let _mastra_core_tools = require("@mastra/core/tools");
 //#region src/server/handlers/tools.ts
@@ -33,10 +34,10 @@ function schemaToJsonSchema(schema) {
 	if (!schema) return;
 	return require_schema_Bv9OdW1f.standardSchemaToJSONSchema(require_schema_Bv9OdW1f.toStandardSchema(schema), { target: "draft-2020-12" });
 }
-function serializeSchema(schema) {
+function serializeSchema(schema, options) {
 	const jsonSchema = schemaToJsonSchema(resolveLazySchema(schema));
 	if (jsonSchema === void 0) return void 0;
-	return require_utils.stringify(jsonSchema);
+	return require_utils.stringify(options?.stripInjectedOverrides ? require_server_handlers_tool_schema_overrides.stripInjectedToolOverrideFields(jsonSchema) : jsonSchema);
 }
 /**
 * Searches dynamically-resolved agent tools (provided via `toolsResolver` /
@@ -77,7 +78,7 @@ function serializeTool(tool) {
 	}
 	return {
 		...tool,
-		inputSchema: serializeSchema(tool.inputSchema),
+		inputSchema: serializeSchema(tool.inputSchema, { stripInjectedOverrides: true }),
 		outputSchema: serializeSchema(tool.outputSchema),
 		requestContextSchema: serializeSchema(tool.requestContextSchema)
 	};

package/dist/server/handlers/tools.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tools.cjs","names":["standardSchemaToJSONSchema","toStandardSchema","stringify","createRoute","listToolsResponseSchema","MastraFGAPermissions","handleError","toolIdPathParams","serializedToolSchema","HTTPException","optionalRunIdSchema","executeToolContextBodySchema","executeToolResponseSchema","agentToolPathParams","getAgentFromSystem","executeToolBodySchema"],"sources":["../../../src/server/handlers/tools.ts"],"sourcesContent":["import { isVercelTool, isProviderDefinedTool } from '@mastra/core/tools';\nimport { toStandardSchema, standardSchemaToJSONSchema } from '@mastra/schema-compat/schema';\nimport type { PublicSchema } from '@mastra/schema-compat/schema';\nimport { stringify } from 'superjson';\nimport { MastraFGAPermissions } from '../fga-permissions';\nimport { HTTPException } from '../http-exception';\nimport {\n  executeToolContextBodySchema,\n  executeToolResponseSchema,\n  listToolsResponseSchema,\n  serializedToolSchema,\n  toolIdPathParams,\n  agentToolPathParams,\n  executeToolBodySchema,\n} from '../schemas/agents';\nimport { optionalRunIdSchema } from '../schemas/common';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { getAgentFromSystem } from './agents';\nimport { handleError } from './error';\nimport { validateBody } from './utils';\n\n/**\n * Resolves a schema that may be a lazy function (e.g. AI SDK provider tools).\n * Recursively resolves until a non-function value is returned.\n * Skips functions that are themselves valid schemas (e.g. ArkType types are\n * callable but also implement StandardSchema via ~standard).\n */\nfunction resolveLazySchema(schema: unknown): unknown {\n  if (typeof schema === 'function' && !('~standard' in schema)) {\n    return resolveLazySchema(schema());\n  }\n  return schema;\n}\n\nfunction schemaToJsonSchema(schema: PublicSchema<unknown> | undefined) {\n  if (!schema) {\n    return undefined;\n  }\n\n  return standardSchemaToJSONSchema(toStandardSchema(schema), { target: 'draft-2020-12' });\n}\n\nfunction serializeSchema(schema: unknown): string | undefined {\n  const jsonSchema = schemaToJsonSchema(resolveLazySchema(schema) as PublicSchema<unknown> | undefined);\n  if (jsonSchema === undefined) return undefined;\n  return stringify(jsonSchema);\n}\n\n/**\n * Searches dynamically-resolved agent tools (provided via `toolsResolver` /\n * function-based `tools`) for a tool with the given id. Used as a fallback\n * after the static tool registry (`registeredTools` + `mastra.getToolById`)\n * misses, so global tool routes can resolve tools that only exist on agents.\n *\n * Errors thrown by an individual agent's `listTools()` are logged and\n * skipped so a single broken resolver doesn't take down the whole lookup.\n */\nasync function findToolInAgents(mastra: any, toolId: string, requestContext: any): Promise<any | undefined> {\n  const agents = mastra.listAgents() || {};\n  for (const agent of Object.values(agents) as any[]) {\n    try {\n      const agentTools = await agent.listTools({ requestContext });\n      const found = Object.values(agentTools || {}).find((t: any) => t.id === toolId);\n      if (found) return found;\n    } catch (error) {\n      mastra.getLogger?.()?.warn?.('Failed to list tools for agent while resolving tool by id', {\n        agentId: agent?.id,\n        toolId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return undefined;\n}\n\n/**\n * Serializes a tool for API responses, handling both regular tools (with Zod schemas)\n * and provider-defined tools (with AI SDK lazy schemas).\n */\nfunction serializeTool(tool: any): any {\n  // Provider-defined tools (e.g. google.tools.googleSearch(), openai.tools.webSearch())\n  // have lazy inputSchema functions that return AI SDK Schema objects, not Zod schemas.\n  // We resolve them and use the jsonSchema property directly.\n  if (isProviderDefinedTool(tool)) {\n    const resolvedInput = resolveLazySchema(tool.inputSchema);\n    const resolvedOutput = resolveLazySchema(tool.outputSchema);\n    return {\n      ...tool,\n      inputSchema:\n        resolvedInput && typeof resolvedInput === 'object' && 'jsonSchema' in resolvedInput\n          ? stringify(resolvedInput.jsonSchema)\n          : undefined,\n      outputSchema:\n        resolvedOutput && typeof resolvedOutput === 'object' && 'jsonSchema' in resolvedOutput\n          ? stringify(resolvedOutput.jsonSchema)\n          : undefined,\n    };\n  }\n\n  return {\n    ...tool,\n    inputSchema: serializeSchema(tool.inputSchema),\n    outputSchema: serializeSchema(tool.outputSchema),\n    requestContextSchema: serializeSchema(tool.requestContextSchema),\n  };\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nexport const LIST_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools',\n  responseType: 'json',\n  responseSchema: listToolsResponseSchema,\n  summary: 'List all tools',\n  description: 'Returns a list of all available tools in the system',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, requestContext }) => {\n    try {\n      // Merge tools from two sources: mastra.listTools() includes dynamically created tools\n      // (e.g. MCP tools, or agent tools registered by their intrinsic id), while registeredTools\n      // includes tools discovered by the CLI bundler (keyed by export name).\n      //\n      // The same tool instance can appear in both maps under different keys (e.g. an agent\n      // registers it by `tool.id` while the bundler registers it by export name). Dedupe by\n      // `tool.id`, preferring the registeredTools (bundler) key, so each tool appears once.\n      const registered = registeredTools && Object.keys(registeredTools).length > 0 ? registeredTools : {};\n\n      const allTools: Record<string, any> = {};\n      const seenToolIds = new Map<string, string>();\n\n      // registeredTools first so their key wins for a given tool.id.\n      for (const [key, tool] of Object.entries(registered)) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      for (const [key, tool] of Object.entries(mastra.listTools() ?? {})) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        // Skip if this exact tool.id was already registered (under any key) by registeredTools.\n        if (toolId !== undefined && seenToolIds.has(toolId)) continue;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      const serializedTools = Object.entries(allTools).reduce(\n        (acc, [id, _tool]) => {\n          acc[id] = serializeTool(_tool);\n          return acc;\n        },\n        {} as Record<string, any>,\n      );\n\n      // Filter tools by FGA if configured\n      const fgaProvider = mastra.getServer?.()?.fga;\n      const user = requestContext?.get('user');\n      if (fgaProvider && user) {\n        const toolList = Object.entries(serializedTools).map(([id, t]) => ({ id, ...t }));\n        const accessible = await fgaProvider.filterAccessible(user, toolList, 'tool', MastraFGAPermissions.TOOLS_READ);\n        const accessibleSet = new Set(accessible.map((t: any) => t.id));\n        for (const id of Object.keys(serializedTools)) {\n          if (!accessibleSet.has(id)) {\n            delete serializedTools[id];\n          }\n        }\n      }\n\n      return serializedTools;\n    } catch (error) {\n      return handleError(error, 'Error getting tools');\n    }\n  },\n});\n\nexport const GET_TOOL_BY_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get tool by ID',\n  description: 'Returns details for a specific tool including its schema and configuration',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, toolId, requestContext }) => {\n    try {\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting tool');\n    }\n  },\n});\n\nexport const EXECUTE_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  queryParamSchema: optionalRunIdSchema,\n  bodySchema: executeToolContextBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute tool',\n  description: 'Executes a specific tool with the provided input data',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, runId, toolId, registeredTools, requestContext, ...bodyParams }) => {\n    try {\n      if (!toolId) {\n        throw new HTTPException(400, { message: 'Tool ID is required' });\n      }\n\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const { data } = bodyParams;\n\n      validateBody({ data });\n\n      let result;\n      if (isVercelTool(tool)) {\n        result = await (tool as any).execute(data);\n      } else {\n        result = await tool.execute(data!, {\n          mastra,\n          requestContext,\n          // TODO: Pass proper tracing context when server API supports tracing\n          tracingContext: { currentSpan: undefined },\n          ...(runId\n            ? {\n                workflow: {\n                  runId,\n                  suspend: async () => {},\n                },\n              }\n            : {}),\n        });\n      }\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing tool');\n    }\n  },\n});\n\n// ============================================================================\n// Agent Tool Routes\n// ============================================================================\n\nexport const GET_AGENT_TOOL_ROUTE = createRoute({\n  method: 'GET',\n  path: '/agents/:agentId/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get agent tool',\n  description: 'Returns details for a specific tool assigned to the agent',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting agent tool');\n    }\n  },\n});\n\nexport const EXECUTE_AGENT_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/agents/:agentId/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  bodySchema: executeToolBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute agent tool',\n  description: 'Executes a specific tool assigned to the agent with the provided input data',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, data, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const result = await tool.execute(data, {\n        mastra,\n        requestContext,\n        // TODO: Pass proper tracing context when server API supports tracing\n        tracingContext: { currentSpan: undefined },\n      });\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing agent tool');\n    }\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"tools.cjs","names":["standardSchemaToJSONSchema","toStandardSchema","stringify","stripInjectedToolOverrideFields","createRoute","listToolsResponseSchema","MastraFGAPermissions","handleError","toolIdPathParams","serializedToolSchema","HTTPException","optionalRunIdSchema","executeToolContextBodySchema","executeToolResponseSchema","agentToolPathParams","getAgentFromSystem","executeToolBodySchema"],"sources":["../../../src/server/handlers/tools.ts"],"sourcesContent":["import { isVercelTool, isProviderDefinedTool } from '@mastra/core/tools';\nimport { toStandardSchema, standardSchemaToJSONSchema } from '@mastra/schema-compat/schema';\nimport type { PublicSchema } from '@mastra/schema-compat/schema';\nimport { stringify } from 'superjson';\nimport { MastraFGAPermissions } from '../fga-permissions';\nimport { HTTPException } from '../http-exception';\nimport {\n  executeToolContextBodySchema,\n  executeToolResponseSchema,\n  listToolsResponseSchema,\n  serializedToolSchema,\n  toolIdPathParams,\n  agentToolPathParams,\n  executeToolBodySchema,\n} from '../schemas/agents';\nimport { optionalRunIdSchema } from '../schemas/common';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { getAgentFromSystem } from './agents';\nimport { handleError } from './error';\nimport { stripInjectedToolOverrideFields } from './tool-schema-overrides';\nimport { validateBody } from './utils';\n\n/**\n * Resolves a schema that may be a lazy function (e.g. AI SDK provider tools).\n * Recursively resolves until a non-function value is returned.\n * Skips functions that are themselves valid schemas (e.g. ArkType types are\n * callable but also implement StandardSchema via ~standard).\n */\nfunction resolveLazySchema(schema: unknown): unknown {\n  if (typeof schema === 'function' && !('~standard' in schema)) {\n    return resolveLazySchema(schema());\n  }\n  return schema;\n}\n\nfunction schemaToJsonSchema(schema: PublicSchema<unknown> | undefined) {\n  if (!schema) {\n    return undefined;\n  }\n\n  return standardSchemaToJSONSchema(toStandardSchema(schema), { target: 'draft-2020-12' });\n}\n\nfunction serializeSchema(schema: unknown, options?: { stripInjectedOverrides?: boolean }): string | undefined {\n  const jsonSchema = schemaToJsonSchema(resolveLazySchema(schema) as PublicSchema<unknown> | undefined);\n  if (jsonSchema === undefined) return undefined;\n  return stringify(options?.stripInjectedOverrides ? stripInjectedToolOverrideFields(jsonSchema) : jsonSchema);\n}\n\n/**\n * Searches dynamically-resolved agent tools (provided via `toolsResolver` /\n * function-based `tools`) for a tool with the given id. Used as a fallback\n * after the static tool registry (`registeredTools` + `mastra.getToolById`)\n * misses, so global tool routes can resolve tools that only exist on agents.\n *\n * Errors thrown by an individual agent's `listTools()` are logged and\n * skipped so a single broken resolver doesn't take down the whole lookup.\n */\nasync function findToolInAgents(mastra: any, toolId: string, requestContext: any): Promise<any | undefined> {\n  const agents = mastra.listAgents() || {};\n  for (const agent of Object.values(agents) as any[]) {\n    try {\n      const agentTools = await agent.listTools({ requestContext });\n      const found = Object.values(agentTools || {}).find((t: any) => t.id === toolId);\n      if (found) return found;\n    } catch (error) {\n      mastra.getLogger?.()?.warn?.('Failed to list tools for agent while resolving tool by id', {\n        agentId: agent?.id,\n        toolId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return undefined;\n}\n\n/**\n * Serializes a tool for API responses, handling both regular tools (with Zod schemas)\n * and provider-defined tools (with AI SDK lazy schemas).\n */\nfunction serializeTool(tool: any): any {\n  // Provider-defined tools (e.g. google.tools.googleSearch(), openai.tools.webSearch())\n  // have lazy inputSchema functions that return AI SDK Schema objects, not Zod schemas.\n  // We resolve them and use the jsonSchema property directly.\n  if (isProviderDefinedTool(tool)) {\n    const resolvedInput = resolveLazySchema(tool.inputSchema);\n    const resolvedOutput = resolveLazySchema(tool.outputSchema);\n    return {\n      ...tool,\n      inputSchema:\n        resolvedInput && typeof resolvedInput === 'object' && 'jsonSchema' in resolvedInput\n          ? stringify(resolvedInput.jsonSchema)\n          : undefined,\n      outputSchema:\n        resolvedOutput && typeof resolvedOutput === 'object' && 'jsonSchema' in resolvedOutput\n          ? stringify(resolvedOutput.jsonSchema)\n          : undefined,\n    };\n  }\n\n  return {\n    ...tool,\n    inputSchema: serializeSchema(tool.inputSchema, { stripInjectedOverrides: true }),\n    outputSchema: serializeSchema(tool.outputSchema),\n    requestContextSchema: serializeSchema(tool.requestContextSchema),\n  };\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nexport const LIST_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools',\n  responseType: 'json',\n  responseSchema: listToolsResponseSchema,\n  summary: 'List all tools',\n  description: 'Returns a list of all available tools in the system',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, requestContext }) => {\n    try {\n      // Merge tools from two sources: mastra.listTools() includes dynamically created tools\n      // (e.g. MCP tools, or agent tools registered by their intrinsic id), while registeredTools\n      // includes tools discovered by the CLI bundler (keyed by export name).\n      //\n      // The same tool instance can appear in both maps under different keys (e.g. an agent\n      // registers it by `tool.id` while the bundler registers it by export name). Dedupe by\n      // `tool.id`, preferring the registeredTools (bundler) key, so each tool appears once.\n      const registered = registeredTools && Object.keys(registeredTools).length > 0 ? registeredTools : {};\n\n      const allTools: Record<string, any> = {};\n      const seenToolIds = new Map<string, string>();\n\n      // registeredTools first so their key wins for a given tool.id.\n      for (const [key, tool] of Object.entries(registered)) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      for (const [key, tool] of Object.entries(mastra.listTools() ?? {})) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        // Skip if this exact tool.id was already registered (under any key) by registeredTools.\n        if (toolId !== undefined && seenToolIds.has(toolId)) continue;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      const serializedTools = Object.entries(allTools).reduce(\n        (acc, [id, _tool]) => {\n          acc[id] = serializeTool(_tool);\n          return acc;\n        },\n        {} as Record<string, any>,\n      );\n\n      // Filter tools by FGA if configured\n      const fgaProvider = mastra.getServer?.()?.fga;\n      const user = requestContext?.get('user');\n      if (fgaProvider && user) {\n        const toolList = Object.entries(serializedTools).map(([id, t]) => ({ id, ...t }));\n        const accessible = await fgaProvider.filterAccessible(user, toolList, 'tool', MastraFGAPermissions.TOOLS_READ);\n        const accessibleSet = new Set(accessible.map((t: any) => t.id));\n        for (const id of Object.keys(serializedTools)) {\n          if (!accessibleSet.has(id)) {\n            delete serializedTools[id];\n          }\n        }\n      }\n\n      return serializedTools;\n    } catch (error) {\n      return handleError(error, 'Error getting tools');\n    }\n  },\n});\n\nexport const GET_TOOL_BY_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get tool by ID',\n  description: 'Returns details for a specific tool including its schema and configuration',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, toolId, requestContext }) => {\n    try {\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting tool');\n    }\n  },\n});\n\nexport const EXECUTE_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  queryParamSchema: optionalRunIdSchema,\n  bodySchema: executeToolContextBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute tool',\n  description: 'Executes a specific tool with the provided input data',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, runId, toolId, registeredTools, requestContext, ...bodyParams }) => {\n    try {\n      if (!toolId) {\n        throw new HTTPException(400, { message: 'Tool ID is required' });\n      }\n\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const { data } = bodyParams;\n\n      validateBody({ data });\n\n      let result;\n      if (isVercelTool(tool)) {\n        result = await (tool as any).execute(data);\n      } else {\n        result = await tool.execute(data!, {\n          mastra,\n          requestContext,\n          // TODO: Pass proper tracing context when server API supports tracing\n          tracingContext: { currentSpan: undefined },\n          ...(runId\n            ? {\n                workflow: {\n                  runId,\n                  suspend: async () => {},\n                },\n              }\n            : {}),\n        });\n      }\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing tool');\n    }\n  },\n});\n\n// ============================================================================\n// Agent Tool Routes\n// ============================================================================\n\nexport const GET_AGENT_TOOL_ROUTE = createRoute({\n  method: 'GET',\n  path: '/agents/:agentId/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get agent tool',\n  description: 'Returns details for a specific tool assigned to the agent',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting agent tool');\n    }\n  },\n});\n\nexport const EXECUTE_AGENT_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/agents/:agentId/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  bodySchema: executeToolBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute agent tool',\n  description: 'Executes a specific tool assigned to the agent with the provided input data',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, data, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const result = await tool.execute(data, {\n        mastra,\n        requestContext,\n        // TODO: Pass proper tracing context when server API supports tracing\n        tracingContext: { currentSpan: undefined },\n      });\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing agent tool');\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/server/handlers/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/tools.ts"],"names":[],"mappings":"AAgHA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE3B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0E7B,CAAC;AAMH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CnC,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/tools.ts"],"names":[],"mappings":"AAiHA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE3B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0E7B,CAAC;AAMH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CnC,CAAC"}

package/dist/server/handlers/tools.js

@@ -8,6 +8,7 @@ import "../../schema-CGeYTFwm.js";
 import { l as stringify } from "../../utils-QXKhjIm6.js";
 import { handleError } from "./error.js";
 import { c as validateBody, d as MastraFGAPermissions } from "../../utils-CmHd1Sgh.js";
+import { stripInjectedToolOverrideFields } from "./tool-schema-overrides.js";
 import { getAgentFromSystem } from "./agents.js";
 import { isProviderDefinedTool, isVercelTool } from "@mastra/core/tools";
 //#region src/server/handlers/tools.ts
@@ -32,10 +33,10 @@ function schemaToJsonSchema(schema) {
 	if (!schema) return;
 	return standardSchemaToJSONSchema(toStandardSchema(schema), { target: "draft-2020-12" });
 }
-function serializeSchema(schema) {
+function serializeSchema(schema, options) {
 	const jsonSchema = schemaToJsonSchema(resolveLazySchema(schema));
 	if (jsonSchema === void 0) return void 0;
-	return stringify(jsonSchema);
+	return stringify(options?.stripInjectedOverrides ? stripInjectedToolOverrideFields(jsonSchema) : jsonSchema);
 }
 /**
 * Searches dynamically-resolved agent tools (provided via `toolsResolver` /
@@ -76,7 +77,7 @@ function serializeTool(tool) {
 	}
 	return {
 		...tool,
-		inputSchema: serializeSchema(tool.inputSchema),
+		inputSchema: serializeSchema(tool.inputSchema, { stripInjectedOverrides: true }),
 		outputSchema: serializeSchema(tool.outputSchema),
 		requestContextSchema: serializeSchema(tool.requestContextSchema)
 	};

package/dist/server/handlers/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","names":[],"sources":["../../../src/server/handlers/tools.ts"],"sourcesContent":["import { isVercelTool, isProviderDefinedTool } from '@mastra/core/tools';\nimport { toStandardSchema, standardSchemaToJSONSchema } from '@mastra/schema-compat/schema';\nimport type { PublicSchema } from '@mastra/schema-compat/schema';\nimport { stringify } from 'superjson';\nimport { MastraFGAPermissions } from '../fga-permissions';\nimport { HTTPException } from '../http-exception';\nimport {\n  executeToolContextBodySchema,\n  executeToolResponseSchema,\n  listToolsResponseSchema,\n  serializedToolSchema,\n  toolIdPathParams,\n  agentToolPathParams,\n  executeToolBodySchema,\n} from '../schemas/agents';\nimport { optionalRunIdSchema } from '../schemas/common';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { getAgentFromSystem } from './agents';\nimport { handleError } from './error';\nimport { validateBody } from './utils';\n\n/**\n * Resolves a schema that may be a lazy function (e.g. AI SDK provider tools).\n * Recursively resolves until a non-function value is returned.\n * Skips functions that are themselves valid schemas (e.g. ArkType types are\n * callable but also implement StandardSchema via ~standard).\n */\nfunction resolveLazySchema(schema: unknown): unknown {\n  if (typeof schema === 'function' && !('~standard' in schema)) {\n    return resolveLazySchema(schema());\n  }\n  return schema;\n}\n\nfunction schemaToJsonSchema(schema: PublicSchema<unknown> | undefined) {\n  if (!schema) {\n    return undefined;\n  }\n\n  return standardSchemaToJSONSchema(toStandardSchema(schema), { target: 'draft-2020-12' });\n}\n\nfunction serializeSchema(schema: unknown): string | undefined {\n  const jsonSchema = schemaToJsonSchema(resolveLazySchema(schema) as PublicSchema<unknown> | undefined);\n  if (jsonSchema === undefined) return undefined;\n  return stringify(jsonSchema);\n}\n\n/**\n * Searches dynamically-resolved agent tools (provided via `toolsResolver` /\n * function-based `tools`) for a tool with the given id. Used as a fallback\n * after the static tool registry (`registeredTools` + `mastra.getToolById`)\n * misses, so global tool routes can resolve tools that only exist on agents.\n *\n * Errors thrown by an individual agent's `listTools()` are logged and\n * skipped so a single broken resolver doesn't take down the whole lookup.\n */\nasync function findToolInAgents(mastra: any, toolId: string, requestContext: any): Promise<any | undefined> {\n  const agents = mastra.listAgents() || {};\n  for (const agent of Object.values(agents) as any[]) {\n    try {\n      const agentTools = await agent.listTools({ requestContext });\n      const found = Object.values(agentTools || {}).find((t: any) => t.id === toolId);\n      if (found) return found;\n    } catch (error) {\n      mastra.getLogger?.()?.warn?.('Failed to list tools for agent while resolving tool by id', {\n        agentId: agent?.id,\n        toolId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return undefined;\n}\n\n/**\n * Serializes a tool for API responses, handling both regular tools (with Zod schemas)\n * and provider-defined tools (with AI SDK lazy schemas).\n */\nfunction serializeTool(tool: any): any {\n  // Provider-defined tools (e.g. google.tools.googleSearch(), openai.tools.webSearch())\n  // have lazy inputSchema functions that return AI SDK Schema objects, not Zod schemas.\n  // We resolve them and use the jsonSchema property directly.\n  if (isProviderDefinedTool(tool)) {\n    const resolvedInput = resolveLazySchema(tool.inputSchema);\n    const resolvedOutput = resolveLazySchema(tool.outputSchema);\n    return {\n      ...tool,\n      inputSchema:\n        resolvedInput && typeof resolvedInput === 'object' && 'jsonSchema' in resolvedInput\n          ? stringify(resolvedInput.jsonSchema)\n          : undefined,\n      outputSchema:\n        resolvedOutput && typeof resolvedOutput === 'object' && 'jsonSchema' in resolvedOutput\n          ? stringify(resolvedOutput.jsonSchema)\n          : undefined,\n    };\n  }\n\n  return {\n    ...tool,\n    inputSchema: serializeSchema(tool.inputSchema),\n    outputSchema: serializeSchema(tool.outputSchema),\n    requestContextSchema: serializeSchema(tool.requestContextSchema),\n  };\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nexport const LIST_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools',\n  responseType: 'json',\n  responseSchema: listToolsResponseSchema,\n  summary: 'List all tools',\n  description: 'Returns a list of all available tools in the system',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, requestContext }) => {\n    try {\n      // Merge tools from two sources: mastra.listTools() includes dynamically created tools\n      // (e.g. MCP tools, or agent tools registered by their intrinsic id), while registeredTools\n      // includes tools discovered by the CLI bundler (keyed by export name).\n      //\n      // The same tool instance can appear in both maps under different keys (e.g. an agent\n      // registers it by `tool.id` while the bundler registers it by export name). Dedupe by\n      // `tool.id`, preferring the registeredTools (bundler) key, so each tool appears once.\n      const registered = registeredTools && Object.keys(registeredTools).length > 0 ? registeredTools : {};\n\n      const allTools: Record<string, any> = {};\n      const seenToolIds = new Map<string, string>();\n\n      // registeredTools first so their key wins for a given tool.id.\n      for (const [key, tool] of Object.entries(registered)) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      for (const [key, tool] of Object.entries(mastra.listTools() ?? {})) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        // Skip if this exact tool.id was already registered (under any key) by registeredTools.\n        if (toolId !== undefined && seenToolIds.has(toolId)) continue;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      const serializedTools = Object.entries(allTools).reduce(\n        (acc, [id, _tool]) => {\n          acc[id] = serializeTool(_tool);\n          return acc;\n        },\n        {} as Record<string, any>,\n      );\n\n      // Filter tools by FGA if configured\n      const fgaProvider = mastra.getServer?.()?.fga;\n      const user = requestContext?.get('user');\n      if (fgaProvider && user) {\n        const toolList = Object.entries(serializedTools).map(([id, t]) => ({ id, ...t }));\n        const accessible = await fgaProvider.filterAccessible(user, toolList, 'tool', MastraFGAPermissions.TOOLS_READ);\n        const accessibleSet = new Set(accessible.map((t: any) => t.id));\n        for (const id of Object.keys(serializedTools)) {\n          if (!accessibleSet.has(id)) {\n            delete serializedTools[id];\n          }\n        }\n      }\n\n      return serializedTools;\n    } catch (error) {\n      return handleError(error, 'Error getting tools');\n    }\n  },\n});\n\nexport const GET_TOOL_BY_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get tool by ID',\n  description: 'Returns details for a specific tool including its schema and configuration',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, toolId, requestContext }) => {\n    try {\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting tool');\n    }\n  },\n});\n\nexport const EXECUTE_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  queryParamSchema: optionalRunIdSchema,\n  bodySchema: executeToolContextBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute tool',\n  description: 'Executes a specific tool with the provided input data',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, runId, toolId, registeredTools, requestContext, ...bodyParams }) => {\n    try {\n      if (!toolId) {\n        throw new HTTPException(400, { message: 'Tool ID is required' });\n      }\n\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const { data } = bodyParams;\n\n      validateBody({ data });\n\n      let result;\n      if (isVercelTool(tool)) {\n        result = await (tool as any).execute(data);\n      } else {\n        result = await tool.execute(data!, {\n          mastra,\n          requestContext,\n          // TODO: Pass proper tracing context when server API supports tracing\n          tracingContext: { currentSpan: undefined },\n          ...(runId\n            ? {\n                workflow: {\n                  runId,\n                  suspend: async () => {},\n                },\n              }\n            : {}),\n        });\n      }\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing tool');\n    }\n  },\n});\n\n// ============================================================================\n// Agent Tool Routes\n// ============================================================================\n\nexport const GET_AGENT_TOOL_ROUTE = createRoute({\n  method: 'GET',\n  path: '/agents/:agentId/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get agent tool',\n  description: 'Returns details for a specific tool assigned to the agent',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting agent tool');\n    }\n  },\n});\n\nexport const EXECUTE_AGENT_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/agents/:agentId/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  bodySchema: executeToolBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute agent tool',\n  description: 'Executes a specific tool assigned to the agent with the provided input data',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, data, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const result = await tool.execute(data, {\n        mastra,\n        requestContext,\n        // TODO: Pass proper tracing context when server API supports tracing\n        tracingContext: { currentSpan: undefined },\n      });\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing agent tool');\n    }\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"tools.js","names":[],"sources":["../../../src/server/handlers/tools.ts"],"sourcesContent":["import { isVercelTool, isProviderDefinedTool } from '@mastra/core/tools';\nimport { toStandardSchema, standardSchemaToJSONSchema } from '@mastra/schema-compat/schema';\nimport type { PublicSchema } from '@mastra/schema-compat/schema';\nimport { stringify } from 'superjson';\nimport { MastraFGAPermissions } from '../fga-permissions';\nimport { HTTPException } from '../http-exception';\nimport {\n  executeToolContextBodySchema,\n  executeToolResponseSchema,\n  listToolsResponseSchema,\n  serializedToolSchema,\n  toolIdPathParams,\n  agentToolPathParams,\n  executeToolBodySchema,\n} from '../schemas/agents';\nimport { optionalRunIdSchema } from '../schemas/common';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { getAgentFromSystem } from './agents';\nimport { handleError } from './error';\nimport { stripInjectedToolOverrideFields } from './tool-schema-overrides';\nimport { validateBody } from './utils';\n\n/**\n * Resolves a schema that may be a lazy function (e.g. AI SDK provider tools).\n * Recursively resolves until a non-function value is returned.\n * Skips functions that are themselves valid schemas (e.g. ArkType types are\n * callable but also implement StandardSchema via ~standard).\n */\nfunction resolveLazySchema(schema: unknown): unknown {\n  if (typeof schema === 'function' && !('~standard' in schema)) {\n    return resolveLazySchema(schema());\n  }\n  return schema;\n}\n\nfunction schemaToJsonSchema(schema: PublicSchema<unknown> | undefined) {\n  if (!schema) {\n    return undefined;\n  }\n\n  return standardSchemaToJSONSchema(toStandardSchema(schema), { target: 'draft-2020-12' });\n}\n\nfunction serializeSchema(schema: unknown, options?: { stripInjectedOverrides?: boolean }): string | undefined {\n  const jsonSchema = schemaToJsonSchema(resolveLazySchema(schema) as PublicSchema<unknown> | undefined);\n  if (jsonSchema === undefined) return undefined;\n  return stringify(options?.stripInjectedOverrides ? stripInjectedToolOverrideFields(jsonSchema) : jsonSchema);\n}\n\n/**\n * Searches dynamically-resolved agent tools (provided via `toolsResolver` /\n * function-based `tools`) for a tool with the given id. Used as a fallback\n * after the static tool registry (`registeredTools` + `mastra.getToolById`)\n * misses, so global tool routes can resolve tools that only exist on agents.\n *\n * Errors thrown by an individual agent's `listTools()` are logged and\n * skipped so a single broken resolver doesn't take down the whole lookup.\n */\nasync function findToolInAgents(mastra: any, toolId: string, requestContext: any): Promise<any | undefined> {\n  const agents = mastra.listAgents() || {};\n  for (const agent of Object.values(agents) as any[]) {\n    try {\n      const agentTools = await agent.listTools({ requestContext });\n      const found = Object.values(agentTools || {}).find((t: any) => t.id === toolId);\n      if (found) return found;\n    } catch (error) {\n      mastra.getLogger?.()?.warn?.('Failed to list tools for agent while resolving tool by id', {\n        agentId: agent?.id,\n        toolId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return undefined;\n}\n\n/**\n * Serializes a tool for API responses, handling both regular tools (with Zod schemas)\n * and provider-defined tools (with AI SDK lazy schemas).\n */\nfunction serializeTool(tool: any): any {\n  // Provider-defined tools (e.g. google.tools.googleSearch(), openai.tools.webSearch())\n  // have lazy inputSchema functions that return AI SDK Schema objects, not Zod schemas.\n  // We resolve them and use the jsonSchema property directly.\n  if (isProviderDefinedTool(tool)) {\n    const resolvedInput = resolveLazySchema(tool.inputSchema);\n    const resolvedOutput = resolveLazySchema(tool.outputSchema);\n    return {\n      ...tool,\n      inputSchema:\n        resolvedInput && typeof resolvedInput === 'object' && 'jsonSchema' in resolvedInput\n          ? stringify(resolvedInput.jsonSchema)\n          : undefined,\n      outputSchema:\n        resolvedOutput && typeof resolvedOutput === 'object' && 'jsonSchema' in resolvedOutput\n          ? stringify(resolvedOutput.jsonSchema)\n          : undefined,\n    };\n  }\n\n  return {\n    ...tool,\n    inputSchema: serializeSchema(tool.inputSchema, { stripInjectedOverrides: true }),\n    outputSchema: serializeSchema(tool.outputSchema),\n    requestContextSchema: serializeSchema(tool.requestContextSchema),\n  };\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nexport const LIST_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools',\n  responseType: 'json',\n  responseSchema: listToolsResponseSchema,\n  summary: 'List all tools',\n  description: 'Returns a list of all available tools in the system',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, requestContext }) => {\n    try {\n      // Merge tools from two sources: mastra.listTools() includes dynamically created tools\n      // (e.g. MCP tools, or agent tools registered by their intrinsic id), while registeredTools\n      // includes tools discovered by the CLI bundler (keyed by export name).\n      //\n      // The same tool instance can appear in both maps under different keys (e.g. an agent\n      // registers it by `tool.id` while the bundler registers it by export name). Dedupe by\n      // `tool.id`, preferring the registeredTools (bundler) key, so each tool appears once.\n      const registered = registeredTools && Object.keys(registeredTools).length > 0 ? registeredTools : {};\n\n      const allTools: Record<string, any> = {};\n      const seenToolIds = new Map<string, string>();\n\n      // registeredTools first so their key wins for a given tool.id.\n      for (const [key, tool] of Object.entries(registered)) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      for (const [key, tool] of Object.entries(mastra.listTools() ?? {})) {\n        const toolId = typeof (tool as any)?.id === 'string' ? (tool as any).id : undefined;\n        // Skip if this exact tool.id was already registered (under any key) by registeredTools.\n        if (toolId !== undefined && seenToolIds.has(toolId)) continue;\n        if (toolId !== undefined) seenToolIds.set(toolId, key);\n        allTools[key] = tool;\n      }\n\n      const serializedTools = Object.entries(allTools).reduce(\n        (acc, [id, _tool]) => {\n          acc[id] = serializeTool(_tool);\n          return acc;\n        },\n        {} as Record<string, any>,\n      );\n\n      // Filter tools by FGA if configured\n      const fgaProvider = mastra.getServer?.()?.fga;\n      const user = requestContext?.get('user');\n      if (fgaProvider && user) {\n        const toolList = Object.entries(serializedTools).map(([id, t]) => ({ id, ...t }));\n        const accessible = await fgaProvider.filterAccessible(user, toolList, 'tool', MastraFGAPermissions.TOOLS_READ);\n        const accessibleSet = new Set(accessible.map((t: any) => t.id));\n        for (const id of Object.keys(serializedTools)) {\n          if (!accessibleSet.has(id)) {\n            delete serializedTools[id];\n          }\n        }\n      }\n\n      return serializedTools;\n    } catch (error) {\n      return handleError(error, 'Error getting tools');\n    }\n  },\n});\n\nexport const GET_TOOL_BY_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get tool by ID',\n  description: 'Returns details for a specific tool including its schema and configuration',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, registeredTools, toolId, requestContext }) => {\n    try {\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting tool');\n    }\n  },\n});\n\nexport const EXECUTE_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  queryParamSchema: optionalRunIdSchema,\n  bodySchema: executeToolContextBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute tool',\n  description: 'Executes a specific tool with the provided input data',\n  tags: ['Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, runId, toolId, registeredTools, requestContext, ...bodyParams }) => {\n    try {\n      if (!toolId) {\n        throw new HTTPException(400, { message: 'Tool ID is required' });\n      }\n\n      let tool: any;\n\n      // Try explicit registeredTools first, then fallback to mastra\n      if (registeredTools && Object.keys(registeredTools).length > 0) {\n        tool = Object.values(registeredTools).find((t: any) => t.id === toolId);\n      }\n      if (!tool) {\n        try {\n          tool = mastra.getToolById(toolId);\n        } catch {\n          // tool not found in global registry, continue to agent fallback\n        }\n      }\n\n      // Fallback: search dynamically-resolved agent tools (toolsResolver)\n      if (!tool) {\n        tool = await findToolInAgents(mastra, toolId, requestContext);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const { data } = bodyParams;\n\n      validateBody({ data });\n\n      let result;\n      if (isVercelTool(tool)) {\n        result = await (tool as any).execute(data);\n      } else {\n        result = await tool.execute(data!, {\n          mastra,\n          requestContext,\n          // TODO: Pass proper tracing context when server API supports tracing\n          tracingContext: { currentSpan: undefined },\n          ...(runId\n            ? {\n                workflow: {\n                  runId,\n                  suspend: async () => {},\n                },\n              }\n            : {}),\n        });\n      }\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing tool');\n    }\n  },\n});\n\n// ============================================================================\n// Agent Tool Routes\n// ============================================================================\n\nexport const GET_AGENT_TOOL_ROUTE = createRoute({\n  method: 'GET',\n  path: '/agents/:agentId/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get agent tool',\n  description: 'Returns details for a specific tool assigned to the agent',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      return serializeTool(tool);\n    } catch (error) {\n      return handleError(error, 'Error getting agent tool');\n    }\n  },\n});\n\nexport const EXECUTE_AGENT_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/agents/:agentId/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  bodySchema: executeToolBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute agent tool',\n  description: 'Executes a specific tool assigned to the agent with the provided input data',\n  tags: ['Agents', 'Tools'],\n  requiresAuth: true,\n  handler: async ({ mastra, agentId, toolId, data, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n      const agent = await getAgentFromSystem({ mastra, agentId });\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const result = await tool.execute(data, {\n        mastra,\n        requestContext,\n        // TODO: Pass proper tracing context when server API supports tracing\n        tracingContext: { currentSpan: undefined },\n      });\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing agent tool');\n    }\n  },\n});\n"],"mappings":"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"}