@mastra/client-js 0.0.0-share-agent-metadata-with-cloud-20250718110128 → 0.0.0-sidebar-window-undefined-fix-20251029233656

package/src/resources/base.ts

@@ -1,72 +0,0 @@
-import type { RequestOptions, ClientOptions } from '../types';
-
-export class BaseResource {
-  readonly options: ClientOptions;
-
-  constructor(options: ClientOptions) {
-    this.options = options;
-  }
-
-  /**
-   * Makes an HTTP request to the API with retries and exponential backoff
-   * @param path - The API endpoint path
-   * @param options - Optional request configuration
-   * @returns Promise containing the response data
-   */
-  public async request<T>(path: string, options: RequestOptions = {}): Promise<T> {
-    let lastError: Error | null = null;
-    const { baseUrl, retries = 3, backoffMs = 100, maxBackoffMs = 1000, headers = {} } = this.options;
-
-    let delay = backoffMs;
-
-    for (let attempt = 0; attempt <= retries; attempt++) {
-      try {
-        const response = await fetch(`${baseUrl.replace(/\/$/, '')}${path}`, {
-          ...options,
-          headers: {
-            ...(options.method === 'POST' || options.method === 'PUT' ? { 'content-type': 'application/json' } : {}),
-            ...headers,
-            ...options.headers,
-            // TODO: Bring this back once we figure out what we/users need to do to make this work with cross-origin requests
-            // 'x-mastra-client-type': 'js',
-          },
-          signal: this.options.abortSignal,
-          body:
-            options.body instanceof FormData ? options.body : options.body ? JSON.stringify(options.body) : undefined,
-        });
-
-        if (!response.ok) {
-          const errorBody = await response.text();
-          let errorMessage = `HTTP error! status: ${response.status}`;
-          try {
-            const errorJson = JSON.parse(errorBody);
-            errorMessage += ` - ${JSON.stringify(errorJson)}`;
-          } catch {
-            if (errorBody) {
-              errorMessage += ` - ${errorBody}`;
-            }
-          }
-          throw new Error(errorMessage);
-        }
-
-        if (options.stream) {
-          return response as unknown as T;
-        }
-
-        const data = await response.json();
-        return data as T;
-      } catch (error) {
-        lastError = error as Error;
-
-        if (attempt === retries) {
-          break;
-        }
-
-        await new Promise(resolve => setTimeout(resolve, delay));
-        delay = Math.min(delay * 2, maxBackoffMs);
-      }
-    }
-
-    throw lastError || new Error('Request failed');
-  }
-}

package/src/resources/index.ts

@@ -1,10 +0,0 @@
-export * from './agent';
-export * from './network';
-export * from './memory-thread';
-export * from './vector';
-export * from './legacy-workflow';
-export * from './tool';
-export * from './base';
-export * from './workflow';
-export * from './a2a';
-export * from './mcp-tool';

package/src/resources/legacy-workflow.ts

