refactor: rename ClientFactory.createFromAgentCardUrl -> createFromUrl (#242)

# Description

`createFromAgentCardUrl` may give a wrong impression that full URL has
to be provided, rename and add examples.

Not yet released, `AgentCardResolver` and the method were added in #225.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: ishymko

src/client/factory.ts

@@ -136,10 +136,18 @@ export class ClientFactory {
   /**
    * Downloads agent card using AgentCardResolver from options
    * and creates a new client from the downloaded card.
+   *
+   * @example
+   * ```ts
+   * const factory = new ClientFactory(); // use default options and default {@link AgentCardResolver}.
+   * const client1 = await factory.createFromUrl('https://example.com'); // /.well-known/agent-card.json is used by default
+   * const client2 = await factory.createFromUrl('https://example.com', '/my-agent-card.json'); // specify custom path
+   * const client3 = await factory.createFromUrl('https://example.com/my-agent-card.json', ''); // specify full URL and set path to empty
+   * ```
    */
-  async createFromAgentCardUrl(baseUrl: string, path?: string): Promise<Client> {
+  async createFromUrl(baseUrl: string, path?: string): Promise<Client> {
     const agentCard = await this.agentCardResolver.resolve(baseUrl, path);
-    return await this.createFromAgentCard(agentCard);
+    return this.createFromAgentCard(agentCard);
   }
 }
 

test/client/factory.spec.ts

@@ -172,7 +172,7 @@ describe('ClientFactory', () => {
         cardResolver,
       });
 
-      await factory.createFromAgentCardUrl('http://transport1.com');
+      await factory.createFromUrl('http://transport1.com');
 
       expect(mockTransportFactory1.create.calledOnce);
       expect(cardResolver.resolve.calledOnceWith('http://transport1.com')).to.be.true;
@@ -187,7 +187,7 @@ describe('ClientFactory', () => {
         cardResolver,
       });
 
-      await factory.createFromAgentCardUrl('http://transport1.com', 'a2a/my-agent-card.json');
+      await factory.createFromUrl('http://transport1.com', 'a2a/my-agent-card.json');
 
       expect(mockTransportFactory1.create.calledOnce);
       expect(cardResolver.resolve.calledOnceWith('http://transport1.com', 'a2a/my-agent-card.json'))