@mastra/client-js 0.1.10 → 0.1.11-alpha.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @mastra/client-js@0.1.10-alpha.0 build /home/runner/work/mastra/mastra/client-sdks/client-js
+> @mastra/client-js@0.1.11-alpha.0 build /home/runner/work/mastra/mastra/client-sdks/client-js
 > tsup src/index.ts --format esm,cjs --dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
@@ -9,11 +9,11 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 17.58 KB
-CJS ⚡️ Build success in 787ms
-ESM dist/index.js 17.49 KB
-ESM ⚡️ Build success in 789ms
+CJS dist/index.cjs 19.59 KB
+CJS ⚡️ Build success in 991ms
+ESM dist/index.js 19.41 KB
+ESM ⚡️ Build success in 997ms
 DTS Build start
-DTS ⚡️ Build success in 10226ms
-DTS dist/index.d.ts  16.15 KB
-DTS dist/index.d.cts 16.15 KB
+DTS ⚡️ Build success in 9664ms
+DTS dist/index.d.ts  17.68 KB
+DTS dist/index.d.cts 17.68 KB

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/client-js
 
+## 0.1.11-alpha.0
+
+### Patch Changes
+
+- 404640e: AgentNetwork changeset
+- Updated dependencies [404640e]
+  - @mastra/core@0.6.3-alpha.0
+
 ## 0.1.10
 
 ### Patch Changes

package/dist/index.cjs

@@ -132,6 +132,52 @@ var Agent = class extends BaseResource {
     return this.request(`/api/agents/${this.agentId}/evals/live`);
   }
 };
