@lobehub/market-sdk 0.22.7 → 0.22.8-beta.0

package/dist/index.mjs

@@ -1380,12 +1380,298 @@ var MarketAdmin = class extends BaseSDK {
 };
 
 // src/market/market-sdk.ts
-import debug11 from "debug";
+import debug13 from "debug";
 
-// src/market/services/DiscoveryService.ts
+// src/market/services/AgentService.ts
 import debug9 from "debug";
+var log9 = debug9("lobe-market-sdk:agents");
+var AgentService = class extends BaseSDK {
+  /**
+   * Retrieves a list of agents from the marketplace
+   *
+   * Supports filtering, pagination, and localization of results.
+   *
+   * @param params - Query parameters for filtering and pagination
+   * @param options - Optional request options
+   * @returns Promise resolving to the agent list response containing items and pagination info
+   */
+  async getAgentList(params = {}, options) {
+    const locale = params.locale || this.defaultLocale;
+    const queryParams = { ...params, locale };
+    const queryString = this.buildQueryString(queryParams);
+    log9("Getting agent list: %O", queryParams);
+    const result = await this.request(`/v1/agents${queryString}`, options);
+    log9("Retrieved %d agents", result.items.length);
+    return result;
+  }
+  /**
+   * Retrieves detailed information about a specific agent
+   *
+   * Returns complete agent information including A2A AgentCard data,
+   * configuration, skills, and localized content.
+   *
+   * @param id - Unique identifier of the agent
+   * @param params - Query parameters for locale and version
+   * @param options - Optional request options
+   * @returns Promise resolving to the agent detail information
+   */
+  async getAgentDetail(id, params = {}, options) {
+    const locale = params.locale || this.defaultLocale;
+    const queryParams = { locale };
+    if (params.version !== void 0) {
+      queryParams.version = params.version.toString();
+    }
+    const queryString = this.buildQueryString(queryParams);
+    log9("Getting agent detail: %O", { id, ...params });
+    const result = await this.request(
+      `/v1/agents/detail/${id}${queryString}`,
+      options
+    );
+    log9("Agent detail successfully retrieved: %s", id);
+    return result;
+  }
+  /**
+   * Retrieves all published agent identifiers
+   *
+   * Returns a lightweight list of all published agent identifiers without
+   * full agent metadata. This is useful for clients that need to know which
+   * agents are available without fetching complete agent information.
+   *
+   * @param options - Optional request options
+   * @returns Promise resolving to an array containing identifiers array and last modified time
+   */
+  async getPublishedIdentifiers(options) {
+    log9("Getting published agent identifiers");
+    const result = await this.request(
+      "/v1/agents/identifiers",
+      options
+    );
+    log9("Retrieved %d published agent identifiers", result.length);
+    return result;
+  }
+  /**
+   * Retrieves agent categories and their counts
+   *
+   * Returns a list of categories along with the number of agents in each category.
+   * Useful for building category filters in a UI. Supports optional search filtering
+   * via 'q' parameter and locale specification.
+   *
+   * @param params - Query parameters for filtering categories
+   * @param options - Optional request options
+   * @returns Promise resolving to an array of category items with counts
+   */
+  async getCategories(params = {}, options) {
+    const locale = params.locale || this.defaultLocale;
+    const queryParams = { ...params, locale };
+    const queryString = this.buildQueryString(queryParams);
+    log9("Getting agent categories: %O", queryParams);
+    const result = await this.request(
+      `/v1/agents/categories${queryString}`,
+      options
+    );
+    log9("Retrieved %d categories", result.length);
+    return result;
+  }
+  /**
+   * Uploads an agent to the marketplace
+   *
+   * Allows users to upload new agents or update existing ones.
+   * The agent data should conform to the A2A AgentCard specification.
+   *
+   * @param agentData - The agent data to upload
+   * @param options - Optional request options
+   * @returns Promise resolving to the upload response
+   */
+  async uploadAgent(agentData, options) {
+    log9("Uploading agent: %s@%s", agentData.agentIdentifier, agentData.version.version);
+    const result = await this.request("/v1/agents/upload", {
+      body: JSON.stringify(agentData),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      ...options
+    });
+    log9("Agent uploaded successfully: %O", result);
+    return result;
+  }
+  /**
+   * Creates a new agent in the marketplace
+   *
+   * @param agentData - The agent data to create
+   * @param options - Optional request options
+   * @returns Promise resolving to the created agent response
+   */
+  async createAgent(agentData, options) {
+    log9("Creating agent: %s", agentData.identifier);
+    const result = await this.request("/v1/agents/create", {
+      body: JSON.stringify(agentData),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      ...options
+    });
+    log9("Agent created successfully: %O", result);
+    return result;
+  }
+  /**
+   * Creates a new version for an existing agent
+   *
+   * @param versionData - The version data to create
+   * @param options - Optional request options
+   * @returns Promise resolving to the created version response
+   */
+  async createAgentVersion(versionData, options) {
+    log9("Creating agent version: %s", versionData.identifier);
+    const result = await this.request("/v1/agents/version/create", {
+      body: JSON.stringify(versionData),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      ...options
+    });
+    log9("Agent version created successfully: %O", result);
+    return result;
+  }
+  /**
+   * Modifies an existing agent
+   *
+   * @param agentData - The agent data to modify
+   * @param options - Optional request options
+   * @returns Promise resolving to the modified agent response
+   */
+  async modifyAgent(agentData, options) {
+    log9("Modifying agent: %s", agentData.identifier);
+    const result = await this.request("/v1/agents/modify", {
+      body: JSON.stringify(agentData),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      ...options
+    });
+    log9("Agent modified successfully: %O", result);
+    return result;
+  }
+  /**
+   * Modifies a specific version of an existing agent
+   *
+   * @param versionData - The version data to modify
+   * @param options - Optional request options
+   * @returns Promise resolving to the modified version response
+   */
+  async modifyAgentVersion(versionData, options) {
+    log9("Modifying agent version: %s@%s", versionData.identifier, versionData.version);
+    const result = await this.request("/v1/agents/version/modify", {
+      body: JSON.stringify(versionData),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      ...options
+    });
+    log9("Agent version modified successfully: %O", result);
+    return result;
+  }
+  /**
+   * Checks if an agent exists in the marketplace
+   *
+   * @param identifier - Unique identifier of the agent
+   * @param options - Optional request options
+   * @returns Promise resolving to true if agent exists, false otherwise
+   */
+  async checkAgentExists(identifier, options) {
+    log9("Checking if agent exists: %s", identifier);
+    try {
+      await this.getAgentDetail(identifier, {}, options);
+      log9("Agent exists: %s", identifier);
+      return true;
+    } catch (e) {
+      log9("Agent does not exist: %s", identifier);
+      return false;
+    }
+  }
+};
+
+// src/market/services/AuthService.ts
+import debug10 from "debug";
 import urlJoin2 from "url-join";
