@lobehub/market-sdk 0.31.1 → 0.31.3

package/dist/index.d.mts

@@ -1560,6 +1560,20 @@ interface MarketSDKOptions {
      * ```
      */
     trustedClientToken?: string;
+    /**
+     * Custom User-Agent string for identifying the client.
+     *
+     * If provided, this will be used instead of the default SDK User-Agent.
+     * Useful for CLI tools or other clients that want to identify themselves.
+     *
+     * @example
+     * ```typescript
+     * const sdk = new MarketSDK({
+     *   userAgent: 'LobeHub-Market-CLI/1.0.0',
+     * });
+     * ```
+     */
+    userAgent?: string;
 }
 /**
  * Shared token state for SDK instances
@@ -2587,6 +2601,10 @@ interface MarketSkillListItem {
      * Category
      */
     category?: string;
+    /**
+     * Number of comments
+     */
+    commentCount: number;
     /**
      * Creation timestamp (ISO string)
      */
@@ -2964,10 +2982,18 @@ interface MarketReportGitHubSkillResponse {
      * Skill identifier
      */
     identifier: string;
+    /**
+     * Skill identifiers (present when reporting a repository with multiple skills)
+     */
+    identifiers?: string[];
     /**
      * Status message
      */
     message: string;
+    /**
+     * Number of queued imports
+     */
+    queuedCount?: number;
     /**
      * Status of the report
      * - 'queued': Import request has been queued
@@ -2975,6 +3001,36 @@ interface MarketReportGitHubSkillResponse {
      */
     status: 'exists' | 'queued';
 }
+/**
+ * Parameters for reporting a skill installation
+ */
+interface MarketReportSkillInstallParams {
+    /** Error code if installation failed */
+    errorCode?: string;
+    /** Error message if installation failed */
+    errorMessage?: string;
+    /** Skill identifier */
+    identifier: string;
+    /** Installation duration in milliseconds */
+    installDurationMs: number;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+    /** Platform information */
+    platform?: string;
+    /** Whether the installation was successful */
+    success: boolean;
+    /** Skill version (optional, omit = latest) */
+    version?: string;
+}
+/**
+ * Response from reporting a skill installation
+ */
+interface MarketReportSkillInstallResponse {
+    /** Message about the processing result */
+    message: string;
+    /** Whether the report was successfully recorded */
+    success: boolean;
+}
 /**
  * Response for skill versions list
  */
@@ -6127,6 +6183,28 @@ declare class MarketSkillService extends BaseSDK {
      * ```
      */
     reportGitHubSkill(params: MarketReportGitHubSkillParams, options?: globalThis.RequestInit): Promise<MarketReportGitHubSkillResponse>;
+    /**
+     * Reports a skill installation attempt
+     *
+     * Submits installation telemetry data including success/failure status,
+     * duration, and optional error information. Used by the CLI after
+     * downloading and extracting a skill package.
+     *
+     * @param params - Installation report parameters
+     * @param options - Optional request options
+     * @returns Promise resolving to the report response
+     *
+     * @example
+     * ```typescript
+     * await sdk.marketSkills.reportSkillInstall({
+     *   identifier: 'github.owner.repo',
+     *   success: true,
+     *   installDurationMs: 1234,
+     *   platform: 'darwin-arm64',
+     * });
+     * ```
+     */
+    reportSkillInstall(params: MarketReportSkillInstallParams, options?: globalThis.RequestInit): Promise<MarketReportSkillInstallResponse>;
     /**
      * Submits or updates a rating for a skill
      *
@@ -6660,6 +6738,18 @@ declare class MarketAPIError extends Error {
     toJSON(): any;
 }
 
+/**
+ * SDK Version
+ *
+ * This version should be kept in sync with package.json version.
+ * It is used for User-Agent header to identify SDK requests.
+ */
+declare const SDK_VERSION = "0.31.3";
+/**
+ * SDK User-Agent string
+ */
+declare const SDK_USER_AGENT = "LobeHub-Market-SDK/0.31.3";
+
 /**
  * Trusted Client Token Utilities
  *
@@ -6733,4 +6823,4 @@ declare function buildTrustedClientPayload(params: {
     userId: string;
 }): TrustedClientPayload;
 
-export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateMemberAgent, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentGroupListQuery, type OwnAgentListQuery, type PaginationQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillErrorResponse, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };
+export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateMemberAgent, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, type MarketReportSkillInstallParams, type MarketReportSkillInstallResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OwnAgentGroupListQuery, type OwnAgentListQuery, type PaginationQuery, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, SDK_USER_AGENT, SDK_VERSION, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillErrorResponse, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserProfile, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };

package/dist/index.mjs

@@ -49,6 +49,10 @@ var MarketAPIError = class _MarketAPIError extends Error {
   }
 };
 
+// src/core/version.ts
+var SDK_VERSION = "0.31.3";
+var SDK_USER_AGENT = `LobeHub-Market-SDK/${SDK_VERSION}`;
+
 // src/core/BaseSDK.ts
 var log = debug("lobe-market-sdk:core");
 var BaseSDK = class {
@@ -69,14 +73,16 @@ var BaseSDK = class {
     this.clientSecret = options.clientSecret;
     this.sharedTokenState = sharedTokenState;
     const apiKey = options.apiKey || process.env.MARKET_API_KEY;
+    const userAgent = options.userAgent || SDK_USER_AGENT;
     if (sharedHeaders) {
       this.headers = sharedHeaders;
       log("Using shared headers object");
     } else {
       this.headers = {
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        "User-Agent": userAgent
       };
-      log("Created new headers object");
+      log("Created new headers object with User-Agent: %s", userAgent);
     }
     if (apiKey) {
       this.headers.Authorization = `Bearer ${apiKey}`;
@@ -3841,6 +3847,40 @@ var MarketSkillService = class extends BaseSDK {
     log19("GitHub skill reported: %s (status: %s)", result.identifier, result.status);
     return result;
   }
+  /**
+   * Reports a skill installation attempt
+   *
+   * Submits installation telemetry data including success/failure status,
+   * duration, and optional error information. Used by the CLI after
+   * downloading and extracting a skill package.
+   *
+   * @param params - Installation report parameters
+   * @param options - Optional request options
+   * @returns Promise resolving to the report response
+   *
+   * @example
+   * ```typescript
+   * await sdk.marketSkills.reportSkillInstall({
+   *   identifier: 'github.owner.repo',
+   *   success: true,
+   *   installDurationMs: 1234,
+   *   platform: 'darwin-arm64',
+   * });
+   * ```
+   */
+  async reportSkillInstall(params, options) {
+    log19("Reporting skill install: %s (success: %s)", params.identifier, params.success);
+    const result = await this.request(
+      "/v1/skills/report/installation",
+      {
+        ...options,
+        body: JSON.stringify(params),
+        method: "POST"
+      }
+    );
+    log19("Skill install reported: %s", result.message);
+    return result;
+  }
   /**
    * Submits or updates a rating for a skill
    *
@@ -4681,6 +4721,8 @@ export {
   MarketAdmin,
   MarketSDK,
   ReviewStatusEnumSchema,
+  SDK_USER_AGENT,
+  SDK_VERSION,
   StatusEnumSchema,
   VisibilityEnumSchema,
   buildTrustedClientPayload,