+var Network = class extends BaseResource {
+  constructor(options, networkId) {
+    super(options);
+    this.networkId = networkId;
+  }
+  /**
+   * Retrieves details about the network
+   * @returns Promise containing network details
+   */
+  details() {
+    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(params) {
+    const processedParams = {
+      ...params,
+      output: params.output instanceof zod.ZodSchema ? zodToJsonSchema.zodToJsonSchema(params.output) : params.output,
+      experimental_output: params.experimental_output instanceof zod.ZodSchema ? zodToJsonSchema.zodToJsonSchema(params.experimental_output) : 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 streamed response
+   */
+  stream(params) {
+    const processedParams = {
+      ...params,
+      output: params.output instanceof zod.ZodSchema ? zodToJsonSchema.zodToJsonSchema(params.output) : params.output,
+      experimental_output: params.experimental_output instanceof zod.ZodSchema ? zodToJsonSchema.zodToJsonSchema(params.experimental_output) : params.experimental_output
+    };
+    return this.request(`/api/networks/${this.networkId}/stream`, {
+      method: "POST",
+      body: processedParams,
+      stream: true
+    });
+  }
+};
 
 // src/resources/memory-thread.ts
 var MemoryThread = class extends BaseResource {
@@ -589,6 +635,21 @@ var MastraClient = class extends BaseResource {
       return this.request(`/api/telemetry`);
     }
   }
+  /**
+   * Retrieves all available networks
+   * @returns Promise containing map of network IDs to network details
+   */
+  getNetworks() {
+    return this.request("/api/networks");
+  }
+  /**
+   * Gets a network instance by ID
+   * @param networkId - ID of the network to retrieve
+   * @returns Network instance
+   */
+  getNetwork(networkId) {
+    return new Network(this.options, networkId);
+  }
 };
 
 exports.MastraClient = MastraClient;

package/dist/index.d.cts

@@ -147,6 +147,20 @@ interface GetTelemetryParams {
     perPage?: number;
     attribute?: Record<string, string>;
 }
+interface GetNetworkResponse {
+    name: string;
+    instructions: string;
+    agents: Array<{
+        name: string;
+        provider: string;
+        modelId: string;
+    }>;
+    routingModel: {
+        provider: string;
+        modelId: string;
+    };
+    state?: Record<string, any>;
+}
 
 declare class BaseResource {
     readonly options: ClientOptions;
@@ -198,6 +212,28 @@ declare class Agent extends BaseResource {
     liveEvals(): Promise<GetEvalsByAgentIdResponse>;
 }
 
+declare class Network extends BaseResource {
+    private networkId;
+    constructor(options: ClientOptions, networkId: string);
+    /**
+     * Retrieves details about the network
+     * @returns Promise containing network details
+     */
+    details(): Promise<GetNetworkResponse>;
+    /**
+     * 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>>;
+    /**
+     * Streams a response from the agent
+     * @param params - Stream parameters including prompt
+     * @returns Promise containing the streamed response
+     */
+    stream<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: StreamParams<T>): Promise<Response>;
+}
+
 declare class MemoryThread extends BaseResource {
     private threadId;
     private agentId;
@@ -473,6 +509,17 @@ declare class MastraClient extends BaseResource {
      * @returns Promise containing telemetry data
      */
     getTelemetry(params?: GetTelemetryParams): Promise<GetTelemetryResponse>;
+    /**
+     * Retrieves all available networks
+     * @returns Promise containing map of network IDs to network details
+     */
+    getNetworks(): Promise<Record<string, GetNetworkResponse>>;
+    /**
+     * Gets a network instance by ID
+     * @param networkId - ID of the network to retrieve
+     * @returns Network instance
+     */
+    getNetwork(networkId: string): Network;
 }
 
-export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult };
+export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult };

package/dist/index.d.ts

@@ -147,6 +147,20 @@ interface GetTelemetryParams {
     perPage?: number;
     attribute?: Record<string, string>;
 }
+interface GetNetworkResponse {
+    name: string;
+    instructions: string;
+    agents: Array<{
+        name: string;
+        provider: string;
+        modelId: string;
+    }>;
+    routingModel: {
+        provider: string;
+        modelId: string;
+    };
+    state?: Record<string, any>;
+}
 
 declare class BaseResource {
     readonly options: ClientOptions;
@@ -198,6 +212,28 @@ declare class Agent extends BaseResource {
     liveEvals(): Promise<GetEvalsByAgentIdResponse>;
 }
 
+declare class Network extends BaseResource {
+    private networkId;
+    constructor(options: ClientOptions, networkId: string);
+    /**
+     * Retrieves details about the network
+     * @returns Promise containing network details
+     */
+    details(): Promise<GetNetworkResponse>;
+    /**
+     * 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>>;
+    /**
+     * Streams a response from the agent
+     * @param params - Stream parameters including prompt
+     * @returns Promise containing the streamed response
+     */
+    stream<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: StreamParams<T>): Promise<Response>;
+}
+
 declare class MemoryThread extends BaseResource {
     private threadId;
     private agentId;
@@ -473,6 +509,17 @@ declare class MastraClient extends BaseResource {
      * @returns Promise containing telemetry data
      */
     getTelemetry(params?: GetTelemetryParams): Promise<GetTelemetryResponse>;
+    /**
+     * Retrieves all available networks
+     * @returns Promise containing map of network IDs to network details
+     */
+    getNetworks(): Promise<Record<string, GetNetworkResponse>>;
+    /**
+     * Gets a network instance by ID
+     * @param networkId - ID of the network to retrieve
+     * @returns Network instance
+     */
+    getNetwork(networkId: string): Network;
 }
 
-export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult };
+export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult };

package/dist/index.js

@@ -130,6 +130,52 @@ var Agent = class extends BaseResource {
     return this.request(`/api/agents/${this.agentId}/evals/live`);
   }
 };
