@mastra/core 0.7.0 → 0.8.0-alpha.2

package/README.md

@@ -29,8 +29,8 @@ For comprehensive documentation, visit our [official documentation](https://mast
 Agents are autonomous AI entities that can understand instructions, use tools, and complete tasks. They encapsulate LLM interactions and can maintain conversation history, use provided tools, and follow specific behavioral guidelines through instructions.
 
 ```typescript
-import { openai } from '@ai-sdk/openai';
 import { Agent } from '@mastra/core/agent';
+import { openai } from '@ai-sdk/openai';
 
 const agent = new Agent({
   name: 'my-agent',
@@ -40,108 +40,99 @@ const agent = new Agent({
 });
 ```
 
-[More agent documentation →](https://mastra.ai/docs/reference/agents/overview)
+[Agent documentation →](https://mastra.ai/docs/agents/00-overview)
 
-### Embeddings (`/embeddings`)
+### Workflows (`/workflows`)
 
-The embeddings module provides a unified interface for converting text into vector representations across multiple AI providers. These vectors are essential for semantic search, similarity comparisons, and other NLP tasks.
+Workflows orchestrate complex AI tasks by combining multiple actions into a coherent sequence. They handle state management, error recovery, and can include conditional logic and parallel execution.
 
 ```typescript
-import { openai } from '@ai-sdk/openai';
-import { embed } from 'ai';
+import { Workflow } from '@mastra/core';
 
-const embeddings = await embed({
-  model: openai.embedding('text-embedding-3-small'),
-  value: 'text to embed',
+const workflow = new Workflow({
+  name: 'my-workflow',
+  steps: [
+    // Workflow steps
+  ],
 });
 ```
 
-Supported providers right now are OpenAI, Cohere, Amazon Bedrock, Google AI, Mistral, and Voyage.
-
-[More embeddings documentation →](https://mastra.ai/docs/reference/embeddings/overview)
-
-### Evaluations (`/eval`)
-
-The evaluation system enables quantitative assessment of AI outputs. Create custom metrics to measure specific aspects of AI performance, from response quality to task completion accuracy.
-
-```typescript
-import { Metric, evaluate } from '@mastra/core';
-
-class CustomMetric extends Metric {
-  async measure(input: string, output: string): Promise<MetricResult> {
-    // Your evaluation logic
-    return { score: 0.95 };
-  }
-}
-```
-
-[More evaluations documentation →](https://mastra.ai/docs/reference/eval/overview)
+[Workflow documentation →](https://mastra.ai/docs/workflows/00-overview)
 
 ### Memory (`/memory`)
 
 Memory management provides persistent storage and retrieval of AI interactions. It supports different storage backends and enables context-aware conversations and long-term learning.
 
 ```typescript
-import { MastraMemory } from '@mastra/core';
+import { Memory } from '@mastra/memory';
+import { Agent } from '@mastra/core/agent';
+import { openai } from '@ai-sdk/openai';
 
-const memory = new MastraMemory({
-  // Memory configuration
+const agent = new Agent({
+  name: 'Project Manager',
+  instructions: 'You are a project manager assistant.',
+  model: openai('gpt-4o-mini'),
+  memory: new Memory({
+    options: {
+      lastMessages: 20,
+      semanticRecall: {
+        topK: 3,
+        messageRange: { before: 2, after: 1 },
+      },
+    },
+  }),
 });
 ```
 
-**Note:** this is the base `MastraMemory` class. This class in `@mastra/core` is intended to be extended when developing custom agent memory strategies.
-To use a premade memory strategy (recommended), with long and short term memory built in, use `import { Memory } from "@mastra/memory"` instead.
-
-[Visit the memory documentation to use Memory in your project →](https://mastra.ai/docs/reference/memory/overview)
-
-### Vector Stores (`/vector`)
-
-Vector stores provide the infrastructure for storing and querying vector embeddings. They support semantic search, similarity matching, and efficient vector operations across different backend implementations.
-
-```typescript
-import { MastraVector } from '@mastra/core';
-
-class CustomVectorStore extends MastraVector {
-  // Vector store implementation
-}
-```
-
-[More vector stores documentation →](https://mastra.ai/docs/reference/vector/overview)
+[Memory documentation →](https://mastra.ai/docs/reference/memory/Memory)
 
-### Workflows (`/workflows`)
+### Tools (`/tools`)
 
-Workflows orchestrate complex AI tasks by combining multiple actions into a coherent sequence. They handle state management, error recovery, and can include conditional logic and parallel execution.
+Tools are functions that agents can use to interact with external systems or perform specific tasks. Each tool has a clear description and schema, making it easy for AI to understand and use them effectively.
 
 ```typescript
-import { Workflow } from '@mastra/core';
-
-const workflow = new Workflow({
-  name: 'my-workflow',
-  steps: [
-    // Workflow steps
-  ],
+import { createTool } from '@mastra/core/tools';
+import { z } from 'zod';
+
+const weatherInfo = createTool({
+  id: 'Get Weather Information',
+  inputSchema: z.object({
+    city: z.string(),
+  }),
+  description: 'Fetches the current weather information for a given city',
+  execute: async ({ context: { city } }) => {
+    // Tool implementation
+  },
 });
 ```
 
-[More workflows documentation →](https://mastra.ai/docs/reference/workflows/overview)
+[Tools documentation →](https://mastra.ai/docs/agents/02-adding-tools)
 
-### Tools (`/tools`)
+### Evals (`/eval`)
 
-Tools are functions that agents can use to interact with external systems or perform specific tasks. Each tool has a clear description and schema, making it easy for AI to understand and use them effectively.
+The evaluation system enables quantitative assessment of AI outputs. Create custom metrics to measure specific aspects of AI performance, from response quality to task completion accuracy.
 
 ```typescript
-import { ToolAction } from '@mastra/core';
+import { Agent } from '@mastra/core/agent';
+import { openai } from '@ai-sdk/openai';
+import { SummarizationMetric } from '@mastra/evals/llm';
+import { ContentSimilarityMetric, ToneConsistencyMetric } from '@mastra/evals/nlp';
 
-const tool = new ToolAction({
-  name: 'tool-name',
-  description: 'Tool description',
-  execute: async context => {
-    // Tool implementation
+const model = openai('gpt-4o');
+
+const agent = new Agent({
+  name: 'ContentWriter',
+  instructions: 'You are a content writer that creates accurate summaries',
+  model,
+  evals: {
+    summarization: new SummarizationMetric(model),
+    contentSimilarity: new ContentSimilarityMetric(),
+    tone: new ToneConsistencyMetric(),
   },
 });
 ```
 
-[More tools documentation →](https://mastra.ai/docs/reference/tools/overview)
+[More evals documentation →](https://mastra.ai/docs/evals/00-overview)
 
 ### Logger (`/logger`)
 
@@ -160,13 +151,24 @@ const logger = createLogger({
 
 ### Telemetry (`/telemetry`)
 
-Telemetry provides OpenTelemetry integration for comprehensive monitoring of your AI systems. Track latency, success rates, and system health with distributed tracing and metrics collection.
+Telemetry provides OpenTelemetry (Otel) integration for comprehensive monitoring of your AI systems. Track latency, success rates, and system health with distributed tracing and metrics collection.
 
 ```typescript
-import { Telemetry } from '@mastra/core';
-
-const telemetry = Telemetry.init({
-  serviceName: 'my-service',
+import { Mastra } from '@mastra/core';
+
+const mastra = new Mastra({
+  telemetry: {
+    serviceName: 'my-service',
+    enabled: true,
+    sampling: {
+      type: 'ratio',
+      probability: 0.5,
+    },
+    export: {
+      type: 'otlp',
+      endpoint: 'https://otel-collector.example.com/v1/traces',
+    },
+  },
 });
 ```
 

package/dist/agent/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkC6BBAS4I_cjs = require('../chunk-C6BBAS4I.cjs');
+var chunk3HE5CJBG_cjs = require('../chunk-3HE5CJBG.cjs');
 
 
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkC6BBAS4I_cjs.Agent; }
+  get: function () { return chunk3HE5CJBG_cjs.Agent; }
 });

package/dist/agent/index.d.cts

@@ -1,9 +1,9 @@
 export { Message as AiMessageType } from 'ai';
 import 'json-schema';
 import 'zod';
-export { A as Agent, m as AgentConfig, aH as AgentGenerateOptions, aI as AgentStreamOptions, az as MastraLanguageModel, a as ToolsInput, aG as ToolsetsInput } from '../base-C0wILuA9.cjs';
-import '../base-ObPJ-w8K.cjs';
-import '../types-CwTG2XyQ.cjs';
+export { j as Agent, k as AgentConfig, aL as AgentGenerateOptions, aM as AgentStreamOptions, aF as MastraLanguageModel, aG as ToolsInput, aK as ToolsetsInput } from '../base-Dpt4tO56.cjs';
+import '../base-CvQbEqGB.cjs';
+import '../types-BtMyV38I.cjs';
 import 'sift';
 import '../index-CquI0inB.cjs';
 import 'stream';
@@ -17,3 +17,5 @@ import '@opentelemetry/sdk-trace-base';
 import '../tts/index.cjs';
 import '../deployer/index.cjs';
 import '../bundler/index.cjs';
+import 'hono';
+import 'hono-openapi';

package/dist/agent/index.d.ts

@@ -1,9 +1,9 @@
 export { Message as AiMessageType } from 'ai';
 import 'json-schema';
 import 'zod';
-export { A as Agent, m as AgentConfig, aH as AgentGenerateOptions, aI as AgentStreamOptions, az as MastraLanguageModel, a as ToolsInput, aG as ToolsetsInput } from '../base-Cyl73WbV.js';
-import '../base-Cmunaaxb.js';
-import '../types-CwTG2XyQ.js';
+export { j as Agent, k as AgentConfig, aL as AgentGenerateOptions, aM as AgentStreamOptions, aF as MastraLanguageModel, aG as ToolsInput, aK as ToolsetsInput } from '../base-CQuRWXAH.js';
+import '../base-BA_in99t.js';
+import '../types-BtMyV38I.js';
 import 'sift';
 import '../index-CquI0inB.js';
 import 'stream';
@@ -17,3 +17,5 @@ import '@opentelemetry/sdk-trace-base';
 import '../tts/index.js';
 import '../deployer/index.js';
 import '../bundler/index.js';
+import 'hono';
+import 'hono-openapi';

package/dist/agent/index.js

@@ -1 +1 @@
-export { Agent } from '../chunk-VNQRLYIA.js';
+export { Agent } from '../chunk-HCDXBSMK.js';

package/dist/{base-Cmunaaxb.d.ts → base-BA_in99t.d.ts}

@@ -1,5 +1,5 @@
 import * as _opentelemetry_api from '@opentelemetry/api';
-import { Tracer, Span } from '@opentelemetry/api';
+import { Tracer, Span, Context } from '@opentelemetry/api';
 import { R as RegisteredLogger, L as Logger } from './index-CquI0inB.js';
 import { SpanExporter } from '@opentelemetry/sdk-trace-base';
 
@@ -71,6 +71,7 @@ declare class Telemetry {
      * @returns Telemetry instance that can be used for tracing
      */
     static init(config?: OtelConfig): Telemetry;
+    static getActiveSpan(): Span | undefined;
     /**
      * Get the global telemetry instance
      * @throws {Error} If telemetry has not been initialized
@@ -93,6 +94,8 @@ declare class Telemetry {
         /** Skip tracing if telemetry is not active */
         skipIfNoTelemetry?: boolean;
     }): T;
+    static setBaggage(baggage: Record<string, string>, ctx?: Context): Context;
+    static withContext(ctx: Context, fn: () => void): void;
     /**
      * method to trace individual methods with proper context
      * @param method The method to trace