-var log9 = debug9("lobe-market-sdk:discovery");
+var log10 = debug10("lobe-market-sdk:auth");
+var AuthService = class extends BaseSDK {
+  /**
+   * Retrieves user information from the OIDC userinfo endpoint
+   *
+   * Requires a valid access token in the Authorization header.
+   *
+   * @param accessToken - The access token to use for authentication
+   * @param options - Optional request options
+   * @returns Promise resolving to the user information
+   */
+  async getUserInfo(accessToken, options) {
+    log10("Getting user info");
+    const userInfoUrl = urlJoin2(this.baseUrl, "market-oidc/userinfo");
+    const response = await fetch(userInfoUrl, {
+      headers: {
+        "Authorization": `Bearer ${accessToken}`,
+        "Content-Type": "application/json"
+      },
+      method: "GET",
+      ...options
+    });
+    if (!response.ok) {
+      const errorMsg = `Failed to fetch user info: ${response.status} ${response.statusText}`;
+      log10("Error: %s", errorMsg);
+      throw new Error(errorMsg);
+    }
+    const userInfo = await response.json();
+    log10("User info retrieved successfully");
+    return userInfo;
+  }
+  /**
+   * Registers a new OAuth client with the marketplace
+   *
+   * This is typically used for device registration or application setup.
+   * Returns client credentials that can be used for M2M authentication.
+   *
+   * @param clientData - The client registration data
+   * @param options - Optional request options
+   * @returns Promise resolving to the client credentials
+   */
+  async registerClient(clientData, options) {
+    log10("Registering client: %s (%s)", clientData.clientName, clientData.clientType);
+    const result = await this.request("/v1/clients/register", {
+      body: JSON.stringify(clientData),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      ...options
+    });
+    log10("Client registered successfully: %s", result.client_id);
+    return result;
+  }
+  /**
+   * Fetches an M2M (Machine-to-Machine) access token
+   *
+   * Uses client credentials to obtain an access token for server-to-server communication.
+   * This method requires clientId and clientSecret to be set in the SDK options.
+   *
+   * @returns Promise resolving to the access token and expiration time
+   */
+  async getM2MToken() {
+    log10("Fetching M2M token");
+    const tokenInfo = await this.fetchM2MToken();
+    log10("M2M token fetched successfully");
+    return tokenInfo;
+  }
+};
+
+// src/market/services/DiscoveryService.ts
+import debug11 from "debug";
+import urlJoin3 from "url-join";
+var log11 = debug11("lobe-market-sdk:discovery");
 var DiscoveryService = class extends BaseSDK {
   /**
    * Retrieves the service discovery document
@@ -1397,24 +1683,24 @@ var DiscoveryService = class extends BaseSDK {
    * @returns Promise resolving to the service discovery document
    */
   async getDiscoveryDocument() {
-    log9("Fetching discovery document");
+    log11("Fetching discovery document");
     if (this.discoveryDoc) {
-      log9("Returning cached discovery document");
+      log11("Returning cached discovery document");
       return this.discoveryDoc;
     }
-    const res = await fetch(urlJoin2(this.baseUrl, "/.well-known/discovery"));
+    const res = await fetch(urlJoin3(this.baseUrl, "/.well-known/discovery"));
     if (!res.ok) {
       throw new Error(await res.text());
     }
     this.discoveryDoc = await res.json();
-    log9("Discovery document successfully fetched");
+    log11("Discovery document successfully fetched");
     return this.discoveryDoc;
   }
 };
 
 // src/market/services/PluginsService.ts
