github mastra-ai/mastra @mastra/core@1.0.0-beta.10
December 9, 2025

Changelog

Summary

  • Total packages with changes: 35
  • Packages with major changes: 0
  • Packages with minor changes: 4
  • Packages with patch changes: 29

@mastra/arize@1.0.0-beta.5

Patch Changes

  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/otel-exporter@1.0.0-beta.5

@mastra/braintrust@1.0.0-beta.5

Patch Changes

  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/observability@1.0.0-beta.4

@mastra/clickhouse@1.0.0-beta.5

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/client-js@1.0.0-beta.10

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/cloudflare@1.0.0-beta.6

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/cloudflare-d1@1.0.0-beta.5

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/convex@0.1.0-beta.3

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/core@1.0.0-beta.10

Patch Changes

  • Add support for typed structured output in agent workflow steps (#11014)

    When wrapping an agent with createStep() and providing a structuredOutput.schema, the step's outputSchema is now correctly inferred from the provided schema instead of defaulting to { text: string }.

    This enables type-safe chaining of agent steps with structured output to subsequent steps:

    const articleSchema = z.object({
      title: z.string(),
      summary: z.string(),
      tags: z.array(z.string()),
    });
    
    // Agent step with structured output - outputSchema is now articleSchema
    const agentStep = createStep(agent, {
      structuredOutput: { schema: articleSchema },
    });
    
    // Next step can receive the structured output directly
    const processStep = createStep({
      id: 'process',
      inputSchema: articleSchema, // Matches agent's outputSchema
      outputSchema: z.object({ tagCount: z.number() }),
      execute: async ({ inputData }) => ({
        tagCount: inputData.tags.length, // Fully typed!
      }),
    });
    
    workflow.then(agentStep).then(processStep).commit();

    When structuredOutput is not provided, the agent step continues to use the default { text: string } output schema.

  • Fixed a bug where multiple tools streaming output simultaneously could fail with "WritableStreamDefaultWriter is locked" errors. Tool streaming now works reliably during concurrent tool executions. (#10830)

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);
  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

  • fix: persist data-* chunks from writer.custom() to memory storage (#10884)

    • Add persistence for custom data chunks (data-* parts) emitted via writer.custom() in tools
    • Data chunks are now saved to message storage so they survive page refreshes
    • Update @assistant-ui/react to v0.11.47 with native DataMessagePart support
    • Convert data-* parts to DataMessagePart format ({ type: 'data', name: string, data: T })
    • Update related @assistant-ui/* packages for compatibility
  • Fixed double validation bug that prevented Zod transforms from working correctly in tool schemas. (#11025)

    When tools with Zod .transform() or .pipe() in their outputSchema were executed through the Agent pipeline, validation was happening twice - once in Tool.execute() (correct) and again in CoreToolBuilder (incorrect). The second validation received already-transformed data but expected pre-transform data, causing validation errors.

    This fix enables proper use of Zod transforms in both inputSchema (for normalizing/cleaning input data) and outputSchema (for transforming output data to be LLM-friendly).

Dependency Updates

  • @mastra/observability@1.0.0-beta.4

@mastra/dane@1.0.0-beta.10

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/upstash@1.0.0-beta.6
  • @mastra/libsql@1.0.0-beta.7

@mastra/deployer@1.0.0-beta.10

Patch Changes

  • Breaking Changes (#11028)

    • Renamed RuntimeContext type to ServerContext to avoid confusion with the user-facing RequestContext (previously called RuntimeContext)
    • Removed playground and isDev options from server adapter constructors - these only set context variables without any actual functionality

    Changes

    @mastra/server

    • Renamed RuntimeContext type to ServerContext in route handler types
    • Renamed createTestRuntimeContext to createTestServerContext in test utilities
    • Renamed isPlayground parameter to isStudio in formatAgent function

    @mastra/hono

    • Removed playground and isDev from HonoVariables type
    • Removed setting of playground and isDev context variables in middleware

    @mastra/express

    • Removed playground and isDev from Express.Locals interface
    • Removed setting of playground and isDev in response locals

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/server@1.0.0-beta.10

@mastra/deployer-cloud@1.0.0-beta.10

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/deployer@1.0.0-beta.10

@mastra/dynamodb@1.0.0-beta.5

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/express@0.0.2-beta.5

Patch Changes

  • Breaking Changes (#11028)

    • Renamed RuntimeContext type to ServerContext to avoid confusion with the user-facing RequestContext (previously called RuntimeContext)
    • Removed playground and isDev options from server adapter constructors - these only set context variables without any actual functionality

    Changes

    @mastra/server

    • Renamed RuntimeContext type to ServerContext in route handler types
    • Renamed createTestRuntimeContext to createTestServerContext in test utilities
    • Renamed isPlayground parameter to isStudio in formatAgent function

    @mastra/hono

    • Removed playground and isDev from HonoVariables type
    • Removed setting of playground and isDev context variables in middleware

    @mastra/express

    • Removed playground and isDev from Express.Locals interface
    • Removed setting of playground and isDev in response locals

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/server@1.0.0-beta.10

@mastra/hono@0.0.2-beta.5

Patch Changes

  • Breaking Changes (#11028)

    • Renamed RuntimeContext type to ServerContext to avoid confusion with the user-facing RequestContext (previously called RuntimeContext)
    • Removed playground and isDev options from server adapter constructors - these only set context variables without any actual functionality

    Changes

    @mastra/server

    • Renamed RuntimeContext type to ServerContext in route handler types
    • Renamed createTestRuntimeContext to createTestServerContext in test utilities
    • Renamed isPlayground parameter to isStudio in formatAgent function

    @mastra/hono

    • Removed playground and isDev from HonoVariables type
    • Removed setting of playground and isDev context variables in middleware

    @mastra/express

    • Removed playground and isDev from Express.Locals interface
    • Removed setting of playground and isDev in response locals

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/server@1.0.0-beta.10

@mastra/inngest@1.0.0-beta.5

Patch Changes

  • Internal code refactoring (#10830)

  • Add support for typed structured output in agent workflow steps (#11014)

    When wrapping an agent with createStep() and providing a structuredOutput.schema, the step's outputSchema is now correctly inferred from the provided schema instead of defaulting to { text: string }.

    This enables type-safe chaining of agent steps with structured output to subsequent steps:

    const articleSchema = z.object({
      title: z.string(),
      summary: z.string(),
      tags: z.array(z.string()),
    });
    
    // Agent step with structured output - outputSchema is now articleSchema
    const agentStep = createStep(agent, {
      structuredOutput: { schema: articleSchema },
    });
    
    // Next step can receive the structured output directly
    const processStep = createStep({
      id: 'process',
      inputSchema: articleSchema, // Matches agent's outputSchema
      outputSchema: z.object({ tagCount: z.number() }),
      execute: async ({ inputData }) => ({
        tagCount: inputData.tags.length, // Fully typed!
      }),
    });
    
    workflow.then(agentStep).then(processStep).commit();

    When structuredOutput is not provided, the agent step continues to use the default { text: string } output schema.

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/lance@1.0.0-beta.6

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/langfuse@1.0.0-beta.4

Patch Changes

  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/observability@1.0.0-beta.4

@mastra/langsmith@1.0.0-beta.5

Patch Changes

  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/observability@1.0.0-beta.4

@mastra/libsql@1.0.0-beta.7

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/longmemeval@1.0.0-beta.10

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/libsql@1.0.0-beta.7

@mastra/mcp-docs-server@1.0.0-beta.10

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/mongodb@1.0.0-beta.6

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/mssql@1.0.0-beta.6

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/observability@1.0.0-beta.4

Patch Changes

  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/otel-bridge@1.0.0-beta.4

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/otel-exporter@1.0.0-beta.5
  • @mastra/observability@1.0.0-beta.4

@mastra/otel-exporter@1.0.0-beta.5

Patch Changes

  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/observability@1.0.0-beta.4

@mastra/pg@1.0.0-beta.7

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);
  • Add halfvec type support for large dimension embeddings (#11002)

    Adds vectorType option to createIndex() for choosing between full precision (vector) and half precision (halfvec) storage. halfvec uses 2 bytes per dimension instead of 4, enabling indexes on embeddings up to 4000 dimensions.

    await pgVector.createIndex({
      indexName: 'large-embeddings',
      dimension: 3072, // text-embedding-3-large
      metric: 'cosine',
      vectorType: 'halfvec',
    });

    Requires pgvector >= 0.7.0 for halfvec support. Docker compose files updated to use pgvector 0.8.0.

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/playground-ui@7.0.0-beta.10

Minor Changes

  • Fix "MessagePartRuntime is not available" error when chatting with agents in Studio playground by replacing deprecated useMessagePart hook with useAssistantState (#11039)

Patch Changes

  • Remove console.log in playground-ui (#11004)

  • Use the hash based stringification mechanism of tanstack query to ensure keys ordering (and to keep the caching key valid and consistent) (#11008)

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);
  • Add the possibility to pass down options to the tanstack query client. Goal is to have cacheable request in cloud and it's not possible for now because of context resolution beeing different (#11026)

  • fix: persist data-* chunks from writer.custom() to memory storage (#10884)

    • Add persistence for custom data chunks (data-* parts) emitted via writer.custom() in tools
    • Data chunks are now saved to message storage so they survive page refreshes
    • Update @assistant-ui/react to v0.11.47 with native DataMessagePart support
    • Convert data-* parts to DataMessagePart format ({ type: 'data', name: string, data: T })
    • Update related @assistant-ui/* packages for compatibility

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/client-js@1.0.0-beta.10
  • @mastra/react@0.1.0-beta.10
  • @mastra/ai-sdk@1.0.0-beta.7

@mastra/posthog@1.0.0-beta.4

Patch Changes

  • Fixed CachedToken tracking in all Observability Exporters. Also fixed TimeToFirstToken in Langfuse, Braintrust, PostHog exporters. Fixed trace formatting in Posthog Exporter. (#11029)

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/observability@1.0.0-beta.4

@mastra/react-hooks@0.1.0-beta.10

Minor Changes

  • Fix "MessagePartRuntime is not available" error when chatting with agents in Studio playground by replacing deprecated useMessagePart hook with useAssistantState (#11039)

Patch Changes

  • fix: persist data-* chunks from writer.custom() to memory storage (#10884)
    • Add persistence for custom data chunks (data-* parts) emitted via writer.custom() in tools
    • Data chunks are now saved to message storage so they survive page refreshes
    • Update @assistant-ui/react to v0.11.47 with native DataMessagePart support
    • Convert data-* parts to DataMessagePart format ({ type: 'data', name: string, data: T })
    • Update related @assistant-ui/* packages for compatibility

Dependency Updates

  • @mastra/client-js@1.0.0-beta.10

@mastra/server@1.0.0-beta.10

Patch Changes

  • Breaking Changes (#11028)

    • Renamed RuntimeContext type to ServerContext to avoid confusion with the user-facing RequestContext (previously called RuntimeContext)
    • Removed playground and isDev options from server adapter constructors - these only set context variables without any actual functionality

    Changes

    @mastra/server

    • Renamed RuntimeContext type to ServerContext in route handler types
    • Renamed createTestRuntimeContext to createTestServerContext in test utilities
    • Renamed isPlayground parameter to isStudio in formatAgent function

    @mastra/hono

    • Removed playground and isDev from HonoVariables type
    • Removed setting of playground and isDev context variables in middleware

    @mastra/express

    • Removed playground and isDev from Express.Locals interface
    • Removed setting of playground and isDev in response locals
  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/upstash@1.0.0-beta.6

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10

@mastra/voice-elevenlabs@0.12.0-beta.1

Minor Changes

  • Add output format support to ElevenLabs voice integration (#11027)

    The speak() method now supports specifying audio output formats via the outputFormat option. This enables telephony and VoIP use cases that require specific audio formats like μ-law (ulaw_8000) or PCM formats.

    import { ElevenLabsVoice } from '@mastra/voice-elevenlabs';
    
    const voice = new ElevenLabsVoice();
    
    // Generate speech with telephony format (μ-law 8kHz)
    const stream = await voice.speak('Hello from Mastra!', {
      outputFormat: 'ulaw_8000',
    });
    
    // Generate speech with PCM format
    const pcmStream = await voice.speak('Hello from Mastra!', {
      outputFormat: 'pcm_16000',
    });

    Supported formats include:

    • MP3 variants: mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192
    • PCM variants: pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100
    • Telephony formats: ulaw_8000, alaw_8000 (μ-law and A-law 8kHz for VoIP/telephony)
    • WAV formats: wav, wav_8000, wav_16000

    If outputFormat is not specified, the method defaults to ElevenLabs' default format (typically mp3_44100_128).

Dependency Updates

  • @mastra/core@1.0.0-beta.10

create-mastra@1.0.0-beta.8

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

mastra@1.0.0-beta.8

Minor Changes

  • Fix "MessagePartRuntime is not available" error when chatting with agents in Studio playground by replacing deprecated useMessagePart hook with useAssistantState (#11039)

Patch Changes

  • Add delete workflow run API (#10991)

    await workflow.deleteWorkflowRunById(runId);

Dependency Updates

  • @mastra/core@1.0.0-beta.10
  • @mastra/deployer@1.0.0-beta.10

Don't miss a new mastra release

NewReleases is sending notifications on new releases.