@mastra/server 0.0.0-ai-v5-20250718021026 → 0.0.0-ai-v5-20250729181825

package/dist/_tsup-dts-rollup.d.cts

@@ -2,12 +2,12 @@ import type { Agent } from '@mastra/core/agent';
 import type { AgentCard } from '@mastra/core/a2a';
 import type { AgentNetwork } from '@mastra/core/network';
 import type { Artifact } from '@mastra/core/a2a';
-import type { BaseLogMessage } from '@mastra/core/logger';
+import { BaseLogMessage } from '@mastra/core/logger';
 import type { CoreMessage } from '@mastra/core/llm';
 import { DefaultEngineType } from '@mastra/core';
 import { EvalRow } from '@mastra/core';
-import { GenerateObjectResult } from 'ai';
-import { GenerateTextResult } from 'ai';
+import type { GenerateReturn } from '@mastra/core/llm';
+import { GenerateTextResult } from '@mastra/core';
 import type { IMastraLogger } from '@mastra/core/logger';
 import type { JSONRPCError } from '@mastra/core/a2a';
 import { JSONRPCResponse } from '@mastra/core/a2a';
@@ -20,18 +20,26 @@ import type { Mastra } from '@mastra/core/mastra';
 import type { MastraError } from '@mastra/core/error';
 import type { MastraMemory } from '@mastra/core/memory';
 import { MastraMessageV1 } from '@mastra/core';
+import { MastraMessageV2 } from '@mastra/core';
+import type { MastraScorerEntry } from '@mastra/core/scores';
+import { MastraWorkflowStream } from '@mastra/core';
+import { MemoryConfig } from '@mastra/core';
 import type { Message } from '@mastra/core/a2a';
 import { ModelMessage } from 'ai';
+import { PaginationInfo } from '@mastra/core';
 import type { QueryResult } from '@mastra/core/vector';
 import { ReadableStream as ReadableStream_2 } from 'node:stream/web';
 import { ReadableStream as ReadableStream_3 } from 'stream/web';
 import { RuntimeContext } from '@mastra/core/runtime-context';
 import type { RuntimeContext as RuntimeContext_2 } from '@mastra/core/di';
+import type { ScoreRowData } from '@mastra/core/scores';
 import type { SerializedStepFlowEntry } from '@mastra/core/workflows';
 import { Step } from '@mastra/core';
 import { StepExecutionContext } from '@mastra/core/workflows/legacy';
 import { StepGraph } from '@mastra/core/workflows/legacy';
 import { StepResult } from '@mastra/core';
+import type { StorageGetMessagesArg } from '@mastra/core';
+import type { StoragePagination } from '@mastra/core/storage';
 import { StorageThreadType } from '@mastra/core';
 import { StreamEvent } from '@mastra/core';
 import { Task } from '@mastra/core/a2a';
@@ -41,7 +49,9 @@ import type { TaskIdParams } from '@mastra/core/a2a';
 import type { TaskQueryParams } from '@mastra/core/a2a';
 import type { TaskSendParams } from '@mastra/core/a2a';
 import type { TaskStatus } from '@mastra/core/a2a';
+import type { ThreadSortOptions } from '@mastra/core/storage';
 import type { ToolAction } from '@mastra/core/tools';
+import { Trace } from '@mastra/core';
 import type { VercelTool } from '@mastra/core/tools';
 import type { WatchEvent } from '@mastra/core/workflows';
 import type { Workflow } from '@mastra/core/workflows';
@@ -77,7 +87,8 @@ export declare namespace agents {
         getEvalsByAgentIdHandler,
         getLiveEvalsByAgentIdHandler,
         generateHandler,
-        streamGenerateHandler
+        streamGenerateHandler,
+        streamVNextGenerateHandler
     }
 }
 
@@ -143,6 +154,21 @@ export declare function deleteIndex({ mastra, vectorName, indexName, }: Pick<Vec
     success: boolean;
 }>;
 