@@ -1,242 +0,0 @@
-import type {
-  ClientOptions,
-  LegacyWorkflowRunResult,
-  GetLegacyWorkflowRunsResponse,
-  GetWorkflowRunsParams,
-  GetLegacyWorkflowResponse,
-} from '../types';
-
-import { BaseResource } from './base';
-
-const RECORD_SEPARATOR = '\x1E';
-
-export class LegacyWorkflow extends BaseResource {
-  constructor(
-    options: ClientOptions,
-    private workflowId: string,
-  ) {
-    super(options);
-  }
-
-  /**
-   * Retrieves details about the legacy workflow
-   * @returns Promise containing legacy workflow details including steps and graphs
-   */
-  details(): Promise<GetLegacyWorkflowResponse> {
-    return this.request(`/api/workflows/legacy/${this.workflowId}`);
-  }
-
-  /**
-   * Retrieves all runs for a legacy workflow
-   * @param params - Parameters for filtering runs
-   * @returns Promise containing legacy workflow runs array
-   */
-  runs(params?: GetWorkflowRunsParams): Promise<GetLegacyWorkflowRunsResponse> {
-    const searchParams = new URLSearchParams();
-    if (params?.fromDate) {
-      searchParams.set('fromDate', params.fromDate.toISOString());
-    }
-    if (params?.toDate) {
-      searchParams.set('toDate', params.toDate.toISOString());
-    }
-    if (params?.limit) {
-      searchParams.set('limit', String(params.limit));
-    }
-    if (params?.offset) {
-      searchParams.set('offset', String(params.offset));
-    }
-    if (params?.resourceId) {
-      searchParams.set('resourceId', params.resourceId);
-    }
-
-    if (searchParams.size) {
-      return this.request(`/api/workflows/legacy/${this.workflowId}/runs?${searchParams}`);
-    } else {
-      return this.request(`/api/workflows/legacy/${this.workflowId}/runs`);
-    }
-  }
-
-  /**
-   * Creates a new legacy workflow run
-   * @returns Promise containing the generated run ID
-   */
-  createRun(params?: { runId?: string }): Promise<{ runId: string }> {
-    const searchParams = new URLSearchParams();
-
-    if (!!params?.runId) {
-      searchParams.set('runId', params.runId);
-    }
-
-    return this.request(`/api/workflows/legacy/${this.workflowId}/create-run?${searchParams.toString()}`, {
-      method: 'POST',
-    });
-  }
-
-  /**
-   * Starts a legacy workflow run synchronously without waiting for the workflow to complete
-   * @param params - Object containing the runId and triggerData
-   * @returns Promise containing success message
-   */
-  start(params: { runId: string; triggerData: Record<string, any> }): Promise<{ message: string }> {
-    return this.request(`/api/workflows/legacy/${this.workflowId}/start?runId=${params.runId}`, {
-      method: 'POST',
-      body: params?.triggerData,
-    });
-  }
-
-  /**
-   * Resumes a suspended legacy workflow step synchronously without waiting for the workflow to complete
-   * @param stepId - ID of the step to resume
-   * @param runId - ID of the legacy workflow run
-   * @param context - Context to resume the legacy workflow with
-   * @returns Promise containing the legacy workflow resume results
-   */
-  resume({
-    stepId,
-    runId,
-    context,
-  }: {
-    stepId: string;
-    runId: string;
-    context: Record<string, any>;
-  }): Promise<{ message: string }> {
-    return this.request(`/api/workflows/legacy/${this.workflowId}/resume?runId=${runId}`, {
-      method: 'POST',
-      body: {
-        stepId,
-        context,
-      },
-    });
-  }
-
-  /**
-   * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
-   * @param params - Object containing the optional runId and triggerData
-   * @returns Promise containing the workflow execution results
-   */
-  startAsync(params: { runId?: string; triggerData: Record<string, any> }): Promise<LegacyWorkflowRunResult> {
-    const searchParams = new URLSearchParams();
-
-    if (!!params?.runId) {
-      searchParams.set('runId', params.runId);
-    }
-
-    return this.request(`/api/workflows/legacy/${this.workflowId}/start-async?${searchParams.toString()}`, {
-      method: 'POST',
-      body: params?.triggerData,
-    });
-  }
-
-  /**
-   * Resumes a suspended legacy workflow step asynchronously and returns a promise that resolves when the workflow is complete
-   * @param params - Object containing the runId, stepId, and context
-   * @returns Promise containing the workflow resume results
-   */
-  resumeAsync(params: {
-    runId: string;
-    stepId: string;
-    context: Record<string, any>;
-  }): Promise<LegacyWorkflowRunResult> {
-    return this.request(`/api/workflows/legacy/${this.workflowId}/resume-async?runId=${params.runId}`, {
-      method: 'POST',
-      body: {
-        stepId: params.stepId,
-        context: params.context,
-      },
-    });
-  }
-
-  /**
-   * Creates an async generator that processes a readable stream and yields records
-   * separated by the Record Separator character (\x1E)
-   *
-   * @param stream - The readable stream to process
-   * @returns An async generator that yields parsed records
-   */
-  private async *streamProcessor(stream: ReadableStream): AsyncGenerator<LegacyWorkflowRunResult, void, unknown> {
-    const reader = stream.getReader();
-
-    // Track if we've finished reading from the stream
-    let doneReading = false;
-    // Buffer to accumulate partial chunks
-    let buffer = '';
-
-    try {
-      while (!doneReading) {
-        // Read the next chunk from the stream
-        const { done, value } = await reader.read();
-        doneReading = done;
-
-        // Skip processing if we're done and there's no value
-        if (done && !value) continue;
-
-        try {
-          // Decode binary data to text
-          const decoded = value ? new TextDecoder().decode(value) : '';
-
-          // Split the combined buffer and new data by record separator
-          const chunks = (buffer + decoded).split(RECORD_SEPARATOR);
-
-          // The last chunk might be incomplete, so save it for the next iteration
-          buffer = chunks.pop() || '';
-
-          // Process complete chunks
-          for (const chunk of chunks) {
-            if (chunk) {
-              // Only process non-empty chunks
-              if (typeof chunk === 'string') {
-                try {
-                  const parsedChunk = JSON.parse(chunk);
-                  yield parsedChunk;
-                } catch {
-                  // Silently ignore parsing errors to maintain stream processing
-                  // This allows the stream to continue even if one record is malformed
-                }
-              }
-            }
-          }
-        } catch {
-          // Silently ignore parsing errors to maintain stream processing
-          // This allows the stream to continue even if one record is malformed
-        }
-      }
-
-      // Process any remaining data in the buffer after stream is done
-      if (buffer) {
-        try {
-          yield JSON.parse(buffer);
-        } catch {
-          // Ignore parsing error for final chunk
-        }
-      }
-    } finally {
-      // Always ensure we clean up the reader
-      reader.cancel().catch(() => {
-        // Ignore cancel errors
-      });
-    }
-  }
-
-  /**
-   * Watches legacy workflow transitions in real-time
-   * @param runId - Optional run ID to filter the watch stream
-   * @returns AsyncGenerator that yields parsed records from the legacy workflow watch stream
-   */
-  async watch({ runId }: { runId?: string }, onRecord: (record: LegacyWorkflowRunResult) => void) {
-    const response: Response = await this.request(`/api/workflows/legacy/${this.workflowId}/watch?runId=${runId}`, {
-      stream: true,
-    });
-
-    if (!response.ok) {
-      throw new Error(`Failed to watch legacy workflow: ${response.statusText}`);
-    }
-
-    if (!response.body) {
-      throw new Error('Response body is null');
-    }
-
-    for await (const record of this.streamProcessor(response.body)) {
-      onRecord(record);
-    }
-  }
-}

