@mastra/schema-compat 1.2.9-alpha.1 → 1.2.9

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/schema-compat
 
+## 1.2.9
+
+### Patch Changes
+
+- Fixed MCP tool validation failures when tools use JSON Schema draft 2020-12. Tools from providers like Firecrawl that declare `$schema: "https://json-schema.org/draft/2020-12/schema"` now validate correctly instead of throwing "no schema with key or ref" errors. ([#14530](https://github.com/mastra-ai/mastra/pull/14530))
+
+- Fixed MCP tools with recursive JSON Schema refs so they stay serializable when loaded. ([#15400](https://github.com/mastra-ai/mastra/pull/15400))
+
 ## 1.2.9-alpha.1
 
 ### Patch Changes

package/dist/_types/@internal_ai-sdk-v4/dist/index.d.ts

@@ -195,6 +195,8 @@ export declare interface Attachment {
  * Attributes is a map from string to attribute values.
  *
  * Note: only the own enumerable keys are counted as valid attribute keys.
+ *
+ * @since 1.3.0
  */
 declare interface Attributes {
     [attributeKey: string]: AttributeValue | undefined;
@@ -204,6 +206,8 @@ declare interface Attributes {
  * Attribute values may be any non-nullish primitive value except an object.
  *
  * null or undefined attribute values are invalid and will result in undefined behavior.
+ *
+ * @since 1.3.0
  */
 declare type AttributeValue = string | number | boolean | Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>;
 
@@ -1057,6 +1061,9 @@ declare type ConsumeStreamOptions = {
     onError?: (error: unknown) => void;
 };
 
+/**
+ * @since 1.0.0
+ */
 declare interface Context {
     /**
      * Get a value from the context.
@@ -1735,6 +1742,8 @@ declare const errorStreamPart: AssistantStreamPart<'3', 'error', string>;
  * Defines Exception.
  *
  * string or an object with one of (message or name or code) and optional stack
+ *
+ * @since 1.0.0
  */
 declare type Exception = ExceptionWithCode | ExceptionWithMessage | ExceptionWithName | string;
 
@@ -2770,6 +2779,8 @@ export declare interface GenerateTextResult<TOOLS extends ToolSet, OUTPUT> {
  * The second number is calculated by converting the digits after the decimal point of the subtraction, (1609504210150 / 1000) - HrTime[0], to nanoseconds:
  * HrTime[1] = Number((1609504210.150 - HrTime[0]).toFixed(9)) * 1e9 = 150000000.
  * This is represented in HrTime format as [1609504210, 150000000].
+ *
+ * @since 1.0.0
  */
 declare type HrTime = [number, number];
 
@@ -4420,6 +4431,8 @@ declare interface LanguageModelV1ToolResultPart {
  *    However, it is desirable to associate incoming SpanContext to new trace
  *    initiated on service provider side so two traces (from Client and from
  *    Service Provider) can be correlated.
+ *
+ * @since 1.0.0
  */
 declare interface Link {
     /** The {@link SpanContext} of a linked span. */
@@ -5289,6 +5302,8 @@ declare type SourceUIPart = {
  * may have children.
  *
  * Spans are created by the {@link Tracer.startSpan} method.
+ *
+ * @since 1.0.0
  */
 declare interface Span {
     /**
@@ -5348,11 +5363,21 @@ declare interface Span {
      */
     addLinks(links: Link[]): this;
     /**
-     * Sets a status to the span. If used, this will override the default Span
-     * status. Default is {@link SpanStatusCode.UNSET}. SetStatus overrides the value
-     * of previous calls to SetStatus on the Span.
+     * Sets the status of the span.
+     *
+     * By default, a span has status {@link SpanStatusCode.UNSET}.
+     * Calling this method overrides that default.
+     *
+     * The status codes have a total order: `OK > ERROR > UNSET`.
+     *
+     * - Once {@link SpanStatusCode.OK} is set, any further attempts to change
+     *   the status are ignored.
+     * - Any attempt to set {@link SpanStatusCode.UNSET} is always ignored.
+     *
+     * The `message` field is only used when {@link SpanStatusCode.ERROR} is set.
+     * For all other status codes, `message` is ignored.
      *
-     * @param status the SpanStatus to set.
+     * @param status The {@link SpanStatus} to set.
      */
     setStatus(status: SpanStatus): this;
     /**
@@ -5397,17 +5422,21 @@ declare interface Span {
 
 /**
  * @deprecated please use {@link Attributes}
+ * @since 1.0.0
  */
 declare type SpanAttributes = Attributes;
 
 /**
  * @deprecated please use {@link AttributeValue}
+ * @since 1.0.0
  */
 declare type SpanAttributeValue = AttributeValue;
 
 /**
  * A SpanContext represents the portion of a {@link Span} which must be
  * serialized and propagated along side of a {@link Baggage}.
+ *
+ * @since 1.0.0
  */
 declare interface SpanContext {
     /**
@@ -5457,6 +5486,9 @@ declare interface SpanContext {
     traceState?: TraceState;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare enum SpanKind {
     /** Default value. Indicates that the span is used internally. */
     INTERNAL = 0,
@@ -5486,6 +5518,8 @@ declare enum SpanKind {
 
 /**
  * Options needed for span creation
+ *
+ * @since 1.0.0
  */
 declare interface SpanOptions {
     /**
@@ -5494,7 +5528,7 @@ declare interface SpanOptions {
      */
     kind?: SpanKind;
     /** A span's attributes */
-    attributes?: SpanAttributes;
+    attributes?: Attributes;
     /** {@link Link}s span to other spans */
     links?: Link[];
     /** A manually specified start time for the created `Span` object. */
@@ -5503,6 +5537,9 @@ declare interface SpanOptions {
     root?: boolean;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare interface SpanStatus {
     /** The status code of this message. */
     code: SpanStatusCode;
@@ -5512,6 +5549,8 @@ declare interface SpanStatus {
 
 /**
  * An enumeration of status codes.
+ *
+ * @since 1.0.0
  */
 declare enum SpanStatusCode {
     /**
@@ -6741,6 +6780,8 @@ declare type TextUIPart = {
  * Defines TimeInput.
  *
  * hrtime, epoch milliseconds, performance.now() or Date
+ *
+ * @since 1.0.0
  */
 declare type TimeInput = HrTime | number | Date;
 
@@ -7087,6 +7128,8 @@ declare type ToToolsWithExecute<TOOLS extends ToolSet> = {
 
 /**
  * Tracer provides an interface for creating {@link Span}s.
+ *
+ * @since 1.0.0
  */
 declare interface Tracer {
     /**
@@ -7153,6 +7196,9 @@ declare interface Tracer {
     startActiveSpan<F extends (span: Span) => unknown>(name: string, options: SpanOptions, context: Context, fn: F): ReturnType<F>;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare interface TraceState {
     /**
      * Create a new TraceState which inherits from this TraceState and has the

package/dist/_types/@internal_ai-sdk-v5/dist/index.d.ts

@@ -435,6 +435,8 @@ export declare type AsyncIterableStream<T> = AsyncIterable<T> & ReadableStream<T
  * Attributes is a map from string to attribute values.
  *
  * Note: only the own enumerable keys are counted as valid attribute keys.
+ *
+ * @since 1.3.0
  */
 declare interface Attributes {
     [attributeKey: string]: AttributeValue | undefined;
@@ -444,6 +446,8 @@ declare interface Attributes {
  * Attribute values may be any non-nullish primitive value except an object.
  *
  * null or undefined attribute values are invalid and will result in undefined behavior.
+ *
+ * @since 1.3.0
  */
 declare type AttributeValue = string | number | boolean | Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>;
 
@@ -778,6 +782,9 @@ export declare type ContentPart<TOOLS extends ToolSet> = {
     providerMetadata?: ProviderMetadata;
 });
 
+/**
+ * @since 1.0.0
+ */
 declare interface Context {
     /**
      * Get a value from the context.
@@ -1705,6 +1712,8 @@ declare class EventSourceParserStream extends TransformStream<string, EventSourc
  * Defines Exception.
  *
  * string or an object with one of (message or name or code) and optional stack
+ *
+ * @since 1.0.0
  */
 declare type Exception = ExceptionWithCode | ExceptionWithMessage | ExceptionWithName | string;
 
@@ -2973,6 +2982,8 @@ export declare function hasToolCall(toolName: string): StopCondition<any>;
  * The second number is calculated by converting the digits after the decimal point of the subtraction, (1609504210150 / 1000) - HrTime[0], to nanoseconds:
  * HrTime[1] = Number((1609504210.150 - HrTime[0]).toFixed(9)) * 1e9 = 150000000.
  * This is represented in HrTime format as [1609504210, 150000000].
+ *
+ * @since 1.0.0
  */
 declare type HrTime = [number, number];
 
@@ -5546,6 +5557,8 @@ declare function lazyValidator<OBJECT>(createValidator: () => Validator<OBJECT>)
  *    However, it is desirable to associate incoming SpanContext to new trace
  *    initiated on service provider side so two traces (from Client and from
  *    Service Provider) can be correlated.
+ *
+ * @since 1.0.0
  */
 declare interface Link {
     /** The {@link SpanContext} of a linked span. */
@@ -7019,6 +7032,8 @@ export declare type SourceUrlUIPart = {
  * may have children.
  *
  * Spans are created by the {@link Tracer.startSpan} method.
+ *
+ * @since 1.0.0
  */
 declare interface Span {
     /**
@@ -7078,11 +7093,21 @@ declare interface Span {
      */
     addLinks(links: Link[]): this;
     /**
-     * Sets a status to the span. If used, this will override the default Span
-     * status. Default is {@link SpanStatusCode.UNSET}. SetStatus overrides the value
-     * of previous calls to SetStatus on the Span.
+     * Sets the status of the span.
+     *
+     * By default, a span has status {@link SpanStatusCode.UNSET}.
+     * Calling this method overrides that default.
+     *
+     * The status codes have a total order: `OK > ERROR > UNSET`.
+     *
+     * - Once {@link SpanStatusCode.OK} is set, any further attempts to change
+     *   the status are ignored.
+     * - Any attempt to set {@link SpanStatusCode.UNSET} is always ignored.
+     *
+     * The `message` field is only used when {@link SpanStatusCode.ERROR} is set.
+     * For all other status codes, `message` is ignored.
      *
-     * @param status the SpanStatus to set.
+     * @param status The {@link SpanStatus} to set.
      */
     setStatus(status: SpanStatus): this;
     /**
@@ -7127,17 +7152,21 @@ declare interface Span {
 
 /**
  * @deprecated please use {@link Attributes}
+ * @since 1.0.0
  */
 declare type SpanAttributes = Attributes;
 
 /**
  * @deprecated please use {@link AttributeValue}
+ * @since 1.0.0
  */
 declare type SpanAttributeValue = AttributeValue;
 
 /**
  * A SpanContext represents the portion of a {@link Span} which must be
  * serialized and propagated along side of a {@link Baggage}.
+ *
+ * @since 1.0.0
  */
 declare interface SpanContext {
     /**
@@ -7187,6 +7216,9 @@ declare interface SpanContext {
     traceState?: TraceState;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare enum SpanKind {
     /** Default value. Indicates that the span is used internally. */
     INTERNAL = 0,
@@ -7216,6 +7248,8 @@ declare enum SpanKind {
 
 /**
  * Options needed for span creation
+ *
+ * @since 1.0.0
  */
 declare interface SpanOptions {
     /**
@@ -7224,7 +7258,7 @@ declare interface SpanOptions {
      */
     kind?: SpanKind;
     /** A span's attributes */
-    attributes?: SpanAttributes;
+    attributes?: Attributes;
     /** {@link Link}s span to other spans */
     links?: Link[];
     /** A manually specified start time for the created `Span` object. */
@@ -7233,6 +7267,9 @@ declare interface SpanOptions {
     root?: boolean;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare interface SpanStatus {
     /** The status code of this message. */
     code: SpanStatusCode;
@@ -7242,6 +7279,8 @@ declare interface SpanStatus {
 
 /**
  * An enumeration of status codes.
+ *
+ * @since 1.0.0
  */
 declare enum SpanStatusCode {
     /**
@@ -8798,6 +8837,8 @@ export declare type TextUIPart = {
  * Defines TimeInput.
  *
  * hrtime, epoch milliseconds, performance.now() or Date
+ *
+ * @since 1.0.0
  */
 declare type TimeInput = HrTime | number | Date;
 
@@ -9142,6 +9183,8 @@ export declare class TooManyEmbeddingValuesForCallError extends AISDKError {
 
 /**
  * Tracer provides an interface for creating {@link Span}s.
+ *
+ * @since 1.0.0
  */
 declare interface Tracer {
     /**
@@ -9208,6 +9251,9 @@ declare interface Tracer {
     startActiveSpan<F extends (span: Span) => unknown>(name: string, options: SpanOptions, context: Context, fn: F): ReturnType<F>;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare interface TraceState {
     /**
      * Create a new TraceState which inherits from this TraceState and has the

package/dist/_types/@internal_ai-v6/dist/index.d.ts

@@ -732,6 +732,8 @@ export declare type AsyncIterableStream<T> = AsyncIterable<T> & ReadableStream<T
  * Attributes is a map from string to attribute values.
  *
  * Note: only the own enumerable keys are counted as valid attribute keys.
+ *
+ * @since 1.3.0
  */
 declare interface Attributes {
     [attributeKey: string]: AttributeValue | undefined;
@@ -741,6 +743,8 @@ declare interface Attributes {
  * Attribute values may be any non-nullish primitive value except an object.
  *
  * null or undefined attribute values are invalid and will result in undefined behavior.
+ *
+ * @since 1.3.0
  */
 declare type AttributeValue = string | number | boolean | Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>;
 
@@ -1125,6 +1129,9 @@ export declare type ContentPart<TOOLS extends ToolSet> = {
     providerMetadata?: ProviderMetadata;
 }) | ToolApprovalRequestOutput<TOOLS>;
 
+/**
+ * @since 1.0.0
+ */
 declare interface Context {
     /**
      * Get a value from the context.
@@ -2680,6 +2687,8 @@ declare class EventSourceParserStream extends TransformStream<string, EventSourc
  * Defines Exception.
  *
  * string or an object with one of (message or name or code) and optional stack
+ *
+ * @since 1.0.0
  */
 declare type Exception = ExceptionWithCode | ExceptionWithMessage | ExceptionWithName | string;
 
@@ -4237,6 +4246,8 @@ export declare function hasToolCall(toolName: string): StopCondition<any>;
  * The second number is calculated by converting the digits after the decimal point of the subtraction, (1609504210150 / 1000) - HrTime[0], to nanoseconds:
  * HrTime[1] = Number((1609504210.150 - HrTime[0]).toFixed(9)) * 1e9 = 150000000.
  * This is represented in HrTime format as [1609504210, 150000000].
+ *
+ * @since 1.0.0
  */
 declare type HrTime = [number, number];
 
@@ -7445,6 +7456,8 @@ declare function lazySchema_2<SCHEMA>(createSchema: () => Schema<SCHEMA>): LazyS
  *    However, it is desirable to associate incoming SpanContext to new trace
  *    initiated on service provider side so two traces (from Client and from
  *    Service Provider) can be correlated.
+ *
+ * @since 1.0.0
  */
 declare interface Link {
     /** The {@link SpanContext} of a linked span. */
@@ -10006,6 +10019,8 @@ export declare type SourceUrlUIPart = {
  * may have children.
  *
  * Spans are created by the {@link Tracer.startSpan} method.
+ *
+ * @since 1.0.0
  */
 declare interface Span {
     /**
@@ -10065,11 +10080,21 @@ declare interface Span {
      */
     addLinks(links: Link[]): this;
     /**
-     * Sets a status to the span. If used, this will override the default Span
-     * status. Default is {@link SpanStatusCode.UNSET}. SetStatus overrides the value
-     * of previous calls to SetStatus on the Span.
+     * Sets the status of the span.
+     *
+     * By default, a span has status {@link SpanStatusCode.UNSET}.
+     * Calling this method overrides that default.
+     *
+     * The status codes have a total order: `OK > ERROR > UNSET`.
+     *
+     * - Once {@link SpanStatusCode.OK} is set, any further attempts to change
+     *   the status are ignored.
+     * - Any attempt to set {@link SpanStatusCode.UNSET} is always ignored.
+     *
+     * The `message` field is only used when {@link SpanStatusCode.ERROR} is set.
+     * For all other status codes, `message` is ignored.
      *
-     * @param status the SpanStatus to set.
+     * @param status The {@link SpanStatus} to set.
      */
     setStatus(status: SpanStatus): this;
     /**
@@ -10114,17 +10139,21 @@ declare interface Span {
 
 /**
  * @deprecated please use {@link Attributes}
+ * @since 1.0.0
  */
 declare type SpanAttributes = Attributes;
 
 /**
  * @deprecated please use {@link AttributeValue}
+ * @since 1.0.0
  */
 declare type SpanAttributeValue = AttributeValue;
 
 /**
  * A SpanContext represents the portion of a {@link Span} which must be
  * serialized and propagated along side of a {@link Baggage}.
+ *
+ * @since 1.0.0
  */
 declare interface SpanContext {
     /**
@@ -10174,6 +10203,9 @@ declare interface SpanContext {
     traceState?: TraceState;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare enum SpanKind {
     /** Default value. Indicates that the span is used internally. */
     INTERNAL = 0,
@@ -10203,6 +10235,8 @@ declare enum SpanKind {
 
 /**
  * Options needed for span creation
+ *
+ * @since 1.0.0
  */
 declare interface SpanOptions {
     /**
@@ -10211,7 +10245,7 @@ declare interface SpanOptions {
      */
     kind?: SpanKind;
     /** A span's attributes */
-    attributes?: SpanAttributes;
+    attributes?: Attributes;
     /** {@link Link}s span to other spans */
     links?: Link[];
     /** A manually specified start time for the created `Span` object. */
@@ -10220,6 +10254,9 @@ declare interface SpanOptions {
     root?: boolean;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare interface SpanStatus {
     /** The status code of this message. */
     code: SpanStatusCode;
@@ -10229,6 +10266,8 @@ declare interface SpanStatus {
 
 /**
  * An enumeration of status codes.
+ *
+ * @since 1.0.0
  */
 declare enum SpanStatusCode {
     /**
@@ -11981,6 +12020,8 @@ export declare type TextUIPart = {
  * Defines TimeInput.
  *
  * hrtime, epoch milliseconds, performance.now() or Date
+ *
+ * @since 1.0.0
  */
 declare type TimeInput = HrTime | number | Date;
 
@@ -13421,6 +13462,8 @@ export declare class TooManyEmbeddingValuesForCallError extends AISDKError {
 
 /**
  * Tracer provides an interface for creating {@link Span}s.
+ *
+ * @since 1.0.0
  */
 declare interface Tracer {
     /**
@@ -13487,6 +13530,9 @@ declare interface Tracer {
     startActiveSpan<F extends (span: Span) => unknown>(name: string, options: SpanOptions, context: Context, fn: F): ReturnType<F>;
 }
 
+/**
+ * @since 1.0.0
+ */
 declare interface TraceState {
     /**
      * Create a new TraceState which inherits from this TraceState and has the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/schema-compat",
-  "version": "1.2.9-alpha.1",
+  "version": "1.2.9",
   "description": "Tool schema compatibility layer for Mastra.ai",
   "type": "module",
   "main": "dist/index.js",
@@ -107,24 +107,24 @@
     "@standard-schema/spec": "^1.1.0",
     "@types/json-schema": "^7.0.15",
     "@types/node": "22.19.15",
-    "@vitest/coverage-v8": "4.0.18",
-    "@vitest/ui": "4.0.18",
+    "@vitest/coverage-v8": "4.1.4",
+    "@vitest/ui": "4.1.4",
     "ajv": "^8.18.0",
     "arktype": "^2.2.0",
-    "eslint": "^9.39.4",
+    "eslint": "^10.2.1",
     "json-schema-traverse": "^1.0.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "4.0.18",
+    "vitest": "4.1.4",
     "zod": "^4.3.6",
     "zod-v3": "npm:zod@^3.25.76",
-    "@internal/ai-sdk-v4": "0.0.30",
-    "@internal/ai-sdk-v5": "0.0.30",
-    "@internal/llm-recorder": "0.0.19",
-    "@internal/lint": "0.0.83",
-    "@internal/test-utils": "0.0.19",
-    "@internal/types-builder": "0.0.58",
-    "@internal/ai-v6": "0.0.30"
+    "@internal/ai-sdk-v4": "0.0.31",
+    "@internal/ai-sdk-v5": "0.0.31",
+    "@internal/llm-recorder": "0.0.20",
+    "@internal/test-utils": "0.0.20",
+    "@internal/lint": "0.0.84",
+    "@internal/types-builder": "0.0.59",
+    "@internal/ai-v6": "0.0.31"
   },
   "homepage": "https://mastra.ai",
   "repository": {