-import debug10 from "debug";
-var log10 = debug10("lobe-market-sdk:plugins");
+import debug12 from "debug";
+var log12 = debug12("lobe-market-sdk:plugins");
 var PluginsService = class extends BaseSDK {
   /**
    * Retrieves a list of plugins from the marketplace
@@ -1429,9 +1715,9 @@ var PluginsService = class extends BaseSDK {
     const locale = params.locale || this.defaultLocale;
     const queryParams = { ...params, locale };
     const queryString = this.buildQueryString(queryParams);
-    log10("Getting plugin list: %O", queryParams);
+    log12("Getting plugin list: %O", queryParams);
     const result = await this.request(`/v1/plugins${queryString}`, options);
-    log10("Retrieved %d plugins", result.items.length);
+    log12("Retrieved %d plugins", result.items.length);
     return result;
   }
   /**
@@ -1449,12 +1735,12 @@ var PluginsService = class extends BaseSDK {
     const locale = params.locale || this.defaultLocale;
     const queryParams = { ...params, locale };
     const queryString = this.buildQueryString(queryParams);
-    log10("Getting plugin categories: %O", queryParams);
+    log12("Getting plugin categories: %O", queryParams);
     const result = await this.request(
       `/v1/plugins/categories${queryString}`,
       options
     );
-    log10("Retrieved %d categories", result.length);
+    log12("Retrieved %d categories", result.length);
     return result;
   }
   /**
@@ -1467,12 +1753,12 @@ var PluginsService = class extends BaseSDK {
    * @returns Promise resolving to an array containing identifiers array and last modified time
    */
   async getPublishedIdentifiers(options) {
-    log10("Getting published plugin identifiers");
+    log12("Getting published plugin identifiers");
     const result = await this.request(
       "/v1/plugins/identifiers",
       options
     );
-    log10("Retrieved %d published plugin identifiers", result.length);
+    log12("Retrieved %d published plugin identifiers", result.length);
     return result;
   }
   /**
@@ -1492,7 +1778,7 @@ var PluginsService = class extends BaseSDK {
     version,
     identifier
   }, options) {
-    log10("Getting plugin manifest: %O", { identifier, locale, version });
+    log12("Getting plugin manifest: %O", { identifier, locale, version });
     const localeParam = locale || this.defaultLocale;
     const params = { locale: localeParam };
     if (version) {
@@ -1503,7 +1789,7 @@ var PluginsService = class extends BaseSDK {
       `/v1/plugins/${identifier}/manifest${queryString}`,
       options
     );
-    log10("Plugin manifest successfully retrieved: %s", identifier);
+    log12("Plugin manifest successfully retrieved: %s", identifier);
     return manifest;
   }
   /**
@@ -1520,7 +1806,7 @@ var PluginsService = class extends BaseSDK {
     version,
     identifier
   }, options) {
-    log10("Getting plugin detail: %O", { identifier, locale, version });
+    log12("Getting plugin detail: %O", { identifier, locale, version });
     const localeParam = locale || this.defaultLocale;
     const params = { locale: localeParam };
     if (version) {
@@ -1531,7 +1817,7 @@ var PluginsService = class extends BaseSDK {
       `/v1/plugins/${identifier}${queryString}`,
       options
     );
-    log10("Plugin manifest successfully retrieved: %s", identifier);
+    log12("Plugin manifest successfully retrieved: %s", identifier);
     return manifest;
   }
   /**
@@ -1546,7 +1832,7 @@ var PluginsService = class extends BaseSDK {
    *
    */
   async reportInstallation(reportData) {
-    log10("Reporting installation for %s@%s", reportData.identifier, reportData.version);
+    log12("Reporting installation for %s@%s", reportData.identifier, reportData.version);
     const result = await this.request("/v1/plugins/report/installation", {
       body: JSON.stringify(reportData),
       headers: {
@@ -1554,7 +1840,7 @@ var PluginsService = class extends BaseSDK {
       },
       method: "POST"
     });
-    log10("Installation report submitted successfully: %O", result);
+    log12("Installation report submitted successfully: %O", result);
     return result;
   }
   /**
@@ -1568,7 +1854,7 @@ var PluginsService = class extends BaseSDK {
    * @returns Promise resolving to the report submission response
    */
   async reportCall(reportData) {
-    log10(
+    log12(
       "Reporting call for %s@%s - %s:%s",
       reportData.identifier,
       reportData.version,
@@ -1582,13 +1868,13 @@ var PluginsService = class extends BaseSDK {
       },
       method: "POST"
     });
-    log10("Call report submitted successfully: %O", result);
+    log12("Call report submitted successfully: %O", result);
     return result;
   }
 };
 
 // src/market/market-sdk.ts
-var log11 = debug11("lobe-market-sdk");
+var log13 = debug13("lobe-market-sdk");
 var MarketSDK = class extends BaseSDK {
   /**
    * Creates a new MarketSDK instance
@@ -1601,7 +1887,9 @@ var MarketSDK = class extends BaseSDK {
       tokenExpiry: void 0
     };
     super(options, void 0, sharedTokenState);
-    log11("MarketSDK instance created");
+    log13("MarketSDK instance created");
+    this.agents = new AgentService(options, this.headers, sharedTokenState);
+    this.auth = new AuthService(options, this.headers, sharedTokenState);
     this.plugins = new PluginsService(options, this.headers, sharedTokenState);
     this.discovery = new DiscoveryService(options, this.headers, sharedTokenState);
   }
@@ -1626,20 +1914,11 @@ var MarketSDK = class extends BaseSDK {
    * @param request - Client registration request data
    * @returns Promise resolving to the client registration response with credentials
    * @throws Error if registration fails
+   * @deprecated Use auth.registerClient() instead
    */
   async registerClient(request) {
-    log11("Registering client: %s (%s)", request.clientName, request.clientType);
-    try {
-      const response = await this.request("v1/clients/register", {
-        body: JSON.stringify(request),
-        method: "POST"
-      });
-      log11("Client registered successfully: %s", response.client_id);
-      return response;
-    } catch (error) {
-      console.error("Client registration failed: %o", error);
-      throw error;
-    }
+    log13("Registering client (deprecated method, use auth.registerClient): %s", request.clientName);
+    return this.auth.registerClient(request);
   }
 };