package/src/resources/mcp-tool.ts

@@ -1,48 +0,0 @@
-import type { RuntimeContext } from '@mastra/core/runtime-context';
-import type { ClientOptions, McpToolInfo } from '../types';
-import { BaseResource } from './base';
-
-/**
- * Represents a specific tool available on a specific MCP server.
- * Provides methods to get details and execute the tool.
- */
-export class MCPTool extends BaseResource {
-  private serverId: string;
-  private toolId: string;
-
-  constructor(options: ClientOptions, serverId: string, toolId: string) {
-    super(options);
-    this.serverId = serverId;
-    this.toolId = toolId;
-  }
-
-  /**
-   * Retrieves details about this specific tool from the MCP server.
-   * @returns Promise containing the tool's information (name, description, schema).
-   */
-  details(): Promise<McpToolInfo> {
-    return this.request(`/api/mcp/${this.serverId}/tools/${this.toolId}`);
-  }
-
-  /**
-   * Executes this specific tool on the MCP server.
-   * @param params - Parameters for tool execution, including data/args and optional runtimeContext.
-   * @returns Promise containing the result of the tool execution.
-   */
-  execute(params: { data?: any; runtimeContext?: RuntimeContext }): Promise<any> {
-    const body: any = {};
-    if (params.data !== undefined) body.data = params.data;
-    // If none of data, args the body might be empty or just contain runtimeContext.
-    // The handler will look for these, so an empty args object might be appropriate if that's the intent.
-    // else body.data = {}; // Or let it be empty if no specific input fields are used
-
-    if (params.runtimeContext !== undefined) {
-      body.runtimeContext = params.runtimeContext;
-    }
-
-    return this.request(`/api/mcp/${this.serverId}/tools/${this.toolId}/execute`, {
-      method: 'POST',
-      body: Object.keys(body).length > 0 ? body : undefined,
-    });
-  }
-}