+/**
+ * Handler to delete one or more messages.
+ * @param messageIds - Can be a single ID, array of IDs, or objects with ID property
+ */
+export declare function deleteMessagesHandler({ mastra, agentId, messageIds, networkId, runtimeContext, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'networkId' | 'runtimeContext'> & {
+    messageIds: string | string[] | {
+        id: string;
+    } | {
+        id: string;
+    }[];
+}): Promise<{
+    success: boolean;
+    message: string;
+}>;
+
 export declare function deleteThreadHandler({ mastra, agentId, threadId, networkId, runtimeContext, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'threadId' | 'networkId' | 'runtimeContext'>): Promise<{
     result: string;
 }>;
@@ -176,14 +202,14 @@ export declare function generateHandler({ mastra, runtimeContext, agentId, body,
         runtimeContext?: Record<string, unknown>;
     };
     abortSignal?: AbortSignal;
-}): Promise<GenerateTextResult<any, unknown>>;
+}): Promise<GenerateTextResult<any, undefined>>;
 
 export declare function generateHandler_alias_1({ mastra, runtimeContext, networkId, body, }: NetworkContext & {
     runtimeContext: RuntimeContext;
     body: {
         messages?: Parameters<AgentNetwork['generate']>[0];
     } & Parameters<AgentNetwork['generate']>[1];
-}): Promise<GenerateObjectResult<any>>;
+}): Promise<GenerateReturn<any>>;
 
 /**
  * Generate speech from text
@@ -206,7 +232,7 @@ export declare function generateVNextNetworkHandler({ mastra, runtimeContext, ne
     task: string;
     result: string;
     resourceId: string;
-    resourceType: "tool" | "none" | "workflow" | "agent";
+    resourceType: "tool" | "none" | "agent" | "workflow";
 }>;
 
 export declare function getAgentByIdHandler({ mastra, runtimeContext, agentId, isPlayground, }: Context & {
@@ -334,6 +360,10 @@ export declare function getLogTransports({ mastra }: Pick<LogsContext, 'mastra'>
     transports: string[];
 }>;
 
+export declare function getMemoryConfigHandler({ mastra, agentId, networkId, runtimeContext, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'networkId' | 'runtimeContext'>): Promise<{
+    config: MemoryConfig;
+}>;
+
 export declare function getMemoryStatusHandler({ mastra, agentId, networkId, runtimeContext, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'networkId' | 'runtimeContext'>): Promise<{
     result: boolean;
 }>;
@@ -347,6 +377,10 @@ export declare function getMessagesHandler({ mastra, agentId, threadId, limit, f
     uiMessages: any[];
 }>;
 
+export declare function getMessagesPaginatedHandler({ mastra, threadId, resourceId, selectBy, format, }: StorageGetMessagesArg & Pick<MemoryContext, 'mastra'>): Promise<PaginationInfo & {
+    messages: MastraMessageV1[] | MastraMessageV2[];
+}>;
+
 export declare function getNetworkByIdHandler({ mastra, networkId, runtimeContext, }: Pick<NetworkContext, 'mastra' | 'networkId' | 'runtimeContext'>): Promise<{
     id: string;
     name: string;
@@ -377,6 +411,50 @@ export declare function getNetworksHandler({ mastra, runtimeContext, }: Pick<Net
     };
 }[]>;
 
+export declare function getScorerHandler({ mastra, scorerId, runtimeContext, }: Context & {
+    scorerId: string;
+    runtimeContext: RuntimeContext;
+}): Promise<(MastraScorerEntry & {
+    agentIds: string[];
+    workflowIds: string[];
+}) | null>;
+
+export declare function getScorersHandler({ mastra, runtimeContext }: Context & {
+    runtimeContext: RuntimeContext;
+}): Promise<{
+    [k: string]: MastraScorerEntry & {
+        agentIds: string[];
+        workflowIds: string[];
+    };
+}>;
+
+export declare function getScoresByEntityIdHandler({ mastra, entityId, entityType, pagination, }: Context & {
+    entityId: string;
+    entityType: string;
+    pagination: StoragePagination;
+}): Promise<never[] | {
+    pagination: PaginationInfo;
+    scores: ScoreRowData[];
+}>;
+
+export declare function getScoresByRunIdHandler({ mastra, runId, pagination, }: Context & {
+    runId: string;
+    pagination: StoragePagination;
+}): Promise<never[] | {
+    pagination: PaginationInfo;
+    scores: ScoreRowData[];
+}>;
+
+export declare function getScoresByScorerIdHandler({ mastra, scorerId, pagination, entityId, entityType, }: Context & {
+    scorerId: string;
+    pagination: StoragePagination;
+    entityId?: string;
+    entityType?: string;
+}): Promise<never[] | {
+    pagination: PaginationInfo;
+    scores: ScoreRowData[];
+}>;
+
 /**
  * Get available speakers for an agent
  */
