@mastra/mcp-docs-server 0.13.39 → 1.0.0-beta.1

package/.docs/raw/reference/memory/getThreadsByResourceId.mdx

@@ -1,79 +0,0 @@
----
-title: "Reference: Memory.getThreadsByResourceId() | Memory | Mastra Docs"
-description: "Documentation for the `Memory.getThreadsByResourceId()` method in Mastra, which retrieves all threads that belong to a specific resource."
----
-
-# Memory.getThreadsByResourceId()
-
-The `.getThreadsByResourceId()` function retrieves all threads associated with a specific resource ID from storage. Threads can be sorted by creation or modification time in ascending or descending order.
-
-## Usage Example
-
-```typescript
-await memory?.getThreadsByResourceId({ resourceId: "user-123" });
-```
-
-## Parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "resourceId",
-      type: "string",
-      description: "The ID of the resource whose threads are to be retrieved.",
-      isOptional: false,
-    },
-    {
-      name: "orderBy",
-      type: "ThreadOrderBy",
-      description:
-        "Field to sort threads by. Accepts 'createdAt' or 'updatedAt'. Default: 'createdAt'",
-      isOptional: true,
-    },
-    {
-      name: "sortDirection",
-      type: "ThreadSortDirection",
-      description:
-        "Sort order direction. Accepts 'ASC' or 'DESC'. Default: 'DESC'",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Returns
-
-<PropertiesTable
-  content={[
-    {
-      name: "StorageThreadType[]",
-      type: "Promise",
-      description:
-        "A promise that resolves to an array of threads associated with the given resource ID.",
-    },
-  ]}
-/>
-
-## Extended usage example
-
-```typescript title="src/test-memory.ts" showLineNumbers copy
-import { mastra } from "./mastra";
-
-const agent = mastra.getAgent("agent");
-const memory = await agent.getMemory();
-
-const thread = await memory?.getThreadsByResourceId({
-  resourceId: "user-123",
-  orderBy: "updatedAt",
-  sortDirection: "ASC",
-});
-
-console.log(thread);
-```
-
-### Related
-
-- [Memory Class Reference](/reference/memory/memory-class)
-- [getThreadsByResourceIdPaginated](/reference/memory/getThreadsByResourceIdPaginated) - Paginated version
-- [Getting Started with Memory](/docs/memory/overview) (Covers threads/resources concept)
-- [createThread](/reference/memory/createThread)
-- [getThreadById](/reference/memory/getThreadById)

package/.docs/raw/reference/memory/getThreadsByResourceIdPaginated.mdx

@@ -1,110 +0,0 @@
----
-title: "Reference: Memory.getThreadsByResourceIdPaginated() | Memory | Mastra Docs"
-description: "Documentation for the `Memory.getThreadsByResourceIdPaginated()` method in Mastra, which retrieves threads associated with a specific resource ID with pagination support."
----
-
-# Memory.getThreadsByResourceIdPaginated()
-
-The `.getThreadsByResourceIdPaginated()` method retrieves threads associated with a specific resource ID with pagination support.
-
-## Usage Example
-
-```typescript copy
-await memory.getThreadsByResourceIdPaginated({
-  resourceId: "user-123",
-  page: 0,
-  perPage: 10,
-});
-```
-
-## Parameters
-
-<PropertiesTable
-  content={[
-    {
-      name: "resourceId",
-      type: "string",
-      description: "The ID of the resource whose threads are to be retrieved",
-      isOptional: false,
-    },
-    {
-      name: "page",
-      type: "number",
-      description: "Page number to retrieve",
-      isOptional: false,
-    },
-    {
-      name: "perPage",
-      type: "number",
-      description: "Number of threads to return per page",
-      isOptional: false,
-    },
-    {
-      name: "orderBy",
-      type: "'createdAt' | 'updatedAt'",
-      description: "Field to sort threads by",
-      isOptional: true,
-    },
-    {
-      name: "sortDirection",
-      type: "'ASC' | 'DESC'",
-      description: "Sort order direction",
-      isOptional: true,
-    },
-  ]}
-/>
-
-## Returns
-
-<PropertiesTable
-  content={[
-    {
-      name: "result",
-      type: "Promise<PaginationInfo & { threads: StorageThreadType[] }>",
-      description:
-        "A promise that resolves to paginated thread results with metadata",
-    },
-  ]}
-/>
-
-## Extended usage example
-
-```typescript title="src/test-memory.ts" showLineNumbers copy
-import { mastra } from "./mastra";
-
-const agent = mastra.getAgent("agent");
-const memory = await agent.getMemory();
-
-let currentPage = 0;
-let hasMorePages = true;
-
-while (hasMorePages) {
-  const threads = await memory?.getThreadsByResourceIdPaginated({
-    resourceId: "user-123",
-    page: currentPage,
-    perPage: 25,
-    orderBy: "createdAt",
-    sortDirection: "ASC",
-  });
-
-  if (!threads) {
-    console.log("No threads");
-    break;
-  }
-
-  threads.threads.forEach((thread) => {
-    console.log(`Thread: ${thread.id}, Created: ${thread.createdAt}`);
-  });
-
-  hasMorePages = threads.hasMore;
-  currentPage++;
-}
-```
-
-## Related
-
-- [Memory Class Reference](/reference/memory/memory-class)
-- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId) - Non-paginated version
-- [Getting Started with Memory](/docs/memory/overview) (Covers threads/resources concept)
-- [createThread](/reference/memory/createThread)
-- [getThreadById](/reference/memory/getThreadById)