package/src/resources/memory-thread.ts

@@ -1,63 +0,0 @@
-import type { StorageThreadType } from '@mastra/core';
-
-import type {
-  GetMemoryThreadMessagesResponse,
-  ClientOptions,
-  UpdateMemoryThreadParams,
-  GetMemoryThreadMessagesParams,
-} from '../types';
-
-import { BaseResource } from './base';
-
-export class MemoryThread extends BaseResource {
-  constructor(
-    options: ClientOptions,
-    private threadId: string,
-    private agentId: string,
-  ) {
-    super(options);
-  }
-
-  /**
-   * Retrieves the memory thread details
-   * @returns Promise containing thread details including title and metadata
-   */
-  get(): Promise<StorageThreadType> {
-    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`);
-  }
-
-  /**
-   * Updates the memory thread properties
-   * @param params - Update parameters including title and metadata
-   * @returns Promise containing updated thread details
-   */
-  update(params: UpdateMemoryThreadParams): Promise<StorageThreadType> {
-    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
-      method: 'PATCH',
-      body: params,
-    });
-  }
-
-  /**
-   * Deletes the memory thread
-   * @returns Promise containing deletion result
-   */
-  delete(): Promise<{ result: string }> {
-    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
-      method: 'DELETE',
-    });
-  }
-
-  /**
-   * Retrieves messages associated with the thread
-   * @param params - Optional parameters including limit for number of messages to retrieve
-   * @returns Promise containing thread messages and UI messages
-   */
-  getMessages(params?: GetMemoryThreadMessagesParams): Promise<GetMemoryThreadMessagesResponse> {
-    const query = new URLSearchParams({
-      agentId: this.agentId,
-      ...(params?.limit ? { limit: params.limit.toString() } : {}),
-    });
-    return this.request(`/api/memory/threads/${this.threadId}/messages?${query.toString()}`);
-  }
-}

package/src/resources/network-memory-thread.ts

@@ -1,63 +0,0 @@
-import type { StorageThreadType } from '@mastra/core';
-
-import type {
-  GetMemoryThreadMessagesResponse,
-  ClientOptions,
-  UpdateMemoryThreadParams,
-  GetMemoryThreadMessagesParams,
-} from '../types';
-
-import { BaseResource } from './base';
-
-export class NetworkMemoryThread extends BaseResource {
-  constructor(
-    options: ClientOptions,
-    private threadId: string,
-    private networkId: string,
-  ) {
-    super(options);
-  }
-
-  /**
-   * Retrieves the memory thread details
-   * @returns Promise containing thread details including title and metadata
-   */
-  get(): Promise<StorageThreadType> {
-    return this.request(`/api/memory/network/threads/${this.threadId}?networkId=${this.networkId}`);
-  }
-
-  /**
-   * Updates the memory thread properties
-   * @param params - Update parameters including title and metadata
-   * @returns Promise containing updated thread details
-   */
-  update(params: UpdateMemoryThreadParams): Promise<StorageThreadType> {
-    return this.request(`/api/memory/network/threads/${this.threadId}?networkId=${this.networkId}`, {
-      method: 'PATCH',
-      body: params,
-    });
-  }
-
-  /**
-   * Deletes the memory thread
-   * @returns Promise containing deletion result
-   */
-  delete(): Promise<{ result: string }> {
-    return this.request(`/api/memory/network/threads/${this.threadId}?networkId=${this.networkId}`, {
-      method: 'DELETE',
-    });
-  }
-
-  /**
-   * Retrieves messages associated with the thread
-   * @param params - Optional parameters including limit for number of messages to retrieve
-   * @returns Promise containing thread messages and UI messages
-   */
-  getMessages(params?: GetMemoryThreadMessagesParams): Promise<GetMemoryThreadMessagesResponse> {
-    const query = new URLSearchParams({
-      networkId: this.networkId,
-      ...(params?.limit ? { limit: params.limit.toString() } : {}),
-    });
-    return this.request(`/api/memory/network/threads/${this.threadId}/messages?${query.toString()}`);
-  }
-}

package/src/resources/network.ts

@@ -1,85 +0,0 @@
-import { processDataStream } from '@ai-sdk/ui-utils';
-import type { GenerateReturn } from '@mastra/core';
-import type { JSONSchema7 } from 'json-schema';
-import type { ZodSchema } from 'zod';
-import type { GenerateParams, ClientOptions, StreamParams, GetNetworkResponse } from '../types';
-import { zodToJsonSchema } from '../utils/zod-to-json-schema';
-
-import { BaseResource } from './base';
-
-export class Network extends BaseResource {
-  constructor(
-    options: ClientOptions,
-    private networkId: string,
-  ) {
-    super(options);
-  }
-
-  /**
-   * Retrieves details about the network
-   * @returns Promise containing network details
-   */
-  details(): Promise<GetNetworkResponse> {
-    return this.request(`/api/networks/${this.networkId}`);
-  }
-
-  /**
-   * Generates a response from the agent
-   * @param params - Generation parameters including prompt
-   * @returns Promise containing the generated response
-   */
-  generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(
-    params: GenerateParams<T>,
-  ): Promise<GenerateReturn<T>> {
-    const processedParams = {
-      ...params,
-      output: zodToJsonSchema(params.output),
-      experimental_output: zodToJsonSchema(params.experimental_output),
-    };
-
-    return this.request(`/api/networks/${this.networkId}/generate`, {
-      method: 'POST',
-      body: processedParams,
-    });
-  }
-
-  /**
-   * Streams a response from the agent
-   * @param params - Stream parameters including prompt
-   * @returns Promise containing the enhanced Response object with processDataStream method
-   */
-  async stream<T extends JSONSchema7 | ZodSchema | undefined = undefined>(
-    params: StreamParams<T>,
-  ): Promise<
-    Response & {
-      processDataStream: (options?: Omit<Parameters<typeof processDataStream>[0], 'stream'>) => Promise<void>;
-    }
-  > {
-    const processedParams = {
-      ...params,
-      output: zodToJsonSchema(params.output),
-      experimental_output: zodToJsonSchema(params.experimental_output),
-    };
-
-    const response: Response & {
-      processDataStream: (options?: Omit<Parameters<typeof processDataStream>[0], 'stream'>) => Promise<void>;
-    } = await this.request(`/api/networks/${this.networkId}/stream`, {
-      method: 'POST',
-      body: processedParams,
-      stream: true,
-    });
-
-    if (!response.body) {
-      throw new Error('No response body');
-    }
-
-    response.processDataStream = async (options = {}) => {
-      await processDataStream({
-        stream: response.body as ReadableStream<Uint8Array>,
-        ...options,
-      });
-    };
-
-    return response;
-  }
-}

package/src/resources/tool.ts

@@ -1,45 +0,0 @@
-import type { RuntimeContext } from '@mastra/core/runtime-context';
-import type { GetToolResponse, ClientOptions } from '../types';
-
-import { BaseResource } from './base';
-import { parseClientRuntimeContext } from '../utils';
-
-export class Tool extends BaseResource {
-  constructor(
-    options: ClientOptions,
-    private toolId: string,
-  ) {
-    super(options);
-  }
-
-  /**
-   * Retrieves details about the tool
-   * @returns Promise containing tool details including description and schemas
-   */
-  details(): Promise<GetToolResponse> {
-    return this.request(`/api/tools/${this.toolId}`);
-  }
-
-  /**
-   * Executes the tool with the provided parameters
-   * @param params - Parameters required for tool execution
-   * @returns Promise containing the tool execution results
-   */
-  execute(params: { data: any; runId?: string; runtimeContext?: RuntimeContext | Record<string, any> }): Promise<any> {
-    const url = new URLSearchParams();
-
-    if (params.runId) {
-      url.set('runId', params.runId);
-    }
-
-    const body = {
-      data: params.data,
-      runtimeContext: parseClientRuntimeContext(params.runtimeContext),
-    };
-
-    return this.request(`/api/tools/${this.toolId}/execute?${url.toString()}`, {
-      method: 'POST',
-      body,
-    });
-  }
-}