@@ -384,11 +462,11 @@ export declare function getSpeakersHandler({ mastra, agentId }: VoiceContext): P
     voiceId: string;
 }[]>;
 
-export declare function getTelemetryHandler({ mastra, body }: TelemetryContext): Promise<any[]>;
+export declare function getTelemetryHandler({ mastra, body }: TelemetryContext): Promise<Trace[]>;
 
 export declare function getThreadByIdHandler({ mastra, agentId, threadId, networkId, runtimeContext, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'threadId' | 'networkId' | 'runtimeContext'>): Promise<StorageThreadType>;
 
-export declare function getThreadsHandler({ mastra, agentId, resourceId, networkId, runtimeContext, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'resourceId' | 'networkId' | 'runtimeContext'>): Promise<StorageThreadType[]>;
+export declare function getThreadsHandler({ mastra, agentId, resourceId, networkId, runtimeContext, orderBy, sortDirection, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'resourceId' | 'networkId' | 'runtimeContext'> & ThreadSortOptions): Promise<StorageThreadType[]>;
 
 export declare function getToolByIdHandler({ tools, toolId }: Pick<ToolsContext, 'tools' | 'toolId'>): Promise<any>;
 
@@ -674,20 +752,20 @@ export declare function loopStreamVNextNetworkHandler({ mastra, networkId, body,
     completionReason: ZodOptional<ZodString>;
     iteration: ZodNumber;
     }, "strip", ZodTypeAny, {
+    resourceId: string;
     result: string;
     prompt: string;
-    resourceId: string;
     task: string;
-    resourceType: "tool" | "none" | "workflow" | "agent";
+    resourceType: "tool" | "none" | "agent" | "workflow";
     iteration: number;
     isComplete?: boolean | undefined;
     completionReason?: string | undefined;
     }, {
+    resourceId: string;
     result: string;
     prompt: string;
-    resourceId: string;
     task: string;
-    resourceType: "tool" | "none" | "workflow" | "agent";
+    resourceType: "tool" | "none" | "agent" | "workflow";
     iteration: number;
     isComplete?: boolean | undefined;
     completionReason?: string | undefined;
@@ -702,8 +780,17 @@ export declare function loopVNextNetworkHandler({ mastra, networkId, body, runti
 }): Promise<{
     status: "success";
     result: {
-        text: string;
+        resourceId: string;
+        result: string;
+        prompt: string;
+        task: string;
+        resourceType: "tool" | "none" | "agent" | "workflow";
         iteration: number;
+        isOneOff: boolean;
+        threadId?: string | undefined;
+        threadResourceId?: string | undefined;
+        isComplete?: boolean | undefined;
+        completionReason?: string | undefined;
     };
     steps: {
         [x: string]: StepResult<any, any, any, any> | StepResult<unknown, unknown, unknown, unknown>;
@@ -713,15 +800,19 @@ export declare function loopVNextNetworkHandler({ mastra, networkId, body, runti
 export declare namespace memory {
     export {
         getMemoryStatusHandler,
+        getMemoryConfigHandler,
         getThreadsHandler,
         getThreadByIdHandler,
         saveMessagesHandler,
         createThreadHandler,
         updateThreadHandler,
         deleteThreadHandler,
+        getMessagesPaginatedHandler,
         getMessagesHandler,
         getWorkingMemoryHandler,
-        updateWorkingMemoryHandler
+        updateWorkingMemoryHandler,
+        deleteMessagesHandler,
+        searchMemoryHandler
     }
 }
 
@@ -810,6 +901,53 @@ export declare function saveMessagesHandler({ mastra, agentId, body, networkId,
     };
 }): Promise<MastraMessageV1[]>;
 
+export declare function saveScoreHandler({ mastra, score }: Context & {
+    score: ScoreRowData;
+}): Promise<never[] | {
+    score: ScoreRowData;
+}>;
+
+export declare namespace scores {
+    export {
+        getScorersHandler,
+        getScorerHandler,
+        getScoresByRunIdHandler,
+        getScoresByScorerIdHandler,
+        getScoresByEntityIdHandler,
+        saveScoreHandler
+    }
+}
+
+export declare function searchMemoryHandler({ mastra, agentId, searchQuery, resourceId, threadId, limit, networkId, runtimeContext, memoryConfig, }: Pick<MemoryContext, 'mastra' | 'agentId' | 'networkId' | 'runtimeContext'> & {
+    searchQuery: string;
+    resourceId: string;
+    threadId?: string;
+    limit?: number;
+    memoryConfig?: any;
+}): Promise<SearchResponse | ReturnType<typeof handleError>>;
+
+declare interface SearchResponse {
+    results: SearchResult[];
+    count: number;
+    query: string;
+    searchScope?: string;
+    searchType?: string;
+}
+
+declare interface SearchResult {
+    id: string;
+    role: string;
+    content: any;
+    createdAt: Date;
+    threadId?: string;
+    threadTitle?: string;
+    score?: number;
+    context?: {
+        before?: SearchResult[];
+        after?: SearchResult[];
+    };
+}
+
 export declare function sendWorkflowRunEventHandler({ mastra, workflowId, runId, event, data, }: Pick<WorkflowContext_3, 'mastra' | 'workflowId' | 'runId'> & {
     event: string;
     data: unknown;
@@ -915,11 +1053,11 @@ export declare function streamGenerateVNextNetworkHandler({ mastra, networkId, b
     threadResourceId: ZodOptional<ZodString>;
     isOneOff: ZodBoolean;
     }, "strip", ZodTypeAny, {
+    resourceId: string;
     result: string;
     prompt: string;
-    resourceId: string;
     task: string;
-    resourceType: "tool" | "none" | "workflow" | "agent";
+    resourceType: "tool" | "none" | "agent" | "workflow";
     iteration: number;
     isOneOff: boolean;
     threadId?: string | undefined;
@@ -927,11 +1065,11 @@ export declare function streamGenerateVNextNetworkHandler({ mastra, networkId, b
     isComplete?: boolean | undefined;
     completionReason?: string | undefined;
     }, {
+    resourceId: string;
     result: string;
     prompt: string;
-    resourceId: string;
     task: string;
-    resourceType: "tool" | "none" | "workflow" | "agent";
+    resourceType: "tool" | "none" | "agent" | "workflow";
     iteration: number;
     isOneOff: boolean;
     threadId?: string | undefined;
@@ -941,6 +1079,20 @@ export declare function streamGenerateVNextNetworkHandler({ mastra, networkId, b
     }>, Step<string, any, any, any, any, DefaultEngineType>[]>>;
 }>;
 
+export declare function streamVNextGenerateHandler({ mastra, runtimeContext, agentId, body, abortSignal, }: Context & {
+    runtimeContext: RuntimeContext;
+    agentId: string;
+    body: GetBody<'streamVNext'> & {
+        runtimeContext?: string;
+    };
+    abortSignal?: AbortSignal;
+}): ReturnType<Agent['streamVNext']>;
+
+export declare function streamVNextWorkflowHandler({ mastra, runtimeContext, workflowId, runId, inputData, }: Pick<WorkflowContext_3, 'mastra' | 'workflowId' | 'runId'> & {
+    inputData?: unknown;
+    runtimeContext?: RuntimeContext_2;
+}): Promise<MastraWorkflowStream>;
+
 export declare function streamWorkflowHandler({ mastra, runtimeContext, workflowId, runId, inputData, }: Pick<WorkflowContext_3, 'mastra' | 'workflowId' | 'runId'> & {
     inputData?: unknown;
     runtimeContext?: RuntimeContext_2;
@@ -1098,6 +1250,7 @@ export declare namespace workflows {
         startWorkflowRunHandler,
         watchWorkflowHandler,
         streamWorkflowHandler,
+        streamVNextWorkflowHandler,
         resumeAsyncWorkflowHandler,
         resumeWorkflowHandler,
         getWorkflowRunsHandler,