+var Network = class extends BaseResource {
+  constructor(options, networkId) {
+    super(options);
+    this.networkId = networkId;
+  }
+  /**
+   * Retrieves details about the network
+   * @returns Promise containing network details
+   */
+  details() {
+    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(params) {
+    const processedParams = {
+      ...params,
+      output: params.output instanceof ZodSchema ? zodToJsonSchema(params.output) : params.output,
+      experimental_output: params.experimental_output instanceof ZodSchema ? zodToJsonSchema(params.experimental_output) : 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 streamed response
+   */
+  stream(params) {
+    const processedParams = {
+      ...params,
+      output: params.output instanceof ZodSchema ? zodToJsonSchema(params.output) : params.output,
+      experimental_output: params.experimental_output instanceof ZodSchema ? zodToJsonSchema(params.experimental_output) : params.experimental_output
+    };
+    return this.request(`/api/networks/${this.networkId}/stream`, {
+      method: "POST",
+      body: processedParams,
+      stream: true
+    });
+  }
+};
 
 // src/resources/memory-thread.ts
 var MemoryThread = class extends BaseResource {
@@ -587,6 +633,21 @@ var MastraClient = class extends BaseResource {
       return this.request(`/api/telemetry`);
     }
   }
+  /**
+   * Retrieves all available networks
+   * @returns Promise containing map of network IDs to network details
+   */
+  getNetworks() {
+    return this.request("/api/networks");
+  }
+  /**
+   * Gets a network instance by ID
+   * @param networkId - ID of the network to retrieve
+   * @returns Network instance
+   */
+  getNetwork(networkId) {
+    return new Network(this.options, networkId);
+  }
 };
 
 export { MastraClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.1.10",
+  "version": "0.1.11-alpha.0",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -25,7 +25,7 @@
     "json-schema": "^0.4.0",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.3",
-    "@mastra/core": "^0.6.2"
+    "@mastra/core": "^0.6.3-alpha.0"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.26.9",

package/src/client.ts

@@ -1,4 +1,4 @@
-import { Agent, MemoryThread, Tool, Workflow, Vector, BaseResource } from './resources';
+import { Agent, MemoryThread, Tool, Workflow, Vector, BaseResource, Network } from './resources';
 import type {
   ClientOptions,
   CreateMemoryThreadParams,
@@ -9,6 +9,7 @@ import type {
   GetLogsResponse,
   GetMemoryThreadParams,
   GetMemoryThreadResponse,
+  GetNetworkResponse,
   GetTelemetryParams,
   GetTelemetryResponse,
   GetToolResponse,
@@ -202,4 +203,21 @@ export class MastraClient extends BaseResource {
       return this.request(`/api/telemetry`);
     }
   }
+
+  /**
+   * Retrieves all available networks
+   * @returns Promise containing map of network IDs to network details
+   */
+  public getNetworks(): Promise<Record<string, GetNetworkResponse>> {
+    return this.request('/api/networks');
+  }
+
+  /**
+   * Gets a network instance by ID
+   * @param networkId - ID of the network to retrieve
+   * @returns Network instance
+   */
+  public getNetwork(networkId: string) {
+    return new Network(this.options, networkId);
+  }
 }

package/src/resources/index.ts

@@ -1,4 +1,5 @@
 export * from './agent';
+export * from './network';
 export * from './memory-thread';
 export * from './vector';
 export * from './workflow';

package/src/resources/network.ts

@@ -0,0 +1,70 @@
+import type { GenerateReturn } from '@mastra/core';
+import type { JSONSchema7 } from 'json-schema';
+import { ZodSchema } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+
+import type { GenerateParams, ClientOptions, StreamParams, GetNetworkResponse } from '../types';
+
+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: params.output instanceof ZodSchema ? zodToJsonSchema(params.output) : params.output,
+      experimental_output:
+        params.experimental_output instanceof ZodSchema
+          ? zodToJsonSchema(params.experimental_output)
+          : 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 streamed response
+   */
+  stream<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: StreamParams<T>): Promise<Response> {
+    const processedParams = {
+      ...params,
+      output: params.output instanceof ZodSchema ? zodToJsonSchema(params.output) : params.output,
+      experimental_output:
+        params.experimental_output instanceof ZodSchema
+          ? zodToJsonSchema(params.experimental_output)
+          : params.experimental_output,
+    };
+
+    return this.request(`/api/networks/${this.networkId}/stream`, {
+      method: 'POST',
+      body: processedParams,
+      stream: true,
+    });
+  }
+}

package/src/types.ts

@@ -7,12 +7,11 @@ import type {
   StepGraph,
   StorageThreadType,
   BaseLogMessage,
-  OutputType,
 } from '@mastra/core';
 
 import type { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
 import type { JSONSchema7 } from 'json-schema';
-import { ZodSchema } from 'zod';
+import type { ZodSchema } from 'zod';
 
 export interface ClientOptions {
   /** Base URL for API requests */
@@ -190,3 +189,18 @@ export interface GetTelemetryParams {
   perPage?: number;
   attribute?: Record<string, string>;
 }
+
+export interface GetNetworkResponse {
+  name: string;
+  instructions: string;
+  agents: Array<{
+    name: string;
+    provider: string;
+    modelId: string;
+  }>;
+  routingModel: {
+    provider: string;
+    modelId: string;
+  };
+  state?: Record<string, any>;
+}