@lobehub/market-sdk 0.32.2 → 0.33.1

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { AgentItem, UserCredSummary, MarketItemBase, PluginConnectionType, InstallFailureAnalysisQuery, InstallFailureAnalysis, RangeQuery, RangeStats, TopPluginsQuery, TopPlugin, PluginManifest, AdminPluginItem, AdminPluginItemDetail, PluginVersion, PluginVersionLocalization, AdminDeploymentOption, InstallationDetails, SystemDependency, IncompleteI18nPlugin, CreateSkillCollectionRequest, AdminSkillCollectionDetail, AdminSkillCollectionListQuery, AdminSkillCollectionListResponse, BatchUpsertSkillCollectionLocalizationsRequest, SkillCollectionLocalizationBatchResponse, SkillCollectionLocalization, UpdateSkillCollectionRequest, UpsertSkillCollectionLocalizationRequest, AgentEventRequest, SkillCredStatus, InjectCredsRequest, InjectCredsResponse, InjectCredsForSkillRequest, InjectCredsForSkillResponse, CategoryListQuery, CategoryItem, PluginItemDetail, InstallReportRequest, InstallReportResponse, CallReportRequest, CallReportResponse, PluginEventRequest, CloudGatewayRequest, CloudGatewayResponse } from '@lobehub/market-types';
+import { AgentItem, UserCredSummary, MarketItemBase, PluginConnectionType, InstallFailureAnalysisQuery, InstallFailureAnalysis, RangeQuery, RangeStats, TopPluginsQuery, TopPlugin, PluginManifest, AdminPluginItem, AdminPluginItemDetail, PluginVersion, PluginVersionLocalization, AdminDeploymentOption, InstallationDetails, SystemDependency, IncompleteI18nPlugin, CreateSkillCollectionRequest, AdminSkillCollectionDetail, AdminSkillCollectionListQuery, AdminSkillCollectionListResponse, BatchUpsertSkillCollectionLocalizationsRequest, SkillCollectionLocalizationBatchResponse, SkillCollectionLocalization, UpdateSkillCollectionRequest, UpsertSkillCollectionLocalizationRequest, SitemapResponse, AgentEventRequest, SkillCredStatus, InjectCredsRequest, InjectCredsResponse, InjectCredsForSkillRequest, InjectCredsForSkillResponse, CategoryListQuery, CategoryItem, PluginItemDetail, InstallReportRequest, InstallReportResponse, CallReportRequest, CallReportResponse, PluginEventRequest, CloudGatewayRequest, CloudGatewayResponse } from '@lobehub/market-types';
 export * from '@lobehub/market-types';
 export { CategoryItem, CategoryListQuery, CategoryListResponse, CredType, InjectCredsForSkillRequest, InjectCredsForSkillResponse, InjectCredsRequest, InjectCredsResponse, InjectedFileInfo, SkillCredStatus, UserCredSummary } from '@lobehub/market-types';
 import { JSONSchema7 } from 'json-schema';
