@mastra/client-js 0.0.0-vector-sources-20250516175436 → 0.0.0-vector-query-tool-provider-options-20250828222356

package/src/client.ts

@@ -1,4 +1,6 @@
 import type { AbstractAgent } from '@ag-ui/client';
+import type { AITraceRecord, AITracesPaginatedArg } from '@mastra/core';
+import type { ServerDetailInfo } from '@mastra/core/mcp';
 import { AGUIAdapter } from './adapters/agui';
 import {
   Agent,
@@ -8,10 +10,13 @@ import {
   Vector,
   BaseResource,
   Network,
-  VNextWorkflow,
   A2A,
   MCPTool,
+  LegacyWorkflow,
+  Observability,
 } from './resources';
+import { NetworkMemoryThread } from './resources/network-memory-thread';
+import { VNextNetwork } from './resources/vNextNetwork';
 import type {
   ClientOptions,
   CreateMemoryThreadParams,
@@ -26,19 +31,31 @@ import type {
   GetTelemetryParams,
   GetTelemetryResponse,
   GetToolResponse,
-  GetVNextWorkflowResponse,
   GetWorkflowResponse,
   SaveMessageToMemoryParams,
   SaveMessageToMemoryResponse,
   McpServerListResponse,
   McpServerToolListResponse,
-  McpToolInfo,
+  GetLegacyWorkflowResponse,
+  GetVNextNetworkResponse,
+  GetNetworkMemoryThreadParams,
+  CreateNetworkMemoryThreadParams,
+  SaveNetworkMessageToMemoryParams,
+  GetScorerResponse,
+  GetScoresByScorerIdParams,
+  GetScoresResponse,
+  GetScoresByRunIdParams,
+  GetScoresByEntityIdParams,
+  SaveScoreParams,
+  SaveScoreResponse,
+  GetAITracesResponse,
 } from './types';
-import type { ServerDetailInfo } from '@mastra/core/mcp';
 
 export class MastraClient extends BaseResource {
+  private observability: Observability;
   constructor(options: ClientOptions) {
     super(options);
+    this.observability = new Observability(options);
   }
 
   /**
@@ -124,6 +141,53 @@ export class MastraClient extends BaseResource {
     return this.request(`/api/memory/status?agentId=${agentId}`);
   }
 
+  /**
+   * Retrieves memory threads for a resource
+   * @param params - Parameters containing the resource ID
+   * @returns Promise containing array of memory threads
+   */
+  public getNetworkMemoryThreads(params: GetNetworkMemoryThreadParams): Promise<GetMemoryThreadResponse> {
+    return this.request(`/api/memory/network/threads?resourceid=${params.resourceId}&networkId=${params.networkId}`);
+  }
+
+  /**
+   * Creates a new memory thread
+   * @param params - Parameters for creating the memory thread
+   * @returns Promise containing the created memory thread
+   */
+  public createNetworkMemoryThread(params: CreateNetworkMemoryThreadParams): Promise<CreateMemoryThreadResponse> {
+    return this.request(`/api/memory/network/threads?networkId=${params.networkId}`, { method: 'POST', body: params });
+  }
+
+  /**
+   * Gets a memory thread instance by ID
+   * @param threadId - ID of the memory thread to retrieve
+   * @returns MemoryThread instance
+   */
+  public getNetworkMemoryThread(threadId: string, networkId: string) {
+    return new NetworkMemoryThread(this.options, threadId, networkId);
+  }
+
+  /**
+   * Saves messages to memory
+   * @param params - Parameters containing messages to save
+   * @returns Promise containing the saved messages
+   */
+  public saveNetworkMessageToMemory(params: SaveNetworkMessageToMemoryParams): Promise<SaveMessageToMemoryResponse> {
+    return this.request(`/api/memory/network/save-messages?networkId=${params.networkId}`, {
+      method: 'POST',
+      body: params,
+    });
+  }
+
+  /**
+   * Gets the status of the memory system
+   * @returns Promise containing memory system status
+   */
+  public getNetworkMemoryStatus(networkId: string): Promise<{ result: boolean }> {
+    return this.request(`/api/memory/network/status?networkId=${networkId}`);
+  }
+
   /**
    * Retrieves all available tools
    * @returns Promise containing map of tool IDs to tool details
@@ -141,6 +205,23 @@ export class MastraClient extends BaseResource {
     return new Tool(this.options, toolId);
   }
 
+  /**
+   * Retrieves all available legacy workflows
+   * @returns Promise containing map of legacy workflow IDs to legacy workflow details
+   */
+  public getLegacyWorkflows(): Promise<Record<string, GetLegacyWorkflowResponse>> {
+    return this.request('/api/workflows/legacy');
+  }
+
+  /**
+   * Gets a legacy workflow instance by ID
+   * @param workflowId - ID of the legacy workflow to retrieve
+   * @returns Legacy Workflow instance
+   */
+  public getLegacyWorkflow(workflowId: string) {
+    return new LegacyWorkflow(this.options, workflowId);
+  }
+
   /**
    * Retrieves all available workflows
    * @returns Promise containing map of workflow IDs to workflow details
@@ -158,23 +239,6 @@ export class MastraClient extends BaseResource {
     return new Workflow(this.options, workflowId);
   }
 
-  /**
-   * Retrieves all available vNext workflows
-   * @returns Promise containing map of vNext workflow IDs to vNext workflow details
-   */
-  public getVNextWorkflows(): Promise<Record<string, GetVNextWorkflowResponse>> {
-    return this.request('/api/workflows/v-next');
-  }
-
-  /**
-   * Gets a vNext workflow instance by ID
-   * @param workflowId - ID of the vNext workflow to retrieve
-   * @returns vNext Workflow instance
-   */
-  public getVNextWorkflow(workflowId: string) {
-    return new VNextWorkflow(this.options, workflowId);
-  }
-
   /**
    * Gets a vector instance by name
    * @param vectorName - Name of the vector to retrieve
@@ -190,7 +254,43 @@ export class MastraClient extends BaseResource {
    * @returns Promise containing array of log messages
    */
   public getLogs(params: GetLogsParams): Promise<GetLogsResponse> {
-    return this.request(`/api/logs?transportId=${params.transportId}`);
+    const { transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+
+    const searchParams = new URLSearchParams();
+    if (transportId) {
+      searchParams.set('transportId', transportId);
+    }
+    if (fromDate) {
+      searchParams.set('fromDate', fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set('toDate', toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set('logLevel', logLevel);
+    }
+    if (page) {
+      searchParams.set('page', String(page));
+    }
+    if (perPage) {
+      searchParams.set('perPage', String(perPage));
+    }
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append('filters', filter);
+        }
+      } else {
+        searchParams.set('filters', _filters);
+      }
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/logs?${searchParams}`);
+    } else {
+      return this.request(`/api/logs`);
+    }
   }
 
   /**
@@ -199,7 +299,47 @@ export class MastraClient extends BaseResource {
    * @returns Promise containing array of log messages
    */
   public getLogForRun(params: GetLogParams): Promise<GetLogsResponse> {
-    return this.request(`/api/logs/${params.runId}?transportId=${params.transportId}`);
+    const { runId, transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
+
+    const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
+    const searchParams = new URLSearchParams();
+    if (runId) {
+      searchParams.set('runId', runId);
+    }
+    if (transportId) {
+      searchParams.set('transportId', transportId);
+    }
+    if (fromDate) {
+      searchParams.set('fromDate', fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set('toDate', toDate.toISOString());
+    }
+    if (logLevel) {
+      searchParams.set('logLevel', logLevel);
+    }
+    if (page) {
+      searchParams.set('page', String(page));
+    }
+    if (perPage) {
+      searchParams.set('perPage', String(perPage));
+    }
+
+    if (_filters) {
+      if (Array.isArray(_filters)) {
+        for (const filter of _filters) {
+          searchParams.append('filters', filter);
+        }
+      } else {
+        searchParams.set('filters', _filters);
+      }
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/logs/${runId}?${searchParams}`);
+    } else {
+      return this.request(`/api/logs/${runId}`);
+    }
   }
 
   /**
@@ -259,10 +399,18 @@ export class MastraClient extends BaseResource {
    * Retrieves all available networks
    * @returns Promise containing map of network IDs to network details
    */
-  public getNetworks(): Promise<Record<string, GetNetworkResponse>> {
+  public getNetworks(): Promise<Array<GetNetworkResponse>> {
     return this.request('/api/networks');
   }
 
+  /**
+   * Retrieves all available vNext networks
+   * @returns Promise containing map of vNext network IDs to vNext network details
+   */
+  public getVNextNetworks(): Promise<Array<GetVNextNetworkResponse>> {
+    return this.request('/api/networks/v-next');
+  }
+
   /**
    * Gets a network instance by ID
    * @param networkId - ID of the network to retrieve
@@ -272,6 +420,15 @@ export class MastraClient extends BaseResource {
     return new Network(this.options, networkId);
   }
 
+  /**
+   * Gets a vNext network instance by ID
+   * @param networkId - ID of the vNext network to retrieve
+   * @returns vNext Network instance
+   */
+  public getVNextNetwork(networkId: string) {
+    return new VNextNetwork(this.options, networkId);
+  }
+
   /**
    * Retrieves a list of available MCP servers.
    * @param params - Optional parameters for pagination (limit, offset).
@@ -332,4 +489,156 @@ export class MastraClient extends BaseResource {
   public getA2A(agentId: string) {
     return new A2A(this.options, agentId);
   }
+
+  /**
+   * Retrieves the working memory for a specific thread (optionally resource-scoped).
+   * @param agentId - ID of the agent.
+   * @param threadId - ID of the thread.
+   * @param resourceId - Optional ID of the resource.
+   * @returns Working memory for the specified thread or resource.
+   */
+  public getWorkingMemory({
+    agentId,
+    threadId,
+    resourceId,
+  }: {
+    agentId: string;
+    threadId: string;
+    resourceId?: string;
+  }) {
+    return this.request(`/api/memory/threads/${threadId}/working-memory?agentId=${agentId}&resourceId=${resourceId}`);
+  }
+
+  /**
+   * Updates the working memory for a specific thread (optionally resource-scoped).
+   * @param agentId - ID of the agent.
+   * @param threadId - ID of the thread.
+   * @param workingMemory - The new working memory content.
+   * @param resourceId - Optional ID of the resource.
+   */
+  public updateWorkingMemory({
+    agentId,
+    threadId,
+    workingMemory,
+    resourceId,
+  }: {
+    agentId: string;
+    threadId: string;
+    workingMemory: string;
+    resourceId?: string;
+  }) {
+    return this.request(`/api/memory/threads/${threadId}/working-memory?agentId=${agentId}`, {
+      method: 'POST',
+      body: {
+        workingMemory,
+        resourceId,
+      },
+    });
+  }
+
+  /**
+   * Retrieves all available scorers
+   * @returns Promise containing list of available scorers
+   */
+  public getScorers(): Promise<Record<string, GetScorerResponse>> {
+    return this.request('/api/scores/scorers');
+  }
+
+  /**
+   * Retrieves a scorer by ID
+   * @param scorerId - ID of the scorer to retrieve
+   * @returns Promise containing the scorer
+   */
+  public getScorer(scorerId: string): Promise<GetScorerResponse> {
+    return this.request(`/api/scores/scorers/${scorerId}`);
+  }
+
+  public getScoresByScorerId(params: GetScoresByScorerIdParams): Promise<GetScoresResponse> {
+    const { page, perPage, scorerId, entityId, entityType } = params;
+    const searchParams = new URLSearchParams();
+
+    if (entityId) {
+      searchParams.set('entityId', entityId);
+    }
+    if (entityType) {
+      searchParams.set('entityType', entityType);
+    }
+
+    if (page !== undefined) {
+      searchParams.set('page', String(page));
+    }
+    if (perPage !== undefined) {
+      searchParams.set('perPage', String(perPage));
+    }
+    const queryString = searchParams.toString();
+    return this.request(`/api/scores/scorer/${scorerId}${queryString ? `?${queryString}` : ''}`);
+  }
+
+  /**
+   * Retrieves scores by run ID
+   * @param params - Parameters containing run ID and pagination options
+   * @returns Promise containing scores and pagination info
+   */
+  public getScoresByRunId(params: GetScoresByRunIdParams): Promise<GetScoresResponse> {
+    const { runId, page, perPage } = params;
+    const searchParams = new URLSearchParams();
+
+    if (page !== undefined) {
+      searchParams.set('page', String(page));
+    }
+    if (perPage !== undefined) {
+      searchParams.set('perPage', String(perPage));
+    }
+
+    const queryString = searchParams.toString();
+    return this.request(`/api/scores/run/${runId}${queryString ? `?${queryString}` : ''}`);
+  }
+
+  /**
+   * Retrieves scores by entity ID and type
+   * @param params - Parameters containing entity ID, type, and pagination options
+   * @returns Promise containing scores and pagination info
+   */
+  public getScoresByEntityId(params: GetScoresByEntityIdParams): Promise<GetScoresResponse> {
+    const { entityId, entityType, page, perPage } = params;
+    const searchParams = new URLSearchParams();
+
+    if (page !== undefined) {
+      searchParams.set('page', String(page));
+    }
+    if (perPage !== undefined) {
+      searchParams.set('perPage', String(perPage));
+    }
+
+    const queryString = searchParams.toString();
+    return this.request(`/api/scores/entity/${entityType}/${entityId}${queryString ? `?${queryString}` : ''}`);
+  }
+
+  /**
+   * Saves a score
+   * @param params - Parameters containing the score data to save
+   * @returns Promise containing the saved score
+   */
+  public saveScore(params: SaveScoreParams): Promise<SaveScoreResponse> {
+    return this.request('/api/scores', {
+      method: 'POST',
+      body: params,
+    });
+  }
+
+  /**
+   * Retrieves model providers with available keys
+   * @returns Promise containing model providers with available keys
+   */
+  getModelProviders(): Promise<string[]> {
+    return this.request(`/api/model-providers`);
+  }
+
+  getAITrace(traceId: string): Promise<AITraceRecord> {
+    return this.observability.getTrace(traceId);
+  }
+
+  getAITraces(params: AITracesPaginatedArg): Promise<GetAITracesResponse> {
+    return this.observability.getTraces(params);
+  }
 }

package/src/example.ts

@@ -1,8 +1,8 @@
+import z from 'zod';
 import { MastraClient } from './client';
 // import type { WorkflowRunResult } from './types';
 
 // Agent
-
 (async () => {
   const client = new MastraClient({
     baseUrl: 'http://localhost:4111',
@@ -14,22 +14,53 @@ import { MastraClient } from './client';
     const agent = client.getAgent('weatherAgent');
     const response = await agent.stream({
       messages: 'what is the weather in new york?',
+      output: z.object({
+        weather: z.string(),
+        temperature: z.number(),
+        humidity: z.number(),
+        windSpeed: z.number(),
+        windDirection: z.string(),
+        windGust: z.number(),
+        windChill: z.number(),
+      }),
     });
 
-    response.processDataStream({
-      onTextPart: text => {
-        process.stdout.write(text);
-      },
-      onFilePart: file => {
-        console.log(file);
-      },
-      onDataPart: data => {
-        console.log(data);
-      },
-      onErrorPart: error => {
-        console.error(error);
-      },
-    });
+    // Process data stream - unstructured output
+
+    // response.processDataStream({
+    //   onTextPart: text => {
+    //     process.stdout.write(text);
+    //   },
+    //   onFilePart: file => {
+    //     console.log(file);
+    //   },
+    //   onDataPart: data => {
+    //     console.log(data);
+    //   },
+    //   onErrorPart: error => {
+    //     console.error(error);
+    //   },
+    //   onToolCallPart(streamPart) {
+    //     console.log(streamPart);
+    //   },
+    // });
+
+    // Process text stream - structured output
+
+    // response.processTextStream({
+    //   onTextPart: text => {
+    //     process.stdout.write(text);
+    //   },
+    // });
+
+    // read the response body directly
+
+    // const reader = response.body!.getReader();
+    // while (true) {
+    //   const { done, value } = await reader.read();
+    //   if (done) break;
+    //   console.log(new TextDecoder().decode(value));
+    // }
   } catch (error) {
     console.error(error);
   }