@lobehub/market-sdk 0.31.7 → 0.31.9

package/dist/index.d.mts

@@ -1966,6 +1966,114 @@ interface CodeInterpreterToolParams {
     searchLocalFiles: SearchLocalFilesParams;
     writeLocalFile: WriteLocalFileParams;
 }
+/**
+ * Author information for a plugin comment
+ */
+interface PluginCommentAuthor {
+    avatar?: string;
+    background?: string | null;
+    displayName?: string | null;
+    id?: number;
+    identifier?: string;
+    sourceType?: string | null;
+    tags?: string[];
+    type: 'agent' | 'user';
+}
+/**
+ * A single plugin comment item
+ */
+interface PluginCommentItem {
+    author: PluginCommentAuthor | null;
+    content: string;
+    createdAt: string;
+    downvotes: number;
+    id: number;
+    parentId: number | null;
+    rating?: number;
+    replyCount: number;
+    updatedAt: string;
+    upvotes: number;
+}
+/**
+ * Created plugin comment entity
+ */
+interface PluginCommentCreateItem {
+    agentId: number | null;
+    content: string;
+    createdAt: string;
+    downvotes: number;
+    id: number;
+    parentId: number | null;
+    pluginId: number;
+    updatedAt: string;
+    upvotes: number;
+    userId: number | null;
+}
+/**
+ * Rating payload returned when creating a comment with a score
+ */
+interface PluginCommentRating {
+    score: number;
+}
+/**
+ * Response returned by the create comment endpoint
+ */
+interface PluginCommentCreateResponse extends PluginCommentCreateItem {
+    rating?: PluginCommentRating;
+}
+/**
+ * Latest comment for the authenticated user/agent on a plugin
+ */
+interface PluginLatestOwnComment {
+    createdAt: string;
+    id: number;
+    parentId: number | null;
+    replyCount: number;
+}
+/**
+ * Response returned by the delete comment endpoint
+ */
+interface PluginCommentDeleteResponse {
+    success: boolean;
+}
+/**
+ * Query parameters for listing plugin comments
+ */
+interface PluginCommentListQuery {
+    order?: 'asc' | 'desc';
+    page?: number;
+    pageSize?: number;
+    sort?: 'createdAt' | 'upvotes';
+}
+/**
+ * Paginated response for plugin comments
+ */
+interface PluginCommentListResponse {
+    currentPage: number;
+    items: PluginCommentItem[];
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+}
+/**
+ * Rating distribution counts by score (1-5)
+ */
+interface PluginRatingDistribution {
+    1: number;
+    2: number;
+    3: number;
+    4: number;
+    5: number;
+    totalCount: number;
+}
+/**
+ * Reaction response type
+ */
+interface PluginCommentReactionResponse {
+    commentId: number;
+    id: number;
+    type: string;
+}
 
 /**
  * Connect Types for LobeHub Market SDK
@@ -2495,6 +2603,14 @@ interface MarketSkillListQuery {
      * Filter by category
      */
     category?: string;
+    /**
+     * Filter by featured flag
+     */
+    isFeatured?: 'false' | 'true';
+    /**
+     * Filter by official flag
+     */
+    isOfficial?: 'false' | 'true';
     /**
      * Locale for localized content (e.g., 'en-US', 'zh-CN')
      */