@@ -2540,6 +2540,13 @@ interface SkillCallParams {
      * Name of the tool to call
      */
     tool: string;
+    /**
+     * Topic ID for CLI session isolation (required for CLI-based providers like github)
+     *
+     * Used to isolate CLI environments between different conversations/sessions.
+     * Each unique topicId gets its own sandbox environment.
+     */
+    topicId?: string;
 }
 /**
  * Summary information about a skill provider
@@ -2592,6 +2599,11 @@ interface ListSkillProvidersResponse {
  * Response for listing tools of a provider
  */
 interface ListSkillToolsResponse {
+    /**
+     * Instruction markdown providing guidance on authentication,
+     * available tools, and extended API reference
+     */
+    instruction?: string;
     /**
      * Provider identifier
      */
@@ -5210,6 +5222,7 @@ declare class AgentService extends BaseSDK {
      * full agent metadata. This is useful for clients that need to know which
      * agents are available without fetching complete agent information.
      *
+     * @deprecated Use {@link AgentService.getSitemap} instead.
      * @param options - Optional request options
      * @returns Promise resolving to an array containing identifiers array and last modified time
      */
@@ -5217,6 +5230,16 @@ declare class AgentService extends BaseSDK {
         id: string;
         lastModified: string;
     }[]>;
+    /**
+     * Retrieves a paginated list of published agent identifiers for sitemaps
+     *
+     * @param params - Pagination (`page` defaults to 1, `pageSize` defaults to 200, max 500 server-side)
+     * @param options - Optional request options
+     */
+    getSitemap(params?: {
+        page?: number;
+        pageSize?: number;
+    }, options?: globalThis.RequestInit): Promise<SitemapResponse>;
     /**
      * Retrieves agent categories and their counts
      *
@@ -6173,12 +6196,23 @@ declare class PluginsService extends BaseSDK {
      * full plugin metadata. This is useful for clients that need to know which
      * plugins are available without fetching complete plugin information.
      *
+     * @deprecated Use {@link PluginsService.getSitemap} instead.
      * @returns Promise resolving to an array containing identifiers array and last modified time
      */
     getPublishedIdentifiers(options?: globalThis.RequestInit): Promise<{
         identifier: string;
         lastModified: string;
     }[]>;
+    /**
+     * Retrieves a paginated list of published plugin (MCP) identifiers for sitemaps
+     *
+     * @param params - Pagination (`page` defaults to 1, `pageSize` defaults to 200, max 500 server-side)
+     * @param options - Optional request options
+     */
+    getSitemap(params?: {
+        page?: number;
+        pageSize?: number;
+    }, options?: globalThis.RequestInit): Promise<SitemapResponse>;
     /**
      * Retrieves the manifest for a specific plugin
      *
@@ -6729,6 +6763,7 @@ declare class MarketSkillService extends BaseSDK {
      * without full metadata. Useful for sitemap generation or
      * knowing which skills are available.
      *
+     * @deprecated Use {@link MarketSkillService.getSitemap} instead.
      * @param options - Optional request options
      * @returns Promise resolving to an array of identifiers with last modified times
      */
@@ -6736,6 +6771,16 @@ declare class MarketSkillService extends BaseSDK {
         identifier: string;
         lastModified: string;
     }[]>;
+    /**
+     * Retrieves a paginated list of published skill identifiers for sitemaps
+     *
+     * @param params - Pagination (`page` defaults to 1, `pageSize` defaults to 200, max 500 server-side)
+     * @param options - Optional request options
+     */
+    getSitemap(params?: {
+        page?: number;
+        pageSize?: number;
+    }, options?: globalThis.RequestInit): Promise<SitemapResponse>;
     /**
      * Checks if a skill exists in the marketplace
      *

package/dist/index.mjs

@@ -1854,6 +1854,7 @@ var AgentService2 = class extends BaseSDK {
    * full agent metadata. This is useful for clients that need to know which
    * agents are available without fetching complete agent information.
    *
+   * @deprecated Use {@link AgentService.getSitemap} instead.
    * @param options - Optional request options
    * @returns Promise resolving to an array containing identifiers array and last modified time
    */
@@ -1866,6 +1867,24 @@ var AgentService2 = class extends BaseSDK {
     log12("Retrieved %d published agent identifiers", result.length);
     return result;
   }
+  /**
+   * Retrieves a paginated list of published agent identifiers for sitemaps
+   *
+   * @param params - Pagination (`page` defaults to 1, `pageSize` defaults to 200, max 500 server-side)
+   * @param options - Optional request options
+   */
+  async getSitemap(params = {}, options) {
+    const queryString = this.buildQueryString(params);
+    log12("Getting agent sitemap%s", queryString);
+    const result = await this.request(`/v1/agents/sitemap${queryString}`, options);
+    log12(
+      "Retrieved agent sitemap page %d/%d (%d items)",
+      result.currentPage,
+      result.totalPages,
+      result.items.length
+    );
+    return result;
+  }
   /**
    * Retrieves agent categories and their counts
    *
@@ -3520,6 +3539,7 @@ var PluginsService = class extends BaseSDK {
    * full plugin metadata. This is useful for clients that need to know which
    * plugins are available without fetching complete plugin information.
    *
+   * @deprecated Use {@link PluginsService.getSitemap} instead.
    * @returns Promise resolving to an array containing identifiers array and last modified time
    */
   async getPublishedIdentifiers(options) {
@@ -3531,6 +3551,27 @@ var PluginsService = class extends BaseSDK {
     log19("Retrieved %d published plugin identifiers", result.length);
     return result;
   }
+  /**
+   * Retrieves a paginated list of published plugin (MCP) identifiers for sitemaps
+   *
+   * @param params - Pagination (`page` defaults to 1, `pageSize` defaults to 200, max 500 server-side)
+   * @param options - Optional request options
+   */
+  async getSitemap(params = {}, options) {
+    const queryString = this.buildQueryString(params);
+    log19("Getting plugin sitemap%s", queryString);
+    const result = await this.request(
+      `/v1/plugins/sitemap${queryString}`,
+      options
+    );
+    log19(
+      "Retrieved plugin sitemap page %d/%d (%d items)",
+      result.currentPage,
+      result.totalPages,
+      result.items.length
+    );
+    return result;
+  }
   /**
    * Retrieves the manifest for a specific plugin
    *
@@ -4412,6 +4453,7 @@ var MarketSkillService = class extends BaseSDK {
    * without full metadata. Useful for sitemap generation or
    * knowing which skills are available.
    *
+   * @deprecated Use {@link MarketSkillService.getSitemap} instead.
    * @param options - Optional request options
    * @returns Promise resolving to an array of identifiers with last modified times
    */
@@ -4424,6 +4466,24 @@ var MarketSkillService = class extends BaseSDK {
     log22("Retrieved %d published skill identifiers", result.length);
     return result;
   }
+  /**
+   * Retrieves a paginated list of published skill identifiers for sitemaps
+   *
+   * @param params - Pagination (`page` defaults to 1, `pageSize` defaults to 200, max 500 server-side)
+   * @param options - Optional request options
+   */
+  async getSitemap(params = {}, options) {
+    const queryString = this.buildQueryString(params);
+    log22("Getting skill sitemap%s", queryString);
+    const result = await this.request(`/v1/skills/sitemap${queryString}`, options);
+    log22(
+      "Retrieved skill sitemap page %d/%d (%d items)",
+      result.currentPage,
+      result.totalPages,
+      result.items.length
+    );
+    return result;
+  }
   /**
    * Checks if a skill exists in the marketplace
    *