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

package/dist/index.mjs

@@ -1380,12 +1380,406 @@ 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 _AuthService 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;
+  }
+  /** OAuth handoff response shapes */
+  // Using inline type aliases inside the class for better encapsulation
+  // success: 200
+  static typeHandoffSuccess(data) {
+    return {
+      clientId: data.clientId,
+      code: data.code,
+      redirectUri: data.redirectUri,
+      status: _AuthService.HANDOFF_SUCCESS_STATUS
+    };
+  }
+  /**
+   * Get OAuth handoff status and data by id.
+   * Maps server HTTP statuses to a typed status union:
+   * - 200: success
+   * - 202: pending
+   * - 404: consumed
+   * - 410: expired
+   * - others: error (throws)
+   */
+  async getOAuthHandoff(id, options) {
+    var _a, _b;
+    if (!id) throw new Error("id is required");
+    log10("Getting OAuth handoff: %s", id);
+    const handoffUrl = `${urlJoin2(this.baseUrl, "market-oidc/handoff")}?id=${encodeURIComponent(id)}`;
+    const response = await fetch(handoffUrl, {
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "GET",
+      ...options
+    });
+    if (response.status === 200) {
+      const json = await response.json();
+      const result = _AuthService.typeHandoffSuccess({
+        clientId: json.clientId,
+        code: json.code,
+        redirectUri: json.redirectUri
+      });
+      log10("OAuth handoff success for id: %s", id);
+      return result;
+    }
+    if (response.status === 202) {
+      log10("OAuth handoff pending for id: %s", id);
+      return { status: _AuthService.HANDOFF_PENDING_STATUS };
+    }
+    if (response.status === 404) {
+      log10("OAuth handoff consumed for id: %s", id);
+      return { status: _AuthService.HANDOFF_CONSUMED_STATUS };
+    }
+    if (response.status === 410) {
+      log10("OAuth handoff expired for id: %s", id);
+      return { status: _AuthService.HANDOFF_EXPIRED_STATUS };
+    }
+    let errorMessage = `Failed to fetch OAuth handoff (status ${response.status} ${response.statusText})`;
+    try {
+      const errJson = await response.json();
+      if (errJson && (errJson.message || errJson.error)) {
+        errorMessage = `${errorMessage}: ${(_a = errJson.error) != null ? _a : ""} ${(_b = errJson.message) != null ? _b : ""}`.trim();
+      }
+    } catch (e) {
+    }
+    log10("Error: %s", errorMessage);
+    throw new Error(errorMessage);
+  }
+  /**
+   * Poll OAuth handoff result until it becomes terminal.
+   * Terminal statuses: success, expired, consumed.
+   * Non-terminal: pending → continue polling.
+   */
+  async pollOAuthHandoff(id, params = {}) {
+    var _a, _b;
+    const intervalMs = (_a = params.intervalMs) != null ? _a : 1500;
+    const timeoutMs = (_b = params.timeoutMs) != null ? _b : 6e4;
+    const startedAt = Date.now();
+    const { signal, requestInit } = params;
+    log10("Start polling OAuth handoff: %s", id);
+    while (true) {
+      if (signal == null ? void 0 : signal.aborted) {
+        const err = new Error("Polling aborted");
+        log10("Error: %s", err.message);
+        throw err;
+      }
+      if (Date.now() - startedAt > timeoutMs) {
+        const err = new Error("Polling timeout");
+        log10("Error: %s", err.message);
+        throw err;
+      }
+      const result = await this.getOAuthHandoff(id, requestInit);
+      if (result.status === "success" || result.status === "expired" || result.status === "consumed") {
+        log10("Stop polling OAuth handoff (terminal): %s -> %s", id, result.status);
+        return result;
+      }
+      await new Promise((resolve) => {
+        setTimeout(resolve, intervalMs);
+      });
+    }
+  }
+};
+// ===== OAuth Handoff Types =====
+/** Successful handoff payload */
+_AuthService.HANDOFF_SUCCESS_STATUS = "success";
+/** Pending handoff status */
+_AuthService.HANDOFF_PENDING_STATUS = "pending";
+/** Consumed handoff status */
+_AuthService.HANDOFF_CONSUMED_STATUS = "consumed";
+/** Expired handoff status */
+_AuthService.HANDOFF_EXPIRED_STATUS = "expired";
+var AuthService = _AuthService;
+
+// 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 +1791,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 +1823,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 +1843,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 +1861,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 +1886,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 +1897,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 +1914,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 +1925,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 +1940,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 +1948,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 +1962,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 +1976,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 +1995,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 +2022,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);
   }
 };