package/.docs/raw/reference/observability/ai-tracing/ai-tracing.mdx

@@ -1,185 +0,0 @@
----
-title: "Reference: AITracing | Observability | Mastra Docs"
-description: Core AI Tracing classes and methods
----
-
-import PropertiesTable from "@site/src/components/PropertiesTable";
-
-# AITracing
-
-## DefaultAITracing
-
-Default implementation of the AITracing interface.
-
-### Constructor
-
-```typescript
-new DefaultAITracing(config: TracingConfig)
-```
-
-Creates a new DefaultAITracing instance with the specified configuration.
-
-### Properties
-
-Inherits all properties and methods from BaseAITracing.
-
-## BaseAITracing
-
-Base class for custom AI tracing implementations.
-
-### Methods
-
-#### getConfig
-
-```typescript
-getConfig(): Readonly<Required<TracingConfig>>
-```
-
-Returns the current tracing configuration.
-
-#### getExporters
-
-```typescript
-getExporters(): readonly AITracingExporter[]
-```
-
-Returns all configured exporters.
-
-#### getProcessors
-
-```typescript
-getProcessors(): readonly AISpanProcessor[]
-```
-
-Returns all configured processors.
-
-#### getLogger
-
-```typescript
-getLogger(): IMastraLogger
-```
-
-Returns the logger instance for exporters and other components.
-
-#### startSpan
-
-```typescript
-startSpan<TType extends AISpanType>(
-  options: StartSpanOptions<TType>
-): AISpan<TType>
-```
-
-Start a new span of a specific AISpanType. Creates the root span of a trace if no parent is provided.
-
-<PropertiesTable
-  props={[
-    {
-      name: "type",
-      type: "AISpanType",
-      description: "Type of span to create",
-      required: true,
-    },
-    {
-      name: "name",
-      type: "string",
-      description: "Name of the span",
-      required: true,
-    },
-    {
-      name: "parent",
-      type: "AnyAISpan",
-      description: "Parent span (if not root)",
-      required: false,
-    },
-    {
-      name: "attributes",
-      type: "AISpanTypeMap[TType]",
-      description: "Type-specific attributes",
-      required: false,
-    },
-    {
-      name: "metadata",
-      type: "Record<string, any>",
-      description: "User-defined metadata",
-      required: false,
-    },
-    {
-      name: "input",
-      type: "any",
-      description: "Initial input data",
-      required: false,
-    },
-    {
-      name: "customSamplerOptions",
-      type: "CustomSamplerOptions",
-      description: "Options for custom sampler",
-      required: false,
-    },
-  ]}
-/>
-
-#### shutdown
-
-```typescript
-async shutdown(): Promise<void>
-```
-
-Shuts down all exporters and processors, cleaning up resources.
-
-## Custom Implementation
-
-To create a custom AI tracing implementation, extend BaseAITracing:
-
-```typescript
-class CustomAITracing extends BaseAITracing {
-  constructor(config: TracingConfig) {
-    super(config);
-    // Custom initialization
-  }
-
-  // Override methods as needed
-  startSpan<TType extends AISpanType>(
-    options: StartSpanOptions<TType>,
-  ): AISpan<TType> {
-    // Custom span creation logic
-    return super.startSpan(options);
-  }
-}
-```
-
-## NO-OP Spans
-
-When tracing is disabled (sampling returns false), NO-OP spans are returned:
-
-### NoOpAISpan
-
-```typescript
-class NoOpAISpan<TType extends AISpanType> extends BaseAISpan<TType>
-```
-
-A span that performs no operations. All methods are no-ops:
-
-- `id` returns `'no-op'`
-- `traceId` returns `'no-op-trace'`
-- `isValid` returns `false`
-- `end()`, `error()`, `update()` do nothing
-- `createChildSpan()` returns another NO-OP span
-
-## See Also
-
-### Documentation
-
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Concepts and usage guide
-- [Configuration Reference](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces Reference](/reference/observability/ai-tracing/interfaces) - Type definitions
-- [Span Reference](/reference/observability/ai-tracing/span) - Span lifecycle and methods
-
-### Examples
-
-- [Basic AI Tracing](/examples/observability/basic-ai-tracing) - Getting started example
-
-### Exporters
-
-- [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage persistence
-- [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Mastra Cloud integration
-- [ConsoleExporter](/reference/observability/ai-tracing/exporters/console-exporter) - Debug output

package/.docs/raw/reference/observability/ai-tracing/configuration.mdx

@@ -1,238 +0,0 @@
----
-title: "Reference: Configuration | Observability | Mastra Docs"
-description: AI Tracing configuration types and registry functions
----
-
-import PropertiesTable from "@site/src/components/PropertiesTable";
-
-# Configuration
-
-## ObservabilityRegistryConfig
-
-```typescript
-interface ObservabilityRegistryConfig {
-  default?: { enabled?: boolean };
-  configs?: Record<string, TracingConfig | AITracing>;
-  configSelector?: ConfigSelector;
-}
-```
-
-<PropertiesTable
-  props={[
-    {
-      name: "default",
-      type: "{ enabled?: boolean }",
-      description: "Enable default configuration",
-      required: false,
-    },
-    {
-      name: "configs",
-      type: "Record<string, TracingConfig | AITracing>",
-      description: "Named tracing configurations",
-      required: false,
-    },
-    {
-      name: "configSelector",
-      type: "ConfigSelector",
-      description: "Runtime configuration selector",
-      required: false,
-    },
-  ]}
-/>
-
-## TracingConfig
-
-```typescript
-interface TracingConfig {
-  name: string;
-  serviceName: string;
-  sampling?: SamplingStrategy;
-  exporters?: AITracingExporter[];
-  processors?: AISpanProcessor[];
-}
-```
-
-<PropertiesTable
-  props={[
-    {
-      name: "name",
-      type: "string",
-      description: "Configuration identifier",
-      required: true,
-    },
-    {
-      name: "serviceName",
-      type: "string",
-      description: "Service name in traces",
-      required: true,
-    },
-    {
-      name: "sampling",
-      type: "SamplingStrategy",
-      description: "Sampling configuration",
-      required: false,
-    },
-    {
-      name: "exporters",
-      type: "AITracingExporter[]",
-      description: "Trace data exporters",
-      required: false,
-    },
-    {
-      name: "processors",
-      type: "AISpanProcessor[]",
-      description: "Span processors",
-      required: false,
-    },
-  ]}
-/>
-
-## SamplingStrategy
-
-```typescript
-type SamplingStrategy =
-  | { type: "always" }
-  | { type: "never" }
-  | { type: "ratio"; probability: number }
-  | { type: "custom"; sampler: (options?: TracingOptions) => boolean };
-```
-
-## ConfigSelector
-
-```typescript
-type ConfigSelector = (
-  options: ConfigSelectorOptions,
-  availableConfigs: Map<string, AITracing>,
-) => string | undefined;
-```
-
-## ConfigSelectorOptions
-
-```typescript
-interface ConfigSelectorOptions {
-  metadata?: Record<string, any>;
-  runtimeContext?: Map<string, any>;
-}
-```
-
-# Registry Functions
-
-## setupAITracing
-
-```typescript
-function setupAITracing(config: ObservabilityRegistryConfig): void;
-```
-
-Initializes AI tracing from configuration. Called automatically by Mastra constructor.
-
-## registerAITracing
-
-```typescript
-function registerAITracing(
-  name: string,
-  instance: AITracing,
-  isDefault?: boolean,
-): void;
-```
-
-Registers a tracing config in the global registry.
-
-## getAITracing
-
-```typescript
-function getAITracing(name: string): AITracing | undefined;
-```
-
-Retrieves a tracing config by name.
-
-## getDefaultAITracing
-
-```typescript
-function getDefaultAITracing(): AITracing | undefined;
-```
-
-Returns the default tracing config.
-
-## getSelectedAITracing
-
-```typescript
-function getSelectedAITracing(
-  options: ConfigSelectorOptions,
-): AITracing | undefined;
-```
-
-Returns the tracing config selected by the config selector or default.
-
-## setSelector
-
-```typescript
-function setSelector(selector: ConfigSelector): void;
-```
-
-Sets the global config selector function.
-
-## unregisterAITracing
-
-```typescript
-function unregisterAITracing(name: string): boolean;
-```
-
-Removes a tracing config from the registry.
-
-## shutdownAITracingRegistry
-
-```typescript
-async function shutdownAITracingRegistry(): Promise<void>;
-```
-
-Shuts down all tracing configs and clears the registry.
-
-## clearAITracingRegistry
-
-```typescript
-function clearAITracingRegistry(): void;
-```
-
-Clears all configs without shutdown.
-
-## getAllAITracing
-
-```typescript
-function getAllAITracing(): ReadonlyMap<string, AITracing>;
-```
-
-Returns all registered tracing configs.
-
-## hasAITracing
-
-```typescript
-function hasAITracing(name: string): boolean;
-```
-
-Checks if a tracing instance exists and is enabled.
-
-## See Also
-
-### Documentation
-
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Concepts and usage guide
-- [Sampling Strategies](/docs/observability/ai-tracing/overview#sampling-strategies) - Sampling configuration details
-- [Multi-Config Setup](/docs/observability/ai-tracing/overview#multi-config-setup) - Using multiple configurations
-
-### Reference
-
-- [AITracing Classes](/reference/observability/ai-tracing/) - Core tracing classes
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
-- [Span Reference](/reference/observability/ai-tracing/span) - Span lifecycle
-
-### Examples
-
-- [Basic AI Tracing](/examples/observability/basic-ai-tracing) - Getting started
-
-### Exporters
-
-- [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage configuration
-- [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Cloud setup
-- [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
-- [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
-- [LangSmith](/reference/observability/ai-tracing/exporters/langsmith) - LangSmith integration