@@ -2648,6 +2764,10 @@ interface MarketSkillListItem {
      * Whether the skill is featured
      */
     isFeatured: boolean;
+    /**
+     * Whether the skill is official
+     */
+    isOfficial: boolean;
     /**
      * Whether the skill is validated
      */
@@ -2871,6 +2991,10 @@ interface MarketSkillDetail {
      * Whether the skill is featured
      */
     isFeatured: boolean;
+    /**
+     * Whether the skill is official
+     */
+    isOfficial: boolean;
     /**
      * Whether the skill is validated
      */
@@ -3151,6 +3275,40 @@ interface SkillRatingDistribution {
     totalCount: number;
 }
 
+type MarketSkillCollectionItemSort = 'createdAt' | 'installCount' | 'name' | 'position' | 'ratingAverage' | 'updatedAt';
+type MarketSkillCollectionMatchType = 'manual' | 'repository';
+interface MarketSkillCollectionListQuery {
+    locale?: string;
+}
+interface MarketSkillCollectionListItem {
+    createdAt: string;
+    description: string;
+    icon: string;
+    id: number;
+    itemCount: number;
+    matchType: MarketSkillCollectionMatchType;
+    position: number;
+    repository?: string;
+    slug: string;
+    title: string;
+    updatedAt: string;
+}
+type MarketSkillCollectionListResponse = MarketSkillCollectionListItem[];
+interface MarketSkillCollectionDetailQuery {
+    locale?: string;
+    page?: number;
+    pageSize?: number;
+    q?: string;
+    sort?: MarketSkillCollectionItemSort;
+}
+interface MarketSkillCollectionDetail extends MarketSkillCollectionListItem {
+    currentPage: number;
+    items: MarketSkillListItem[];
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+}
+
 /**
  * User-related type definitions for LobeHub Market SDK
  *
@@ -5932,6 +6090,93 @@ declare class PluginsService extends BaseSDK {
         topicId: string;
         userId: string;
     }): Promise<RunBuildInToolsResponse>;
+    /**
+     * Submits or updates a rating for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param score - Rating score (1-5)
+     * @param options - Optional request options
+     * @returns Promise resolving to the submitted score
+     */
+    submitRating(identifier: string, score: number, options?: globalThis.RequestInit): Promise<{
+        score: number;
+    }>;
+    /**
+     * Deletes the current user/agent's rating for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param options - Optional request options
+     * @returns Promise resolving to success status
+     */
+    deleteRating(identifier: string, options?: globalThis.RequestInit): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Gets the rating distribution for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param options - Optional request options
+     * @returns Promise resolving to the rating distribution
+     */
+    getRatingDistribution(identifier: string, options?: globalThis.RequestInit): Promise<PluginRatingDistribution>;
+    /**
+     * Gets paginated comments for a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param params - Query parameters for pagination and sorting
+     * @param options - Optional request options
+     * @returns Promise resolving to the paginated comment list
+     */
+    getComments(identifier: string, params?: PluginCommentListQuery, options?: globalThis.RequestInit): Promise<PluginCommentListResponse>;
+    /**
+     * Gets the latest comment for the authenticated user or agent on a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param options - Optional request options
+     * @returns Promise resolving to the latest own comment or null when none exists
+     */
+    getLatestOwnComment(identifier: string, options?: globalThis.RequestInit): Promise<PluginLatestOwnComment | null>;
+    /**
+     * Creates a comment on a plugin, optionally with a rating
+     *
+     * @param identifier - Unique plugin identifier
+     * @param data - Comment data with content, optional score, and optional parentId
+     * @param options - Optional request options
+     * @returns Promise resolving to the created comment (with optional rating field)
+     */
+    createComment(identifier: string, data: {
+        content: string;
+        parentId?: number;
+        score?: number;
+    }, options?: globalThis.RequestInit): Promise<PluginCommentCreateResponse>;
+    /**
+     * Deletes a comment from a plugin
+     *
+     * @param identifier - Unique plugin identifier
+     * @param commentId - Comment ID to delete
+     * @param options - Optional request options
+     * @returns Promise resolving to success status
+     */
+    deleteComment(identifier: string, commentId: number, options?: globalThis.RequestInit): Promise<PluginCommentDeleteResponse>;
+    /**
+     * Adds or updates a reaction on a comment
+     *
+     * @param commentId - Comment ID to react to
+     * @param type - Reaction type ('upvote' or 'downvote')
+     * @param options - Optional request options
+     * @returns Promise resolving to the created reaction
+     */
+    addReaction(commentId: number, type: 'downvote' | 'upvote', options?: globalThis.RequestInit): Promise<PluginCommentReactionResponse>;
+    /**
+     * Removes a reaction from a comment
+     *
+     * @param commentId - Comment ID to remove reaction from
+     * @param options - Optional request options
+     * @returns Promise resolving to success status
+     */
+    removeReaction(commentId: number, options?: globalThis.RequestInit): Promise<{
+        success: boolean;
+    }>;
 }
 
 /**
@@ -6016,6 +6261,11 @@ declare class SkillService extends BaseSDK {
     callTool<T = unknown>(provider: string, params: SkillCallParams, options?: globalThis.RequestInit): Promise<CallSkillToolResponse<T>>;
 }
 
+declare class MarketSkillCollectionService extends BaseSDK {
+    getSkillCollectionDetail(slug: string, params?: MarketSkillCollectionDetailQuery, options?: globalThis.RequestInit): Promise<MarketSkillCollectionDetail>;
+    getSkillCollections(params?: MarketSkillCollectionListQuery, options?: globalThis.RequestInit): Promise<MarketSkillCollectionListResponse>;
+}
+
 /**
  * Market Skill Service
  *
@@ -6737,6 +6987,11 @@ declare class MarketSDK extends BaseSDK {
      * Provides methods to list providers, list tools, and call tools on connected OAuth providers
      */
     readonly skills: SkillService;
+    /**
+     * Market Skill Collection service for curated marketplace skill collections
+     * Provides methods to list and retrieve manually curated skill collections
+     */
+    readonly skillCollections: MarketSkillCollectionService;
     /**
      * Market Skill service for marketplace skill resources
      * Provides methods to list, search, retrieve details, and download skills from the marketplace
@@ -6884,4 +7139,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, 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 SkillCommentCreateItem, type SkillCommentCreateResponse, type SkillCommentDeleteResponse, type SkillCommentItem, type SkillCommentListItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillCommentRating, type SkillErrorResponse, type SkillLatestOwnComment, 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 MarketSkillCollectionDetail, type MarketSkillCollectionDetailQuery, type MarketSkillCollectionItemSort, type MarketSkillCollectionListItem, type MarketSkillCollectionListQuery, type MarketSkillCollectionListResponse, type MarketSkillCollectionMatchType, 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 PluginCommentAuthor, type PluginCommentCreateItem, type PluginCommentCreateResponse, type PluginCommentDeleteResponse, type PluginCommentItem, type PluginCommentListQuery, type PluginCommentListResponse, type PluginCommentRating, type PluginCommentReactionResponse, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginLatestOwnComment, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginRatingDistribution, 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 SkillCommentCreateItem, type SkillCommentCreateResponse, type SkillCommentDeleteResponse, type SkillCommentItem, type SkillCommentListItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillCommentRating, type SkillErrorResponse, type SkillLatestOwnComment, 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 };