@mastra/mcp-docs-server 1.1.4 → 1.1.5

package/.docs/docs/workspace/skills.md

@@ -1,126 +0,0 @@
-# Workspace Skills
-
-**Added in:** `@mastra/core@1.1.0`
-
-Skills are reusable instructions that teach agents how to perform specific tasks. They follow the [Agent Skills specification](https://agentskills.io) - an open standard for packaging agent capabilities.
-
-A skill is a folder containing:
-
-- `SKILL.md`: Instructions and metadata for the agent
-- `references/`: Supporting documentation (optional)
-- `scripts/`: Executable scripts (optional)
-- `assets/`: Images and other files (optional)
-
-```plaintext
-/skills
-  /code-review
-    SKILL.md
-    /references
-      style-guide.md
-      pr-checklist.md
-    /scripts
-      lint.ts
-```
-
-When skills are configured on a workspace, agents can discover and activate them during conversations.
-
-## SKILL.md format
-
-Follow the official [skill specification](https://agentskills.io/specification) when creating your skill. Here is an example `SKILL.md` for a code review skill:
-
-```markdown
----
-name: code-review
-description: Reviews code for quality, style, and potential issues
-version: 1.0.0
-tags:
-  - development
-  - review
----
-
-# Code Review
-
-You are a code reviewer. When reviewing code:
-
-1. Check for bugs and edge cases
-2. Verify the code follows the style guide in references/style-guide.md
-3. Suggest improvements for readability
-4. Run the linter using scripts/lint.ts
-
-## What to look out for
-
-- Unused variables and imports
-- Missing error handling
-- Security vulnerabilities
-- Performance issues
-```
-
-## Configuring skills
-
-Enable skill discovery by setting the `skills` option on your workspace:
-
-```typescript
-import { Workspace, LocalFilesystem } from '@mastra/core/workspace';
-
-const workspace = new Workspace({
-  filesystem: new LocalFilesystem({ basePath: './workspace' }),
-  skills: ['/skills'],
-});
-```
-
-The `skills` directory is relative to your `basePath`. You can specify multiple skill directories:
-
-```typescript
-const workspace = new Workspace({
-  filesystem: new LocalFilesystem({ basePath: './workspace' }),
-  skills: [
-    '/skills',      // Project skills
-    '/team-skills', // Shared team skills
-  ],
-});
-```
-
-## Dynamic skills
-
-For dynamic skill paths based on context, pass a function:
-
-```typescript
-const workspace = new Workspace({
-  filesystem: new LocalFilesystem({ basePath: './workspace' }),
-  skills: (context) => {
-    const paths = ['/skills'];
-    if (context.user?.role === 'developer') {
-      paths.push('/dev-skills');
-    }
-    return paths;
-  },
-});
-```
-
-## How agents use skills
-
-When an agent activates a skill, the skill's instructions are added to the conversation context. The agent can then follow those instructions and access the skill's references and scripts.
-
-Under the hood this involves:
-
-1. Lists available skills in the system message
-2. Allows agents to activate skills during conversation
-3. Provides access to skill references and scripts
-
-## Skill search
-
-If BM25 or vector search is enabled on the workspace, skills are automatically indexed. Agents can search across skill content to find relevant instructions.
-
-```typescript
-const workspace = new Workspace({
-  filesystem: new LocalFilesystem({ basePath: './workspace' }),
-  skills: ['/skills'],
-  bm25: true,
-});
-```
-
-## Related
-
-- [Agent skills specification](https://agentskills.io)
-- [Workspace overview](https://mastra.ai/docs/workspace/overview)
-- [Search and indexing](https://mastra.ai/docs/workspace/search)

package/.docs/guides/agent-frameworks/ai-sdk.md

@@ -1,140 +0,0 @@
-# AI SDK
-
-If you're already using the [Vercel AI SDK](https://sdk.vercel.ai) directly and want to add Mastra capabilities like [processors](https://mastra.ai/docs/agents/processors) or [memory](https://mastra.ai/docs/memory/memory-processors) without switching to the full Mastra agent API, [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) lets you wrap any AI SDK model with these features. This is useful when you want to keep your existing AI SDK code but add input/output processing, conversation persistence, or content filtering.
-
-> **Tip:** If you want to use Mastra together with AI SDK UI (e.g. `useChat()`), visit the [AI SDK UI guide](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
-
-## Installation
-
-Install `@mastra/ai-sdk` to begin using the `withMastra()` function.
-
-**npm**:
-
-```bash
-npm install @mastra/ai-sdk@latest
-```
-
-**pnpm**:
-
-```bash
-pnpm add @mastra/ai-sdk@latest
-```
-
-**Yarn**:
-
-```bash
-yarn add @mastra/ai-sdk@latest
-```
-
-**Bun**:
-
-```bash
-bun add @mastra/ai-sdk@latest
-```
-
-## Examples
-
-### With Processors
-
-Processors let you transform messages before they're sent to the model (`processInput`) and after responses are received (`processOutputResult`). This example creates a logging processor that logs message counts at each stage, then wraps an OpenAI model with it.
-
-```typescript
-import { openai } from '@ai-sdk/openai';
-import { generateText } from 'ai';
-import { withMastra } from '@mastra/ai-sdk';
-import type { Processor } from '@mastra/core/processors';
-
-const loggingProcessor: Processor<'logger'> = {
-  id: 'logger',
-  async processInput({ messages }) {
-    console.log('Input:', messages.length, 'messages');
-    return messages;
-  },
-  async processOutputResult({ messages }) {
-    console.log('Output:', messages.length, 'messages');
-    return messages;
-  },
-};
-
-const model = withMastra(openai('gpt-4o'), {
-  inputProcessors: [loggingProcessor],
-  outputProcessors: [loggingProcessor],
-});
-
-const { text } = await generateText({
-  model,
-  prompt: 'What is 2 + 2?',
-});
-```
-
-### With Memory
-
-Memory automatically loads previous messages from storage before the LLM call and saves new messages after. This example configures a libSQL storage backend to persist conversation history, loading the last 10 messages for context.
-
-```typescript
-import { openai } from '@ai-sdk/openai';
-import { generateText } from 'ai';
-import { withMastra } from '@mastra/ai-sdk';
-import { LibSQLStore } from '@mastra/libsql';
-
-const storage = new LibSQLStore({
-  id: 'my-app',
-  url: 'file:./data.db',
-});
-await storage.init();
-
-const memoryStorage = await storage.getStore('memory');
-
-const model = withMastra(openai('gpt-4o'), {
-  memory: {
-    storage: memoryStorage!,
-    threadId: 'user-thread-123',
-    resourceId: 'user-123',
-    lastMessages: 10,
-  },
-});
-
-const { text } = await generateText({
-  model,
-  prompt: 'What did we talk about earlier?',
-});
-```
-
-### With Processors & Memory
-
-You can combine processors and memory together. Input processors run after memory loads historical messages, and output processors run before memory saves the response.
-
-```typescript
-import { openai } from '@ai-sdk/openai';
-import { generateText } from 'ai';
-import { withMastra } from '@mastra/ai-sdk';
-import { LibSQLStore } from '@mastra/libsql';
-
-const storage = new LibSQLStore({ id: 'my-app', url: 'file:./data.db' });
-await storage.init();
-
-const memoryStorage = await storage.getStore('memory');
-
-const model = withMastra(openai('gpt-4o'), {
-  inputProcessors: [myGuardProcessor],
-  outputProcessors: [myLoggingProcessor],
-  memory: {
-    storage: memoryStorage!,
-    threadId: 'thread-123',
-    resourceId: 'user-123',
-    lastMessages: 10,
-  },
-});
-
-const { text } = await generateText({
-  model,
-  prompt: 'Hello!',
-});
-```
-
-## Related
-
-- [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) - API reference for `withMastra()`
-- [Processors](https://mastra.ai/docs/agents/processors) - Learn about input and output processors
-- [Memory](https://mastra.ai/docs/memory/overview) - Overview of Mastra's memory system
-- [AI SDK UI](https://mastra.ai/guides/build-your-ui/ai-sdk-ui) - Using AI SDK UI hooks with Mastra agents, workflows, and networks